mandoc/mdoc.7 - diff

Return to mdoc.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc.7 between version 1.259 and 1.260

version 1.259, 2016/12/28 17:34:18

version 1.260, 2017/01/09 14:10:53

Line 1

.\" $Id$

.\"

.\" Permission to use, copy, modify, and distribute this software for any

.\" purpose with or without fee is hereby granted, provided that the above

Line 1831 The

list is the most complicated.

Its syntax is as follows:

.Pp

.D1 Pf \. Sx \&It Ar cell Op <TAB> Ar cell ...

.D1 Pf \. Sx \&It Ar cell Op Sx \&Ta Ar cell ...

.D1 Pf \. Sx \&It Ar cell Op <TAB> Ar cell ...

.Pp

The arguments consist of one or more lines of text and macros

representing a complete table line.

Cells within the line are delimited by tabs or by the special

Cells within the line are delimited by the special

.Sx \&Ta

block macro.

block macro or by literal tab characters.

.Pp

Using literal tabs is strongly discouraged because they are very

hard to use correctly and

.Nm

code using them is very hard to read.

In particular, a blank character is syntactically significant

before and after the literal tab character.

If a word precedes or follows the tab without an intervening blank,

that word is never interpreted as a macro call, but always output

literally.

.Pp

The tab cell delimiter may only be used within the

.Sx \&It

line itself; on following lines, only the

Line 1853 Note that quoted strings may span tab-delimited cells

Line 1864 Note that quoted strings may span tab-delimited cells

line.

For example,

.Pp

.Dl .It \(dqcol1 ; <TAB> col2 ;\(dq \&;

.Dl .It \(dqcol1 ,\& <TAB> col2 ,\(dq \&;

.Pp

will preserve the semicolon whitespace except for the last.

will preserve the whitespace before both commas,

but not the whitespace before the semicolon.

.Pp