[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff-commit] groff ChangeLog NEWS src/preproc/tbl/tbl.man
From: |
Werner LEMBERG |
Subject: |
[Groff-commit] groff ChangeLog NEWS src/preproc/tbl/tbl.man |
Date: |
Fri, 05 Jan 2007 13:47:13 +0000 |
CVSROOT: /cvsroot/groff
Module name: groff
Changes by: Werner LEMBERG <wl> 07/01/05 13:47:13
Modified files:
. : ChangeLog NEWS
src/preproc/tbl: tbl.man
Log message:
* src/preproc/tbl/tbl.man, NEWS: Document \n[TW].
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1017&r2=1.1018
http://cvs.savannah.gnu.org/viewcvs/groff/NEWS?cvsroot=groff&r1=1.231&r2=1.232
http://cvs.savannah.gnu.org/viewcvs/groff/src/preproc/tbl/tbl.man?cvsroot=groff&r1=1.16&r2=1.17
Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1017
retrieving revision 1.1018
diff -u -b -r1.1017 -r1.1018
--- ChangeLog 5 Jan 2007 06:51:10 -0000 1.1017
+++ ChangeLog 5 Jan 2007 13:47:13 -0000 1.1018
@@ -1,3 +1,7 @@
+2006-01-05 Werner LEMBERG <address@hidden>
+
+ * src/preproc/tbl/tbl.man, NEWS: Document \n[TW].
+
2006-01-04 Gaius Mulley <address@hidden>
Make -me macros ready for grohtml.
Index: NEWS
===================================================================
RCS file: /cvsroot/groff/groff/NEWS,v
retrieving revision 1.231
retrieving revision 1.232
diff -u -b -r1.231 -r1.232
--- NEWS 31 Dec 2006 17:34:32 -0000 1.231
+++ NEWS 5 Jan 2007 13:47:13 -0000 1.232
@@ -72,7 +72,6 @@
For backwards compatibility, the old set of font definition files is still
available; for details please read the man page of `grops(1)'.
-
Pic
---
@@ -83,6 +82,12 @@
o Pic now supports up to 32 macro arguments (and up to 16 on EBCDIC
platforms).
+Tbl
+---
+
+o The number register `TW' holds the width of the last table. This GNU
+ extension isn't new but hasn't been documented before.
+
Chem
----
Index: src/preproc/tbl/tbl.man
===================================================================
RCS file: /cvsroot/groff/groff/src/preproc/tbl/tbl.man,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -b -r1.16 -r1.17
--- src/preproc/tbl/tbl.man 16 Jun 2006 06:32:18 -0000 1.16
+++ src/preproc/tbl/tbl.man 5 Jan 2007 13:47:13 -0000 1.17
@@ -1,5 +1,5 @@
.ig
-Copyright (C) 1989-1995, 2001, 2002, 2003, 2004, 2006
+Copyright (C) 1989-1995, 2001, 2002, 2003, 2004, 2006, 2007
Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
@@ -17,7 +17,11 @@
translations approved by the Free Software Foundation instead of in
the original English.
..
+.
+.
.TH @address@hidden @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
+.
+.
.SH NAME
@address@hidden \- format tables for troff
.
@@ -70,6 +74,7 @@
.B .TE
even when followed by a character other than space or newline.
Leader characters (\[rs]a) are handled as interpreted.
+.
.TP
.B \-v
Print the version number.
@@ -163,6 +168,7 @@
.LP
The global options must end with a semicolon.
There might be whitespace after an option and its argument in parentheses.
+.
.LP
After global options come lines describing the format of each line of
the table.
@@ -172,15 +178,18 @@
A single key character describes each column of each line of the table.
You may run format specs for multiple lines together on the same line by
separating them with commas.
+.
.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.
+.
.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 `L'.
Extra columns in the data (which have no corresponding format entry) are
ignored.
+.
.LP
The available key characters are:
.
@@ -231,6 +240,7 @@
.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.
+.
.LP
Here are the specifiers that can appear in suffixes to column key letters:
.
@@ -334,6 +344,7 @@
.B expand
option is on).
Default separation is 3n.
+.
.LP
The format lines are followed by lines containing the actual data for the
table, followed finally by
@@ -343,26 +354,31 @@
.B tab
option).
Long input lines can be broken across multiple lines if the last character
-on the line is `\e' (which vanishes after concatenation).
+on the line is `\[rs]' (which vanishes after concatenation).
+.
.LP
A dot starting a line, followed by anything but a digit is handled as a
troff command, passed through without changes.
The table position is unchanged in this case.
+.
.LP
If a data line consists of only `_' or `=', 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 `_' or `=', then that item is replaced by a
single or double line, joining its neighbours.
-If a data item consists only of `\e_' or `\e=', a single or double line,
+If a data item consists only of `\[rs]_' or `\[rs]=', a single or double line,
respectively, is drawn across the field at that point which does not join
its neighbours.
+.
.LP
-A data item consisting only of `\eRx' (`x' any character) is replaced by
+A data item consisting only of `\[rs]Rx' (`x' any character) is replaced by
repetitions of character `x' as wide as the column (not joining its
neighbours).
+.
.LP
-A data item consisting only of `\e^' indicates that the field immediately
+A data item consisting only of `\[rs]^' indicates that the field immediately
above spans downward over this row.
+.
.LP
A text block can be used to enter data as a single entry which would be
too long as a simple string between tabs.
@@ -385,6 +401,7 @@
The default length of a text block is given by L\[tmu]C/(N+1),
where `L' is the current line length, `C' the number of columns spanned
by the text block, and `N' the total number of columns in the table.
+.
.LP
To change the data format within a table, use the
.B .T&
@@ -411,10 +428,13 @@
Table continuation
.RB ( .T& )
lines are not restricted to the first 200 lines.
+.
.LP
Numeric and alphabetic items may appear in the same column.
+.
.LP
Numeric and alphabetic items may span horizontally.
+.
.LP
.B @address@hidden
uses register, string, macro and diversion names beginning with the digit\~\c
@@ -424,6 +444,11 @@
you should avoid using any names beginning with a\~\c
.BR 3 .
.
+.LP
+The number register
+.B \[rs]n[TW]
+holds the table width of the previous table.
+.
.
.SH "GNU TBL WITHIN MACROS"
Since
@@ -455,6 +480,7 @@
.B .ATABLE Another table
.br
.B .ATABLE And \[dq]another one\[dq]
+.
.LP
Note, however, that not all features of
.B @address@hidden
@@ -482,8 +508,10 @@
line immediately after the format section.
Do not enclose a multi-page table within keep/release macros,
or divert it in any other way.
+.
.LP
A text block within a table must be able to fit on one page.
+.
.LP
The
.B bp
@@ -494,21 +522,23 @@
.IP
.B .de BP
.br
-.B .ie '\e\en(.z'' .bp \e\e$1
+.B .ie '\[rs]\[rs]n(.z'' .bp \[rs]\[rs]$1
.br
-.B .el \e!.BP \e\e$1
+.B .el \[rs]!.BP \[rs]\[rs]$1
.br
.B ..
.br
+.
.LP
and use
.B BP
instead of
.BR bp .
+.
.LP
-Using \ea directly in a table to get leaders will not work (except in
+Using \[rs]a directly in a table to get leaders will not work (except in
compatibility mode).
-This is correct behaviour: \ea is an
+This is correct behaviour: \[rs]a is an
.B uninterpreted
leader.
To get leaders use a real leader, either by using a control A or like
@@ -516,11 +546,11 @@
.IP
.nf
.ft B
-\&.ds a \ea
+\&.ds a \[rs]a
\&.TS
tab(;);
lw(1i) l.
-A\e*a;B
+A\[rs]*a;B
\&.TE
.ft
.fi
- [Groff-commit] groff ChangeLog NEWS src/preproc/tbl/tbl.man,
Werner LEMBERG <=