man.h

   1 /*      $Id: man.h,v 1.45 2010/10/04 07:01:02 kristaps Exp $ */
   2 /*
   3  * Copyright (c) 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
   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 above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16  */
  17 #ifndef MAN_H
  18 #define MAN_H
  19
  20 /*
  21  * What follows is a list of ALL possible macros.
  22  */
  23 enum    mant {
  24         MAN_br = 0,
  25         MAN_TH,
  26         MAN_SH,
  27         MAN_SS,
  28         MAN_TP,
  29         MAN_LP,
  30         MAN_PP,
  31         MAN_P,
  32         MAN_IP,
  33         MAN_HP,
  34         MAN_SM,
  35         MAN_SB,
  36         MAN_BI,
  37         MAN_IB,
  38         MAN_BR,
  39         MAN_RB,
  40         MAN_R,
  41         MAN_B,
  42         MAN_I,
  43         MAN_IR,
  44         MAN_RI,
  45         MAN_na,
  46         MAN_i,
  47         MAN_sp,
  48         MAN_nf,
  49         MAN_fi,
  50         MAN_r,
  51         MAN_RE,
  52         MAN_RS,
  53         MAN_DT,
  54         MAN_UC,
  55         MAN_PD,
  56         MAN_Sp,
  57         MAN_Vb,
  58         MAN_Ve,
  59         MAN_AT,
  60         MAN_in,
  61         MAN_MAX
  62 };
  63
  64 /*
  65  * Type of a syntax node.
  66  */
  67 enum    man_type {
  68         MAN_TEXT,
  69         MAN_ELEM,
  70         MAN_ROOT,
  71         MAN_BLOCK,
  72         MAN_HEAD,
  73         MAN_BODY
  74 };
  75
  76 /*
  77  * Information from prologue.
  78  */
  79 struct  man_meta {
  80         char            *msec; /* `TH' section (1, 3p, etc.) */
  81         time_t           date; /* `TH' normalised date */
  82         char            *rawdate; /* raw `TH' date */
  83         char            *vol; /* `TH' volume */
  84         char            *title; /* `TH' title (e.g., FOO) */
  85         char            *source; /* `TH' source (e.g., GNU) */
  86 };
  87
  88 /*
  89  * Single node in tree-linked AST.
  90  */
  91 struct  man_node {
  92         struct man_node *parent; /* parent AST node */
  93         struct man_node *child; /* first child AST node */
  94         struct man_node *next; /* sibling AST node */
  95         struct man_node *prev; /* prior sibling AST node */
  96         int              nchild; /* number children */
  97         int              line;
  98         int              pos;
  99         enum mant        tok; /* tok or MAN__MAX if none */
 100         int              flags;
 101 #define MAN_VALID       (1 << 0) /* has been validated */
 102 #define MAN_ACTED       (1 << 1) /* has been acted upon */
 103 #define MAN_EOS         (1 << 2) /* at sentence boundary */
 104         enum man_type    type; /* AST node type */
 105         char            *string; /* TEXT node argument */
 106         struct man_node *head; /* BLOCK node HEAD ptr */
 107         struct man_node *body; /* BLOCK node BODY ptr */
 108 };
 109
 110 /*
 111  * Names of macros.  Index is enum mant.  Indexing into this returns
 112  * the normalised name, e.g., man_macronames[MAN_SH] -> "SH".
 113  */
 114 extern  const char *const *man_macronames;
 115
 116 __BEGIN_DECLS
 117
 118 struct  man;
 119
 120 void              man_free(struct man *);
 121 struct  man      *man_alloc(struct regset *, void *, mandocmsg);
 122 void              man_reset(struct man *);
 123 int               man_parseln(struct man *, int, char *, int);
 124 int               man_endparse(struct man *);
 125
 126 const struct man_node *man_node(const struct man *);
 127 const struct man_meta *man_meta(const struct man *);
 128
 129 __END_DECLS
 130
 131 #endif /*!MAN_H*/