/* $Id: mdoc_man.c,v 1.3 2011/09/30 00:13:28 schwarze Exp $ */ /* * Copyright (c) 2011 Ingo Schwarze * * Permission to use, copy, modify, and distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #include #include #include "mandoc.h" #include "mdoc.h" #include "main.h" static int need_space = 0; static int need_nl = 0; #define DECL_ARGS const struct mdoc_meta *m, \ const struct mdoc_node *n struct manact { int (*cond)(DECL_ARGS); int (*pre)(DECL_ARGS); void (*post)(DECL_ARGS); const char *prefix; const char *suffix; }; static void print_word(const char *); static void print_node(DECL_ARGS); static int cond_head(DECL_ARGS); static int cond_body(DECL_ARGS); static int pre_enc(DECL_ARGS); static void post_enc(DECL_ARGS); static void post_percent(DECL_ARGS); static int pre_sect(DECL_ARGS); static void post_sect(DECL_ARGS); static int pre_ap(DECL_ARGS); static int pre_bd(DECL_ARGS); static void post_bd(DECL_ARGS); static int pre_br(DECL_ARGS); static int pre_dl(DECL_ARGS); static void post_dl(DECL_ARGS); static int pre_it(DECL_ARGS); static int pre_nm(DECL_ARGS); static void post_nm(DECL_ARGS); static int pre_ns(DECL_ARGS); static void post_pf(DECL_ARGS); static int pre_pp(DECL_ARGS); static int pre_sp(DECL_ARGS); static void post_sp(DECL_ARGS); static int pre_xr(DECL_ARGS); static const struct manact manacts[MDOC_MAX + 1] = { { NULL, pre_ap, NULL, NULL, NULL }, /* Ap */ { NULL, NULL, NULL, NULL, NULL }, /* Dd */ { NULL, NULL, NULL, NULL, NULL }, /* Dt */ { NULL, NULL, NULL, NULL, NULL }, /* _Os */ { NULL, pre_sect, post_sect, ".SH", NULL }, /* Sh */ { NULL, pre_sect, post_sect, ".SS", NULL }, /* Ss */ { NULL, pre_pp, NULL, NULL, NULL }, /* Pp */ { cond_body, pre_dl, post_dl, NULL, NULL }, /* D1 */ { cond_body, pre_dl, post_dl, NULL, NULL }, /* Dl */ { cond_body, pre_bd, post_bd, NULL, NULL }, /* Bd */ { NULL, NULL, NULL, NULL, NULL }, /* Ed */ { NULL, NULL, NULL, NULL, NULL }, /* Bl */ { NULL, NULL, NULL, NULL, NULL }, /* El */ { NULL, pre_it, NULL, NULL, NULL }, /* _It */ { NULL, NULL, NULL, NULL, NULL }, /* _Ad */ { NULL, NULL, NULL, NULL, NULL }, /* _An */ { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Ar */ { NULL, NULL, NULL, NULL, NULL }, /* _Cd */ { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Cm */ { NULL, NULL, NULL, NULL, NULL }, /* _Dv */ { NULL, NULL, NULL, NULL, NULL }, /* _Er */ { NULL, NULL, NULL, NULL, NULL }, /* _Ev */ { NULL, pre_enc, post_enc, "The \\fB", "\\fP\nutility exits 0 on success, and >0 if an error occurs." }, /* Ex */ { NULL, NULL, NULL, NULL, NULL }, /* _Fa */ { NULL, NULL, NULL, NULL, NULL }, /* _Fd */ { NULL, pre_enc, post_enc, "\\fB-", "\\fP" }, /* Fl */ { NULL, NULL, NULL, NULL, NULL }, /* _Fn */ { NULL, NULL, NULL, NULL, NULL }, /* _Ft */ { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Ic */ { NULL, NULL, NULL, NULL, NULL }, /* _In */ { NULL, NULL, NULL, NULL, NULL }, /* _Li */ { cond_head, pre_enc, NULL, "\\- ", NULL }, /* Nd */ { NULL, pre_nm, post_nm, NULL, NULL }, /* Nm */ { cond_body, pre_enc, post_enc, "[", "]" }, /* Op */ { NULL, NULL, NULL, NULL, NULL }, /* _Ot */ { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* _Pa */ { NULL, NULL, NULL, NULL, NULL }, /* _Rv */ { NULL, NULL, NULL, NULL, NULL }, /* _St */ { NULL, NULL, NULL, NULL, NULL }, /* _Va */ { NULL, NULL, NULL, NULL, NULL }, /* _Vt */ { NULL, pre_xr, NULL, NULL, NULL }, /* _Xr */ { NULL, NULL, post_percent, NULL, NULL }, /* _%A */ { NULL, NULL, NULL, NULL, NULL }, /* _%B */ { NULL, NULL, post_percent, NULL, NULL }, /* _%D */ { NULL, NULL, NULL, NULL, NULL }, /* _%I */ { NULL, pre_enc, post_percent, "\\fI", "\\fP" }, /* %J */ { NULL, NULL, NULL, NULL, NULL }, /* _%N */ { NULL, NULL, NULL, NULL, NULL }, /* _%O */ { NULL, NULL, NULL, NULL, NULL }, /* _%P */ { NULL, NULL, NULL, NULL, NULL }, /* _%R */ { NULL, pre_enc, post_percent, "\"", "\"" }, /* %T */ { NULL, NULL, NULL, NULL, NULL }, /* _%V */ { NULL, NULL, NULL, NULL, NULL }, /* _Ac */ { NULL, NULL, NULL, NULL, NULL }, /* _Ao */ { cond_body, pre_enc, post_enc, "<", ">" }, /* Aq */ { NULL, NULL, NULL, NULL, NULL }, /* _At */ { NULL, NULL, NULL, NULL, NULL }, /* Bc */ { NULL, NULL, NULL, NULL, NULL }, /* _Bf */ { cond_body, pre_enc, post_enc, "[", "]" }, /* Bo */ { cond_body, pre_enc, post_enc, "[", "]" }, /* Bq */ { NULL, NULL, NULL, NULL, NULL }, /* _Bsx */ { NULL, NULL, NULL, NULL, NULL }, /* _Bx */ { NULL, NULL, NULL, NULL, NULL }, /* _Db */ { NULL, NULL, NULL, NULL, NULL }, /* _Dc */ { NULL, NULL, NULL, NULL, NULL }, /* _Do */ { cond_body, pre_enc, post_enc, "``", "''" }, /* Dq */ { NULL, NULL, NULL, NULL, NULL }, /* _Ec */ { NULL, NULL, NULL, NULL, NULL }, /* _Ef */ { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Em */ { NULL, NULL, NULL, NULL, NULL }, /* _Eo */ { NULL, NULL, NULL, NULL, NULL }, /* _Fx */ { NULL, NULL, NULL, NULL, NULL }, /* _Ms */ { NULL, NULL, NULL, NULL, NULL }, /* _No */ { NULL, pre_ns, NULL, NULL, NULL }, /* Ns */ { NULL, NULL, NULL, NULL, NULL }, /* _Nx */ { NULL, NULL, NULL, NULL, NULL }, /* _Ox */ { NULL, NULL, NULL, NULL, NULL }, /* Pc */ { NULL, NULL, post_pf, NULL, NULL }, /* Pf */ { cond_body, pre_enc, post_enc, "(", ")" }, /* Po */ { cond_body, pre_enc, post_enc, "(", ")" }, /* Pq */ { NULL, NULL, NULL, NULL, NULL }, /* _Qc */ { cond_body, pre_enc, post_enc, "`", "'" }, /* Ql */ { NULL, NULL, NULL, NULL, NULL }, /* _Qo */ { NULL, NULL, NULL, NULL, NULL }, /* _Qq */ { NULL, NULL, NULL, NULL, NULL }, /* _Re */ { cond_body, pre_pp, NULL, NULL, NULL }, /* Rs */ { NULL, NULL, NULL, NULL, NULL }, /* _Sc */ { NULL, NULL, NULL, NULL, NULL }, /* _So */ { cond_body, pre_enc, post_enc, "`", "'" }, /* Sq */ { NULL, NULL, NULL, NULL, NULL }, /* _Sm */ { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Sx */ { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Sy */ { NULL, NULL, NULL, NULL, NULL }, /* _Tn */ { NULL, NULL, NULL, NULL, NULL }, /* _Ux */ { NULL, NULL, NULL, NULL, NULL }, /* _Xc */ { NULL, NULL, NULL, NULL, NULL }, /* _Xo */ { NULL, NULL, NULL, NULL, NULL }, /* _Fo */ { NULL, NULL, NULL, NULL, NULL }, /* _Fc */ { cond_body, pre_enc, post_enc, "[", "]" }, /* Oo */ { NULL, NULL, NULL, NULL, NULL }, /* _Oc */ { NULL, NULL, NULL, NULL, NULL }, /* _Bk */ { NULL, NULL, NULL, NULL, NULL }, /* _Ek */ { NULL, NULL, NULL, NULL, NULL }, /* _Bt */ { NULL, NULL, NULL, NULL, NULL }, /* _Hf */ { NULL, NULL, NULL, NULL, NULL }, /* _Fr */ { NULL, NULL, NULL, NULL, NULL }, /* _Ud */ { NULL, NULL, NULL, NULL, NULL }, /* _Lb */ { NULL, pre_pp, NULL, NULL, NULL }, /* Lp */ { NULL, NULL, NULL, NULL, NULL }, /* _Lk */ { NULL, NULL, NULL, NULL, NULL }, /* _Mt */ { NULL, NULL, NULL, NULL, NULL }, /* _Brq */ { NULL, NULL, NULL, NULL, NULL }, /* _Bro */ { NULL, NULL, NULL, NULL, NULL }, /* _Brc */ { NULL, NULL, NULL, NULL, NULL }, /* _%C */ { NULL, NULL, NULL, NULL, NULL }, /* _Es */ { NULL, NULL, NULL, NULL, NULL }, /* _En */ { NULL, NULL, NULL, NULL, NULL }, /* _Dx */ { NULL, NULL, NULL, NULL, NULL }, /* _%Q */ { NULL, pre_br, NULL, NULL, NULL }, /* br */ { NULL, pre_sp, post_sp, NULL, NULL }, /* sp */ { NULL, NULL, NULL, NULL, NULL }, /* _%U */ { NULL, NULL, NULL, NULL, NULL }, /* _Ta */ { NULL, NULL, NULL, NULL, NULL }, /* ROOT */ }; static void print_word(const char *s) { if (need_nl) { putchar('\n'); need_space = 0; need_nl = 0; } else if (need_space && (NULL == strchr(".,:;)]?!", s[0]) || '\0' != s[1])) putchar(' '); need_space = ('(' != s[0] && '[' != s[0]) || '\0' != s[1]; for ( ; *s; s++) { switch (*s) { case (ASCII_NBRSP): printf("\\~"); break; case (ASCII_HYPH): putchar('-'); break; default: putchar(*s); break; } } } void man_mdoc(void *arg, const struct mdoc *mdoc) { const struct mdoc_meta *m; const struct mdoc_node *n; m = mdoc_meta(mdoc); n = mdoc_node(mdoc); printf(".TH \"%s\" \"%s\" \"%s\" \"%s\" \"%s\"", m->title, m->msec, m->date, m->os, m->vol); need_nl = 1; need_space = 0; print_node(m, n); putchar('\n'); } static void print_node(DECL_ARGS) { const struct mdoc_node *prev, *sub; const struct manact *act = NULL; int cond, do_sub; prev = n->prev ? n->prev : n->parent; if (prev && prev->line < n->line) need_nl = 1; cond = 0; do_sub = 1; if (MDOC_TEXT == n->type) { if (need_nl && ('.' == *n->string || '\'' == *n->string)) { print_word("\\&"); need_space = 0; } print_word(n->string); } else { act = manacts + n->tok; cond = NULL == act->cond || (*act->cond)(m, n); if (cond && act->pre) do_sub = (*act->pre)(m, n); } if (do_sub) for (sub = n->child; sub; sub = sub->next) print_node(m, sub); if (cond && act->post) (*act->post)(m, n); } static int cond_head(DECL_ARGS) { return(MDOC_HEAD == n->type); } static int cond_body(DECL_ARGS) { return(MDOC_BODY == n->type); } static int pre_enc(DECL_ARGS) { const char *prefix; prefix = manacts[n->tok].prefix; if (NULL == prefix) return(1); print_word(prefix); need_space = 0; return(1); } static void post_enc(DECL_ARGS) { const char *suffix; suffix = manacts[n->tok].suffix; if (NULL == suffix) return; need_space = 0; print_word(suffix); } static void post_percent(DECL_ARGS) { post_enc(m, n); if (n->next) print_word(","); else { print_word("."); need_nl = 1; } } static int pre_sect(DECL_ARGS) { if (MDOC_HEAD != n->type) return(1); need_nl = 1; print_word(manacts[n->tok].prefix); print_word("\""); need_space = 0; return(1); } static void post_sect(DECL_ARGS) { if (MDOC_HEAD != n->type) return; need_space = 0; print_word("\""); need_nl = 1; } static int pre_ap(DECL_ARGS) { need_space = 0; print_word("'"); need_space = 0; return(0); } static int pre_bd(DECL_ARGS) { if (DISP_unfilled == n->norm->Bd.type || DISP_literal == n->norm->Bd.type) { need_nl = 1; print_word(".nf"); } need_nl = 1; return(1); } static void post_bd(DECL_ARGS) { if (DISP_unfilled == n->norm->Bd.type || DISP_literal == n->norm->Bd.type) { need_nl = 1; print_word(".fi"); } need_nl = 1; } static int pre_br(DECL_ARGS) { need_nl = 1; print_word(".br"); need_nl = 1; return(0); } static int pre_dl(DECL_ARGS) { need_nl = 1; print_word(".RS 6n"); need_nl = 1; return(1); } static void post_dl(DECL_ARGS) { need_nl = 1; print_word(".RE"); need_nl = 1; } static int pre_it(DECL_ARGS) { const struct mdoc_node *bln; if (MDOC_HEAD == n->type) { need_nl = 1; print_word(".TP"); bln = n->parent->parent->prev; switch (bln->norm->Bl.type) { case (LIST_bullet): print_word("4n"); need_nl = 1; print_word("\\fBo\\fP"); break; default: if (bln->norm->Bl.width) print_word(bln->norm->Bl.width); break; } need_nl = 1; } return(1); } static int pre_nm(DECL_ARGS) { if (MDOC_ELEM != n->type && MDOC_HEAD != n->type) return(1); print_word("\\fB"); need_space = 0; if (NULL == n->child) print_word(m->name); return(1); } static void post_nm(DECL_ARGS) { if (MDOC_ELEM != n->type && MDOC_HEAD != n->type) return; need_space = 0; print_word("\\fP"); } static int pre_ns(DECL_ARGS) { need_space = 0; return(0); } static void post_pf(DECL_ARGS) { need_space = 0; } static int pre_pp(DECL_ARGS) { need_nl = 1; if (MDOC_It == n->parent->tok) print_word(".sp"); else print_word(".PP"); need_nl = 1; return(1); } static int pre_sp(DECL_ARGS) { need_nl = 1; print_word(".sp"); return(1); } static void post_sp(DECL_ARGS) { need_nl = 1; } static int pre_xr(DECL_ARGS) { n = n->child; if (NULL == n) return(0); print_node(m, n); n = n->next; if (NULL == n) return(0); need_space = 0; print_word("("); print_node(m, n); print_word(")"); return(0); }