version 1.70, 2018/08/08 14:03:27 |
version 1.73, 2018/08/10 22:12:44 |
Line 62 escape sequences to represent national language charac |
|
Line 62 escape sequences to represent national language charac |
|
names; instead, provide ASCII transcriptions of the names. |
names; instead, provide ASCII transcriptions of the names. |
.Ss Dashes and Hyphens |
.Ss Dashes and Hyphens |
In typography there are different types of dashes of various width: |
In typography there are different types of dashes of various width: |
the hyphen (-), |
the hyphen (\(hy), |
the en-dash (\(en), |
the en-dash (\(en), |
the em-dash (\(em), |
the em-dash (\(em), |
and the mathematical minus sign (\(mi). |
and the mathematical minus sign (\(mi). |
|
|
lorry-driver |
lorry-driver |
.Ed |
.Ed |
.Pp |
.Pp |
If a word on a text input line contains a hyphen, a formatter may decide |
|
to insert an output line break after the hyphen if that helps filling |
|
the current output line, but the whole word would overflow the line. |
|
If it is important that the word is not broken across lines in this |
|
way, a zero-width space |
|
.Pq Sq \e& |
|
can be inserted before or after the hyphen. |
|
While |
|
.Xr mandoc 1 |
|
never breaks the output line after hyphens adjacent to a zero-width |
|
space, after any of the other dash- or hyphen-like characters |
|
represented by escape sequences, or after hyphens inside words in |
|
macro arguments, other software may not respect these rules and may |
|
break the line even in such cases. |
|
.Pp |
|
Some |
|
.Xr roff 7 |
|
implementations contains dictionaries allowing to break the line |
|
at syllable boundaries even inside words that contain no hyphens. |
|
Such automatic hyphenation is not supported by |
|
.Xr mandoc 1 , |
|
which only breaks the line at whitespace, and inside words only |
|
after existing hyphens. |
|
.Pp |
|
The en-dash is used to separate the two elements of a range, |
The en-dash is used to separate the two elements of a range, |
or can be used the same way as an em-dash. |
or can be used the same way as an em-dash. |
It should be written as |
It should be written as |
Line 135 But currently, no practically relevant manual page for |
|
Line 111 But currently, no practically relevant manual page for |
|
requires that subtlety, so in manual pages just write plain |
requires that subtlety, so in manual pages just write plain |
.Sq - |
.Sq - |
to represent hyphen, minus, and hyphen-minus. |
to represent hyphen, minus, and hyphen-minus. |
|
.Pp |
|
If a word on a text input line contains a hyphen, a formatter may decide |
|
to insert an output line break after the hyphen if that helps filling |
|
the current output line, but the whole word would overflow the line. |
|
If it is important that the word is not broken across lines in this |
|
way, a zero-width space |
|
.Pq Sq \e& |
|
can be inserted before or after the hyphen. |
|
While |
|
.Xr mandoc 1 |
|
never breaks the output line after hyphens adjacent to a zero-width |
|
space, after any of the other dash- or hyphen-like characters |
|
represented by escape sequences, or after hyphens inside words in |
|
macro arguments, other software may not respect these rules and may |
|
break the line even in such cases. |
|
.Pp |
|
Some |
|
.Xr roff 7 |
|
implementations contains dictionaries allowing to break the line |
|
at syllable boundaries even inside words that contain no hyphens. |
|
Such automatic hyphenation is not supported by |
|
.Xr mandoc 1 , |
|
which only breaks the line at whitespace, and inside words only |
|
after existing hyphens. |
.Ss Spaces |
.Ss Spaces |
To separate words in normal text, for indenting and alignment |
To separate words in normal text, for indenting and alignment |
in literal context, and when none of the following special cases apply, |
in literal context, and when none of the following special cases apply, |
Line 761 For backward compatibility with existing manuals, |
|
Line 761 For backward compatibility with existing manuals, |
|
.Xr mandoc 1 |
.Xr mandoc 1 |
also supports the |
also supports the |
.Pp |
.Pp |
.Dl \eN\(aq Ns Ar number Ns \(aq |
.Dl \eN\(aq Ns Ar number Ns \(aq and \e[ Ns Cm char Ns Ar number ] |
.Pp |
.Pp |
escape sequence, inserting the character |
escape sequences, inserting the character |
.Ar number |
.Ar number |
from the current character set into the output. |
from the current character set into the output. |
Of course, this is inherently non-portable and is already marked |
Of course, this is inherently non-portable and is already marked |
as deprecated in the Heirloom roff manual. |
as deprecated in the Heirloom roff manual; |
For example, do not use \eN\(aq34\(aq, use \e(dq, or even the plain |
on top of that, the second form is a GNU extension. |
|
For example, do not use \eN\(aq34\(aq or \e[char34], use \e(dq, |
|
or even the plain |
.Sq \(dq |
.Sq \(dq |
character where possible. |
character where possible. |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |