]> git.cameronkatri.com Git - mandoc.git/blobdiff - man.c
simple implementation of the roff(7) .als (macro alias) request,
[mandoc.git] / man.c
diff --git a/man.c b/man.c
index d2c27bfaf6075cdf2563c275c66541ae23753fd3..f2ba1bdbdd4c45561634a762cff8e57f7cab6dde 100644 (file)
--- a/man.c
+++ b/man.c
@@ -1,7 +1,7 @@
-/*     $Id: man.c,v 1.165 2015/10/06 18:32:19 schwarze Exp $ */
+/*     $Id: man.c,v 1.174 2017/06/03 15:55:24 schwarze Exp $ */
 /*
  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 /*
  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
- * Copyright (c) 2013, 2014, 2015 Ingo Schwarze <schwarze@openbsd.org>
+ * Copyright (c) 2013, 2014, 2015, 2017 Ingo Schwarze <schwarze@openbsd.org>
  * Copyright (c) 2011 Joerg Sonnenberger <joerg@netbsd.org>
  *
  * Permission to use, copy, modify, and distribute this software for any
  * Copyright (c) 2011 Joerg Sonnenberger <joerg@netbsd.org>
  *
  * Permission to use, copy, modify, and distribute this software for any
 #include "roff_int.h"
 #include "libman.h"
 
 #include "roff_int.h"
 #include "libman.h"
 
-const  char *const __man_macronames[MAN_MAX] = {
-       "br",           "TH",           "SH",           "SS",
-       "TP",           "LP",           "PP",           "P",
-       "IP",           "HP",           "SM",           "SB",
-       "BI",           "IB",           "BR",           "RB",
-       "R",            "B",            "I",            "IR",
-       "RI",           "sp",           "nf",
-       "fi",           "RE",           "RS",           "DT",
-       "UC",           "PD",           "AT",           "in",
-       "ft",           "OP",           "EX",           "EE",
-       "UR",           "UE",           "ll"
-       };
-
-const  char * const *man_macronames = __man_macronames;
-
 static void             man_descope(struct roff_man *, int, int);
 static int              man_ptext(struct roff_man *, int, char *, int);
 static int              man_pmacro(struct roff_man *, int, char *, int);
 static void             man_descope(struct roff_man *, int, int);
 static int              man_ptext(struct roff_man *, int, char *, int);
 static int              man_pmacro(struct roff_man *, int, char *, int);
@@ -104,15 +89,17 @@ man_ptext(struct roff_man *man, int line, char *buf, int offs)
                /* Skip leading whitespace. */ ;
 
        /*
                /* Skip leading whitespace. */ ;
 
        /*
-        * Blank lines are ignored right after headings
-        * but add a single vertical space elsewhere.
+        * Blank lines are ignored in next line scope and right
+        * after headings but add a single vertical space elsewhere.
         */
 
        if (buf[i] == '\0') {
         */
 
        if (buf[i] == '\0') {
-               /* Allocate a blank entry. */
-               if (man->last->tok != MAN_SH &&
+               if (man->flags & (MAN_ELINE | MAN_BLINE))
+                       mandoc_msg(MANDOCERR_BLK_BLANK, man->parse,
+                           line, 0, NULL);
+               else if (man->last->tok != MAN_SH &&
                    man->last->tok != MAN_SS) {
                    man->last->tok != MAN_SS) {
-                       roff_elem_alloc(man, line, offs, MAN_sp);
+                       roff_elem_alloc(man, line, offs, ROFF_sp);
                        man->next = ROFF_NEXT_SIBLING;
                }
                return 1;
                        man->next = ROFF_NEXT_SIBLING;
                }
                return 1;
@@ -149,7 +136,7 @@ man_ptext(struct roff_man *man, int line, char *buf, int offs)
 
        assert(i);
        if (mandoc_eos(buf, (size_t)i))
 
        assert(i);
        if (mandoc_eos(buf, (size_t)i))
-               man->last->flags |= MAN_EOS;
+               man->last->flags |= NODE_EOS;
 
        man_descope(man, line, offs);
        return 1;
 
        man_descope(man, line, offs);
        return 1;
@@ -160,26 +147,19 @@ man_pmacro(struct roff_man *man, int ln, char *buf, int offs)
 {
        struct roff_node *n;
        const char      *cp;
 {
        struct roff_node *n;
        const char      *cp;
-       int              tok;
-       int              i, ppos;
+       size_t           sz;
+       enum roff_tok    tok;
+       int              ppos;
        int              bline;
        int              bline;
-       char             mac[5];
-
-       ppos = offs;
-
-       /*
-        * Copy the first word into a nil-terminated buffer.
-        * Stop when a space, tab, escape, or eoln is encountered.
-        */
-
-       i = 0;
-       while (i < 4 && strchr(" \t\\", buf[offs]) == NULL)
-               mac[i++] = buf[offs++];
-
-       mac[i] = '\0';
 
 
-       tok = (i > 0 && i < 4) ? man_hash_find(mac) : TOKEN_NONE;
+       /* Determine the line macro. */
 
 
+       ppos = offs;
+       tok = TOKEN_NONE;
+       for (sz = 0; sz < 4 && strchr(" \t\\", buf[offs]) == NULL; sz++)
+               offs++;
+       if (sz > 0 && sz < 4)
+               tok = roffhash_find(man->manmac, buf + ppos, sz);
        if (tok == TOKEN_NONE) {
                mandoc_msg(MANDOCERR_MACRO, man->parse,
                    ln, ppos, buf + ppos - 1);
        if (tok == TOKEN_NONE) {
                mandoc_msg(MANDOCERR_MACRO, man->parse,
                    ln, ppos, buf + ppos - 1);
@@ -203,7 +183,7 @@ man_pmacro(struct roff_man *man, int ln, char *buf, int offs)
 
        /* Jump to the next non-whitespace word. */
 
 
        /* Jump to the next non-whitespace word. */
 
-       while (buf[offs] && buf[offs] == ' ')
+       while (buf[offs] == ' ')
                offs++;
 
        /*
                offs++;
 
        /*
@@ -223,6 +203,20 @@ man_pmacro(struct roff_man *man, int ln, char *buf, int offs)
        man_breakscope(man, tok);
        bline = man->flags & MAN_BLINE;
 
        man_breakscope(man, tok);
        bline = man->flags & MAN_BLINE;
 
+       /*
+        * If the line in next-line scope ends with \c, keep the
+        * next-line scope open for the subsequent input line.
+        * That is not at all portable, only groff >= 1.22.4
+        * does it, but *if* this weird idiom occurs in a manual
+        * page, that's very likely what the author intended.
+        */
+
+       if (bline) {
+               cp = strchr(buf + offs, '\0') - 2;
+               if (cp >= buf && cp[0] == '\\' && cp[1] == 'c')
+                       bline = 0;
+       }
+
        /* Call to handler... */
 
        assert(man_macros[tok].fp);
        /* Call to handler... */
 
        assert(man_macros[tok].fp);
@@ -266,7 +260,7 @@ man_breakscope(struct roff_man *man, int tok)
         * Delete the element that is being broken.
         */
 
         * Delete the element that is being broken.
         */
 
-       if (man->flags & MAN_ELINE && (tok == TOKEN_NONE ||
+       if (man->flags & MAN_ELINE && (tok < MAN_TH ||
            ! (man_macros[tok].flags & MAN_NSCOPED))) {
                n = man->last;
                assert(n->type != ROFFT_TEXT);
            ! (man_macros[tok].flags & MAN_NSCOPED))) {
                n = man->last;
                assert(n->type != ROFFT_TEXT);
@@ -275,8 +269,7 @@ man_breakscope(struct roff_man *man, int tok)
 
                mandoc_vmsg(MANDOCERR_BLK_LINE, man->parse,
                    n->line, n->pos, "%s breaks %s",
 
                mandoc_vmsg(MANDOCERR_BLK_LINE, man->parse,
                    n->line, n->pos, "%s breaks %s",
-                   tok == TOKEN_NONE ? "TS" : man_macronames[tok],
-                   man_macronames[n->tok]);
+                   roff_name[tok], roff_name[n->tok]);
 
                roff_node_delete(man, n);
                man->flags &= ~MAN_ELINE;
 
                roff_node_delete(man, n);
                man->flags &= ~MAN_ELINE;
@@ -302,7 +295,7 @@ man_breakscope(struct roff_man *man, int tok)
         * Delete the block that is being broken.
         */
 
         * Delete the block that is being broken.
         */
 
-       if (man->flags & MAN_BLINE && (tok == TOKEN_NONE ||
+       if (man->flags & MAN_BLINE && (tok < MAN_TH ||
            man_macros[tok].flags & MAN_BSCOPE)) {
                n = man->last;
                if (n->type == ROFFT_TEXT)
            man_macros[tok].flags & MAN_BSCOPE)) {
                n = man->last;
                if (n->type == ROFFT_TEXT)
@@ -317,8 +310,7 @@ man_breakscope(struct roff_man *man, int tok)
 
                mandoc_vmsg(MANDOCERR_BLK_LINE, man->parse,
                    n->line, n->pos, "%s breaks %s",
 
                mandoc_vmsg(MANDOCERR_BLK_LINE, man->parse,
                    n->line, n->pos, "%s breaks %s",
-                   tok == TOKEN_NONE ? "TS" : man_macronames[tok],
-                   man_macronames[n->tok]);
+                   roff_name[tok], roff_name[n->tok]);
 
                roff_node_delete(man, n);
                man->flags &= ~MAN_BLINE;
 
                roff_node_delete(man, n);
                man->flags &= ~MAN_BLINE;
@@ -332,3 +324,38 @@ man_mparse(const struct roff_man *man)
        assert(man && man->parse);
        return man->parse;
 }
        assert(man && man->parse);
        return man->parse;
 }
+
+void
+man_state(struct roff_man *man, struct roff_node *n)
+{
+
+       switch(n->tok) {
+       case MAN_nf:
+       case MAN_EX:
+               if (man->flags & MAN_LITERAL && ! (n->flags & NODE_VALID))
+                       mandoc_msg(MANDOCERR_NF_SKIP, man->parse,
+                           n->line, n->pos, "nf");
+               man->flags |= MAN_LITERAL;
+               break;
+       case MAN_fi:
+       case MAN_EE:
+               if ( ! (man->flags & MAN_LITERAL) &&
+                    ! (n->flags & NODE_VALID))
+                       mandoc_msg(MANDOCERR_FI_SKIP, man->parse,
+                           n->line, n->pos, "fi");
+               man->flags &= ~MAN_LITERAL;
+               break;
+       default:
+               break;
+       }
+       man->last->flags |= NODE_VALID;
+}
+
+void
+man_validate(struct roff_man *man)
+{
+
+       man->last = man->first;
+       man_node_validate(man);
+       man->flags &= ~MAN_LITERAL;
+}