Fixed up some documentation in man.7: only documenting man.7 macros, not related...

[mandoc.git] / man_action.c

diff --git a/man_action.c b/man_action.c
index 2c926b5d44e7f0f25fff842155e6aafb358dd0b9..53f79b3bbbb17d4088baf019647431f4d9762d3d 100644 (file)
--- a/man_action.c
+++ b/man_action.c
@@ -1,44 +1,41 @@
-/* $Id: man_action.c,v 1.9 2009/04/05 16:34:22 kristaps Exp $ */
+/*     $Id: man_action.c,v 1.29 2010/03/24 20:10:53 kristaps Exp $ */

 /*
 /*

- * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@openbsd.org>
+ * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>

  *
  * Permission to use, copy, modify, and distribute this software for any
  *
  * 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.
+ * 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.
+ * 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 <sys/utsname.h>
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif

 
 #include <assert.h>
 
 #include <assert.h>

-#include <errno.h>

 #include <stdlib.h>
 #include <string.h>
 
 #include "libman.h"
 #include <stdlib.h>
 #include <string.h>
 
 #include "libman.h"

-
-#ifdef __linux__
-extern char            *strptime(const char *, const char *, struct tm *);
-#endif
+#include "libmandoc.h"

 
 struct actions {
        int     (*post)(struct man *);
 };
 
 
 struct actions {
        int     (*post)(struct man *);
 };
 

-

 static int       post_TH(struct man *);
 static int       post_TH(struct man *);

-static time_t    man_atotime(const char *);
+static int       post_de(struct man *);
+static int       post_fi(struct man *);
+static int       post_nf(struct man *);

 
 const  struct actions man_actions[MAN_MAX] = {
 
 const  struct actions man_actions[MAN_MAX] = {

-       { NULL }, /* __ */
+       { NULL }, /* br */

        { post_TH }, /* TH */
        { NULL }, /* SH */
        { NULL }, /* SS */
        { post_TH }, /* TH */
        { NULL }, /* SH */
        { NULL }, /* SS */


@@ -59,9 +56,26 @@ const        struct actions man_actions[MAN_MAX] = {
        { NULL }, /* I */
        { NULL }, /* IR */
        { NULL }, /* RI */
        { NULL }, /* I */
        { NULL }, /* IR */
        { NULL }, /* RI */

-       { NULL }, /* br */

        { NULL }, /* na */
        { NULL }, /* i */
        { NULL }, /* na */
        { NULL }, /* i */

+       { NULL }, /* sp */
+       { post_nf }, /* nf */
+       { post_fi }, /* fi */
+       { NULL }, /* r */
+       { NULL }, /* RE */
+       { NULL }, /* RS */
+       { NULL }, /* DT */
+       { NULL }, /* UC */
+       { NULL }, /* PD */
+       { NULL }, /* Sp */
+       { post_nf }, /* Vb */
+       { post_fi }, /* Ve */
+       { post_de }, /* de */
+       { post_de }, /* dei */
+       { post_de }, /* am */
+       { post_de }, /* ami */
+       { post_de }, /* ig */
+       { NULL }, /* . */

 };
 
 
 };
 
 


@@ -75,14 +89,54 @@ man_action_post(struct man *m)
 
        switch (m->last->type) {
        case (MAN_TEXT):
 
        switch (m->last->type) {
        case (MAN_TEXT):

-               break;
+               /* FALLTHROUGH */

        case (MAN_ROOT):
        case (MAN_ROOT):

-               break;
+               return(1);

        default:
        default:

-               if (NULL == man_actions[m->last->tok].post)
-                       break;
-               return((*man_actions[m->last->tok].post)(m));
+               break;

        }
        }

+
+       if (NULL == man_actions[m->last->tok].post)
+               return(1);
+       return((*man_actions[m->last->tok].post)(m));
+}
+
+
+static int
+post_fi(struct man *m)
+{
+
+       if ( ! (MAN_LITERAL & m->flags))
+               if ( ! man_nwarn(m, m->last, WNLITERAL))
+                       return(0);
+       m->flags &= ~MAN_LITERAL;
+       return(1);
+}
+
+
+static int
+post_de(struct man *m)
+{
+
+       /*
+        * XXX: for the time being, we indiscriminately remove roff
+        * instructions from the parse stream.
+        */
+       if (MAN_BLOCK == m->last->type)
+               man_node_delete(m, m->last);
+
+       return(1);
+}
+
+
+static int
+post_nf(struct man *m)
+{
+
+       if (MAN_LITERAL & m->flags)
+               if ( ! man_nwarn(m, m->last, WOLITERAL))
+                       return(0);
+       m->flags |= MAN_LITERAL;

        return(1);
 }
 
        return(1);
 }
 


