mandoc 0.0.1

data/mandoc-1.14.6/tree.c

@@ -0,0 +1,536 @@
+/* $Id: tree.c,v 1.91 2021/09/07 10:59:18 schwarze Exp $ */
+/*
+ * Copyright (c) 2008, 2009, 2011, 2014 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2013-2015, 2017-2021 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.
+ *
+ * Formatting module to let mandoc(1) show
+ * a human readable representation of the syntax tree.
+ */
+#include "config.h"
+
+#include <sys/types.h>
+
+#include <assert.h>
+#include <limits.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <time.h>
+
+#include "mandoc.h"
+#include "roff.h"
+#include "mdoc.h"
+#include "man.h"
+#include "tbl.h"
+#include "eqn.h"
+#include "main.h"
+
+static	void	print_attr(const struct roff_node *);
+static	void	print_box(const struct eqn_box *, int);
+static	void	print_cellt(enum tbl_cellt);
+static	void	print_man(const struct roff_node *, int);
+static	void	print_meta(const struct roff_meta *);
+static	void	print_mdoc(const struct roff_node *, int);
+static	void	print_span(const struct tbl_span *, int);
+
+
+void
+tree_mdoc(void *arg, const struct roff_meta *mdoc)
+{
+	print_meta(mdoc);
+	putchar('\n');
+	print_mdoc(mdoc->first->child, 0);
+}
+
+void
+tree_man(void *arg, const struct roff_meta *man)
+{
+	print_meta(man);
+	if (man->hasbody == 0)
+		puts("body  = empty");
+	putchar('\n');
+	print_man(man->first->child, 0);
+}
+
+static void
+print_meta(const struct roff_meta *meta)
+{
+	if (meta->title != NULL)
+		printf("title = \"%s\"\n", meta->title);
+	if (meta->name != NULL)
+		printf("name  = \"%s\"\n", meta->name);
+	if (meta->msec != NULL)
+		printf("sec   = \"%s\"\n", meta->msec);
+	if (meta->vol != NULL)
+		printf("vol   = \"%s\"\n", meta->vol);
+	if (meta->arch != NULL)
+		printf("arch  = \"%s\"\n", meta->arch);
+	if (meta->os != NULL)
+		printf("os    = \"%s\"\n", meta->os);
+	if (meta->date != NULL)
+		printf("date  = \"%s\"\n", meta->date);
+}
+
+static void
+print_mdoc(const struct roff_node *n, int indent)
+{
+	const char	 *p, *t;
+	int		  i, j;
+	size_t		  argc;
+	struct mdoc_argv *argv;
+
+	if (n == NULL)
+		return;
+
+	argv = NULL;
+	argc = 0;
+	t = p = NULL;
+
+	switch (n->type) {
+	case ROFFT_ROOT:
+		t = "root";
+		break;
+	case ROFFT_BLOCK:
+		t = "block";
+		break;
+	case ROFFT_HEAD:
+		t = "head";
+		break;
+	case ROFFT_BODY:
+		if (n->end)
+			t = "body-end";
+		else
+			t = "body";
+		break;
+	case ROFFT_TAIL:
+		t = "tail";
+		break;
+	case ROFFT_ELEM:
+		t = "elem";
+		break;
+	case ROFFT_TEXT:
+		t = "text";
+		break;
+	case ROFFT_COMMENT:
+		t = "comment";
+		break;
+	case ROFFT_TBL:
+		break;
+	case ROFFT_EQN:
+		t = "eqn";
+		break;
+	default:
+		abort();
+	}
+
+	switch (n->type) {
+	case ROFFT_TEXT:
+	case ROFFT_COMMENT:
+		p = n->string;
+		break;
+	case ROFFT_BODY:
+		p = roff_name[n->tok];
+		break;
+	case ROFFT_HEAD:
+		p = roff_name[n->tok];
+		break;
+	case ROFFT_TAIL:
+		p = roff_name[n->tok];
+		break;
+	case ROFFT_ELEM:
+		p = roff_name[n->tok];
+		if (n->args) {
+			argv = n->args->argv;
+			argc = n->args->argc;
+		}
+		break;
+	case ROFFT_BLOCK:
+		p = roff_name[n->tok];
+		if (n->args) {
+			argv = n->args->argv;
+			argc = n->args->argc;
+		}
+		break;
+	case ROFFT_TBL:
+		break;
+	case ROFFT_EQN:
+		p = "EQ";
+		break;
+	case ROFFT_ROOT:
+		p = "root";
+		break;
+	default:
+		abort();
+	}
+
+	if (n->span) {
+		assert(NULL == p && NULL == t);
+		print_span(n->span, indent);
+	} else {
+		for (i = 0; i < indent; i++)
+			putchar(' ');
+
+		printf("%s (%s)", p, t);
+
+		for (i = 0; i < (int)argc; i++) {
+			printf(" -%s", mdoc_argnames[argv[i].arg]);
+			if (argv[i].sz > 0)
+				printf(" [");
+			for (j = 0; j < (int)argv[i].sz; j++)
+				printf(" [%s]", argv[i].value[j]);
+			if (argv[i].sz > 0)
+				printf(" ]");
+		}
+		print_attr(n);
+	}
+	if (n->eqn)
+		print_box(n->eqn->first, indent + 4);
+	if (n->child)
+		print_mdoc(n->child, indent +
+		    (n->type == ROFFT_BLOCK ? 2 : 4));
+	if (n->next)
+		print_mdoc(n->next, indent);
+}
+
+static void
+print_man(const struct roff_node *n, int indent)
+{
+	const char	 *p, *t;
+	int		  i;
+
+	if (n == NULL)
+		return;
+
+	t = p = NULL;
+
+	switch (n->type) {
+	case ROFFT_ROOT:
+		t = "root";
+		break;
+	case ROFFT_ELEM:
+		t = "elem";
+		break;
+	case ROFFT_TEXT:
+		t = "text";
+		break;
+	case ROFFT_COMMENT:
+		t = "comment";
+		break;
+	case ROFFT_BLOCK:
+		t = "block";
+		break;
+	case ROFFT_HEAD:
+		t = "head";
+		break;
+	case ROFFT_BODY:
+		t = "body";
+		break;
+	case ROFFT_TBL:
+		break;
+	case ROFFT_EQN:
+		t = "eqn";
+		break;
+	default:
+		abort();
+	}
+
+	switch (n->type) {
+	case ROFFT_TEXT:
+	case ROFFT_COMMENT:
+		p = n->string;
+		break;
+	case ROFFT_ELEM:
+	case ROFFT_BLOCK:
+	case ROFFT_HEAD:
+	case ROFFT_BODY:
+		p = roff_name[n->tok];
+		break;
+	case ROFFT_ROOT:
+		p = "root";
+		break;
+	case ROFFT_TBL:
+		break;
+	case ROFFT_EQN:
+		p = "EQ";
+		break;
+	default:
+		abort();
+	}
+
+	if (n->span) {
+		assert(NULL == p && NULL == t);
+		print_span(n->span, indent);
+	} else {
+		for (i = 0; i < indent; i++)
+			putchar(' ');
+		printf("%s (%s)", p, t);
+		print_attr(n);
+	}
+	if (n->eqn)
+		print_box(n->eqn->first, indent + 4);
+	if (n->child)
+		print_man(n->child, indent +
+		    (n->type == ROFFT_BLOCK ? 2 : 4));
+	if (n->next)
+		print_man(n->next, indent);
+}
+
+static void
+print_attr(const struct roff_node *n)
+{
+	putchar(' ');
+	if (n->flags & NODE_DELIMO)
+		putchar('(');
+	if (n->flags & NODE_LINE)
+		putchar('*');
+	printf("%d:%d", n->line, n->pos + 1);
+	if (n->flags & NODE_DELIMC)
+		putchar(')');
+	if (n->flags & NODE_EOS)
+		putchar('.');
+	if (n->flags & NODE_ID) {
+		printf(" ID");
+		if (n->flags & NODE_HREF)
+			printf("=HREF");
+	} else if (n->flags & NODE_HREF)
+		printf(" HREF");
+	else if (n->tag != NULL)
+		printf(" STRAYTAG");
+	if (n->tag != NULL)
+		printf("=%s", n->tag);
+	if (n->flags & NODE_BROKEN)
+		printf(" BROKEN");
+	if (n->flags & NODE_NOFILL)
+		printf(" NOFILL");
+	if (n->flags & NODE_NOSRC)
+		printf(" NOSRC");
+	if (n->flags & NODE_NOPRT)
+		printf(" NOPRT");
+	putchar('\n');
+}
+
+static void
+print_box(const struct eqn_box *ep, int indent)
+{
+	int		 i;
+	const char	*t;
+
+	static const char *posnames[] = {
+	    NULL, "sup", "subsup", "sub",
+	    "to", "from", "fromto",
+	    "over", "sqrt", NULL };
+
+	if (NULL == ep)
+		return;
+	for (i = 0; i < indent; i++)
+		putchar(' ');
+
+	t = NULL;
+	switch (ep->type) {
+	case EQN_LIST:
+		t = "eqn-list";
+		break;
+	case EQN_SUBEXPR:
+		t = "eqn-expr";
+		break;
+	case EQN_TEXT:
+		t = "eqn-text";
+		break;
+	case EQN_PILE:
+		t = "eqn-pile";
+		break;
+	case EQN_MATRIX:
+		t = "eqn-matrix";
+		break;
+	}
+
+	fputs(t, stdout);
+	if (ep->pos)
+		printf(" pos=%s", posnames[ep->pos]);
+	if (ep->left)
+		printf(" left=\"%s\"", ep->left);
+	if (ep->right)
+		printf(" right=\"%s\"", ep->right);
+	if (ep->top)
+		printf(" top=\"%s\"", ep->top);
+	if (ep->bottom)
+		printf(" bottom=\"%s\"", ep->bottom);
+	if (ep->text)
+		printf(" text=\"%s\"", ep->text);
+	if (ep->font)
+		printf(" font=%d", ep->font);
+	if (ep->size != EQN_DEFSIZE)
+		printf(" size=%d", ep->size);
+	if (ep->expectargs != UINT_MAX && ep->expectargs != ep->args)
+		printf(" badargs=%zu(%zu)", ep->args, ep->expectargs);
+	else if (ep->args)
+		printf(" args=%zu", ep->args);
+	putchar('\n');
+
+	print_box(ep->first, indent + 4);
+	print_box(ep->next, indent);
+}
+
+static void
+print_cellt(enum tbl_cellt pos)
+{
+	switch(pos) {
+	case TBL_CELL_LEFT:
+		putchar('L');
+		break;
+	case TBL_CELL_LONG:
+		putchar('a');
+		break;
+	case TBL_CELL_CENTRE:
+		putchar('c');
+		break;
+	case TBL_CELL_RIGHT:
+		putchar('r');
+		break;
+	case TBL_CELL_NUMBER:
+		putchar('n');
+		break;
+	case TBL_CELL_SPAN:
+		putchar('s');
+		break;
+	case TBL_CELL_DOWN:
+		putchar('^');
+		break;
+	case TBL_CELL_HORIZ:
+		putchar('-');
+		break;
+	case TBL_CELL_DHORIZ:
+		putchar('=');
+		break;
+	case TBL_CELL_MAX:
+		putchar('#');
+		break;
+	}
+}
+
+static void
+print_span(const struct tbl_span *sp, int indent)
+{
+	const struct tbl_dat *dp;
+	const struct tbl_cell *cp;
+	int		 i;
+
+	if (sp->prev == NULL) {
+		for (i = 0; i < indent; i++)
+			putchar(' ');
+		printf("%d", sp->opts->cols);
+		if (sp->opts->opts & TBL_OPT_CENTRE)
+			fputs(" center", stdout);
+		if (sp->opts->opts & TBL_OPT_EXPAND)
+			fputs(" expand", stdout);
+		if (sp->opts->opts & TBL_OPT_ALLBOX)
+			fputs(" allbox", stdout);
+		if (sp->opts->opts & TBL_OPT_BOX)
+			fputs(" box", stdout);
+		if (sp->opts->opts & TBL_OPT_DBOX)
+			fputs(" doublebox", stdout);
+		if (sp->opts->opts & TBL_OPT_NOKEEP)
+			fputs(" nokeep", stdout);
+		if (sp->opts->opts & TBL_OPT_NOSPACE)
+			fputs(" nospaces", stdout);
+		if (sp->opts->opts & TBL_OPT_NOWARN)
+			fputs(" nowarn", stdout);
+		printf(" (tbl options) %d:1\n", sp->line);
+	}
+
+	for (i = 0; i < indent; i++)
+		putchar(' ');
+
+	switch (sp->pos) {
+	case TBL_SPAN_HORIZ:
+		putchar('-');
+		putchar(' ');
+		break;
+	case TBL_SPAN_DHORIZ:
+		putchar('=');
+		putchar(' ');
+		break;
+	default:
+		for (cp = sp->layout->first; cp != NULL; cp = cp->next)
+			print_cellt(cp->pos);
+		putchar(' ');
+		for (dp = sp->first; dp; dp = dp->next) {
+			if ((cp = dp->layout) == NULL)
+				putchar('*');
+			else {
+				printf("%d", cp->col);
+				print_cellt(dp->layout->pos);
+				switch (cp->font) {
+				case ESCAPE_FONTROMAN:
+					break;
+				case ESCAPE_FONTBOLD:
+					putchar('b');
+					break;
+				case ESCAPE_FONTITALIC:
+					putchar('i');
+					break;
+				case ESCAPE_FONTBI:
+					fputs("bi", stdout);
+					break;
+				case ESCAPE_FONTCR:
+					putchar('c');
+					break;
+				case ESCAPE_FONTCB:
+					fputs("cb", stdout);
+					break;
+				case ESCAPE_FONTCI:
+					fputs("ci", stdout);
+					break;
+				default:
+					abort();
+				}
+				if (cp->flags & TBL_CELL_TALIGN)
+					putchar('t');
+				if (cp->flags & TBL_CELL_UP)
+					putchar('u');
+				if (cp->flags & TBL_CELL_BALIGN)
+					putchar('d');
+				if (cp->flags & TBL_CELL_WIGN)
+					putchar('z');
+				if (cp->flags & TBL_CELL_EQUAL)
+					putchar('e');
+				if (cp->flags & TBL_CELL_WMAX)
+					putchar('x');
+			}
+			switch (dp->pos) {
+			case TBL_DATA_HORIZ:
+			case TBL_DATA_NHORIZ:
+				putchar('-');
+				break;
+			case TBL_DATA_DHORIZ:
+			case TBL_DATA_NDHORIZ:
+				putchar('=');
+				break;
+			default:
+				putchar(dp->block ? '{' : '[');
+				if (dp->string != NULL)
+					fputs(dp->string, stdout);
+				putchar(dp->block ? '}' : ']');
+				break;
+			}
+			if (dp->hspans)
+				printf(">%d", dp->hspans);
+			if (dp->vspans)
+				printf("v%d", dp->vspans);
+			putchar(' ');
+		}
+		break;
+	}
+	printf("(tbl) %d:1\n", sp->line);
+}

