Return to mmain.h CVS log

Up to [cvsweb.bsd.lv] / mandoc

Annotation of mandoc/mmain.h, Revision 1.4

1.4     ! kristaps    1: /* $Id: mmain.h,v 1.3 2009/02/23 12:45:19 kristaps Exp $ */
1.1       kristaps    2: /*
                      3:  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
                      4:  *
                      5:  * Permission to use, copy, modify, and distribute this software for any
                      6:  * purpose with or without fee is hereby granted, provided that the
                      7:  * above copyright notice and this permission notice appear in all
                      8:  * copies.
                      9:  *
                     10:  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
                     11:  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
                     12:  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
                     13:  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
                     14:  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
                     15:  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
                     16:  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
                     17:  * PERFORMANCE OF THIS SOFTWARE.
                     18:  */
                     19: #ifndef MMAIN_H
                     20: #define MMAIN_H
                     21:
                     22: /*
                     23:  * This is a convenience library for utilities implementing mdoc(3)
                     24:  * accepting a similar set of command-line patterns.  mmain handles
1.2       kristaps   25:  * error reporting (to the terminal), command-line parsing, preparing
                     26:  * and reading the input file, and enacting the parse itself.
1.1       kristaps   27:  */
                     28:
                     29: #include "mdoc.h"
                     30:
1.4     ! kristaps   31: /* Rules for "dead" functions: */
        !            32: #if defined(__NetBSD__)
        !            33: #define        dead_pre        __dead
        !            34: #define        dead_post       __attribute__((__noreturn__))
        !            35: #elif defined(__OpenBSD__)
        !            36: #define        dead_pre        __dead
        !            37: #define        dead_post       /* Nothing. */
        !            38: #else
        !            39: #define        dead_pre        /* Nothing. */
        !            40: #define        dead_post       __attribute__((__noreturn__))
1.3       kristaps   41: #endif
                     42:
1.1       kristaps   43: __BEGIN_DECLS
                     44:
                     45: struct mmain;
                     46:
                     47: struct mmain           *mmain_alloc(void);
1.4     ! kristaps   48: dead_pre void           mmain_exit(struct mmain *, int) dead_post;
1.2       kristaps   49: int                     mmain_getopt(struct mmain *, int, char *[],
                     50:                                const char *, const char *, void *,
                     51:                                int (*)(void *, int, const char *));
1.1       kristaps   52: struct mdoc            *mmain_mdoc(struct mmain *);
                     53: void                    mmain_usage(const char *);
                     54:
                     55: __END_DECLS
                     56:
                     57: #endif /*!MMAIN_H*/