=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.259 retrieving revision 1.260 diff -u -p -r1.259 -r1.260 --- mandoc/mandoc.1 2022/06/05 13:54:09 1.259 +++ mandoc/mandoc.1 2022/06/07 09:54:40 1.260 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.259 2022/06/05 13:54:09 schwarze Exp $ +.\" $Id: mandoc.1,v 1.260 2022/06/07 09:54:40 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: June 7 2022 $ .Dt MANDOC 1 .Os .Sh NAME @@ -1797,10 +1797,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 +2313,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 charcters 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