Commit: e25e11c6770a3d7a2e98cbcfce66dbffd7d8b5a0 - groff-psbb (git)

Demonstration of groff .psbb request handling code, for EPS and PDF input files

Commit MetaInfo

• Revisão: e25e11c6770a3d7a2e98cbcfce66dbffd7d8b5a0 (tree)
• Hora: 2017-10-17 06:06:35
• Autor: Keith Marshall <keith@user...>
• Commiter: Keith Marshall

Mensagem de Log

Add lexer state mapping for debugging trace logs.

* GNUmakefile (all): New default goal; it amalgamates...
(state.map): ...this new sed filter file target, along with...
(psbb): ...this original target, as default primary build goals.
(psbblex.map, psbblex.map.ls, psbblex.map.lx, psbblex.state.map)
(psbblex.map.l): New intermediate goals; in conjunction with...
(STATE_MAP_SCRIPT): ...this new macro, they are required to
facilitate the building of the final state.map target.
(vpath) [%.in, %.map]: Add $srcdir references.

* psbblex.map.in: New template file, for psbblex.map.l

Mudança Sumário

• modified: GNUmakefile
• add: psbblex.map.in

Diff

--- a/GNUmakefile
+++ b/GNUmakefile
@@ -21,7 +21,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 #
-psbb:
+all: psbb state.map
 
 srcdir = .
 vpath %.l  ${srcdir}
@@ -68,6 +68,37 @@ psbblex.o: psbblex.c psbb.tab.h psbb.h
 t-psbb.o psbblex.o psbb.tab.o error.o errarg.o: error.h errarg.h
 t-psbb.o: psbb.h
 
+
+# Rules to derive, from psbblex.l source, a sed filter for mapping
+# of lexer state values, as they appear in debugging trace log files,
+# back to their original state names.
+#
+vpath %.in   ${srcdir}
+vpath %.map  ${srcdir}
+
+state.map: psbblex.l psbblex.map.in
+	$(MAKE) --no-print-directory psbblex.$@
+	mv psbblex.$@ $@
+
+%.state.map: %.l %.map.in
+	$(MAKE) --no-print-directory $*.map
+	echo "#! $(shell which sed) -f" > $@
+	./$*.map >> $@ && chmod 755 $@
+	$(RM) $*.map
+
+%.map.lx: %.l
+	sed -n -e '/^%x/{s/  */\n%x /g' -e 's/^%x\n//p' -e '}' $^ > $@
+
+%.map.ls: %.map.lx
+	sed -e 's/ *%x */  SHOW(/' -e 's/$$/);/' $< > $@
+
+%.map.l: %.map.in %.map.ls
+	sed $(STATE_MAP_SCRIPT) $< > $@
+
+STATE_MAP_SCRIPT = -e '/@LEXER_STATE_MAP@/{r $@x' -e d -e '}' \
+  -e '/@SED_FILTER_RULES@/{r $@s' -e d -e '}'
+
+
 # Clean up rules
 #
 clean:; $(RM) *.o psbb

--- /dev/null
+++ b/psbblex.map.in
@@ -0,0 +1,55 @@
+/* psbblex.map.in
+ *
+ * A simplified lexical analyser template, derived from psbblex.l, whence
+ * a state mapping filter for debugging trace logs may be created.
+ *
+ * Written by Keith Marshall <[e-mail]>
+ * Copyright (C) 2017, Free Software Foundation, Inc.
+ *
+ * This file is part of groff.
+ *
+ * groff is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License as published by the Free
+ * Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * groff is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ *
+ * The following lexer state mapping template is substituted at build time
+ * by the complete set of state declarations, in order, which is abstracted
+ * from psbblex.l itself.
+ *
+ */
+@LEXER_STATE_MAP@
+%option noyywrap
+
+%%
+ /* A minimal pattern rule set, for the INITIAL state only; this
+  * makes yylex() a no-op, and is never actually used.
+  */
+.|\n		|
+<<EOF>> 	{ return 0; }
+%%
+#include <stdio.h>
+
+/* Macro, representing a sed filter rule to map a single lexer state.
+ */
+#define SHOW(STATE)  printf( "s/^%d:/& %s:/\n", STATE, #STATE )
+
+int main()
+{ /* The preceding macro is substituted here, at build time, once for
+   * each lexer state, to generate the complete set state mapping sed
+   * filter rules.
+   */
+  @SED_FILTER_RULES@
+  return 0;
+}
+
+/* vim: set ft=lex cin fo=croqj: */