diff options
| -rw-r--r-- | man.7 | 19 | ||||
| -rw-r--r-- | mandoc.1 | 8 |
2 files changed, 24 insertions, 3 deletions
@@ -403,9 +403,11 @@ Documents any security precautions that operators should consider. Macros are one to three three characters in length and begin with a control character , .Sq \&. , -at the beginning of the line. An arbitrary amount of whitespace may -sit between the control character and the macro name. Thus, the -following are equivalent: +at the beginning of the line. The +.Sq \(aq +macro control character is also accepted. An arbitrary amount of +whitespace may sit between the control character and the macro name. +Thus, the following are equivalent: .Bd -literal -offset indent \&.PP \&.\ \ \ PP @@ -999,22 +1001,33 @@ This section documents areas of questionable portability between implementations of the .Nm language. +. .Pp .Bl -dash -compact .It In quoted literals, GNU troff allowed pair-wise double-quotes to produce a standalone double-quote in formatted output. It is not known whether this behaviour is exhibited by other formatters. +. .It Blocks of whitespace are stripped from macro and free-form text lines (except when in literal mode) in mandoc. This is not the case for GNU troff: for maximum portability, whitespace sensitive blocks should be enclosed in literal contexts. +. .It The .Sx \&sp macro does not accept negative values in mandoc. In GNU troff, this would result in strange behaviour. +. +.It +The +.Sq \(aq +macro control character, in GNU troff (and prior troffs) suppresses a +newline before macro output; in mandoc, it is an alias for the standard +.Sq \&. +control character. .El . . @@ -510,6 +510,7 @@ CSS2 styling used for .Fl m Ns Ar doc input lists does not render properly in older browsers, such as Internet Explorer 6 and earlier. +. .Pp In .Fl T Ns Ar html @@ -520,6 +521,7 @@ the maximum size of an element attribute is determined by which is usually 1024 bytes. Be aware of this when setting long link formats, e.g., .Fl O Ns Ar style=really/long/link . +. .Pp The .Fl T Ns Ar html @@ -531,6 +533,7 @@ font size escape documented in .Xr mdoc 7 and .Xr man 7 . +. .Pp Nesting elements within next-line element scopes of .Fl m Ns Ar an , @@ -543,6 +546,7 @@ will confuse and .Fl T Ns Ar xhtml and cause them to forget the formatting of the prior next-line scope. +. .Pp The .Sq i @@ -550,3 +554,7 @@ macro in .Fl m Ns Ar an should italicise all subsequent text if a line argument is not provided. This behaviour is not implemented. +. +The +.Sq \(aq +control character does not have the same |