version 1.139, 2019/04/28 15:03:28 |
version 1.143, 2019/04/28 19:59:01 |
|
|
*/ |
*/ |
|
|
static void pnode_print(struct format *, struct pnode *); |
static void pnode_print(struct format *, struct pnode *); |
static void pnode_printrefentry(struct format *, struct pnode *); |
|
|
|
|
|
static void |
static void |
|
|
pnode_printsection(struct format *f, struct pnode *n) |
pnode_printsection(struct format *f, struct pnode *n) |
{ |
{ |
struct pnode *nc, *ncc; |
struct pnode *nc, *ncc; |
const char *title; |
|
int flags, level; |
int flags, level; |
|
|
if (n->parent == NULL) { |
if (n->parent == NULL) |
pnode_printrefentry(f, n); |
|
return; |
return; |
} |
|
|
|
level = ++f->level; |
level = ++f->level; |
flags = ARG_SPACE; |
flags = ARG_SPACE; |
switch (n->node) { |
switch (n->node) { |
case NODE_PREFACE: |
|
case NODE_SECTION: |
case NODE_SECTION: |
case NODE_APPENDIX: |
case NODE_APPENDIX: |
if (level == 1) |
if (level == 1) |
flags |= ARG_UPPER; |
flags |= ARG_UPPER; |
break; |
break; |
case NODE_SIMPLESECT: |
case NODE_SIMPLESECT: |
case NODE_LEGALNOTICE: |
|
if (level < 2) |
if (level < 2) |
level = 2; |
level = 2; |
break; |
break; |
default: |
case NODE_NOTE: |
if (level < 3) |
if (level < 3) |
level = 3; |
level = 3; |
break; |
break; |
|
default: |
|
abort(); |
} |
} |
|
|
TAILQ_FOREACH(nc, &n->childq, child) |
TAILQ_FOREACH(nc, &n->childq, child) |
if (nc->node == NODE_TITLE) |
if (nc->node == NODE_TITLE) |
break; |
break; |
|
|
if (nc == NULL) { |
|
switch (n->node) { |
|
case NODE_PREFACE: |
|
title = "Preface"; |
|
break; |
|
case NODE_APPENDIX: |
|
title = "Appendix"; |
|
break; |
|
case NODE_LEGALNOTICE: |
|
title = "Legal Notice"; |
|
break; |
|
case NODE_CAUTION: |
|
title = "Caution"; |
|
break; |
|
case NODE_NOTE: |
|
title = "Note"; |
|
break; |
|
case NODE_TIP: |
|
title = "Tip"; |
|
break; |
|
case NODE_WARNING: |
|
title = "Warning"; |
|
break; |
|
default: |
|
title = "Unknown"; |
|
break; |
|
} |
|
} |
|
|
|
switch (level) { |
switch (level) { |
case 1: |
case 1: |
macro_close(f); |
macro_close(f); |
Line 272 pnode_printsection(struct format *f, struct pnode *n) |
|
Line 239 pnode_printsection(struct format *f, struct pnode *n) |
|
macro_open(f, "Sy"); |
macro_open(f, "Sy"); |
break; |
break; |
} |
} |
|
macro_addnode(f, nc, flags); |
if (nc != NULL) |
|
macro_addnode(f, nc, flags); |
|
else |
|
macro_addarg(f, title, flags | ARG_QUOTED); |
|
macro_close(f); |
macro_close(f); |
|
|
/* |
/* |
Line 729 pnode_printolink(struct format *f, struct pnode *n) |
|
Line 692 pnode_printolink(struct format *f, struct pnode *n) |
|
static void |
static void |
pnode_printprologue(struct format *f, struct pnode *root) |
pnode_printprologue(struct format *f, struct pnode *root) |
{ |
{ |
struct pnode *date, *refmeta, *name, *vol, *descr, *nc, *nn; |
struct pnode *name, *nc; |
const char *sname; |
|
|
|
/* Collect information. */ |
nc = TAILQ_FIRST(&root->childq); |
|
assert(nc->node == NODE_DATE); |
|
macro_nodeline(f, "Dd", nc, 0); |
|
pnode_unlink(nc); |
|
|
if ((date = pnode_takefirst(root, NODE_PUBDATE)) == NULL) |
|
date = pnode_takefirst(root, NODE_DATE); |
|
|
|
name = vol = NULL; |
|
if ((refmeta = pnode_findfirst(root, NODE_REFMETA)) != NULL) { |
|
TAILQ_FOREACH_SAFE(nc, &refmeta->childq, child, nn) { |
|
switch (nc->node) { |
|
case NODE_REFENTRYTITLE: |
|
name = nc; |
|
break; |
|
case NODE_MANVOLNUM: |
|
vol = nc; |
|
break; |
|
default: |
|
continue; |
|
} |
|
TAILQ_REMOVE(&refmeta->childq, nc, child); |
|
} |
|
} |
|
|
|
if (pnode_findfirst(root, NODE_REFNAMEDIV) == NULL && |
|
((nc = pnode_findfirst(root, NODE_BOOKINFO)) != NULL || |
|
(nc = pnode_findfirst(root, NODE_REFENTRYINFO)) != NULL)) |
|
descr = pnode_takefirst(nc, NODE_TITLE); |
|
else |
|
descr = NULL; |
|
|
|
/* Print prologue. */ |
|
|
|
if (date == NULL) |
|
macro_line(f, "Dd $Mdocdate" "$"); |
|
else |
|
macro_nodeline(f, "Dd", date, 0); |
|
|
|
macro_open(f, "Dt"); |
macro_open(f, "Dt"); |
if (name == NULL) { |
name = TAILQ_FIRST(&root->childq); |
sname = pnode_getattr_raw(root, ATTRKEY_ID, "UNKNOWN"); |
assert(name->node == NODE_REFENTRYTITLE); |
macro_addarg(f, sname, ARG_SPACE | ARG_SINGLE | ARG_UPPER); |
macro_addnode(f, name, ARG_SPACE | ARG_SINGLE | ARG_UPPER); |
} else |
TAILQ_REMOVE(&root->childq, name, child); |
macro_addnode(f, name, ARG_SPACE | ARG_SINGLE | ARG_UPPER); |
name->parent = NULL; |
if (vol == NULL) |
nc = TAILQ_FIRST(&root->childq); |
macro_addarg(f, "1", ARG_SPACE); |
assert (nc->node == NODE_MANVOLNUM); |
else |
macro_addnode(f, nc, ARG_SPACE | ARG_SINGLE); |
macro_addnode(f, vol, ARG_SPACE | ARG_SINGLE); |
pnode_unlink(nc); |
|
|
macro_line(f, "Os"); |
macro_line(f, "Os"); |
|
|
if (descr != NULL) { |
nc = TAILQ_FIRST(&root->childq); |
|
if (nc != NULL && nc->node == NODE_TITLE) { |
macro_line(f, "Sh NAME"); |
macro_line(f, "Sh NAME"); |
if (name == NULL) |
macro_nodeline(f, "Nm", name, ARG_SINGLE); |
macro_argline(f, "Nm", sname); |
macro_nodeline(f, "Nd", nc, 0); |
else |
pnode_unlink(nc); |
macro_nodeline(f, "Nm", name, ARG_SINGLE); |
|
macro_nodeline(f, "Nd", descr, 0); |
|
} |
} |
|
|
/* Clean up. */ |
|
|
|
pnode_unlink(date); |
|
pnode_unlink(name); |
pnode_unlink(name); |
pnode_unlink(vol); |
|
pnode_unlink(descr); |
|
f->parastate = PARA_HAVE; |
f->parastate = PARA_HAVE; |
} |
} |
|
|
static void |
|
pnode_printrefentry(struct format *f, struct pnode *n) |
|
{ |
|
struct pnode *info, *meta, *nc, *title; |
|
struct pnode *match, *later; |
|
|
|
/* Collect nodes that remained behind when writing the prologue. */ |
|
|
|
meta = NULL; |
|
info = pnode_takefirst(n, NODE_BOOKINFO); |
|
if (info != NULL && TAILQ_FIRST(&info->childq) == NULL) { |
|
pnode_unlink(info); |
|
info = NULL; |
|
} |
|
if (info == NULL) { |
|
info = pnode_takefirst(n, NODE_REFENTRYINFO); |
|
if (info != NULL && TAILQ_FIRST(&info->childq) == NULL) { |
|
pnode_unlink(info); |
|
info = NULL; |
|
} |
|
if (info == NULL) |
|
info = pnode_takefirst(n, NODE_INFO); |
|
meta = pnode_takefirst(n, NODE_REFMETA); |
|
if (meta != NULL && TAILQ_FIRST(&meta->childq) == NULL) { |
|
pnode_unlink(meta); |
|
meta = NULL; |
|
} |
|
} |
|
if (info == NULL && meta == NULL) |
|
return; |
|
|
|
/* |
|
* Find the best place to put this information. |
|
* Use the last existing AUTHORS node, if any. |
|
* Otherwise, put it behind all standard sections that |
|
* conventionally precede AUTHORS, and also behind any |
|
* non-standard sections that follow the last of these, |
|
* but before the next standard section. |
|
*/ |
|
|
|
match = later = NULL; |
|
TAILQ_FOREACH(nc, &n->childq, child) { |
|
switch (nc->node) { |
|
case NODE_REFENTRY: |
|
case NODE_REFNAMEDIV: |
|
case NODE_REFSYNOPSISDIV: |
|
case NODE_PREFACE: |
|
later = NULL; |
|
continue; |
|
case NODE_APPENDIX: |
|
case NODE_INDEX: |
|
if (later == NULL) |
|
later = nc; |
|
continue; |
|
default: |
|
break; |
|
} |
|
if ((title = pnode_findfirst(nc, NODE_TITLE)) == NULL || |
|
(title = TAILQ_FIRST(&title->childq)) == NULL || |
|
title->node != NODE_TEXT) |
|
continue; |
|
if (strcasecmp(title->b, "AUTHORS") == 0 || |
|
strcasecmp(title->b, "AUTHOR") == 0) |
|
match = nc; |
|
else if (strcasecmp(title->b, "NAME") == 0 || |
|
strcasecmp(title->b, "SYNOPSIS") == 0 || |
|
strcasecmp(title->b, "DESCRIPTION") == 0 || |
|
strcasecmp(title->b, "RETURN VALUES") == 0 || |
|
strcasecmp(title->b, "ENVIRONMENT") == 0 || |
|
strcasecmp(title->b, "FILES") == 0 || |
|
strcasecmp(title->b, "EXIT STATUS") == 0 || |
|
strcasecmp(title->b, "EXAMPLES") == 0 || |
|
strcasecmp(title->b, "DIAGNOSTICS") == 0 || |
|
strcasecmp(title->b, "ERRORS") == 0 || |
|
strcasecmp(title->b, "SEE ALSO") == 0 || |
|
strcasecmp(title->b, "STANDARDS") == 0 || |
|
strcasecmp(title->b, "HISTORY") == 0) |
|
later = NULL; |
|
else if ((strcasecmp(title->b, "CAVEATS") == 0 || |
|
strcasecmp(title->b, "BUGS") == 0) && |
|
later == NULL) |
|
later = nc; |
|
} |
|
|
|
/* |
|
* If no AUTHORS section was found, create one from scratch, |
|
* and insert that at the place selected earlier. |
|
*/ |
|
|
|
if (match == NULL) { |
|
match = xcalloc(1, sizeof(*match)); |
|
match->node = NODE_SECTION; |
|
match->flags |= NFLAG_SPC; |
|
match->parent = n; |
|
TAILQ_INIT(&match->childq); |
|
TAILQ_INIT(&match->attrq); |
|
nc = pnode_alloc(match); |
|
nc->node = NODE_TITLE; |
|
nc->flags |= NFLAG_SPC; |
|
nc = pnode_alloc(nc); |
|
nc->node = NODE_TEXT; |
|
nc->b = xstrdup("AUTHORS"); |
|
nc->flags |= NFLAG_SPC; |
|
if (later == NULL) |
|
TAILQ_INSERT_TAIL(&n->childq, match, child); |
|
else |
|
TAILQ_INSERT_BEFORE(later, match, child); |
|
} |
|
|
|
/* |
|
* Dump the stuff excised at the beginning |
|
* into this AUTHORS section. |
|
*/ |
|
|
|
if (info != NULL) |
|
TAILQ_INSERT_TAIL(&match->childq, info, child); |
|
if (meta != NULL) |
|
TAILQ_INSERT_TAIL(&match->childq, meta, child); |
|
} |
|
|
|
/* |
/* |
* We can have multiple <term> elements within a <varlistentry>, which |
* We can have multiple <term> elements within a <varlistentry>, which |
* we should comma-separate as list headers. |
* we should comma-separate as list headers. |
Line 1302 pnode_print(struct format *f, struct pnode *n) |
|
Line 1106 pnode_print(struct format *f, struct pnode *n) |
|
case NODE_SYSTEMITEM: |
case NODE_SYSTEMITEM: |
pnode_printsystemitem(f, n); |
pnode_printsystemitem(f, n); |
break; |
break; |
case NODE_REFENTRY: |
|
pnode_printrefentry(f, n); |
|
break; |
|
case NODE_REFNAME: |
case NODE_REFNAME: |
/* More often, these appear inside NODE_REFNAMEDIV. */ |
/* More often, these appear inside NODE_REFNAMEDIV. */ |
macro_open(f, "Nm"); |
macro_open(f, "Nm"); |
Line 1318 pnode_print(struct format *f, struct pnode *n) |
|
Line 1119 pnode_print(struct format *f, struct pnode *n) |
|
case NODE_REFSYNOPSISDIV: |
case NODE_REFSYNOPSISDIV: |
pnode_printrefsynopsisdiv(f, n); |
pnode_printrefsynopsisdiv(f, n); |
break; |
break; |
case NODE_PREFACE: |
|
case NODE_SECTION: |
case NODE_SECTION: |
case NODE_SIMPLESECT: |
case NODE_SIMPLESECT: |
case NODE_APPENDIX: |
case NODE_APPENDIX: |
case NODE_LEGALNOTICE: |
|
case NODE_NOTE: |
case NODE_NOTE: |
case NODE_TIP: |
|
case NODE_CAUTION: |
|
case NODE_WARNING: |
|
pnode_printsection(f, n); |
pnode_printsection(f, n); |
break; |
break; |
case NODE_REPLACEABLE: |
case NODE_REPLACEABLE: |
Line 1378 pnode_print(struct format *f, struct pnode *n) |
|
Line 1174 pnode_print(struct format *f, struct pnode *n) |
|
case NODE_XREF: |
case NODE_XREF: |
pnode_printxref(f, n); |
pnode_printxref(f, n); |
break; |
break; |
|
case NODE_CAUTION: |
|
case NODE_LEGALNOTICE: |
|
case NODE_PREFACE: |
|
case NODE_TIP: |
|
case NODE_WARNING: |
|
abort(); |
default: |
default: |
break; |
break; |
} |
} |
Line 1462 pnode_print(struct format *f, struct pnode *n) |
|
Line 1264 pnode_print(struct format *f, struct pnode *n) |
|
} else |
} else |
f->flags &= ~FMT_IMPL; |
f->flags &= ~FMT_IMPL; |
break; |
break; |
case NODE_PREFACE: |
|
case NODE_SECTION: |
case NODE_SECTION: |
|
case NODE_SIMPLESECT: |
case NODE_APPENDIX: |
case NODE_APPENDIX: |
case NODE_LEGALNOTICE: |
|
case NODE_NOTE: |
case NODE_NOTE: |
case NODE_TIP: |
if (n->parent != NULL) |
case NODE_CAUTION: |
f->level--; |
case NODE_WARNING: |
|
f->level--; |
|
break; |
break; |
case NODE_BLOCKQUOTE: |
case NODE_BLOCKQUOTE: |
case NODE_LITERALLAYOUT: |
case NODE_LITERALLAYOUT: |