[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff-commit] groff/man groff_tmac.man
From: |
Eric S. Raymond |
Subject: |
[Groff-commit] groff/man groff_tmac.man |
Date: |
Sun, 04 Feb 2007 17:47:33 +0000 |
CVSROOT: /sources/groff
Module name: groff
Changes by: Eric S. Raymond <esr> 07/02/04 17:47:33
Modified files:
man : groff_tmac.man
Log message:
Get rid of the rest of the groff-dependent macrology. File should now
be viewer-portable.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/man/groff_tmac.man?cvsroot=groff&r1=1.23&r2=1.24
Patches:
Index: groff_tmac.man
===================================================================
RCS file: /sources/groff/groff/man/groff_tmac.man,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -b -r1.23 -r1.24
--- groff_tmac.man 4 Feb 2007 17:33:08 -0000 1.23
+++ groff_tmac.man 4 Feb 2007 17:47:33 -0000 1.24
@@ -37,43 +37,8 @@
.\" Setup
.\" --------------------------------------------------------------------
.
-.do nr groff_tmac_C \n[.C]
-.cp 0
-.
-.
.ds Ellipsis \&.\|.\|.\&\"
.
-.\"--------------------------------------------------------------------
-.\" .Text (<text>...)
-.\"
-.\" Treat the arguments as text, no matter how they look.
-.\"
-.de Text
-. if \\n[.$]=0 \
-. return
-. nop \)\\$*\)
-..
-.\" --------------------------------------------------------------------
-.de option
-. ds @tmp@ \f(CB\\$1\f[]
-. shift 1
-. Text address@hidden@]\\$*
-. rm @tmp@
-..
-.\" --------------------------------------------------------------------
-.de argument
-. ds @tmp@ \f(CI\\$1\f[]
-. shift 1
-. Text address@hidden@]\\$*
-. rm @tmp@
-..
-.\" --------------------------------------------------------------------
-.de request
-. ds @tmp@ \f(CB\\$1\f[]
-. shift 1
-. Text address@hidden@]\\$*
-. rm @tmp@
-..
.\" --------------------------------------------------------------------
.\" SH DESCRIPTION
.\" --------------------------------------------------------------------
@@ -475,12 +440,12 @@
.RS
.IP
.EX
-. Text .am PSPIC
-. Text .\ \ vpt 0
-. Text \[rs]h'(\[rs]\[rs]n[ps-offset]u + \[rs]\[rs]n[ps-deswid]u)'
-. Text .\ \ sp -1
-. Text .\ \ vpt 1
-. Text ..
+\&.am PSPIC
+\&.\ \ vpt 0
+\&\eh'(\e\en[ps-offset]u + \e\en[ps-deswid]u)'
+\&.\ \ sp -1
+\&.\ \ vpt 1
+\&..
.EE
.RE
.
@@ -520,7 +485,7 @@
packages, due to a simplistic design in option parsing.
.
Macro packages were always included by option
-.option -m;
+.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.
@@ -538,9 +503,9 @@
So it could be activated by the argument
.I an
to option
-.option -m ,
+.BR -m ,
or
-.option -man
+.BR -man
for short.
.
.
@@ -556,7 +521,7 @@
.IR doc .
For, when omitting the space between the option and its argument, the
command line option for activating this package reads
-.option "-mdoc" .
+.BR -mdoc .
.
.
.P
@@ -643,8 +608,8 @@
There are several ways to use a macro package in a document.
.
The classical way is to specify the troff/groff option
-.option \-m
-.argument name
+.BR \-m
+.I name
at run-time; this makes the contents of the macro package
.I name
available.
@@ -659,31 +624,31 @@
.P
Alternatively, it is also possible to include a macro file by adding
the request
-.request so
+.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
-.request mso
+.B \&.mso
.IR package ,
which added searching in the tmac path, just like option
-.option -m
+.BR -m
does.
.
.
.P
Note that in order to resolve the
-.request so
+.B \&.so
and
-.request mso
+.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
-.option \-s .
+.BR \-s .
.
.I man
calls soelim automatically.
@@ -736,9 +701,9 @@
and put it in some directory of the tmac path, see section
.BR FILES .
Then documents can include it with the
-.request mso
+.B \&.mso
request or the option
-.option -m .
+.BR -m .
.
.
.ig
@@ -880,13 +845,13 @@
.
.
.P
-.ds @1 \[rs]f[I]\[rs]\[rs]$0\[rs]f[]\"
+.ds @1 \ef[I]\e\e$0\ef[]\"
.ds @2 arguments:\"
.EX
\&.ds midpart was called with
\&.de print_args
-\&.\ \ tm\ address@hidden \[rs]\[rs]*[midpart]\ \[rs]\[rs]n[.$]\ address@hidden
-\&.\ \ tm\ \[rs]\[rs]$*
+\&.\ \ tm\ address@hidden \e\e*[midpart]\ \e\en[.$]\ address@hidden
+\&.\ \ tm\ \e\e$*
\&..
.EE
.rm @1
@@ -917,28 +882,28 @@
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
-.I \[rs]\[rs]$*
+.I \e\e$*
and
-.IR \[rs]\[rs][.$] .
+.IR \e\e[.$] .
The same applies to the macro name because it could be called with an
alias name, so
-.IR \[rs]\[rs]$0 .
+.IR \e\e$0 .
.
.
.P
On the other hand,
.I midpart
is a constant string, it does not change, so no doubling for
-.IR \[rs]*[midpart] .
+.IR \e*[midpart] .
The
-.I \[rs]f
+.I \ef
escape sequences are predefined groff elements for setting the font
within the text.
.
Of course, this behavior does not change, so no doubling with
-.I \[rs]f[I]
+.I \ef[I]
and
-.IR \[rs]f[] .
+.IR \ef[] .
.
.
.\" --------------------------------------------------------------------
@@ -963,14 +928,14 @@
.
.
.P
-.ds @1 \[rs]f[I]\[rs]$0\[rs]f[]\"
+.ds @1 \ef[I]\e$0\ef[]\"
.ds @2 arguments:\"
.EX
\&.eo
\&.ds midpart was called with
\&.de print_args
-\&.\ \ tm\ address@hidden \[rs]*[midpart]\ \[rs]n[.$]\ address@hidden
-\&.\ \ tm\ \[rs]$*
+\&.\ \ tm\ address@hidden \e*[midpart]\ \en[.$]\ address@hidden
+\&.\ \ tm\ \e$*
\&..
\&.ec
.EE
@@ -1005,9 +970,9 @@
.IP
.EX
\&.de Text
-\&.\ \ if (\[rs]\[rs]n[.$] == 0)\ \[rs]
+\&.\ \ if (\e\en[.$] == 0)\ \e
\&.\ \ \ \ return
-\&.\ \ nop\ \[rs])\[rs]\[rs]$*[rs]\)
+\&.\ \ nop\ \e)\e\e$*[rs]\)
\&..
.EE
.RE
@@ -1240,8 +1205,6 @@
FHS web site
.UE
.
-.cp \n[groff_tmac_C]
-.
.\" Local Variables:
.\" mode: nroff
.\" End:
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man,
Eric S. Raymond <=
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/04
- [Groff-commit] groff/man groff_tmac.man, Eric S. Raymond, 2007/02/06
- [Groff-commit] groff/man groff_tmac.man, Werner LEMBERG, 2007/02/08