groff-psbb

Fork

Clean state map generator files.

* GNUmakefile (clean): Augment commands to remove files...
[*.map]: ...matching this glob reference.

Correctly handle lexical scans of nested PDF dictionaries.

* psbblex.l [PDFDICT] ("<<"): Add missing pattern rule; it causes a
recursive push of the nested dictionary scanning state.

Report PDF context when tracing lexer state pushes.

* psbblex.l [DEBUG] (DEBUG_PUSH_STATE): Redefine in terms of...
(DEBUG_PUSH_NAMED_STATE): ...this new macro; it is also used by...
(DEBUG_PUSH_KEY_STATE): ...this further new macro; use it instead of
DEBUG_PUSH_STATE, to report PDF context at change of lexer state.

Extend debugging diagnostics to report popped lexer state.

* psbblex.l (DEBUG_POP_STATE): New macro; define, and use it
as a debug-enabled diagnostic wrapper, in place of...
(yy_pop_state): ...this.

Simplify building with debugging diagnostics enabled.

* psbblex.l [DEBUG || DEBUGGING || EBUG || EBUGGING]: Accept...
[-D DEBUG, -D DEBUGGING, -DEBUG, -DEBUGGING]: ...as equivalents, when
specified as compile-time options.

* GNUmakefile (all): Remove dependency on...
(state.map): ...build of this, but preserve it within...
(all-debug): ...this new target; it reproduces original "all", and...
(CPPFLAGS) [-DEBUG]: ...adds this compile-time option.

Provide a prototype for the yylex() replacement function.

* psbb.h (psbb_lex): Declare prototype.

Avoid use of yacc-incompatible bison directives.

* psbb.y (%name-prefix): Directive is bison-specific; delete, and...
* GNUmakefile (YFLAGS): ...append corresponding '-p' assignment.

Ignore ".map" files in source directory.

* .hgignore: Remove this unneeded file; delegate to...
* .gitignore: ...this; it is sufficient, when using hg-git.
(*.map): Add glob reference.

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

Add support for out-of-source builds.

* GNUmakefile (srcdir): Define it; default is "."
(vpath) [%.l, %.y]: Locate them, by reference to $srcdir
(vpath) [%.c, %.cpp, %.h]: Locate them in $srcdir, or $srcdir/libgroff
(CPPFLAGS): Incrementally add $srcdir and $srcdir/libgroff includes.
(CFLAGS, CXXFLAGS): Remove include path specifications.

Improve lexer suppression of unmatched content.

* psbblex.l (PDFIGNORE): Actively discard end-of-line markers; revert
to prior state, when detected. Identify dictionary start markers, and
handle by pushing a subsidiary change of lexer state, to...
(PDFDICT): ...this, to ensure properly nested handling, otherwise...
(PDFIGNORE): ...stop at [</>] characters; leave in input queue, and
revert to prior state.

Avoid a potential PDFSCANOBJECT lexer overrun.

* psbblex.l: Do not allow the lexer to remain in...
(PDFOBJTYPE): ...this state, when object type is unrecognized, and...
[DEBUGGING]: ...log any unrecognized object type name.

Add DEBUGGING mode "next object" reference logging.

* psbblex.l (PDFSCANOBJECT): Add DEBUG_MSG request, to report the...
(PDFENDOBJ) [DEBUGGING]: ...next object to be scanned, after this.

Add more comprehensive DEBUGGING mode lexer trace logging.

* psbblex.l (RETURN_VALUE): New macro, expanded in terms of...
(DEBUG_RETURN_VALUE) [DEBUGGING]: ...this, replacing RETURN(VALUE), to
include the associated yylval result in the token return log message.
(DEBUG_PUSH_STATE) [DEBUGGING]: New macro; it logs the change of lexer
state, when used to wrap calls to yy_push_state().

Support postfix notation for PDFOBJREF parsing.

* psbb.y (psbb): Add an additional grammar rule, to interpret...
(VALUE VALUE 'R' PDFOBJREF): ...this token sequence, augmenting...
(PDFOBJREF VALUE VALUE 'R'): ...this prefix notation.

Keep optional subdirectories out of SCM control.

* .gitignore .hgignore (dist, build): Add directory references.

Include GPL licence document, for distribution.

* GPL.v3: New file; it is a verbatim copy of groff's COPYING file.

Implement an extended .psbb request handling API.

* psbb.h psbb.y psbblex.l: New files; they implement the API.
* t-psbb.cpp: New file; it implements a test program, emulating the
intended gtroff usage of this API.

* GNUmakefile: New file; it facilitates building the test program,
using GNU make.

* README .gitignore .hgignore: New files.

Add a printf-alike API entry for libgroff error reporting.

* libgroff/error.h (errprintf): New function; add prototype.
* libgroff/error.cpp (do_error_with_file_and_line): Factor out...
(report_file_and_line, end_error_with_file_and_line): ...this pair of
initial and final fragments, respectively; incorporate them with...
(do_printf_with_file_and_line): ...this new function; hence...
(do_printf, errprintf): ...implement these.

Initial import of original libgroff.a code.

* libgroff/error.h libgroff/error.cpp libgroff/fatal.cpp
* libgroff/errarg.h libgroff/errarg.cpp libgroff/itoa.c: New files;
all are copied verbatim, from the GNU Troff source code repository.
* libgroff/README: New file.