@@ -109,88 +163,48 @@ post_TH(struct man *m)
 
        n = m->last->child;
        assert(n);
 
        n = m->last->child;
        assert(n);

-
-       if (NULL == (m->meta.title = strdup(n->string)))
-               return(man_verr(m, n->line, n->pos, 
-                                       "memory exhausted"));
+       m->meta.title = mandoc_strdup(n->string);

 
        /* TITLE ->MSEC<- DATE SOURCE VOL */
 
        n = n->next;
        assert(n);
 
 
        /* TITLE ->MSEC<- DATE SOURCE VOL */
 
        n = n->next;
        assert(n);
 

-       errno = 0;

        lval = strtol(n->string, &ep, 10);
        if (n->string[0] != '\0' && *ep == '\0')
                m->meta.msec = (int)lval;
        lval = strtol(n->string, &ep, 10);
        if (n->string[0] != '\0' && *ep == '\0')
                m->meta.msec = (int)lval;

-       else if ( ! man_vwarn(m, n->line, n->pos, "invalid section"))
+       else if ( ! man_nwarn(m, n, WMSEC))

                return(0);
 
        /* TITLE MSEC ->DATE<- SOURCE VOL */
 
                return(0);
 
        /* TITLE MSEC ->DATE<- SOURCE VOL */
 

-       if (NULL == (n = n->next))
-               m->meta.date = time(NULL);
-       else if (0 == (m->meta.date = man_atotime(n->string))) {
-               if ( ! man_vwarn(m, n->line, n->pos, "invalid date"))
-                       return(0);
+       n = n->next;
+       if (n) {
+               m->meta.date = mandoc_a2time
+                       (MTIME_ISO_8601, n->string);
+
+               if (0 == m->meta.date) {
+                       if ( ! man_nwarn(m, n, WDATE))
+                               return(0);
+                       m->meta.date = time(NULL);
+               }
+       } else

                m->meta.date = time(NULL);
                m->meta.date = time(NULL);

-       }

 
        /* TITLE MSEC DATE ->SOURCE<- VOL */
 
        if (n && (n = n->next))
 
        /* TITLE MSEC DATE ->SOURCE<- VOL */
 
        if (n && (n = n->next))

-               if (NULL == (m->meta.source = strdup(n->string)))
-                       return(man_verr(m, n->line, n->pos, 
-                                               "memory exhausted"));
+               m->meta.source = mandoc_strdup(n->string);

 
        /* TITLE MSEC DATE SOURCE ->VOL<- */
 
        if (n && (n = n->next))
 
        /* TITLE MSEC DATE SOURCE ->VOL<- */
 
        if (n && (n = n->next))

-               if (NULL == (m->meta.vol = strdup(n->string)))
-                       return(man_verr(m, n->line, n->pos, 
-                                               "memory exhausted"));
+               m->meta.vol = mandoc_strdup(n->string);

 
 

-       /* 
-        * The end document shouldn't have the prologue macros as part
-        * of the syntax tree (they encompass only meta-data).  
+       /*
+        * Remove the `TH' node after we've processed it for our
+        * meta-data.

         */
         */

-
-       if (m->last->parent->child == m->last) {
-               assert(MAN_ROOT == m->last->parent->type);
-               m->last->parent->child = NULL;
-               n = m->last;
-               m->last = m->last->parent;
-               m->next = MAN_NEXT_CHILD;
-               assert(m->last == m->first);
-       } else {
-               assert(m->last->prev);
-               m->last->prev->next = NULL;
-               n = m->last;
-               m->last = m->last->prev;
-               m->next = MAN_NEXT_SIBLING;
-       }
-
-       man_node_freelist(n);
+       man_node_delete(m, m->last);

        return(1);
 }
        return(1);
 }

-
-
-static time_t
-man_atotime(const char *p)
-{
-       struct tm        tm;
-       char            *pp;
-
-       (void)memset(&tm, 0, sizeof(struct tm));
-
-       if ((pp = strptime(p, "%b %d %Y", &tm)) && 0 == *pp)
-               return(mktime(&tm));
-       if ((pp = strptime(p, "%d %b %Y", &tm)) && 0 == *pp)
-               return(mktime(&tm));
-       if ((pp = strptime(p, "%b %d, %Y", &tm)) && 0 == *pp)
-               return(mktime(&tm));
-       if ((pp = strptime(p, "%b %Y", &tm)) && 0 == *pp)
-               return(mktime(&tm));
-
-       return(0);
-}