metadata

@@ -0,0 +1,170 @@
+--- !ruby/object:Gem::Specification
+name: mandoc
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- gemmaro
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: This is a mandoc binding for Ruby.  This can parse manpages in mdoc/man
+  formats, get metadata, traverse abstract syntax tree, and convert into some formats.
+email:
+- gemmaro.dev@gmail.com
+executables: []
+extensions:
+- ext/mandoc/extconf.rb
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- COPYING
+- README.md
+- ext/mandoc/extconf.rb
+- ext/mandoc/rb_mandoc.c
+- ext/mandoc/rb_mandoc.h
+- lib/mandoc.rb
+- lib/mandoc/version.rb
+- mandoc-1.14.6/LICENSE
+- mandoc-1.14.6/arch.c
+- mandoc-1.14.6/att.c
+- mandoc-1.14.6/catman.c
+- mandoc-1.14.6/cgi.c
+- mandoc-1.14.6/chars.c
+- mandoc-1.14.6/compat_err.c
+- mandoc-1.14.6/compat_fts.c
+- mandoc-1.14.6/compat_fts.h
+- mandoc-1.14.6/compat_getline.c
+- mandoc-1.14.6/compat_getsubopt.c
+- mandoc-1.14.6/compat_isblank.c
+- mandoc-1.14.6/compat_mkdtemp.c
+- mandoc-1.14.6/compat_mkstemps.c
+- mandoc-1.14.6/compat_ohash.c
+- mandoc-1.14.6/compat_ohash.h
+- mandoc-1.14.6/compat_progname.c
+- mandoc-1.14.6/compat_reallocarray.c
+- mandoc-1.14.6/compat_recallocarray.c
+- mandoc-1.14.6/compat_strcasestr.c
+- mandoc-1.14.6/compat_stringlist.c
+- mandoc-1.14.6/compat_stringlist.h
+- mandoc-1.14.6/compat_strlcat.c
+- mandoc-1.14.6/compat_strlcpy.c
+- mandoc-1.14.6/compat_strndup.c
+- mandoc-1.14.6/compat_strsep.c
+- mandoc-1.14.6/compat_strtonum.c
+- mandoc-1.14.6/compat_vasprintf.c
+- mandoc-1.14.6/config.h
+- mandoc-1.14.6/dba.c
+- mandoc-1.14.6/dba.h
+- mandoc-1.14.6/dba_array.c
+- mandoc-1.14.6/dba_array.h
+- mandoc-1.14.6/dba_read.c
+- mandoc-1.14.6/dba_write.c
+- mandoc-1.14.6/dba_write.h
+- mandoc-1.14.6/dbm.c
+- mandoc-1.14.6/dbm.h
+- mandoc-1.14.6/dbm_map.c
+- mandoc-1.14.6/dbm_map.h
+- mandoc-1.14.6/demandoc.c
+- mandoc-1.14.6/eqn.c
+- mandoc-1.14.6/eqn.h
+- mandoc-1.14.6/eqn_html.c
+- mandoc-1.14.6/eqn_parse.h
+- mandoc-1.14.6/eqn_term.c
+- mandoc-1.14.6/html.c
+- mandoc-1.14.6/html.h
+- mandoc-1.14.6/lib.c
+- mandoc-1.14.6/libman.h
+- mandoc-1.14.6/libmandoc.h
+- mandoc-1.14.6/libmdoc.h
+- mandoc-1.14.6/main.c
+- mandoc-1.14.6/main.h
+- mandoc-1.14.6/man.c
+- mandoc-1.14.6/man.h
+- mandoc-1.14.6/man_html.c
+- mandoc-1.14.6/man_macro.c
+- mandoc-1.14.6/man_term.c
+- mandoc-1.14.6/man_validate.c
+- mandoc-1.14.6/manconf.h
+- mandoc-1.14.6/mandoc.c
+- mandoc-1.14.6/mandoc.h
+- mandoc-1.14.6/mandoc_aux.c
+- mandoc-1.14.6/mandoc_aux.h
+- mandoc-1.14.6/mandoc_msg.c
+- mandoc-1.14.6/mandoc_ohash.c
+- mandoc-1.14.6/mandoc_ohash.h
+- mandoc-1.14.6/mandoc_parse.h
+- mandoc-1.14.6/mandoc_xr.c
+- mandoc-1.14.6/mandoc_xr.h
+- mandoc-1.14.6/mandocd.c
+- mandoc-1.14.6/mandocdb.c
+- mandoc-1.14.6/manpath.c
+- mandoc-1.14.6/mansearch.c
+- mandoc-1.14.6/mansearch.h
+- mandoc-1.14.6/mdoc.c
+- mandoc-1.14.6/mdoc.h
+- mandoc-1.14.6/mdoc_argv.c
+- mandoc-1.14.6/mdoc_html.c
+- mandoc-1.14.6/mdoc_macro.c
+- mandoc-1.14.6/mdoc_man.c
+- mandoc-1.14.6/mdoc_markdown.c
+- mandoc-1.14.6/mdoc_state.c
+- mandoc-1.14.6/mdoc_term.c
+- mandoc-1.14.6/mdoc_validate.c
+- mandoc-1.14.6/msec.c
+- mandoc-1.14.6/out.c
+- mandoc-1.14.6/out.h
+- mandoc-1.14.6/preconv.c
+- mandoc-1.14.6/read.c
+- mandoc-1.14.6/roff.c
+- mandoc-1.14.6/roff.h
+- mandoc-1.14.6/roff_html.c
+- mandoc-1.14.6/roff_int.h
+- mandoc-1.14.6/roff_term.c
+- mandoc-1.14.6/roff_validate.c
+- mandoc-1.14.6/soelim.c
+- mandoc-1.14.6/st.c
+- mandoc-1.14.6/tag.c
+- mandoc-1.14.6/tag.h
+- mandoc-1.14.6/tbl.c
+- mandoc-1.14.6/tbl.h
+- mandoc-1.14.6/tbl_data.c
+- mandoc-1.14.6/tbl_html.c
+- mandoc-1.14.6/tbl_int.h
+- mandoc-1.14.6/tbl_layout.c
+- mandoc-1.14.6/tbl_opts.c
+- mandoc-1.14.6/tbl_parse.h
+- mandoc-1.14.6/tbl_term.c
+- mandoc-1.14.6/term.c
+- mandoc-1.14.6/term.h
+- mandoc-1.14.6/term_ascii.c
+- mandoc-1.14.6/term_ps.c
+- mandoc-1.14.6/term_tab.c
+- mandoc-1.14.6/term_tag.c
+- mandoc-1.14.6/term_tag.h
+- mandoc-1.14.6/tree.c
+homepage: https://codeberg.org/gemmaro/ruby-mandoc
+licenses:
+- GPL-3.0-or-later
+metadata:
+  homepage_uri: https://codeberg.org/gemmaro/ruby-mandoc
+  source_code_uri: https://codeberg.org/gemmaro/ruby-mandoc.git
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: mdoc/man parsing library
+test_files: []