[BACK]Return to tbl.7 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/tbl.7 between version 1.29 and 1.38

version 1.29, 2017/10/17 23:19:12 version 1.38, 2022/01/12 04:14:25
Line 1 
Line 1 
 .\"     $Id$  .\" $Id$
 .\"  .\"
 .\" Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>  .\" Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2014, 2015, 2017 Ingo Schwarze <schwarze@openbsd.org>  .\" Copyright (c) 2014,2015,2017,2018,2019 Ingo Schwarze <schwarze@openbsd.org>
 .\"  .\"
 .\" Permission to use, copy, modify, and distribute this software for any  .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above  .\" purpose with or without fee is hereby granted, provided that the above
Line 94  Allow page breaks within the table.
Line 94  Allow page breaks within the table.
 This is a GNU extension and currently ignored.  This is a GNU extension and currently ignored.
 .It Cm nospaces  .It Cm nospaces
 Ignore leading and trailing spaces in data cells.  Ignore leading and trailing spaces in data cells.
 This is a GNU extension and currently ignored.  This is a GNU extension.
 .It Cm nowarn  .It Cm nowarn
 Suppress warnings about tables exceeding the current line length.  Suppress warnings about tables exceeding the current line length.
 This is a GNU extension and currently ignored.  This is a GNU extension and currently ignored.
Line 147  The combined cell as a whole consumes only one cell
Line 147  The combined cell as a whole consumes only one cell
 of the corresponding data line.  of the corresponding data line.
 .It Cm a  .It Cm a
 Left-justify a string and pad with one space.  Left-justify a string and pad with one space.
 .It Cm ^  .It Cm \(ha
 Vertically span rows from the last  Vertically span rows from the last
 .Pf non- Cm ^  .Pf non- Cm \(ha
 layout cell.  layout cell.
 It is an error to invoke a vertical span on the first layout line.  It is an error to invoke a vertical span on the first layout line.
 Unlike a horizontal span, a vertical span consumes a data cell  Unlike a horizontal span, a vertical span consumes a data cell
Line 178  of any other column also having the
Line 178  of any other column also having the
 .Cm e  .Cm e
 modifier.  modifier.
 .It Cm f  .It Cm f
 The next character selects the font to use for this cell.  The next one or two characters select the font to use for this cell.
   One-character font names must be followed by a blank or period.
 See the  See the
 .Xr roff 7  .Xr roff 7
 manual for supported one-character font names.  manual for supported font names.
 .It Cm i  .It Cm i
 Use an italic font for the contents of this cell.  Use an italic font for the contents of this cell.
 .It Cm m  .It Cm m
Line 231  Each data line consists of one or more data cells, del
Line 232  Each data line consists of one or more data cells, del
 .Cm tab  .Cm tab
 characters.  characters.
 .Pp  .Pp
 If a data cells contains only the single character  If a data cell contains only the two bytes
   .Ql \e\(ha ,
   the cell above spans to this row, as if the layout specification
   of this cell were
   .Cm \(ha .
   .Pp
   If a data cell contains only the single character
 .Ql _  .Ql _
 or  or
 .Ql = ,  .Ql = ,
 a single or double horizontal line is drawn across the cell,  a single or double horizontal line is drawn across the cell,
 joining its neighbours.  joining its neighbours.
 If a data cells contains only the two character sequence  If a data cell contains only the two character sequence
 .Ql \e_  .Ql \e_
 or  or
 .Ql \e= ,  .Ql \e= ,
Line 323  _
Line 330  _
 AFL:2.39b  AFL:2.39b
 Mutt:1.8.0  Mutt:1.8.0
 Ruby:1.8.7.374  Ruby:1.8.7.374
 TeX Live:2015  TeX Live:2015
 .TE  .TE
 .Ed  .Ed
 .sp 2v  .sp 2v
Line 332  Spans and skipping width calculations:
Line 339  Spans and skipping width calculations:
 \&.TS  \&.TS
 box tab(:);  box tab(:);
 lz  s | rt  lz  s | rt
 lt| cb| ^  lt| cb| \(ha
 ^ | rz  s.  \(ha | rz  s.
 left:r  left:r
 l:center:  l:center:
 :right  :right
Line 360  allbox tab(:);
Line 367  allbox tab(:);
 le le||7 lw10.  le le||7 lw10.
 The fourth line:_:line 1  The fourth line:_:line 1
 of this column:=:line 2  of this column:=:line 2
 determines:\_:line 3  determines:\e_:line 3
 the column width.:T{  the column width.:T{
 This text is too wide to fit into a column of width 17.  This text is too wide to fit into a column of width 17.
 T}:line 4  T}:line 4
Line 388  T}::line 5
Line 395  T}::line 5
 These examples were constructed to demonstrate many  These examples were constructed to demonstrate many
 .Nm  .Nm
 features in a compact way.  features in a compact way.
 In real manual pages, keep tables as simple as possible:  In real manual pages, keep tables as simple as possible.
 Like that, they usually look better, are less fragile, and more portable.  They usually look better, are less fragile, and are more portable.
 .Sh COMPATIBILITY  .Sh COMPATIBILITY
 The  The
 .Xr mandoc 1  .Xr mandoc 1
Line 410  equations inside tables.
Line 417  equations inside tables.
 .Xr roff 7  .Xr roff 7
 .Rs  .Rs
 .%A M. E. Lesk  .%A M. E. Lesk
 .%T Tbl\(emA Program to Format Tables  .%T Tbl \(em A Program to Format Tables
 .%D June 11, 1976  .%D June 11, 1976
 .Re  .Re
 .Sh HISTORY  .Sh HISTORY
Line 432  reference was written by
Line 439  reference was written by
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv  .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
 and  and
 .An Ingo Schwarze Aq Mt schwarze@openbsd.org .  .An Ingo Schwarze Aq Mt schwarze@openbsd.org .
   .Sh BUGS
   In
   .Fl T
   .Cm utf8
   output mode, heavy lines are drawn instead of double lines.
   This cannot be improved because the Unicode standard only provides
   an incomplete set of box drawing characters with double lines,
   whereas it provides a full set of box drawing characters
   with heavy lines.
   It is unlikely this can be improved in the future because the box
   drawing characters are already marked in Unicode as characters
   intended only for backward compatibility with legacy systems,
   and their use is not encouraged.
   So it seems unlikely that the missing ones might get added in the future.
Legend:
Removed from v.1.29  
changed lines
  Added in v.1.38
CVSweb