~ubuntu-branches/ubuntu/maverick/texlive-extra/maverick

« back to all changes in this revision

Viewing changes to texmf-dist/doc/plain/cellular/cellular.doc

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2009-05-05 09:18:38 UTC
  • mfrom: (1.1.8 upstream) (3.1.12 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090505091838-n4cyrz5wncwsu0ml
Tags: 2007.dfsg.17-2ubuntu1
* Merge with Debian unstable; remaining Ubuntu changes:
  - Drop texpower Recommends to Suggests. It is in universe, and drags in
    context and xpdf.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
% File:       TeX Inputs cellular.doc
2
 
% Author:     J E Pittman
3
 
% Bitnet:     JEPTeX@TAMVenus
4
 
% Internet:   JEPTeX@Venus.TAMU.EDU
5
 
% Date:       November 8, 1988
6
 
 
7
 
A cellular table is specified by:
8
 
 
9
 
   \begincellular{specifications that change defaults}
10
 
      appropriate macro definitions
11
 
      column header specifications
12
 
      row specifications (header and data)
13
 
      \endcellular
14
 
 
15
 
The following are examples of specifications that change defaults:
16
 
 
17
 
   \pixelwidth=1in
18
 
   \divide\pixelwidth by 300
19
 
 
20
 
   The pixel width dimension register should be set to the resolution 
21
 
   of the device used.  The default is 1/300th of an inch.
22
 
 
23
 
   \setverticaladjustment -or- \sethorizontaladjustment
24
 
 
25
 
   Some printers (such as the Xerox 9700s and 4050s) produce vertical 
26
 
   and horizontal rules that have a different visual thickness for the 
27
 
   same specified thickness.  The macros set vertical and set 
28
 
   horizontal adjustment specified that vertical or horizontal rules 
29
 
   are to be thickened by pixel width, which may correct this problem.   
30
 
 
31
 
   \edef\everycolumn{\everycolumn
32
 
      \leftrulewidth=0.4pt\relax
33
 
      \rightrulewidth=\leftrulewidth
34
 
      \leftborderskip=6pt plus 1fil\relax
35
 
      \rightborderskip=\leftborderskip
36
 
      \columnwidth=\zeropt\relax
37
 
      \columnwidth=\zeropt\relax
38
 
      }%
39
 
 
40
 
   An \edef can be used to add material (usually default overrides) to 
41
 
   the every column macro.  The information shown above reflect the 
42
 
   defaults.  Care must be exercised to avoid introducing spurous 
43
 
   spaces, which will be very visible when output.
44
 
 
45
 
   \edef\everyrow{\everyrow
46
 
      \toprulewidth=0.4pt\relax
47
 
      \bottomrulewidth=\toprulewidth
48
 
      \topborderskip=3pt plus 1fil\relax
49
 
      \bottomborderskip=\topborderskip
50
 
      \rowheight=\zeropt\relax
51
 
      }%
52
 
 
53
 
   Same as every column.
54
 
 
55
 
   \tracingexpansions=1
56
 
 
57
 
   This specification will request notes on how column and rows are 
58
 
   expanded to accommedate spans.
59
 
 
60
 
Any sort of macros can be defined within a cellular table.  An obvious 
61
 
example is abbrevations for commonly used control sequence names.
62
 
 
63
 
A column header is specified as:
64
 
 
65
 
   \column{specifications}
66
 
 
67
 
   The specifications are the same as for every column.  Note:  There 
68
 
   is a considerable amount of processing required for these 
69
 
   specifications, wise selection of defaults can decrease execution 
70
 
   time significantly.
71
 
 
72
 
   Column headers are optional.
73
 
 
74
 
Rows are specified as a row header (similiar to a column header) and a 
75
 
series of entry specifications.
76
 
 
77
 
An entry specification can be any of the following:
78
 
 
79
 
   \blank
80
 
 
81
 
   A blank entry specification creates a completely blank spot in the 
82
 
   table (no rules or text).
83
 
 
84
 
   \mergeright
85
 
   
86
 
   A merge right specification merges the width of the entry into the 
87
 
   width of the entry to the right.  It is used to create column 
88
 
   spans.
89
 
 
90
 
   \mergedown
91
 
   
92
 
   Similar to merge right.  Note:  The overhead for a merge down 
93
 
   specification is considerably higher than a merge right.  
94
 
   Therefore, when specifing an entry that spans both rows and 
95
 
   columns, merge rights should be used as much as possible.  For 
96
 
   example:
97
 
 
98
 
                  > > > V                  V V V V
99
 
                  > > > V      rather      V V V V
100
 
                  > > > V       than       V V V V
101
 
                  > > > *                  > > > *
102
 
 
103
 
   \entry{horizontal mode material}
104
 
 
105
 
   An entry macro takes the specified material and formats it as 
106
 
   appropriate.
107
 
 
108
 
It is not necessary to complete every row.
109
 
 
110
 
Vertical mode material can be added after a row by specifying:
111
 
 
112
 
   \noalign{vertical mode material}
113
 
 
114
 
at any point in the row.  Multiple no aligns are permitted.