diff options
| author |   Ingo Schwarze <schwarze@openbsd.org> | 2015-01-14 22:02:49 +0000 |
|---|---|---|
| committer | Ingo Schwarze <schwarze@openbsd.org> | 2015-01-14 22:02:49 +0000 |
| commit | e54b1e9f0f881374060eef0e4c54bdd192cf7f34 (patch) | |
| tree | 3b0e9093efa2cafde5e03c08a0a9e95f3603e03f /mandoc.1 | |
| parent | 669764169e6c178341b11ebab8f1885b74e310db (diff) | |
| download | mandoc-e54b1e9f0f881374060eef0e4c54bdd192cf7f34.tar.gz mandoc-e54b1e9f0f881374060eef0e4c54bdd192cf7f34.tar.zst mandoc-e54b1e9f0f881374060eef0e4c54bdd192cf7f34.zip | |
To get rid of SYSERR entries in enum mandocerr, downgrade problems with
missing and unreadable files from SYSERR to ERROR.
Needed for upcoming work.
As a bonus, this minimally simplifies code and documentation.
Diffstat (limited to 'mandoc.1')
| -rw-r--r-- | mandoc.1 | 22 |
1 files changed, 13 insertions, 9 deletions
@@ -1,7 +1,7 @@ -.\" $Id: mandoc.1,v 1.130 2014/12/28 14:42:27 schwarze Exp $ +.\" $Id: mandoc.1,v 1.131 2015/01/14 22:02:49 schwarze Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> -.\" Copyright (c) 2012, 2014 Ingo Schwarze <schwarze@openbsd.org> +.\" Copyright (c) 2012, 2014, 2015 Ingo Schwarze <schwarze@openbsd.org> .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above @@ -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: December 28 2014 $ +.Dd $Mdocdate: January 14 2015 $ .Dt MANDOC 1 .Os .Sh NAME @@ -543,8 +543,8 @@ A fatal parsing error occurred. Invalid command line arguments were specified. No input files have been read. .It 6 -An operating system error occurred, for example memory exhaustion or an -error accessing input files. +An operating system error occurred, for example exhaustion +of memory, file descriptors, or process table entries. Such errors cause .Nm to exit at once, possibly in the middle of parsing or formatting a file. @@ -603,9 +603,6 @@ fields. .Pp Message levels have the following meanings: .Bl -tag -width "warning" -.It Cm syserr -Opening or reading an input file failed, so the parser cannot -even be started and no output is produced from that input file. .It Cm fatal The parser is unable to parse a given input file at all. No formatted output is produced from that input file. @@ -619,6 +616,12 @@ the parser is able to continue, and the error does not prevent generation of formatted output, but typically, preparing that output involves information loss, broken document structure or unintended formatting. +.Pp +Non-existent or unreadable input files are also reported on the +.Cm error +level. +In that case, the parser cannot even be started and no output +is produced from those input files. .It Cm warning An input file uses obsolete, discouraged or non-portable syntax. All the same, the meaning of the input is unambiguous and a correct @@ -632,7 +635,8 @@ Messages of the .Cm warning and .Cm error -levels are hidden unless their level, or a lower level, is requested using a +levels except those about non-existent or unreadable input files +are hidden unless their level, or a lower level, is requested using a .Fl W option or .Fl T Ns Cm lint |