[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff-commit] groff ChangeLog contrib/pdfmark/pdfroff.man man...
|
From: |
Werner LEMBERG |
|
Subject: |
[Groff-commit] groff ChangeLog contrib/pdfmark/pdfroff.man man... |
|
Date: |
Tue, 30 Jan 2007 23:05:02 +0000 |
CVSROOT: /cvsroot/groff
Module name: groff
Changes by: Werner LEMBERG <wl> 07/01/30 23:05:02
Modified files:
. : ChangeLog
contrib/pdfmark: pdfroff.man
man : ditroff.man groff_diff.man roff.man
tmac : an-ext.tmac
Log message:
* tmac/an-ext.tmac (\n[EX]): Rename to \n[mX].
(\n[mH]): New register (set if grohtml is used).
(\n[SY]): Rename to \n[mS].
(\n[a]): Rename to \n[mA].
(\n[i]): Rename to \n[mI].
(mU): New auxiliary input trap macro.
(UR, UE): Replace stub with real definition.
(URL): Remove.
(MT, ME): New macros.
(MTO): Remove.
(EX, EE): Don't insert vertical space.
Use a register to store (and restore) the current font.
* man/ditroff.man, man/groff_diff.man, man/roff.man: Revised, based
on patches from Eric Raymond.
Fix URL addresses.
* contrib/pdfmark/pdfroff.man: Updated.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1025&r2=1.1026
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/pdfmark/pdfroff.man?cvsroot=groff&r1=1.8&r2=1.9
http://cvs.savannah.gnu.org/viewcvs/groff/man/ditroff.man?cvsroot=groff&r1=1.5&r2=1.6
http://cvs.savannah.gnu.org/viewcvs/groff/man/groff_diff.man?cvsroot=groff&r1=1.60&r2=1.61
http://cvs.savannah.gnu.org/viewcvs/groff/man/roff.man?cvsroot=groff&r1=1.34&r2=1.35
http://cvs.savannah.gnu.org/viewcvs/groff/tmac/an-ext.tmac?cvsroot=groff&r1=1.3&r2=1.4
Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1025
retrieving revision 1.1026
diff -u -b -r1.1025 -r1.1026
--- ChangeLog 25 Jan 2007 12:10:51 -0000 1.1025
+++ ChangeLog 30 Jan 2007 23:05:02 -0000 1.1026
@@ -1,3 +1,23 @@
+2007-01-30 Werner LEMBERG <address@hidden>
+
+ * tmac/an-ext.tmac (\n[EX]): Rename to \n[mX].
+ (\n[mH]): New register (set if grohtml is used).
+ (\n[SY]): Rename to \n[mS].
+ (\n[a]): Rename to \n[mA].
+ (\n[i]): Rename to \n[mI].
+ (mU): New auxiliary input trap macro.
+ (UR, UE): Replace stub with real definition.
+ (URL): Remove.
+ (MT, ME): New macros.
+ (MTO): Remove.
+ (EX, EE): Don't insert vertical space.
+ Use a register to store (and restore) the current font.
+
+ * man/ditroff.man, man/groff_diff.man, man/roff.man: Revised, based
+ on patches from Eric Raymond.
+ Fix URL addresses.
+ * contrib/pdfmark/pdfroff.man: Updated.
+
2007-01-22 Gaius Mulley <address@hidden>
* tmac/an-old.tmac (an-trap, HP): Make `HP' work as expected.
Index: contrib/pdfmark/pdfroff.man
===================================================================
RCS file: /cvsroot/groff/groff/contrib/pdfmark/pdfroff.man,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- contrib/pdfmark/pdfroff.man 22 Jan 2007 05:43:35 -0000 1.8
+++ contrib/pdfmark/pdfroff.man 30 Jan 2007 23:05:02 -0000 1.9
@@ -8,7 +8,7 @@
File position: <groff-source>/contrib/pdfmark/pdfroff.man
Last update:
-16 Jan 2007. Converted to use .SY/.OP/.YS
+30 Jan 2007.
This file is part of groff, the GNU roff type-setting system.
@@ -797,8 +797,10 @@
and is part of the
.I GNU troff
software package.
-It was originally written by Keith Marshall,
-.NH <address@hidden>,
+It was originally written by
+.MT address@hidden:ntlworld.com ,
+Keith Marshall
+.ME
who also wrote the implementation of the
.I pdfroff
program, to which it relates.
@@ -807,7 +809,9 @@
You should have received a copy of the FDL as part of the
.I GNU troff
distribution; it is also available on\-line, at
-.URL http://www.gnu.org/copyleft/fdl.html "The GNU copyleft site" .
+.UR http://\:www.gnu.org/\:copyleft/\:fdl.html .
+the GNU copyleft site
+.UE
.
.\" --------------------------------------------------------------------
.\" EOF / vim: ft=groff
Index: man/ditroff.man
===================================================================
RCS file: /cvsroot/groff/groff/man/ditroff.man,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- man/ditroff.man 3 Jul 2004 12:46:58 -0000 1.5
+++ man/ditroff.man 30 Jan 2007 23:05:02 -0000 1.6
@@ -1,11 +1,12 @@
.ig
ditroff.man
-Last update: 2 Jul 2004
+Last update:
+30 Jan 2007 -- converted to use .SY/.OP./.YS.
This file is part of groff, the GNU roff type-setting system.
-Copyright (C) 2001, 2002, 2004 Free Software Foundation, Inc.
+Copyright (C) 2001, 2002, 2004, 2007 Free Software Foundation, Inc.
written by Bernd Warken <address@hidden>
maintained by Werner Lemberg <address@hidden>
@@ -19,28 +20,14 @@
FDL in the main directory of the groff source package.
..
.
-.\" --------------------------------------------------------------------
-.\" Setup
-.\" --------------------------------------------------------------------
-.
-.mso www.tmac
-.
-.if n \{\
-. mso tty-char.tmac
-. ftr CR R
-. ftr CI I
-. ftr CB B
-.\}
-.
-.if '\*[.T]'dvi' \
-. ftr CB CW
-.
.
.\" --------------------------------------------------------------------
.\" Title
.\" --------------------------------------------------------------------
.
.TH DITROFF @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
+.
+.
.SH NAME
ditroff \- classical device independent roff
.
@@ -86,7 +73,7 @@
it was called
.I ditroff
(\c
-.IR d\/ evice\~ i\/ ndependent\~ troff\/\c
+.IR d\/ "evice " i\/ "ndependent " troff\/\c
)
on some systems, though this naming isn't mentioned in the classical
documentation.
@@ -128,13 +115,13 @@
The 1992 revision of the
.I Nroff/Troff User's Manual
by
-.I J. F. Osanna
+.I J.\& F.\& Osanna
and
.IR "Brian Kernighan" ,
see
-.br
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz \
- "Bell Labs CSTR\~#54" .
+.UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz .
+Bell Labs CSTR\~#54
+.UE
.
.TP
.I [CSTR\~#97]
@@ -144,9 +131,9 @@
is the original documentation of the first multi-device troff
.RI ( ditroff\/ ),
see
-.br
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz \
- "Bell Labs CSTR\~#97" .
+.UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz .
+Bell Labs CSTR\~#97
+.UE
.
.TP
.BR roff (@MAN7EXT@)
@@ -171,7 +158,7 @@
.SH "AUTHORS"
.\" --------------------------------------------------------------------
.
-Copyright (C) 2001, 2002, 2004 Free Software Foundation, Inc.
+Copyright (C) 2001, 2002, 2004, 2007 Free Software Foundation, Inc.
.
.P
This document is distributed under the terms of the FDL (GNU Free
@@ -179,7 +166,9 @@
.
You should have received a copy of the FDL on your system, it is also
available on-line at the
-.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
+.UR http://\:www.gnu.org/\:copyleft/\:fdl.html .
+GNU copyleft site
+.UE
.
.P
This document is part of
@@ -187,9 +176,13 @@
the GNU roff distribution.
.
It was written by
-.MTO address@hidden "Bernd Warken"
+.MT address@hidden:mayn.de
+Bernd Warken
+.ME
and is maintained by
-.MTO address@hidden "Werner Lemberg" .
+.MT address@hidden:gnu.org .
+Werner Lemberg
+.ME
.
.
.\" --------------------------------------------------------------------
Index: man/groff_diff.man
===================================================================
RCS file: /cvsroot/groff/groff/man/groff_diff.man,v
retrieving revision 1.60
retrieving revision 1.61
diff -u -b -r1.60 -r1.61
--- man/groff_diff.man 26 Oct 2006 19:39:07 -0000 1.60
+++ man/groff_diff.man 30 Jan 2007 23:05:02 -0000 1.61
@@ -3,12 +3,13 @@
.ig
groff_diff.man
-Last update : 26 Oct 2006
+Last update:
+24 Jan 2007 -- macro simplification by ESR.
This file is part of groff, the GNU roff type-setting system.
It is the source of the man-page groff_diff(7).
-Copyright (C) 1989, 2001, 2002, 2003, 2004, 2006
+Copyright (C) 1989, 2001, 2002, 2003, 2004, 2006, 2007
Free Software Foundation, Inc.
written by James Clark
@@ -25,25 +26,11 @@
FDL in the main directory of the groff source package.
..
.
+.
.\" --------------------------------------------------------------------
-.\" Setup
+.\" Local definitions
.\" --------------------------------------------------------------------
.
-.do nr groff_diff_C \n[.C]
-.cp 0
-.
-.mso www.tmac
-.
-.if n \{\
-. mso tty-char.tmac
-. ftr CR R
-. ftr CI I
-. ftr CB B
-.\}
-.
-.if '\*[.T]'dvi' \
-. ftr CB CW
-.
.\" define a string tx for the TeX logo
.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
.el .ds tx TeX
@@ -52,56 +39,46 @@
.\" --------------------------------------------------------------------
.\" start of macro definitions
.
-.eo
-.
-.de c
-..
-.
-.de TQ
-. br
-. ns
-. TP \$1
-..
.de Text
-. RI "\$*"
+. RI "\\$*"
..
+.
+.
.de Topic
. TP 2m
. Text \[bu]
+. RI "\\$*"
..
+.
+.
.de squoted
-. ds @arg1 \$1
-. shift
-.\" Text address@hidden
-. Text address@hidden
+. ds @arg1 \\$1
+. shift 1
+. Text address@hidden
. rm @arg1
..
-.c A shell command line
-.de ShellCommand
-. br
-. IR "shell#" "\h'1m'\f[CB]\$*\f[]\/"
-..
-.c reference of a request or macro
+.
+.
+.\" reference of a request or macro
.de request
-. ds @arg1 \$1
+. ds @arg1 \\$1
. shift 1
-.\" Text address@hidden
-. Text address@hidden
+. Text address@hidden
. rm @arg1
..
.als option request
.
-.c representation of an escape sequence
+.
+.\" representation of an escape sequence
.de esc
-. ds @arg1 \$1
-. shift
-.\" Text address@hidden
-. Text address@hidden&\f[]\$*
+. ds @arg1 \\$1
+. shift 1
+. Text address@hidden
. rm @arg1
..
-.ec
.\" end of macro definitions
.
+.
.\" from old groff_out.man
.ie \n(.g \
. ds ic \/
@@ -413,13 +390,13 @@
.
.RS
.IP
-.ft CB
-.Text .ds { \[rs]v'\-.3m'\[rs]s'\[rs]En[.s]*6u/10u'
-.br
-.Text .ds } \[rs]s0\[rs]v'.3m'
-.ft
+.EX
+\&.ds { \[rs]v'\-.3m'\[rs]s'\[rs]En[.s]*6u/10u'
+\&.ds } \[rs]s0\[rs]v'.3m'
+.EE
+.RE
.
-.P
+.IP
The use of
.B \[rs]E
ensures that these definitions work even if
@@ -1166,7 +1143,7 @@
to glyph name
.I glyph2
if it is used in
-.BI \[rs][ ... ]
+.BI \[rs][ .\|.\|. ]
with more than one component.
.
.TP
@@ -1822,7 +1799,7 @@
.IP
Line-tabs mode is associated with the current environment; the
read-only number register
-.B \\[rs]n[.linetabs]
+.B \[rs]n[.linetabs]
is set to\~1 if in line-tabs mode, and 0 otherwise.
.
.TP
@@ -3840,7 +3817,7 @@
.SH AUTHORS
.\" --------------------------------------------------------------------
.
-Copyright (C) 1989, 2001, 2002, 2003, 2004, 2006
+Copyright (C) 1989, 2001, 2002, 2003, 2004, 2006, 2007
Free Software Foundation, Inc.
.
.P
@@ -3849,12 +3826,18 @@
.
You should have received a copy of the FDL on your system, it is also
available on-line at the
-.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
+.UR http://\:www.gnu.org/\:copyleft/\:fdl.html .
+GNU copyleft site
+.UE
.
This document was written by James Clark, with modifications by
-.MTO address@hidden "Werner Lemberg"
-and
-.MTO address@hidden "Bernd Warken" .
+.MT address@hidden
+Werner Lemberg
+.ME
+and
+.MT address@hidden .
+Bernd Warken
+.ME
.
.P
This document is part of
@@ -3898,8 +3881,12 @@
.IR groff .
From the command line, this is called using
.
+.RS
.IP
-.ShellCommand man\~7\~groff
+.EX
+man 7 groff
+.EE
+.RE
.
.TP
.BR roff (@MAN7EXT@)
@@ -3916,10 +3903,9 @@
of 1976 in the revision of
.I Brian Kernighan
of 1992, being the
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz \
- "classical troff documentation" .
-.
-.cp \n[groff_diff_C]
+.UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz .
+classical troff documentation
+.UE
.
.\" --------------------------------------------------------------------
.\" Emacs variables
Index: man/roff.man
===================================================================
RCS file: /cvsroot/groff/groff/man/roff.man,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -b -r1.34 -r1.35
--- man/roff.man 19 Nov 2006 09:56:49 -0000 1.34
+++ man/roff.man 30 Jan 2007 23:05:02 -0000 1.35
@@ -1,11 +1,12 @@
+.\" t
.ig
roff.man
-Last update: 18 Nov 2006
+Last update: 30 Jan 2007
This file is part of groff, the GNU roff type-setting system.
-Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006
+Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006, 2007
Free Software Foundation, Inc.
written by Bernd Warken <address@hidden>
maintained by Werner Lemberg <address@hidden>
@@ -20,130 +21,25 @@
FDL in the main directory of the groff source package.
..
.
-.\" --------------------------------------------------------------------
-.\" Setup
-.\" --------------------------------------------------------------------
-.
-.do nr roff_C \n[.C]
-.cp 0
-.
-.mso www.tmac
-.
-.if n \{\
-. mso tty-char.tmac
-. ftr CR R
-. ftr CI I
-. ftr CB B
-.\}
-.
-.if '\*[.T]'dvi' \{\
-. ftr CB CW
-.\}
-.
.
.\" --------------------------------------------------------------------
-.\" String definitions
-.
-.\" Final `\""' comments are used to make Emacs happy, sic \""
-.
-.\" The `-' sign for options.
-.ie t \{\
-. ds @- \-\"
-. ds @-- \-\-\"
-.\}
-.el \{\
-. ds @- -\"
-. ds @-- --\"
-.\}
-.
-.ds Comment \.\[rs]\[dq]\"
-.ds Ellipsis \.\|.\|.\&\"
-.
-.
-.\" --------------------------------------------------------------------
-.\" Begin of macro definitions
-.
-.de c
-.\" this is like a comment request when escape mechanism is off
-..
-.
-.eo
-.
-.c ---------------------------------------------------------------------
-.
-.de Text
-. nop \)\$*
-..
-.
-.de CodeSkip
-. ie t \
-. sp 0.2v
-. el \
-. sp
-..
+.\" Local macros
.
.de Esc
-. ds @1 \$1\"
-. shift
-. Text address@hidden
-. rm @1
-..
-.
-.de QuotedChar
-. ds @1 \$1
+. ds @1 \\$1
. shift
-. nop address@hidden'\$*
+. nop address@hidden
. rm @1
..
.
-.c --------------------------------------------------------------------
.
-.c a shell command line
-.de ShellCommand
-. br
-. ad l
-. nh
-. Text \f[I]sh#\h'1m'\f[]\f[CR]\$*\f[]\&\"
-. ft R
-. ft P
-. hy
-. ad
-..
-.
-.c --------------------------------------------------------------------
-.
-.c ShortOpt ([c [punct]])
-.c
-.c `-c' somewhere in the text.
-.c The second argument is some trailing punctuation.
-.c
-.de ShortOpt
-. ds @1 \$1\"
+.de QuotedChar
+. ds @1 \\$1
. shift
-. nh
-. Text address@hidden@1]\f[]\/\$*
-. hy
+. nop address@hidden'\\$*
. rm @1
..
.
-.de TP+
-. br
-. ns
-. TP \$1
-..
-.
-.c --------------------------------------------------------------------
-.
-.c Topic
-.c
-.de Topic
-. TP 2m
-. Text \[bu]
-..
-.
-.ec
-.\" End of macro definitions
-.
.
.\" --------------------------------------------------------------------
.\" Title
@@ -291,7 +187,9 @@
as early as 1964 \[en] note that CTSS commands were all uppercase.
.
When CTSS was further developed into the operating system
-.URL http://\:www.multicians.org "Multics" ,
+.UR http://\:www.multicians.org ,
+Multics
+.UE
the famous predecessor of Unix from 1963,
.I runoff
has been improved further by people from the Massachusetts Institute of
@@ -484,7 +382,7 @@
All of the different commercial
.I roff
systems made heavy use of Osanna/\:Kernighan's open source code and
-documentation, but sold them as \[lq]their\[rq] system \[em] with only
+documentation, but sold them as \[lq]their\[rq] system \[en] with only
minor additions.
.
.P
@@ -508,7 +406,9 @@
project was the \f[CR]GNU\f[] implementation of
.IR troff ,
written from scratch by James Clark and put under the
-.URL http://\:www.gnu.org/\:copyleft "GNU Public License" .
+.UR http://\:www.gnu.org/\:copyleft .
+GNU Public License
+.UE
.
It was called
.I groff
@@ -529,7 +429,7 @@
.
It is the first
.I roff
-system that is available on almost all operating systems \[em] and it
+system that is available on almost all operating systems \[en] and it
is free.
.
This makes
@@ -540,7 +440,9 @@
.
.P
An alternative is Gunnar Ritter's
-.URL http://\:heirloom.sf.net "Heirloom Documentation Tools"
+.UR http://\:heirloom.sf.net
+Heirloom Documentation Tools
+.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.
@@ -609,23 +511,22 @@
where the output of each program in the queue is taken as the input
for the next program.
.
-.CodeSkip
-.
-.ds @1 "cat \f[I]file\f[P] |\""
-.ds @2 "\*[Ellipsis] | \f[I]preproc\f[P] | \*[Ellipsis] |\""
-.ds @3 "troff \f[I]options\f[P] | \f[I]postproc\f[P]\""
-.
-.ShellCommand "address@hidden address@hidden address@hidden"
+.RS
+.P
+cat \f[I]file\f[P] \
+| .\|.\|. \
+| \f[I]preproc\f[P] \
+| .\|.\|. \
+| troff \f[I]options\f[P] \
+| \f[I]postproc\f[P]
+.RE
.
-.rm @1
-.rm @2
-.rm @3
.P
The preprocessors generate
.I roff
code that is fed into a
.I roff
-formatter (e.g.
+formatter (e.g.\&
.BR troff ),
which in turn generates
.I intermediate output
@@ -699,55 +600,32 @@
.
The classical preprocessors are
.
-
-.de @TP
-.\" local indent for .TP
-.TP \\w'\\f[B]soelim\\f[P]'u+2n
-..
-.P
.RS
-.PD 0
address@hidden
-.B tbl
-for tables.
address@hidden
-.B eqn
-for mathematical formul\[ae].
address@hidden
-.B pic
-for drawing diagrams.
address@hidden
-.B refer
-for bibliographic references.
address@hidden
-.B soelim
-for including macro files from standard locations.
address@hidden
-.B chem
-for drawing chemical formul\[ae].
-.PD
+.TS
+tab (@);
+lb l.
address@hidden tables.
address@hidden mathematical formul\[ae].
address@hidden drawing diagrams.
address@hidden bibliographic references.
address@hidden including macro files from standard locations.
address@hidden drawing chemical formul\[ae].
+.TE
.RE
.
.P
Other known preprocessors that are not available on all systems
include
.
-.P
.RS
-.PD 0
address@hidden
-.B grap
-for constructing graphical elements.
address@hidden
-.B grn
-for including
-.BR gremlin (1)
-pictures.
-.PD
+.TS
+tab (@);
+lb l.
address@hidden constructing graphical elements.
address@hidden including \fBgremlin\fR(1) pictures.
+.TE
.RE
.
-.rm @TP
-.
.\" --------------------------------------------------------------------
.SS "Formatter Programs"
.\" --------------------------------------------------------------------
@@ -917,7 +795,7 @@
.P
A macro package that is to be used in a document can be announced to
the formatter by the command line option
-.ShortOpt m ,
+.BR \-m ,
see
.BR troff (@MAN1EXT@),
or it can be specified within a document using the file inclusion
@@ -1029,7 +907,7 @@
of the man pages.
.
.P
-The classical macro packages take the package name as an extension, e.g.
+The classical macro packages take the package name as an extension, e.g.\&
.IB file. me
for a document using the
.I me
@@ -1069,10 +947,14 @@
.BR LESSOPEN .
This process is not well documented, so here an example:
.
-.CodeSkip
-.ShellCommand LESSOPEN='|lesspipe %s'
-.CodeSkip
+.RS
+.P
+.EX
+LESSOPEN='|lesspipe %s'
+.EE
+.RE
.
+.P
where
.B lesspipe
is either a system supplied command or a shell script of your own.
@@ -1111,28 +993,36 @@
But it is also possible to have the mode automatically selected when
the file is loaded into the editor.
.
-.Topic
+.IP \(bu
The most general method is to include the following 3 comment lines at
the end of the file.
.
-.CodeSkip
-.nf
-.B \*[Comment] Local Variables:
-.B \*[Comment] mode: nroff
-.B \*[Comment] End:
-.fi
+.RS
+.IP
+.EX
+\&.\[rs]" Local Variables:
+\&.\[rs]" mode: nroff
+\&.\[rs]" End:
+.EE
+.RE
.
-.Topic
-There is a set of file name extensions, e.g. the man pages that
+.IP \(bu
+There is a set of file name extensions, e.g.\& the man pages that
trigger the automatic activation of the
.I nroff
mode.
.
-.Topic
+.IP \(bu
Theoretically, it is possible to write the sequence
-.CodeSkip
-.B \*[Comment] \%-*-\ nroff\ -*-
-.CodeSkip
+.
+.RS
+.IP
+.EX
+\&.\[rs]" \%-*-\ nroff\ -*-
+.EE
+.RE
+.
+.IP
as the first line of a file to have it started in
.I nroff
mode when loaded.
@@ -1149,17 +1039,17 @@
.
In order to not disturb this, the following tips can be helpful.
.
-.Topic
+.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 \*[Comment]
+.B .\e"
if a structuring element is needed.
.
-.Topic
+.IP \(bu
Never start a line with whitespace because this can lead to
unexpected behavior.
.
@@ -1167,14 +1057,14 @@
.I roff
requests.
.
-.Topic
+.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.
.
To distinguish both cases, do a line break after each sentence.
.
-.Topic
+.IP \(bu
To additionally use the auto-fill mode in Emacs, it is best to insert
an empty
.I roff
@@ -1185,22 +1075,24 @@
.I roff
editing could look.
.
-.IP
-.nf
+.RS
+.P
+.EX
This is an example for a
-.I roff
+\&.I roff
document.
-.Text .
+\&.
This is the next sentence in the same paragraph.
-.Text .
+\&.
This is a longer sentence stretching over several
lines; abbreviations like `cf.' are easily
identified because the dot is not followed by a
line break.
-.Text .
+\&.
In the output, this will still go to the same
paragraph.
-.fi
+.EE
+.RE
.
.P
Besides Emacs, some other editors provide
@@ -1243,13 +1135,17 @@
.
.TP
troff.org
-.URL http://\:www.troff.org "The historical troff site"
+.UR http://\:www.troff.org
+The historical troff site
+.UE
provides an overview and pointers to all historical aspects of
.IR roff .
.
.TP
Multics
-.URL http://\:www.multicians.org "The Multics site"
+.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 ;
@@ -1258,42 +1154,49 @@
.
.TP
Unix Archive
-.URL http://\:www.tuhs.org/\:Archive/ \
- "The Ancient Unixes Archive"
+.UR http://\:www.tuhs.org/\:Archive/
+The Ancient Unixes Archive
+.UE
.
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
-.URL http://\:www.tuhs.org/\:Archive/\:PDP-11/\:Trees/\:V7 \
- "Unix V7 site" .
+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
.
.TP
Developers at AT&T Bell Labs
-.URL http://\:cm.bell-labs.com/\:cm/\:index.html \
- "Bell Labs Computing and Mathematical Sciences Research"
+.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.
.
.TP
Plan 9
-.URL http://\:plan9.bell-labs.com "The Plan\~9 operating system"
+.UR http://\:plan9.bell-labs.com
+The Plan\~9 operating system
+.UE
.
by AT&T Bell Labs.
.
.TP
runoff
-.URL http://web.mit.edu/\:Saltzer/\:www/\:publications/\:pubs.html \
-"Jerry Saltzer's home page"
+.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.
.
.TP
CSTR Papers
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr.html \
- "The Bell Labs CSTR site"
+.UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr.html
+The Bell Labs CSTR site
+.UE
.
stores the original
.I troff
@@ -1302,7 +1205,9 @@
.
.TP
\f[CR]GNU\f[] \f[I]roff\f[]
-.URL http://\:www.gnu.org/\:software/\:groff "The groff web site"
+.UR http://\:www.gnu.org/\:software/\:groff
+The groff web site
+.UE
provides the free
.I roff
implementation
@@ -1326,47 +1231,51 @@
.TP
[CSTR\~#54]
J. F. Osanna,
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:54.ps \
- "\fINroff/\:Troff User's Manual\fP" ;
+.UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz ;
+.I "Nroff/\:Troff User's Manual"
+.UE
.
Bell Labs, 1976; revised by Brian Kernighan, 1992.
-
.
.TP
[CSTR\~#97]
Brian Kernighan,
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:97.ps \
- "\fIA Typesetter-independent TROFF\fP" ,
+.UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz ,
+.I "A Typesetter-independent TROFF"
+.UE
.
Bell Labs, 1981, revised March 1982.
.
.P
-The "little language"
+The \[lq]little language\[rq]
.I roff
papers are
.
.TP
[CSTR\~#114]
Jon L. Bentley and Brian W. Kernighan,
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:114.ps \
- "\fIGRAP \(em A Language for Typesetting Graphs\fP" ;
+.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.
.
.TP
[CSTR\~#116]
Brian W. Kernighan,
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:116.ps \
- "\fIPIC -- A Graphics Language for Typesetting\fP" ;
+.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.
.
.TP
[CSTR\~#122]
J. L. Bentley, L. W. Jelinski, and B. W. Kernighan,
-.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:122.ps \
-"\fICHEM \(em A Program for Typesetting Chemical Structure Diagrams, \
-Computers and Chemistry\fP" ;
+.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.
.
@@ -1403,7 +1312,7 @@
.SH AUTHORS
.\" --------------------------------------------------------------------
.
-Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006
+Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006, 2007
Free Software Foundation, Inc.
.
.P
@@ -1412,7 +1321,9 @@
.
You should have received a copy of the \f[CR]FDL\f[] on your system,
it is also available on-line at the
-.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
+.UR http://\:www.gnu.org/\:copyleft/\:fdl.html .
+GNU copyleft site
+.UE
.
.P
This document is part of
@@ -1422,11 +1333,13 @@
distribution.
.
It was written by
-.MTO address@hidden "Bernd Warken" ;
+.MT address@hidden ;
+Bernd Warken
+.ME
it is maintained by
-.MTO address@hidden "Werner Lemberg".
-.
-.cp \n[roff_C]
+.MT address@hidden .
+Werner Lemberg
+.ME
.
.\" --------------------------------------------------------------------
.\" Emacs setup
Index: tmac/an-ext.tmac
===================================================================
RCS file: /cvsroot/groff/groff/tmac/an-ext.tmac,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- tmac/an-ext.tmac 22 Jan 2007 07:52:19 -0000 1.3
+++ tmac/an-ext.tmac 30 Jan 2007 23:05:02 -0000 1.4
@@ -3,9 +3,10 @@
.\" Written by Eric S. Raymond <address@hidden>
.\" Werner Lemberg <address@hidden>
.\"
-.\" Version 2006-Jan-22
+.\" Version 2007-Jan-26
.\"
-.\" This file is explicitly placed into the public domain.
+.\" Copyright (C) 2007 Free Software Foundation, Inc.
+.\" You may freely use, modify and/or distribute this file.
.\"
.\"
.\" The code below provides extension macros for the `man' macro package.
@@ -17,13 +18,23 @@
.\" used macros directly to the prologue of the man page(s).
.
.
+.\" Convention: Auxiliary macros and registers start with `m' followed
+.\" by an uppercase letter or digit.
+.
+.
.\" Protect against being sourced twice.
-.nr EX +1
-.if \n(EX>1 \
+.nr mX +1
+.if \n(mX>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
+.
+.\" Map mono-width fonts to standard fonts for groff's TTY device.
.if n \{\
. do ftr CR R
. do ftr CI I
@@ -38,20 +49,21 @@
.el \{\
. ds la <\"
. ds ra >\"
+. \" groff's man macros control hyphenation with this register.
. nr HY 1
.\}
.
-.nr SY 0
+.nr mS 0
.
.
.\" Declare start of command synopsis. Sets up hanging indentation.
.de SY
-. ie !\\n(SY \{\
+. ie !\\n(mS \{\
. nh
-. nr SY 1
-. nr a \\n(.j
+. nr mS 1
+. nr mA \\n(.j
. ad l
-. nr i \\n(.i
+. nr mI \\n(.i
. \}
. el \{\
. br
@@ -65,10 +77,10 @@
.
.\" End of command synopsis. Restores adjustment.
.de YS
-. in \\niu
-. ad \\na
+. in \\n(mIu
+. ad \\n(mA
. hy \\n(HY
-. nr SY 0
+. nr mS 0
..
.
.
@@ -81,26 +93,82 @@
..
.
.
-.\" Universal resource locator.
-.\" XXX to be modified
-.de URL
+.\" Start URL.
+.de UR
+. ds m1 \\$1\"
+. ds m2 \\$2\"
. nh
-. ie \\n(.$-1 \
-\\$2 \\*(laURL:\\$1\\*(ra\"
+. if \\n(mH \{\
+. \" Start diversion in a new environment.
+. do ev URL-div
+. do di URL-div
+. \}
+..
+.
+.
+.\" End URL.
+.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>"
+\&\\*(m2\"
+. \}
. el \
-\\*(la\\$1\\*(ra\"
+\\*(la\\*(m1\\*(ra\\*(m2\"
+.
. hy \\n(HY
..
.
.
-.\" Email address.
-.\" XXX to be modified
-.de MTO
+.\" Start email address.
+.de MT
+. ds m1 \\$1\"
+. ds m2 \\$2\"
. nh
-. ie \\n(.$-1 \
-\\$2 \\*(la\\$1\\*(ra\"
+. if \\n(mH \{\
+. \" Start diversion in a new environment.
+. do ev URL-div
+. do di URL-div
+. \}
+..
+.
+.
+.\" End email address.
+.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 \
-\\*(la\\$1\\*(ra\"
+. do HTML-NS "<a href=""mailto:\:\\*(m1"">\\*(m1</a>"
+\&\\*(m2\"
+. \}
+. el \
+\\*(la\\*(m1\\*(ra\\*(m2\"
+.
. hy \\n(HY
..
.
@@ -115,7 +183,7 @@
.
.\" Start example.
.de EX
-. sp 0.5
+. nr mE \\n(.f
. nf
. nh
. ft CW
@@ -124,10 +192,9 @@
.
.\" End example.
.de EE
-. ft
+. ft \\n(mE
. fi
. hy \\n(HY
-. sp 0.5
..
.
.
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Groff-commit] groff ChangeLog contrib/pdfmark/pdfroff.man man...,
Werner LEMBERG <=