improve documentation of .Fa, .Va, and .Vt;

[mandoc.git] / tbl.c

diff --git a/tbl.c b/tbl.c
index 1f2d6f1a090ea9c9c9cb4f2b5296ccafb9a5e4fa..bfed242b9d9e231a732a0ecdc3bafcc9e4087d7a 100644 (file)
--- a/tbl.c
+++ b/tbl.c
@@ -1,6 +1,7 @@
-/*     $Id: tbl.c,v 1.2 2010/12/28 10:55:24 kristaps Exp $ */
+/*     $Id: tbl.c,v 1.30 2014/08/10 23:54:41 schwarze Exp $ */

 /*
 /*

- * Copyright (c) 2009, 2010 Kristaps Dzonsons <kristaps@kth.se>
+ * Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2011 Ingo Schwarze <schwarze@openbsd.org>

  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above


@@ -14,45 +15,24 @@
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */

+#include "config.h"
+
+#include <sys/types.h>
+

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

+#include <stdio.h>

 #include <stdlib.h>
 #include <string.h>
 #include <time.h>
 
 #include "mandoc.h"
 #include <stdlib.h>
 #include <string.h>
 #include <time.h>
 
 #include "mandoc.h"

-#include "roff.h"
+#include "mandoc_aux.h"

 #include "libmandoc.h"
 #include "libroff.h"
 
 #include "libmandoc.h"
 #include "libroff.h"
 

-enum   tbl_part {
-       TBL_PART_OPTS, /* in options (first line) */
-       TBL_PART_LAYOUT, /* describing layout */
-       TBL_PART_DATA  /* creating data rows */
-};
-
-
-struct tbl {
-       enum tbl_part    part;
-};
-
-static void             tbl_init(struct tbl *);
-static void             tbl_clear(struct tbl *);
-
-static void
-tbl_clear(struct tbl *tbl)
-{
-
-}
-
-static void
-tbl_init(struct tbl *tbl)
-{
-
-       tbl->part = TBL_PART_OPTS;
-}

 
 enum rofferr
 
 enum rofferr

-tbl_read(struct tbl *tbl, int ln, const char *p, int offs)
+tbl_read(struct tbl_node *tbl, int ln, const char *p, int offs)

 {
        int              len;
        const char      *cp;
 {
        int              len;
        const char      *cp;


@@ -60,35 +40,137 @@ tbl_read(struct tbl *tbl, int ln, const char *p, int offs)
        cp = &p[offs];
        len = (int)strlen(cp);
 
        cp = &p[offs];
        len = (int)strlen(cp);
 

-       if (len && TBL_PART_OPTS == tbl->part)
+       /*
+        * If we're in the options section and we don't have a
+        * terminating semicolon, assume we've moved directly into the
+        * layout section.  No need to report a warning: this is,
+        * apparently, standard behaviour.
+        */
+
+       if (TBL_PART_OPTS == tbl->part && len)

                if (';' != cp[len - 1])
                        tbl->part = TBL_PART_LAYOUT;
                if (';' != cp[len - 1])
                        tbl->part = TBL_PART_LAYOUT;

-       
-       return(ROFF_CONT);
+
+       /* Now process each logical section of the table.  */
+
+       switch (tbl->part) {
+       case TBL_PART_OPTS:
+               return(tbl_option(tbl, ln, p) ? ROFF_IGN : ROFF_ERR);
+       case TBL_PART_LAYOUT:
+               return(tbl_layout(tbl, ln, p) ? ROFF_IGN : ROFF_ERR);
+       case TBL_PART_CDATA:
+               return(tbl_cdata(tbl, ln, p) ? ROFF_TBL : ROFF_IGN);
+       default:
+               break;
+       }
+
+       /*
+        * This only returns zero if the line is empty, so we ignore it
+        * and continue on.
+        */
+       return(tbl_data(tbl, ln, p) ? ROFF_TBL : ROFF_IGN);

 }
 
 }
 

-struct tbl *
-tbl_alloc(void)
+struct tbl_node *
+tbl_alloc(int pos, int line, struct mparse *parse)

 {
 {

-       struct tbl      *p;
+       struct tbl_node *tbl;

 
 

-       p = mandoc_malloc(sizeof(struct tbl));
-       tbl_init(p);
-       return(p);
+       tbl = mandoc_calloc(1, sizeof(struct tbl_node));
+       tbl->line = line;
+       tbl->pos = pos;
+       tbl->parse = parse;
+       tbl->part = TBL_PART_OPTS;
+       tbl->opts.tab = '\t';
+       tbl->opts.linesize = 12;
+       tbl->opts.decimal = '.';
+       return(tbl);
+}
+
+void
+tbl_free(struct tbl_node *tbl)
+{
+       struct tbl_row  *rp;
+       struct tbl_cell *cp;
+       struct tbl_span *sp;
+       struct tbl_dat  *dp;
+       struct tbl_head *hp;
+
+       while (NULL != (rp = tbl->first_row)) {
+               tbl->first_row = rp->next;
+               while (rp->first) {
+                       cp = rp->first;
+                       rp->first = cp->next;
+                       free(cp);
+               }
+               free(rp);
+       }
+
+       while (NULL != (sp = tbl->first_span)) {
+               tbl->first_span = sp->next;
+               while (sp->first) {
+                       dp = sp->first;
+                       sp->first = dp->next;
+                       if (dp->string)
+                               free(dp->string);
+                       free(dp);
+               }
+               free(sp);
+       }
+
+       while (NULL != (hp = tbl->first_head)) {
+               tbl->first_head = hp->next;
+               free(hp);
+       }
+
+       free(tbl);

 }
 
 void
 }
 
 void

-tbl_free(struct tbl *p)
+tbl_restart(int line, int pos, struct tbl_node *tbl)

 {
 {

+       if (TBL_PART_CDATA == tbl->part)
+               mandoc_msg(MANDOCERR_TBLBLOCK, tbl->parse,
+                   tbl->line, tbl->pos, NULL);

 
 

-       tbl_clear(p);
-       free(p);
+       tbl->part = TBL_PART_LAYOUT;
+       tbl->line = line;
+       tbl->pos = pos;
+
+       if (NULL == tbl->first_span || NULL == tbl->first_span->first)
+               mandoc_msg(MANDOCERR_TBLNODATA, tbl->parse,
+                   tbl->line, tbl->pos, NULL);
+}
+
+const struct tbl_span *
+tbl_span(struct tbl_node *tbl)
+{
+       struct tbl_span  *span;
+
+       assert(tbl);
+       span = tbl->current_span ? tbl->current_span->next
+                                : tbl->first_span;
+       if (span)
+               tbl->current_span = span;
+       return(span);

 }
 
 void
 }
 
 void

-tbl_reset(struct tbl *tbl)
+tbl_end(struct tbl_node **tblp)

 {
 {

+       struct tbl_node *tbl;
+
+       tbl = *tblp;
+       *tblp = NULL;
+
+       if (NULL == tbl->first_span || NULL == tbl->first_span->first)
+               mandoc_msg(MANDOCERR_TBLNODATA, tbl->parse,
+                   tbl->line, tbl->pos, NULL);
+
+       if (tbl->last_span)
+               tbl->last_span->flags |= TBL_SPAN_LAST;

 
 

-       tbl_clear(tbl);
-       tbl_init(tbl);
+       if (TBL_PART_CDATA == tbl->part)
+               mandoc_msg(MANDOCERR_TBLBLOCK, tbl->parse,
+                   tbl->line, tbl->pos, NULL);

 }
 }