diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2010-08-20 01:02:07 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2010-08-20 01:02:07 +0000 |
commit | a1567e8417f169edf6c71532dc11bfa763ac444b (patch) | |
tree | 9acbfb9862a556c0d41f4af58c78fafc856128c1 /man.3 | |
parent | 6f04dff21d0fded19bbcaefed07c6e35138b590f (diff) | |
download | mandoc-a1567e8417f169edf6c71532dc11bfa763ac444b.tar.gz mandoc-a1567e8417f169edf6c71532dc11bfa763ac444b.tar.zst mandoc-a1567e8417f169edf6c71532dc11bfa763ac444b.zip |
Implement a simple, consistent user interface for error handling.
We now have sufficient practical experience to know what we want,
so this is intended to be final:
- provide -Wlevel (warning, error or fatal) to select what you care about
- provide -Wstop to stop after parsing a file with warnings you care about
- provide consistent exit status codes for those warnings you care about
- fully document what warnings, errors and fatal errors mean
- remove all other cruft from the user interface, less is more:
- remove all -f knobs along with the whole -f option
- remove the old -Werror because calling warnings "fatal" is silly
- always finish parsing each file, unless fatal errors prevent that
This commit also includes a couple of related simplifications behind
the scenes regarding error handling.
Feedback and OK kristaps@; Joerg Sonnenberger (NetBSD) and
Sascha Wildner (DragonFly BSD) agree with the general direction.
Diffstat (limited to 'man.3')
-rw-r--r-- | man.3 | 11 |
1 files changed, 3 insertions, 8 deletions
@@ -1,4 +1,4 @@ -.\" $Id: man.3,v 1.23 2010/08/16 09:51:17 kristaps Exp $ +.\" $Id: man.3,v 1.24 2010/08/20 01:02:07 schwarze Exp $ .\" .\" Copyright (c) 2009-2010 Kristaps Dzonsons <kristaps@bsd.lv> .\" @@ -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: August 16 2010 $ +.Dd $Mdocdate: August 20 2010 $ .Dt MAN 3 .Os .Sh NAME @@ -35,7 +35,6 @@ .Fo man_alloc .Fa "struct regset *regs" .Fa "void *data" -.Fa "int pflags" .Fa "mandocmsg msgs" .Fc .Ft int @@ -172,10 +171,6 @@ The .Fa data pointer is passed to .Fa msgs . -The -.Fa pflags -arguments are defined in -.Pa man.h . Returns NULL on failure. If non-NULL, the pointer must be freed with .Fn man_free . @@ -298,7 +293,7 @@ int line; bzero(®s, sizeof(struct regset)); line = 1; -man = man_alloc(®s, NULL, 0, NULL); +man = man_alloc(®s, NULL, NULL); buf = NULL; alloc_len = 0; |