mandoc/mandoc_char.7 - diff

Return to mandoc_char.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc_char.7 between version 1.68 and 1.70

version 1.68, 2018/03/15 18:10:31

version 1.70, 2018/08/08 14:03:27

Line 63 names; instead, provide ASCII transcriptions of the na

.Ss Dashes and Hyphens

In typography there are different types of dashes of various width:

the hyphen (-),

the minus sign (\(mi),

the en-dash (\(en),

and the em-dash (\(em).

the em-dash (\(em),

and the mathematical minus sign (\(mi).

.Pp

Hyphens are used for adjectives;

to separate the two parts of a compound word;

Line 100 Such automatic hyphenation is not supported by

which only breaks the line at whitespace, and inside words only

after existing hyphens.

.Pp

The mathematical minus sign is used for negative numbers or subtraction.

It should be written as

.Sq \e(mi :

.Bd -unfilled -offset indent

a = 3 \e(mi 1;

b = \e(mi2;

.Ed

.Pp

The en-dash is used to separate the two elements of a range,

or can be used the same way as an em-dash.

It should be written as

Line 126 Three things \e(em apples, oranges, and bananas.

Line 118 Three things \e(em apples, oranges, and bananas.

This is not that \e(em rather, this is that.

.Ed

.Pp

Note:

hyphens, minus signs, and en-dashes look identical under normal ASCII output.

.Xr roff 7

Other formats, such as PostScript, render them correctly,

documents, the minus sign is normally written as

with differing widths.

.Sq \e- .

In manual pages, some style guides recommend to also use

.Sq \e-

if an ASCII 0x2d

.Dq hyphen-minus

output glyph that can be copied and pasted is desired in output modes

supporting it, for example in

.Fl T Cm utf8

and

.Fl T Cm html .

But currently, no practically relevant manual page formatter actually

requires that subtlety, so in manual pages just write plain

.Sq -

to represent hyphen, minus, and hyphen-minus.

.Ss Spaces

To separate words in normal text, for indenting and alignment

in literal context, and when none of the following special cases apply,

Line 333 Quotes:

Line 338 Quotes:

.It \e(rq Ta \(rq Ta right double-quote

.It \e(oq Ta \(oq Ta left single-quote

.It \e(cq Ta \(cq Ta right single-quote

.It \e(aq Ta \(aq Ta apostrophe quote (text)

.It \e(aq Ta \(aq Ta apostrophe quote (ASCII character)

.It \e(dq Ta \(dq Ta double quote (text)

.It \e(dq Ta \(dq Ta double quote (ASCII character)

.It \e(Fo Ta \(Fo Ta left guillemet

.It \e(Fc Ta \(Fc Ta right guillemet

.It \e(fo Ta \(fo Ta left single guillemet

Line 350 Brackets:

Line 355 Brackets:

.It \e(rC Ta \(rC Ta right brace

.It \e(la Ta \(la Ta left angle

.It \e(ra Ta \(ra Ta right angle

.It \e(bv Ta \(bv Ta brace extension

.It \e(bv Ta \(bv Ta brace extension (special font)

.It \e[braceex] Ta \[braceex] Ta brace extension

.It \e[bracketlefttp] Ta \[bracketlefttp] Ta top-left hooked bracket

.It \e[bracketleftbt] Ta \[bracketleftbt] Ta bottom-left hooked bracket

Line 403 Logical:

Line 408 Logical:

.It Em Input Ta Em Rendered Ta Em Description

.It \e(AN Ta \(AN Ta logical and

.It \e(OR Ta \(OR Ta logical or

.It \e(no Ta \(no Ta logical not

.It \e[tno] Ta \[tno] Ta logical not (text font)

.It \e[tno] Ta \[tno] Ta logical not (text)

.It \e(no Ta \(no Ta logical not (special font)

.It \e(te Ta \(te Ta existential quantifier

.It \e(fa Ta \(fa Ta universal quantifier

.It \e(st Ta \(st Ta such that

Line 416 Logical:

Line 421 Logical:

Mathematical:

.Bl -column "xxcoproductxx" "Rendered" "Description" -offset indent -compact

.It Em Input Ta Em Rendered Ta Em Description

.It \e(pl Ta \(pl Ta plus

.It \e- Ta \- Ta minus (text font)

.It \e(mi Ta \(mi Ta minus

.It \e(mi Ta \(mi Ta minus (special font)

.It \e- Ta \- Ta minus (text)

.It + Ta + Ta plus (text font)

.It \e(pl Ta \(pl Ta plus (special font)

.It \e(-+ Ta \(-+ Ta minus-plus

.It \e(+- Ta \(+- Ta plus-minus

.It \e[t+-] Ta \[t+-] Ta plus-minus (text font)

.It \e[t+-] Ta \[t+-] Ta plus-minus (text)

.It \e(+- Ta \(+- Ta plus-minus (special font)

.It \e(pc Ta \(pc Ta center-dot

.It \e(mu Ta \(mu Ta multiply

.It \e[tmu] Ta \[tmu] Ta multiply (text font)

.It \e[tmu] Ta \[tmu] Ta multiply (text)

.It \e(mu Ta \(mu Ta multiply (special font)

.It \e(c* Ta \(c* Ta circle-multiply

.It \e(c+ Ta \(c+ Ta circle-plus

.It \e(di Ta \(di Ta divide

.It \e[tdi] Ta \[tdi] Ta divide (text font)

.It \e[tdi] Ta \[tdi] Ta divide (text)

.It \e(di Ta \(di Ta divide (special font)

.It \e(f/ Ta \(f/ Ta fraction

.It \e(** Ta \(** Ta asterisk

.It \e(<= Ta \(<= Ta less-than-equal

Line 525 Accents:

Line 531 Accents:

.It \e(ao Ta \(ao Ta ring

.It \e(a\(ti Ta \(a~ Ta tilde

.It \e(ho Ta \(ho Ta ogonek

.It \e(ha Ta \(ha Ta hat (text)

.It \e(ha Ta \(ha Ta hat (ASCII character)

.It \e(ti Ta \(ti Ta tilde (text)

.It \e(ti Ta \(ti Ta tilde (ASCII character)

.El

.Pp

Accented letters:

CVSweb