=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.259 retrieving revision 1.263 diff -u -p -r1.259 -r1.263 --- mandoc/mandoc.1 2022/06/05 13:54:09 1.259 +++ mandoc/mandoc.1 2022/08/02 12:02:28 1.263 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.259 2022/06/05 13:54:09 schwarze Exp $ +.\" $Id: mandoc.1,v 1.263 2022/08/02 12:02:28 schwarze Exp $ .\" .\" Copyright (c) 2012, 2014-2022 Ingo Schwarze .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons @@ -15,7 +15,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: June 5 2022 $ +.Dd $Mdocdate: August 2 2022 $ .Dt MANDOC 1 .Os .Sh NAME @@ -342,7 +342,6 @@ and may exceed the output width. Output produced by .Fl T Cm html conforms to HTML5 using optional self-closing tags. -Default styles use only CSS1. Equations rendered from .Xr eqn 7 blocks use MathML. @@ -1474,10 +1473,8 @@ A .Ic \&Bl , .Ic \&D1 , .Ic \&Dl , -.Ic \&MT , -.Ic \&RS , or -.Ic \&UR +.Ic \&RS block contains nothing in its body and will produce no output. .It Sy "empty argument, using 0n" .Pq mdoc @@ -1797,10 +1794,9 @@ it is hard to predict which tab stop position the tab .Pq mdoc A new sentence starts in the middle of a text line. Start it on a new input line to help formatters produce correct spacing. -.It Sy "invalid escape sequence" +.It Sy "invalid escape sequence argument" .Pq roff -An escape sequence has an invalid opening argument delimiter -or the argument is of an invalid form. +The argument of an escape sequence is of an invalid form. Invalid escape sequences are ignored. .It Sy "undefined escape, printing literally" .Pq roff @@ -2314,6 +2310,18 @@ The escape sequence is ignored. The name given in a special character escape sequence is not known to .Nm . The escape sequence is ignored. +.It Sy "invalid escape argument delimiter" +.Pq roff +An escape sequence that expects a numerical argument +attempts to employ one of the characters +.Qq " %&()*+-./0123456789:<=>" +as an argument delimiter. +The escape sequence is ignored including the invalid opening delimiter +and the rest of the argument may appear as output text. +While various characters can be used as argument delimiters, +using the apostrophe-quote character +.Pq Sq \(aq +is recommended for readability and robustness. .El .Ss Unsupported features .Bl -ohang