Make empty sections and parts (SH, SS, RS) only produce a warning if it

[mandoc.git] / out.h

diff --git a/out.h b/out.h
index f544b8e32e266fcbd028f748f0ea4c3c90ee8df0..9bf5357b309dd456056bb6c1d04316f167422259 100644 (file)
--- a/out.h
+++ b/out.h
@@ -1,6 +1,6 @@
-/*     $Id: out.h,v 1.15 2011/01/05 15:37:23 kristaps Exp $ */
+/*     $Id: out.h,v 1.18 2011/03/22 10:13:01 kristaps Exp $ */
 /*
- * Copyright (c) 2009 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
@@ -17,41 +17,23 @@
 #ifndef OUT_H
 #define OUT_H
 
-#define        DATESIZ         24
-
-__BEGIN_DECLS
-
-struct roffcol {
-       size_t           width; /* width of cell */
-       size_t           decimal; /* decimal position in cell */
-};
-
-typedef        size_t (*tbl_strlen)(const char *, void *);
-typedef        size_t (*tbl_len)(size_t, void *);
-
-struct rofftbl {
-       tbl_strlen       slen; /* calculate string length */
-       tbl_len          len; /* produce width of empty space */
-       struct roffcol  *cols; /* master column specifiers */
-       void            *arg; /* passed to slen and len */
-};
-
 enum   roffscale {
-       SCALE_CM,
-       SCALE_IN,
-       SCALE_PC,
-       SCALE_PT,
-       SCALE_EM,
-       SCALE_MM,
-       SCALE_EN,
-       SCALE_BU,
-       SCALE_VS,
-       SCALE_FS,
+       SCALE_CM, /* centimeters (c) */
+       SCALE_IN, /* inches (i) */
+       SCALE_PC, /* pica (P) */
+       SCALE_PT, /* points (p) */
+       SCALE_EM, /* ems (m) */
+       SCALE_MM, /* mini-ems (M) */
+       SCALE_EN, /* ens (n) */
+       SCALE_BU, /* default horizontal (u) */
+       SCALE_VS, /* default vertical (v) */
+       SCALE_FS, /* syn. for u (f) */
        SCALE_MAX
 };
 
 enum   roffdeco {
        DECO_NONE,
+       DECO_NUMBERED, /* numbered character */
        DECO_SPECIAL, /* special character */
        DECO_SSPECIAL, /* single-char special */
        DECO_RESERVED, /* reserved word */
@@ -65,11 +47,33 @@ enum        roffdeco {
        DECO_MAX
 };
 
+enum   chars {
+       CHARS_ASCII, /* 7-bit ascii representation */
+       CHARS_HTML /* unicode values */
+};
+
+struct roffcol {
+       size_t           width; /* width of cell */
+       size_t           decimal; /* decimal position in cell */
+};
+
 struct roffsu {
        enum roffscale    unit;
        double            scale;
 };
 
+typedef        size_t  (*tbl_strlen)(const char *, void *);
+typedef        size_t  (*tbl_len)(size_t, void *);
+
+struct rofftbl {
+       tbl_strlen       slen; /* calculate string length */
+       tbl_len          len; /* produce width of empty space */
+       struct roffcol  *cols; /* master column specifiers */
+       void            *arg; /* passed to slen and len */
+};
+
+__BEGIN_DECLS
+
 #define        SCALE_VS_INIT(p, v) \
        do { (p)->unit = SCALE_VS; \
             (p)->scale = (v); } \
@@ -80,10 +84,18 @@ struct      roffsu {
             (p)->scale = (v); } \
        while (/* CONSTCOND */ 0)
 
-int      a2roffsu(const char *, struct roffsu *, enum roffscale);
-int      a2roffdeco(enum roffdeco *, const char **, size_t *);
-void     time2a(time_t, char *, size_t);
-void     tblcalc(struct rofftbl *tbl, const struct tbl_span *);
+int              a2roffsu(const char *, struct roffsu *, enum roffscale);
+int              a2roffdeco(enum roffdeco *, const char **, size_t *);
+void             time2a(time_t, char *, size_t);
+void             tblcalc(struct rofftbl *tbl, const struct tbl_span *);
+
+void            *chars_init(enum chars);
+const char      *chars_num2char(const char *, size_t);
+const char      *chars_spec2str(void *, const char *, size_t, size_t *);
+int              chars_spec2cp(void *, const char *, size_t);
+const char      *chars_res2str(void *, const char *, size_t, size_t *);
+int              chars_res2cp(void *, const char *, size_t);
+void             chars_free(void *);
 
 __END_DECLS