File: [cvsweb.bsd.lv] / docbook2mdoc / macro.h (download)
Revision 1.3, Sat Apr 6 22:37:57 2019 UTC (5 years ago) by schwarze
Branch: MAIN
Changes since 1.2: +2 -1 lines
Store the information whether a node is preceded by whitespace
into the node tree. Use that information in the formatter
to suppress the insertion of whitespace
in text-text, macro-text, and macro-macro node sequences.
Text-macro sequences are not yet handled. They are more complicated
because they require emitting a .Pf macro as part of a text node
depending on the spacing properties of the *following* macro node.
|
/* $Id: macro.h,v 1.3 2019/04/06 22:37:57 schwarze Exp $ */
/*
* Copyright (c) 2019 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
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS 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 interface of the macro line formatter,
* a part of the mdoc(7) formatter.
*/
enum linestate {
LINE_NEW = 0, /* At the beginning of a new line. */
LINE_TEXT, /* In the middle of a text line. */
LINE_MACRO /* In the middle of a macro line. */
};
struct format {
int level; /* Header level, starting at 1. */
int spc; /* Whitespace before next macro. */
enum linestate linestate;
};
#define ARG_SPACE 1 /* Insert whitespace before this argument. */
#define ARG_SINGLE 2 /* Quote argument if it contains whitespace. */
#define ARG_QUOTED 4 /* We are already in a quoted argument. */
#define ARG_UPPER 8 /* Covert argument to upper case. */
void macro_open(struct format *, const char *);
void macro_close(struct format *);
void macro_line(struct format *, const char *);
void macro_closepunct(struct format *, struct pnode *);
void macro_addarg(struct format *, const char *, int);
void macro_argline(struct format *, const char *, const char *);
void macro_addnode(struct format *, struct pnode *, int);
void macro_nodeline(struct format *, const char *, struct pnode *, int);
void print_text(struct format *, const char *, int);
void print_textnode(struct format *, struct pnode *);