=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.19 retrieving revision 1.21 diff -u -p -r1.19 -r1.21 --- mandoc/mandoc.1 2009/06/15 09:35:16 1.19 +++ mandoc/mandoc.1 2009/06/18 08:13:34 1.21 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.19 2009/06/15 09:35:16 kristaps Exp $ +.\" $Id: mandoc.1,v 1.21 2009/06/18 08:13:34 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons .\" @@ -14,7 +14,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 15 2009 $ +.Dd $Mdocdate: June 18 2009 $ .Dt MANDOC 1 .Os .\" SECTION @@ -210,16 +210,18 @@ flag. When rewinding the scope of a block macro, forces the compiler to ignore scope violations. This can seriously mangle the resulting tree. .Pq mdoc only -.It Fl f Ns Ar ign-escape -Ignore invalid escape sequences. -.It Fl f Ns Ar ign-macro -Ignore unknown macros at the start of input lines (default for -.Xr man 7 -parsing). +.It Fl f Ns Ar no-ign-escape +Don't ignore invalid escape sequences. .It Fl f Ns Ar no-ign-macro -Do not ignore unknown macros at the start of input lines (default for -.Xr mdoc 7 -parsing). +Do not ignore unknown macros at the start of input lines. +.It Fl f Ns Ar no-ign-chars +Do not ignore disallowed characters. +.It Fl f Ns Ar strict +Implies +.Fl f Ns Ar no-ign-escape , +.Fl f Ns Ar no-ign-macro +and +.Fl f Ns Ar no-ign-chars . .El .\" PARAGRAPH .Pp @@ -228,22 +230,44 @@ As with the flag, multiple .Fl f options may be grouped and delimited with a comma. Using -.Fl f Ns Ar ign-scope,ign-escape , -for example, will try to ignore scope and character-escape errors. +.Fl f Ns Ar ign-scope,no-ign-escape , +for example, will try to ignore scope and not ignore character-escape +errors. .\" SECTION .Sh EXAMPLES To page manuals to the terminal: .\" PARAGRAPH .Pp -.D1 % mandoc \-Wall,error mandoc.1 2>&1 | less -.Pp +.D1 % mandoc \-Wall,error \-fstrict mandoc.1 2>&1 | less .D1 % mandoc mandoc.1 mdoc.3 mdoc.7 | less .\" SECTION +.Sh COMPATIBILITY +This section summarises +.Nm +compatibility with +.Xr groff 1 . +.Pp +.Bl -bullet -compact +.It +A list or display following +.Sq \&.Ss +does not assert a prior vertical break, just as it doesn't with +.Sq \&.Sh . +.\" LIST-ITEM +.It +The \-literal and \-unfilled +.Sq \&.Bd +displays types are synonyms, as are \-filled and \-ragged. +.\" LIST-ITEM +.It +Words aren't hyphenated. +.El +.\" SECTION .Sh SEE ALSO .Xr mandoc_char 7 , .Xr mdoc 7 , .Xr man 7 -.\" +.\" SECTION .Sh AUTHORS The .Nm @@ -253,37 +277,7 @@ utility was written by .Sh CAVEATS The .Nm -utility in -.Fl T Ns Ar ascii -mode doesn't yet know how to display the following: +utility doesn't yet know how to display \-hang lists. .Pp -.Bl -bullet -compact -.It -The \-hang -.Sq \&.Bl -list is not yet supported. -.El -.Pp Other macros still aren't supported by virtue of nobody complaining -about their absence. Please report any omissions: this is a work in -progress. -.Pp -The following list documents differences between traditional -.Xr nroff 1 -output and -.Nm : -.Pp -.Bl -bullet -compact -.It -A list of display following -.Sq \&.Ss -does not assert a prior vertical break, just as it doesn't with -.Sq \&.Sh . -.It -Special characters don't follow the current font style. -.\" LIST-ITEM -.It -The \-literal and \-unfilled -.Sq \&.Bd -displays types are synonyms, as are \-filled and \-ragged. -.El +about their absence.