-2010-12-31 Werner LEMBERG <wl@gnu.org>
+2023-06-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-Version 1.21 released
-=====================
+ [ms]: Offer advice to users of PDF who want a table of contents
+ at the front of the document.
- * NEWS, REVISION, VERSION, doc/groff.texinfo, doc/webpage.ms: Updated.
- * aclocal.m4, configure: Regenerated.
+ * doc/groff.texi (ms Document Structure): Move mention of
+ pdfjam(1) from here...
+ (ms TOC): ...to here, and identify alternatives, including
+ gropdf(1)'s `pdfswitchtopage` macro.
-2010-12-31 Werner LEMBERG <wl@gnu.org>
+ * doc/ms.ms (General structure of an ms document):
+ (Creating a table of contents): Similar.
- * doc/webpage.ms: Updated.
+ Fixes <https://savannah.gnu.org/bugs/?64278>. Thanks to MichaĆ
+ Kruszewski for the report.
-2010-12-31 Werner LEMBERG <wl@gnu.org>
+2023-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure: Regenerate with autoconf 2.67.
+ [docs]: Migrate terminology to "scaling unit".
-2010-12-31 Werner LEMBERG <wl@gnu.org>
+ ...from "scaling indicator".
- Update various scripts.
+ Fixes <https://savannah.gnu.org/bugs/?60957>. Thanks to Ingo
+ Schwarze for the discussion.
- * config.guess, config.sub: Update from `config' repository.
- * install-sh, mkinstalldirs: Update from `gnulib' repository.
+2023-05-29 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-12-31 Werner LEMBERG <wl@gnu.org>
+ [docs]: Revise discussion of fonts.
- Update texinfo.tex.
+ * doc/groff.texi:
+ - Rename node/section "Fonts and Symbols" to "Using Fonts". Add
+ giant new introduction, properly establishing terminology.
+ - Rename node/section "Changing Fonts" to "Selecting Fonts".
+ Shift location of `.fn` and `.sty` register documentation.
+ Rewrite presentation of `ft` and `\f`. Discuss typeface
+ selection by mounting position and font (or style) name
+ together; since arguments to these formatter instructions are
+ always interpreted as mounting positions first, it doesn't
+ make much sense to me to present them separately, and the new
+ introduction provides the necessary background. Tighten
+ example. Document that current and previous font selections
+ are environment properties.
+ - Add several concept index entries.
+ - Do more migration from "symbol" and "glyph" names to "special
+ character" names.
- * doc/texinfo.tex: Update von `texinfo' repository.
+ * man/groff.7 (Using fonts): Introduce new section, synced with
+ the renamed node from our Texinfo manual above.
-2010-12-30 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?62973>.
- Call texi2dvi with correct makeinfo binary.
+2023-05-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/Makefile.in (.texinfo.dvi, .texinfo.pdf): Use $(MAKEINFO).
+ [docs]: Revise "Page Layout" material.
-2010-12-30 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi:
+ - Recast generally.
+ - Describe behavior of `pl` in more detail.
+ - Migrate terminology from "scaling indicator" to "scaling
+ unit".
+ - Stop discussing page margins in the context of the `pl`
+ request.
+ - Move concept index entries regarding margins from here to
+ "Traps".
+ - Move discussion of `pn` request to precede `tl` request.
+ - Add concept index entries.
+ - Recast description of `tl` request. Migrate terminology from
+ "justification" to "alignment".
+ - Recast description of `lt` request. Describe behavior in more
+ detail.
+ - Recast description of `pc` request.
+ - Add example of `lt` and `tl` usage. Add forward reference to
+ "Traps", mentioning page header and footer traps.
- Documentation updates.
+ Fixes <https://savannah.gnu.org/bugs/?55124>. Thanks to Dave
+ Kemper for the report.
- * NEWS, PROBLEMS, MANIFEST: Update.
+2023-05-22 Dave Kemper <saint.snit@gmail.com>
-2010-12-26 Werner LEMBERG <wl@gnu.org>
+ [docs]: Correct minor punctuation, grammar, and spelling issues.
- Speed up troff.
+ Also remove a couple instances of unnecessarily telling the
+ reader to note something.
- * src/include/ptable.h (PTABLE): Make hash tables much more sparse
- by changing the ratio `FULL_NUM/FULL_DEN' from 2/3 to 1/4. This
- increases the allocated memory by about 200kByte (which is nothing
- today) but assures that there aren't extremely long searches for a
- free hash slot in case that the hash function doesn't return a free
- one. Due to the nature of the entries in uniuni.cpp, the used hash
- function in ptable.cpp is not optimal, but using a sparse array
- compensates this.
+ * doc/groff.texi:
+ * man/groff.7.man:
+ * man/groff_char.7.man:
+ * man/groff_diff.7.man:
+ * man/roff.7.man:
+ * src/roff/nroff/nroff.1.man: Do it.
-2010-12-20 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?64230>. [I threw in a few
+ more fixes. --GBR]
- Replace patch from 2010-12-18 with a much faster implementation.
+2023-04-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/node.h (node): Add virtual function
- `get_break_code'.
+ [docs]: Attempt to further clarify end-of-sentence detection.
- * src/roff/troff/node.cpp (inter_char_space_node): Remove class
- completely.
- (glyph_node::merge_glyph_node): Restore previous version.
+ * doc/groff.texi (Sentences):
+ * man/roff.7 (Concepts): Do it.
- (break_char_node): Add `prev_break_code' field and update
- constructors.
- (node::get_break_code, break_char_node::get_break_code): Implement.
+ Fixes <https://savannah.gnu.org/bugs/?64091>. Thanks to Ingo
+ Schwarze and Dave Kemper for the report.
- (node::add_char): Pass remaining cflags values.
+2023-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- (break_char_node::add_self): Use the logic of the now deleted
- `inter_char_space_node::add_self' function to insert a space node if
- necessary.
+ [docs]: Minimally document `tag`, `taga` requests.
-2010-12-20 Daiki Ueno <ueno@unixuser.org>
+ * doc/groff.texi (Postprocessor Access):
+ * man/groff.7 (Request short reference): Do it.
- A new try to not changing srcdir if building in separate builddir.
+ Fixes <https://savannah.gnu.org/bugs/?62695>.
- Makefile.in ($GNULIBDIRS): Disable calls to autoconf and friends.
+2023-04-11 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-12-20 Werner LEMBERG <wl@gnu.org>
+ [docs]: Fix typos.
- Speed up access to cflags values.
+ * doc/groff.texi (ms basic information):
+ * doc/ms.ms (Basic information): Do it.
- We now recompute the cflags values for all charinfo objects if
- `.class' has been called.
+ Fixes <https://savannah.gnu.org/bugs/?64032>. Thanks to an
+ anonymous reporter.
- * src/roff/troff/charinfo.h: Add external references to `class_flag'
- and `get_flags'.
- (charinfo): `get_flags' no longer has a return value.
- (charinfo::overlaps_horizontally, charinfo::overlaps_vertically,
- charinfo::can_break_before, charinfo::can_break_after,
- charinfo::can_break_after, charinfo::ends_sentence,
- charinfo::transparent,, charinfo:ignore_hcodes,
- charinfo::prohibit_break_before, charinfo::prohibit_break_after,
- charinfo::inter_char_space): Call global `get_flags' only if
- necessary.
- (charinfo::add_to_class): Set `class_flag'.
+2023-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (class_flag): New global flag.
- (charinfo::charinfo): Call `get_flags' member function.
- (get_flags): New global function which iterates over all entries in
- the charinfo dictionary.
- (charinfo::get_flags): Set `flags' directly.
+ * doc/groff.texi (Operators in Conditionals):
+ * man/groff.7.in (Conditional expressions): Clarify how the
+ output comparison operator is recognized.
-2010-12-19 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?63812>. Thanks to John
+ Gardner for the report.
- Protect `.class' against cyclic nesting.
+2023-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/charinfo.h (charinfo::contains): Add optional
- boolean argument.
- * src/roff/troff/input.cpp (define_class, charinfo::contains): Check
- for cyclic nesting.
+ Use a better type for symbol hashes.
-2010-12-18 Werner LEMBERG <wl@gnu.org>
+ * bootstrap.conf: Add "stdint" module to ensure that the
+ `uintptr_t` type is available.
+ * src/include/symbol.h: Include <stdint.h> for `uintptr_t`.
+ (class symbol):
+ (symbol::hash): Change return type from `unsigned long`, which
+ causes build failures on 64-bit MinGW, to `uintptr_t`.
+ (symbol::hash): Use a C++ type cast, not a C-style one.
- Improve CJK support with new values for `.cflags'.
+ Thanks to Bruno Haible for reporting the build failure in the
+ 64-bit MinGW environment, and for suggesting a remedy.
- This patch introduces three new values to `.cflags':
+2023-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- don't break before character: 128
- don't break after character: 256
- allow inter-character break: 512
+ [groff]: Revise a test to be more revealing.
- They are handled differently if compared to other cflags values:
+ * src/roff/groff/tests/initialization_is_quiet.sh: Stop using
+ "set -e". Instead use `fail` variable and `wail` function (and
+ lowercase names for our internal variables) like many of our
+ other tests. If the "unset" shell built-in fails, skip the
+ test (prompted by /usr/xpg4/bin/sh on Solaris). Attempt every
+ groff locale, with and without compatibility mode initially
+ enabled, instead of stopping at the first failure. Report
+ standard error and standard output content separately. Use
+ groff's `-a` flag to prepare the standard output, for
+ readability.
+ * PROBLEMS: Document that this test might be skipped rather than
+ failing on Solaris. (What actually happens depends on which
+ shell you run it with, and we advise a variety of approaches.)
- (1) hcode values are completely ignored
- (2) similar to kern values, and contrary to the other cflags
- values, troff looks at pairs of characters to decide whether a
- break gets inserted
+ Thanks to Bruno Haible for feedback regarding mysterious
+ failures of this test on GNU/Hurd and NetBSD systems.
- A yet-to-be-written patch should add inter-character spacing if
- those flags are active; currently, only zero-width breakpoints are
- inserted.
+2023-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/charinfo.h (charinfo): Change type of `flags' to
- `int'. Update callers accordingly.
- New enum values `DONT_BREAK_BEFORE', `DONT_BREAK_AFTER', and
- `INTER_CHAR_SPACE'.
- New member functions `prohibit_break_before',
- `prohibit_break_after', and `inter_char_space'.
- * src/roff/troff/input.cpp: Updated.
+ * bootstrap.conf (gnulib_modules): Add "stdbool-c99" per
+ recommendation from Bruno Haible.
- * src/roff/troff/node.cpp (inter_char_space_node): New class similar
- to kern_pair_node, collecting charinfo entities with the
- abovementioned cflags values.
- (break_char_type): Add new enum values.
- (glyph_node::merge_glyph_node): Handle abovementioned cflags values
- and emit an `inter_char_space_node' if necessary.
+ Fixes build problem on Solaris using Sun compiler.
- * tmac/ja.tmac: Use new cflags values.
+2023-03-06 Bruno Haible <bruno@clisp.org>
- * doc/groff.texinfo, NEWS, man/groff_diff.man: Document new values.
+ * Makefile.am (AR): Remove hardcoded value. Let Automake use the
+ value from config.status.
-2010-12-18 Werner LEMBERG <wl@gnu.org>
+ {Fixes build problem on 64-bit AIX. Problem appears to date
+ back to commit 5fec19d453, 2014-08-15. --GBR}
- Remove compiler warning.
+2023-03-06 Bruno Haible <bruno@clisp.org>
- * src/libs/libgroff/relocate.cpp (msw2posixpath): Remove redundant
- dereferencing.
+ * arch/misc/misc.am (shdeps.sed): Rename target from this...
+ ($(SH_DEPS_SED_SCRIPT)): ...to this, to work better with make(1)
+ on FreeBSD, NetBSD, and AIX.
-2010-12-16 Daiki Ueno <ueno@unixuser.org>
+2023-03-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- Don't change srcdir if building in a separate builddir.
+ [build]: Discard now-unneeded Autoconf macro and variables.
- * Makefile.in ($GNULIBDIRS): Copy configuring stuff of gnulib if
- necessary.
+ * configure.ac: Stop calling `GROFF_POPPLER`. Stop populating
+ the Automake conditional `HAVE_PDFTOOLS`. Eliminate chatter
+ about their availability in the configuration report.
+ * m4/groff.m4 (GROFF_POPPLER): Delete.
-2010-12-15 Werner LEMBERG <wl@gnu.org>
+2023-03-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- Fix compilation problem.
+ * m4/groff.m4 (GROFF_URW_FONTS_NOTICE): Adapt wording of notice
+ to presence and identity of Ghostscript interpreter command.
+ Clarify that it is gropdf(1) specifically that traverses the
+ Ghostscript search path reported by its "-h" option.
- This issue happens with gcc 4.2.4.
+ Continues <https://savannah.gnu.org/bugs/?63808>. Thanks to
+ Deri James for the ongoing discussion.
- * src/roff/troff/node.cpp (node::~node): Move to...
- * src/roff/troff/node.h: Here. This ensures that the inline
- member function is publicly visible.
+2023-02-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-12-15 Werner LEMBERG <wl@gnu.org>
+ [devpdf]: Revise tests.
- Remove unused code.
+ * font/devpdf/tests/check-default-foundry.sh.in: Test only the
+ base 14 fonts of the PDF standard unconditionally. Test the
+ remainder from the set of 35 commonly distributed only if a
+ Ghostscript interpreter was detected at configuration time,
+ because the latter fonts _must_ be embedded in PDF documents.
+ If they're not present, skip the test rather than failing it.
+ * font/devpdf/tests/check-urw-foundry.sh.in: Skip test if no URW
+ fonts detected at configuration time, rather than failing it.
+ * m4/groff.m4 (GROFF_GROPDF_PROGRAM_NOTICE)
+ (GROFF_URW_FONTS_NOTICE): Drop warnings of expected test
+ failures. The tests no longer fail in the anticipated
+ circumstances.
- * src/roff/troff/node.cpp, src/roff/troff/node.h
- (space_node::space_node): Remove unused constructor.
+2023-02-24 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-12-15 Werner LEMBERG <wl@gnu.org>
+ [devpdf]: Generate tests from template files, so we can populate
+ the test scripts with information determined at configuration.
+ The default foundry test depends on $GHOSTSCRIPT, and the URW
+ foundry test on $urwfontsdir.
- Use enum to increase readability.
+ * font/devpdf/tests/check-default-foundry.sh:
+ * font/devpdf/tests/check-urw-foundry.sh: Rename these...
+ * font/devpdf/tests/check-default-foundry.sh.in:
+ * font/devpdf/tests/check-urw-foundry.sh.in: ...to these.
- * src/roff/troff/node.cpp (break_char_type): New enum.
- (break_char_node::add_self, node::add_char): Use it.
+ * font/devpdf/devpdf.am (font_devpdf_default_test)
+ (font_devpdf_urw_test): New variables store names of generated
+ test scripts.
+ (font/devpdf/tests/check-default-foundry.sh):
+ (font/devpdf/tests/check-urw-foundry.sh): New targets produce
+ test scripts from corresponding .in files.
-2010-12-13 Daiki Ueno <ueno@unixuser.org>
- Werner LEMBERG <wl@gnu.org>
+2023-02-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add wide character support to grotty.
+ [devpdf]: Trivially refactor. Rename sed-substitutum [Lat.]
+ from "@GROFF_GHOSTSCRIPT_INTERPRETERS@" to "@GHOSTSCRIPT@" for
+ clarity and brevity; this is a scalar value containing the
+ Autoconf-determined name of the Ghostscript interpreter. It is
+ not the same as the replacement that occurs in contrib/pdfmark.
- This is a huge patch, mainly by adding the gnulib infrastructure in
- a separate directory tree (in `src/libs/gnulib/lib') for its
- `wcwidth' module. However, the actual changes to native groff
- source files are just a few lines.
+ * font/devpdf/devpdf.am:
+ * font/devpdf/util/BuildFoundries.pl: Do it.
- * Makefile.comm (INCLUDES): Updated.
- (LIBGNU): Define.
+2023-02-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in (NOMAKEDIRS): Updated.
- (GNULLIBDIRS): Define.
- (DISTDIRS): Add GNULLIBDIRS.
- ($LIBDIRS): Depend on GNULLIBDIRS.
- ($GNULLIBDIRS): New target.
+ [build]: Stop scraping output of Ghostscript executable with
+ "-h" option to attempt to find URW fonts. Fonts that ship with
+ Ghostscript are regarded as the "default" foundry, not the URW
+ foundry (though they often ultimately originate with URW fonts).
+ They are often missing Adobe Font Metric (AFM) files, so it is
+ impossible for groff to generate font description files for them
+ at build time.
- * src/libs/libgroff/font.cpp (font::get_width, font::load)
- [is_unicode]: Use `wcwidth'.
+ * m4/groff.m4 (GROFF_URW_FONTS_CHECK): Drop `AC_REQUIRE` on
+ `GROFF_AWK_PATH`. Drop awk-based scraping of Ghostscript "-h"
+ output. Annotate need for sync between this list of
+ characteristic font file names and the one in BuildFoundries.
- * src/roff/troff/Makefile.sub (XLIBS): Add LIBGNU.
- * src/roff/troff/input.cpp (main): Set LC_CTYPE.
+ Thanks to Deri James for the ongoing discussions.
- * src/devices/grotty/Makefile.sub (XLIBS): Add LIBGNU.
- * src/devices/grotty/tty.cpp (main): Set LC_CTYPE.
+2023-02-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/gnulib/*: New files. The import was done as follows:
+ * configure.ac: Drop now-redundant explicit
+ `GROFF_URW_FONTS_CHECK`. `GROFF_GROPDF_DEPENDENCIES_CHECK`
+ `AC_REQUIRE`s it as of commit ec001d2a23, 18 February.
- . Call
+2023-02-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- gnulib-tool --create-testdir \
- --dir=src/libs/gnulib \
- wcwidth
+ * m4/groff.m4 (GROFF_URW_FONTS_CHECK): When looking for a
+ characteristic URW font by its file name, also check for
+ "URWGothic-Book" with no file extension. Avoids false negatives
+ in URW Type 1 font detection when using Ghostscript 9.53.3.
+ Thanks to Deri James for suggesting the test procedure that
+ uncovered this flaw.
- to get a testbed.
+2023-02-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- . Manually move directories src/libs/gl{lib,m4} to
- src/libs/{lib,m4}, and do s/gllib/lib/ and s/glm4/m4/ everywhere
- to `convert' the gnulib testbed to a standard gnulib
- configuration as maintained by gnulib-tool.
+ * Makefile.am (uninstall_groffdirs): Remove "html.mono" and
+ "html.node" directories corresponding to HTML version of our
+ Texinfo manual.
+ * doc/doc.am (uninstall-html): Uninstall HTML version of our
+ Texinfo manual more reliably.
- . Call
+ Fixes a regression introduced by me in commit c2698aade, 6 April
+ {my claim "we're only deleting files with this command, not
+ directories" was not correct}.
- gnulib-tool --add-import \
- --dir=src/libs/gnulib \
- wcwidth
+2023-02-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- to update everything.
+ [doc]: Handle output formats of our Texinfo manual more
+ consistently.
-2010-12-13 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am (install-doc): Add dependency on (Automake
+ standard) target 'install-dvi'.
+ (maintainer-clean-local): Remove our Texinfo manual in plain
+ text format.
+ (install-data-local): Add dependency on new target
+ 'install-txt'.
+ (install-txt): Install our Texinfo manual in plain text format.
+ (uninstall-local): Add dependency on new target 'uninstall-txt'.
+ (uninstall-txt): Uninstall our Texinfo manual in plain text
+ format.
+
+ Thanks to T. Kurt Bond for noticing the discrepancy.
- `.class' must not emit empty lines.
+2023-02-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (define_class): Add missing `skip_line'
- calls.
+ * doc/doc.am (install-pdf-local, install-html-local): Enable
+ rules to work in out-of-tree builds.
+
+2023-02-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am (uninstall-hook): Drop dependency on
+ "uninstall_mom"; this is not the appropriate place to declare
+ it, and "uninstall_groffdirs" already depends on it in mom's
+ Automake file.
+
+2023-02-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Have more tests report output.
+
+ * src/roff/groff/tests/ab_works.sh:
+ * src/roff/groff/tests/handle_special_input_code_points.sh:
+ * src/roff/groff/tests/initialization_is_quiet.sh:
+ * src/roff/groff/tests/msoquiet_works.sh:
+ * src/roff/groff/tests/soquiet_works.sh:
+ * tmac/tests/an-ext_MR-works.sh:
+ * tmac/tests/an_MR-works.sh: Do it.
+
+2023-02-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Prevent failures when $GROFF_ENCODING is set.
+
+ * src/roff/groff/tests/ab_works.sh:
+ * src/roff/groff/tests/handle_special_input_code_points.sh:
+ * src/roff/groff/tests/initialization_is_quiet.sh:
+ * src/roff/groff/tests/msoquiet_works.sh:
+ * src/roff/groff/tests/soquiet_works.sh:
+ * tmac/tests/an-ext_MR-works.sh:
+ * tmac/tests/an_MR-works.sh:
+ * tmac/tests/an_font-remapping-does-not-affect-titles.sh: Unset
+ $GROFF_ENCODING before running test because preconv(1) confounds
+ these tests.
+
+ Thanks to Alexis for reporting this problem.
+
+2023-02-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Rename test.
+
+ * tmac/tests/s_no-excess-space-around-displays.tmac: Rename...
+ * tmac/tests/s_no-excess-space-around-displays.sh: ...to this.
+ * tmac/tmac.am (tmac_TESTS): Update.
+
+2023-02-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [gropdf]: Revise tests to run unconditionally, rather than
+ configuring them away at build time, which can cause a
+ distribution archive to be incorrectly structured. Update
+ configuration notices when optional dependencies are absent.
+
+ * font/devpdf/devpdf.am (font_devpdf_TESTS): Remove `USE_GROPDF`
+ and `HAVE_URW_FONTS` conditionals.
+ * m4/groff.m4 (GROFF_GROPDF_PROGRAM_NOTICE):
+ (GROFF_URW_FONTS_NOTICE): Warn reader that a gropdf test failure
+ is to be expected.
+
+ Fixes <https://savannah.gnu.org/bugs/?63824> (2/2).
+
+2023-02-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Revise tests to check for requisite programs at test
+ time and skip if not found, rather than configuring them away at
+ build time, which can cause a distribution archive to be
+ incorrectly structured.
+
+ * m4/groff.m4: Annotate requisite program list since we're
+ violating the DRY principle.
+ * src/roff/groff/groff.am (groff_TESTS): Populate
+ unconditionally.
+
+ * src/roff/groff/tests/html_works_with_grn_and_eqn.sh:
+ * src/roff/groff/tests/smoke-test_html_device.sh: Check for
+ requisite programs and skip test if any are not found.
+
+ Fixes <https://savannah.gnu.org/bugs/?63824> (1/2).
+
+2023-02-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man pages]: Define page-local `MR` fallback.
+
+ [man pages]: Provide page-local fallback definition of new `MR`
+ macro. I didn't think I was going to have to do this, but the
+ premier site on the web for viewing Linux man pages, Michael
+ Kerrisk's man7.org, has been pulling snapshots of the pages
+ themselves without upgrading the underlying macros, and so man
+ page cross references set with `MR` are getting lost in its
+ presentations. (I acknowledge: Ingo Schwarze warned me
+ something like this could happen.) This definition is intended
+ as a stopgap measure only. I want to revert this after groff
+ 1.23 is released and has spread to some reasonable degree.
+
+ * contrib/chem/chem.1.man:
+ * contrib/eqn2graph/eqn2graph.1.man:
+ * contrib/gdiffmk/gdiffmk.1.man:
+ * contrib/glilypond/glilypond.1.man:
+ * contrib/gperl/gperl.1.man:
+ * contrib/gpinyin/gpinyin.1.man:
+ * contrib/grap2graph/grap2graph.1.man:
+ * contrib/hdtbl/groff_hdtbl.7.man:
+ * contrib/mm/groff_mm.7.man:
+ * contrib/mm/groff_mmse.7.man:
+ * contrib/mm/mmroff.1.man:
+ * contrib/mom/groff_mom.7.man:
+ * contrib/pdfmark/pdfroff.1.man:
+ * contrib/pic2graph/pic2graph.1.man:
+ * contrib/rfc1345/groff_rfc1345.7.man:
+ * man/groff.7.man:
+ * man/groff_char.7.man:
+ * man/groff_diff.7.man:
+ * man/groff_font.5.man:
+ * man/groff_out.5.man:
+ * man/groff_tmac.5.man:
+ * man/roff.7.man:
+ * src/devices/grodvi/grodvi.1.man:
+ * src/devices/grohtml/grohtml.1.man:
+ * src/devices/grolbp/grolbp.1.man:
+ * src/devices/grolj4/grolj4.1.man:
+ * src/devices/gropdf/gropdf.1.man:
+ * src/devices/gropdf/pdfmom.1.man:
+ * src/devices/grops/grops.1.man:
+ * src/devices/grotty/grotty.1.man:
+ * src/devices/xditview/gxditview.1.man:
+ * src/preproc/eqn/eqn.1.man:
+ * src/preproc/eqn/neqn.1.man:
+ * src/preproc/grn/grn.1.man:
+ * src/preproc/pic/pic.1.man:
+ * src/preproc/preconv/preconv.1.man:
+ * src/preproc/refer/refer.1.man:
+ * src/preproc/soelim/soelim.1.man:
+ * src/preproc/tbl/tbl.1.man:
+ * src/roff/groff/groff.1.man:
+ * src/roff/nroff/nroff.1.man:
+ * src/roff/troff/troff.1.man:
+ * src/utils/addftinfo/addftinfo.1.man:
+ * src/utils/afmtodit/afmtodit.1.man:
+ * src/utils/grog/grog.1.man:
+ * src/utils/hpftodit/hpftodit.1.man:
+ * src/utils/indxbib/indxbib.1.man:
+ * src/utils/lkbib/lkbib.1.man:
+ * src/utils/lookbib/lookbib.1.man:
+ * src/utils/pfbtops/pfbtops.1.man:
+ * src/utils/tfmtodit/tfmtodit.1.man:
+ * src/utils/xtotroff/xtotroff.1.man:
+ * tmac/groff_man.7.man.in:
+ * tmac/groff_me.7.man:
+ * tmac/groff_ms.7.man:
+ * tmac/groff_trace.7.man:
+ * tmac/groff_www.7.man: Do it.
+
+ Fixes <https://savannah.gnu.org/bugs/?63825>. Thanks greatly to
+ Alexis for identifying an issue with mandoc(1)'s handling of an
+ earlier iteration of this fallback, and to John Gardner for
+ identifying a method of detecting mandoc as the renderer at
+ formatting time.
+
+2023-02-20 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Improve
+ portability of script by using shell constructs instead of the
+ nonstandard GNU coreutils 'seq' utility. Resolves test failure
+ on Solaris 10.
+ * HACKING: Document this problem.
+
+2023-02-20 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_MAKE_DEFINES_RM): Test the make(1) in the
+ environment variable $MAKE if defined, not a literal "make".
+ Required on (some) Solaris 10 configurations where traditional
+ make(1) is not installed but GNU make is installed as "gmake".
+
+2023-02-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/latin2_works.sh: Fix missing backslash in printf.
+ Solaris printf(1) was sensitive to this error; macOS and GNU
+ printf were not. Fixes a test failure on Solaris 11.
+
+2023-02-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/regression_savannah_58153.sh: Improve
+ portability. Avoid the unpredictability of implementations when
+ putting backslashes inside a groff-piped printf shell command
+ inside a here document inside a command substitution by changing
+ the groff escape character to something meaningless to the shell
+ and to printf ('@'). Fixes a test failure on Solaris 11.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/Foundry.in: Recognize URW foundry replacements for
+ Helvetica Bold-Oblique and Helvetica Oblique under the file
+ names "NimbusSans-BoldItalic.t1" and "NimbusSans-Italic.t1",
+ respectively.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am (uninstall-pdf): Clean more fastidiously; try to
+ remove the configured `pdfdocdir` in the event it is empty, but
+ do not fail if it isn't. (It can be a directory shared with
+ other groff components; we don't know in what order the
+ uninstall targets will serialize, but the last one run should
+ succeed.)
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Detangle "pdfroff" and "gropdf" configuration (2/2).
+
+ * m4/groff.m4: Give pdfroff its own Autoconf macros to handle
+ dependency checking, build objectives, and user notice.
+ (GROFF_PDFROFF_DEPENDENCIES_CHECK): New macro requires
+ `GROFF_AWK_PATH` and `GROFF_GHOSTSCRIPT_PATH`, determines
+ whether pdfroff can be used at build time, and (if not)
+ constructs part of message to be shown to user explaining why.
+ (GROFF_PDFROFF_PROGRAM_NOTICE): New macro requires
+ `GROFF_PDFROFF_DEPENDENCIES_CHECK` and emits message if needed.
+ (GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE): Drop mention of impact
+ on pdfroff since its dedicated notice covers this now.
+ * configure.ac: Call the new macros at appropriate times.
+ Produce a new Automake macro, `USE_PDFROFF`, to replace
+ inapposite use of `USE_GROPDF` in pdfmark.am.
+ * contrib/pdfmark/pdfmark.am: Use `USE_PDFROFF` instead of
+ `USE_GROPDF`.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Detangle "pdfroff" and "gropdf" configuration (1/2).
+
+ * m4/groff.m4 (GROFF_GROPDF_DEPENDENCIES_CHECK): Add
+ `AC_REQUIRE`ment on `GROFF_URW_FONTS_CHECK`. Per discussion
+ with Deri James, if _either_ Ghostscript or the URW fonts are
+ avilable, gropdf will be fully functional, consequent to commit
+ d5515, 22 June. Drop dependency on awk; it is used only at
+ configuration time (in an Autoconf macro) and since Savannah
+ #62775 was resolved (19 September), it has not been strictly
+ necessary. (It is useful for searching more locations for URW
+ fonts, but several others are searched even if it is absent.)
+ Stop populating notice text here, instead moving it...
+ (GROFF_GROPDF_PROGRAM_NOTICE): ...here, since it no longer needs
+ to be dynamically constructed.
+
+ Continues <https://savannah.gnu.org/bugs/?63808>. Thanks to
+ Deri James for the continued discussion.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Rename `GROFF_CHECK_GROPDF_PROGRAMS` macro to
+ `GROFF_GROPDF_DEPENDENCIES_CHECK` to generalize for greater
+ accuracy in forthcoming change.
+
+ * configure.ac:
+ * m4/groff.m4: Do it.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [gropdf]: Don't run automated tests if 'gropdf' will be
+ operating with reduced function. If neither Ghostscript nor the
+ URW fonts are available at configuration time, there is no point
+ testing for successful build-time population of the font
+ descriptions for the default and URW foundries.
+
+ * font/devpdf/devpdf.am (font_devpdf_TESTS) [USE_GROPDF]: Run
+ "check-default-foundry" only if gropdf is fully functional.
+ (font_devpdf_TESTS) [USE_GROPDF && HAVE_URW_FONTS]: Run
+ "check-urw-foundry" only if the URW fonts were found.
+
+ Continues <https://savannah.gnu.org/bugs/?63808>. Thanks to
+ Deri James for the continued discussion.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [gropdf]: Rename tests to more accurately characterize their
+ purpose.
+
+ * font/devpdf/tests/basic-fonts-present.sh:
+ * font/devpdf/tests/urw-fonts-present.sh: Rename these...
+ * font/devpdf/tests/check-default-foundry.sh:
+ * font/devpdf/tests/check-urw-foundry.sh: ...to these.
+ * font/devpdf/devpdf.am (font_devpdf_TESTS): Reflect rename.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [gropdf]: Revise tests to be foundry-focussed.
+
+ * font/devpdf/tests/basic-fonts-present.sh: Stop trying to match
+ font descriptions in the "devps" directory with ones in
+ "devpdf"; instead, test whether "BuildFoundries" did its job.
+ Test for font descriptions corresponding to the full 35
+ PostScript Level 2 font repertoire, plus groff's "EURO".
+ * font/devpdf/tests/urw-fonts-present.sh: Drop stale comment and
+ rename variable for better parallelism with the other test
+ above.
+
+ Continues <https://savannah.gnu.org/bugs/?63808>. Thanks to
+ Deri James for the continued discussion.
+
+2023-02-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Tweak fix to Savannah #63768.
+
+ * tmac/an.tmac (MR): Ensure `an*url` always has a value,
+ defaulting to "format 1" (man:page(section)). Resequence the
+ macOS URL formats to sort the contemporary one before the
+ others.
+ * tmac/man.local: Reflect resequencing of integer assignments to
+ formats. Clarify historicity of annotations.
+
+ Continues <https://savannah.gnu.org/bugs/?63768>. Thanks to
+ John Gardner for further discussion.
+
+2023-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Port a test to Solaris 11 sed.
+
+ * tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Put
+ newlines after opening braces in sed scripts. macOS and GNU sed
+ tolerate their absence, but this sed does not.
+ * HACKING: Document this problem.
+
+2023-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/groff.am (groff_TESTS) [!USE_GROHTML]: Don't
+ test the 'grohtml' driver if we know it won't work.
+
+2023-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/\
+ device_control_escapes_express_basic_latin.sh: Use printf(1),
+ which is often a shell built-in command, more consistently.
+ Double backslashes intended as literals in the format string,
+ and single-quote format strings using them. Fixes test failure
+ seen on Solaris 11 with GNU Bash 4.4 and ksh 93u+ (2012-08-01).
+
+2023-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/an_use-input-traps-correctly.sh: Explicitly test
+ `SM` and `SB` with 'ps' output device. If one set
+ GROFF_TYPESETTER=utf8 in the test environment, these test cases
+ would fail. Thanks to John Gardner for the report.
+
+2023-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac: Add Automake conditional, `HAVE_GHOSTSCRIPT`, so
+ that we can populate the list of PDF device font tests
+ dynamically. Call new macro
+ `GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE`. Call
+ `GROFF_GHOSTSCRIPT_VERSION_NOTICE` after it, but before
+ `GROFF_URW_FONTS_NOTICE`.
+ * m4/groff.m4 (GROFF_AWK_NOTICE): New macro produces warning if
+ no awk could be found. This reduces gropdf functionality, but
+ so do missing URW fonts, so we report this problem separately.
+ Report the names under which we sought it, since there's a
+ configure script option for that.
+ (GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE): New macro explains
+ consequences of missing optional dependency on Ghostscript
+ program: reduced grohtml functionality, nonfunctional pdfroff.
+ Report the names under which we sought it, since there's a
+ configure script option for that.
+ (GROFF_CHECK_GROPDF_PROGRAMS): Better characterize gropdf's
+ reduced function, pointing out the ways in which it would be
+ more useful if the dependencies were met. Also simplify the
+ computational grammar.
+ (GROFF_URW_FONTS_NOTICE): Identify 'U' as the foundry name
+ gropdf uses for the URW fonts. Confirm continuing availability
+ of most recent URW fonts release; bump date.
+ * font/devpdf/devpdf.am: Test availability of "basic" (PDF base
+ 14) fonts (plus groff's "EURO") if either Ghostscript or URW
+ fonts are available. Test availability of URW fonts (35) only
+ if Ghostscript _and_ the URW fonts were found at configuration
+ time.
+
+ Fixes <https://savannah.gnu.org/bugs/?63808>. Thanks to Deri
+ James for the report and extremely helpful pseudocode.
+
+2023-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK,
+ GROFF_URW_FONTS_NOTICE): Add macro dependency on
+ `GROFF_GHOSTSCRIPT_PATH`, which should have been there already.
+ (GROFF_GROHTML_PROGRAM_NOTICE): Add macro dependency on
+ `GROFF_CHECK_GROHTML_PROGRAMS`, which should have been there
+ already.
+
+ (GROFF_CHECK_GROHTML_PROGRAMS, GROFF_PNMTOOLS_CAN_BE_QUIET):
+ Move `AC_REQUIRE` expansions to precede shell variable
+ assignments (after checking that the required macros don't
+ clobber the assignments we're making).
+
+2023-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/tests/basic-fonts-present.sh: Revise test again,
+ per feedback from Deri James. Even without Ghostscript or URW
+ fonts available, gropdf can generate valid PDF documents; it
+ simply can't embed fonts in general (without further
+ arrangements made on the host system), which means it is
+ restricted to the PDF base 14 fonts. That's enough for many
+ purposes, including generating our compiled man pages document
+ {with minor degradations to the typeface lists in gropdf(1) and
+ grops(1)}. Drop the 'gs' command check, which also didn't check
+ for the name of the Ghostscript interpreter determined by the
+ "configure" script. Replace dynamically generated font list
+ with a static one (the base 14 fonts plus groff's EURO).
+
+2023-02-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/tests/basic-fonts-present.sh: Revise test.
+ Improve explanation of why we're looking for the gs(1) command
+ in a font availability test. Prefix diagnostic output with name
+ of test script. Perform a search for the 'ps' device font
+ descriptions that will work in more build scenarios (i.e., don't
+ assume an out-of-tree build taking place in an immediate
+ subdirectory of the source). Distinguish failure to find the
+ font descriptions from a failure to locate the 'gs' command,
+ skipping the test in both scenarios. Reduce noise in output.
+ * m4/groff.m4 (GROFF_CHECK_GROPDF_PROGRAMS): Revise warning
+ issued when awk and Ghostscript are unavailable; gropdf will not
+ be completely inoperative. Characterize its reduced function.
+
+ Thanks to Deri James in <https://lists.gnu.org/archive/html/\
+ groff-commit/2023-02/msg00089.html> for prompting me to take a
+ another look at this.
+
+2023-02-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/latin2_works.sh:
+ * tmac/tests/latin5_works.sh:
+ * tmac/tests/latin9_works.sh: Port to work around macOS's
+ apparently POSIX non-conforming 'od' command. Use single-byte
+ octal output format instead of "character", and update test
+ expectations accordingly. Apparently gratuitously, macOS also
+ puts more spaces after the octal address field when using this
+ output format.
+ * HACKING: Document, and elaborate upon, this problem.
+
+2023-02-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Port a test to work with macOS sed.
+
+ * tmac/tests/doc_heading-font-remapping-works.sh: Put semicolons
+ between commands and closing braces in sed script. Put each of
+ multiple closing braces on a separate input line, because macOS
+ doesn't accept them otherwise. Resolves test failure observed
+ on macOS.
+ * HACKING: Document the closing brace sequence problem.
+
+2023-02-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Port a test to work with macOS sed.
+
+ * tmac/tests/an_TS-adds-no-vertical-space.sh: Put semicolons
+ between commands and closing braces in sed script. Separate
+ command stream into multiple '-e' expressions, breaking them
+ after branch and label commands. Resolves test failure observed
+ on macOS.
+ * HACKING: Document the above problems.
+
+2023-02-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/\
+ some_escapes_accept_newline_delimiters.sh: Weaken regexes in two
+ test cases to accommodate excessive output from macOS's 'od'
+ command. Resolves test failure seen on macOS.
+ * HACKING: Add section "Writing Tests" and document the above
+ since this is the second time I've cracked my shin on this.
+
+2023-02-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/tests/basic-fonts-present.sh: Skip test if 'gs'
+ command not available. The test is to ensure that gropdf will
+ produce sound documents using the base fonts from PostScript,
+ but since gropdf requires Ghostscript to do this (as noted in
+ our "./configure" messages), it makes no sense to validate font
+ availability if the program is absent. Resolves test failure
+ seen on macOS with minimal dependencies installed.
+
+2023-02-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Manipulating Filling and Adjustment): Say more
+ about the consequences of a break.
+
+ Fixes <https://savannah.gnu.org/bugs/?63777>. Thanks to Dave
+ Kemper for the report.
+
+2023-02-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [docs]: Re-re-christen 'ESCAPE_AMPERSAND' ('\&'). Now call it a
+ {non-transparent} "dummy character". Also rechristen
+ 'ESCAPE_RIGHT_PARENTHESIS', ('\)') as the "transparent dummy
+ character"; it has no impact on sentence-ending detection.
+
+ * doc/groff.texi:
+ * doc/meref.me.in:
+ * man/groff.7.man:
+ * man/groff_diff.7.man:
+ * man/roff.7.man:
+ * src/preproc/refer/refer.1.man:
+ * tmac/groff_man.7.man.in: Do it.
+
+ Fixes <https://savannah.gnu.org/bugs/?62816>. Thanks to Dave
+ Kemper for the report and to the groff mailing list for the
+ vigorous discussion. I don't expect my solution to please
+ everyone.
+
+2023-02-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac: Add internal register `an*MR-URL-format` to
+ select from a few known formats of man page hyperlink. There
+ are three known on macOS, and one used everywhere else.
+ * tmac/man.local: Document this feature so macOS users can enjoy
+ the OSC 8 hyperlink feature if their terminal application
+ supports it.
+
+ I hope that this feature will be a temporary measure while macOS
+ implements support for the man page URL format used everywhere
+ else in the world.
+
+ Fixes <https://savannah.gnu.org/bugs/?63768>. Thanks to John
+ Gardner for the report, research, consultation, and testing.
+
+2023-02-11 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ [BuildFoundries]: Fails if neither ghostcript nor URW fonts
+ are installed.
+
+ * font/devpdf/util/BuildFoundries.pl: When the change to hold
+ paths in an array, rather than a delimited string (see commit
+ 4ae4aeb6555f4f16c28fcb03eb1f56577826054c), the FindGSpath
+ subroutine should return a pointer to an empty array when the
+ call to ghostscript fails, rather than return an empty string,
+ as was done previously.
+
+ See <https://lists.gnu.org/archive/html/groff/2023-02/\
+ msg00042.html>; thanks to Bruno Haible for the report.
+
+2023-02-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Switch to using system's assert.h header file. It is futile to
+ attempt to preserve compatibility with ISO C90 systems by
+ providing a bespoke predicate-reporting assert() (a C99 feature)
+ when gnulib, which we require, itself demands C99. This ensures
+ that `static_assert` remains defined so that gnulib can use it.
+ Thanks to Bruno Haible for the consultation.
+ <https://lists.gnu.org/archive/html/groff/2023-02/msg00034.html>
+
+ * src/include/assert.h: Delete.
+
+ * src/devices/grodvi/dvi.cpp:
+ * src/devices/grolbp/lbp.cpp:
+ * src/devices/grolj4/lj4.cpp:
+ * src/include/itable.h:
+ * src/include/stringclass.h:
+ * src/libs/libbib/linear.cpp:
+ * src/libs/libbib/search.cpp:
+ * src/libs/libdriver/printer.cpp:
+ * src/libs/libgroff/assert.cpp:
+ * src/libs/libgroff/color.cpp:
+ * src/libs/libgroff/errarg.cpp:
+ * src/libs/libgroff/font.cpp:
+ * src/libs/libgroff/nametoindex.cpp:
+ * src/libs/libgroff/prime.cpp:
+ * src/libs/libgroff/relocate.cpp:
+ * src/libs/libgroff/searchpath.cpp:
+ * src/preproc/eqn/box.cpp:
+ * src/preproc/eqn/delim.cpp:
+ * src/preproc/eqn/pile.cpp:
+ * src/preproc/eqn/script.cpp:
+ * src/preproc/html/pre-html.cpp:
+ * src/preproc/pic/pic.h:
+ * src/preproc/preconv/preconv.cpp:
+ * src/preproc/soelim/soelim.cpp:
+ * src/roff/groff/groff.cpp:
+ * src/roff/troff/troff.h:
+ * src/utils/hpftodit/hpftodit.cpp:
+ * src/utils/indxbib/indxbib.cpp:
+ * src/utils/lkbib/lkbib.cpp:
+ * src/utils/lookbib/lookbib.cpp:
+ * src/utils/tfmtodit/tfmtodit.cpp: Respell "assert.h" inclusion
+ with angle brackets instead of quotation marks.
+
+ Fixes <https://savannah.gnu.org/bugs/?63078>.
+
+2023-02-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (token::next): Use correct kind of
+ null object in comparison. Fixes latent bug that would be
+ exposed if we were to migrate from zero literals to `nullptr`.
+
+2023-02-09 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ [gropdf] Parse multiple entries in 'papersize' as specified in
+ the groff_font man page. Reported by Ben Wong and fix based on
+ his patch, thanks.
+
+ * src/devices/gropdf/gropdf.pl: Parse papersize string for
+ possible multiple (space separated) entries. First valid entry
+ wins.
+
+ Fixes https://savannah.gnu.org/bugs/?63757
+
+2023-02-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Correct numerous typos and solecisms throughout the source tree.
+
+ * ChangeLog:
+ * ChangeLog.115:
+ * ChangeLog.116:
+ * ChangeLog.117:
+ * ChangeLog.118:
+ * ChangeLog.119:
+ * ChangeLog.121:
+ * ChangeLog.122:
+ * Makefile.am:
+ * NEWS:
+ * PROBLEMS:
+ * README:
+ * contrib/chem/chem.am:
+ * contrib/chem/chem.pl:
+ * contrib/glilypond/README.txt:
+ * contrib/glilypond/glilypond.pl:
+ * contrib/hdtbl/groff_hdtbl.7.man:
+ * contrib/mm/ChangeLog:
+ * contrib/mm/m.tmac:
+ * contrib/pdfmark/pdfmark.ms:
+ * doc/automake.mom:
+ * doc/groff.texi:
+ * doc/me-revisions:
+ * doc/webpage.ms:
+ * m4/lib-link.m4:
+ * man/groff.7.man:
+ * man/groff_diff.7.man:
+ * man/roff.7.man:
+ * src/devices/grohtml/post-html.cpp:
+ * src/devices/grolbp/lbp.h:
+ * src/devices/gropdf/TODO:
+ * src/devices/gropdf/gropdf.1.man:
+ * src/devices/gropdf/gropdf.pl:
+ * src/devices/xditview/ChangeLog:
+ * src/devices/xditview/xditview.c:
+ * src/libs/libdriver/input.cpp:
+ * src/libs/libgroff/glyphuni.cpp:
+ * src/preproc/eqn/eqn.1.man:
+ * src/preproc/grn/gprint.h:
+ * src/preproc/grn/main.cpp:
+ * src/preproc/html/pre-html.cpp:
+ * src/preproc/preconv/preconv.cpp:
+ * src/preproc/tbl/table.cpp:
+ * src/roff/groff/pipeline.c:
+ * src/roff/groff/tests/substring_works.sh:
+ * src/roff/groff/tests/
+ use_point_size_escape_with_single_digit_arg.sh:
+ * src/roff/troff/div.cpp:
+ * src/roff/troff/input.cpp:
+ * src/roff/troff/troff.1.man:
+ * src/utils/grog/grog.pl:
+ * src/utils/indxbib/indxbib.cpp:
+ * src/utils/tfmtodit/tfmtodit.1.man:
+ * tmac/doc-old.tmac:
+ * tmac/doc.tmac:
+ * tmac/groff_man.7.man.in:
+ * tmac/hyphen.fr: Do it.
+
+ Fixes <https://savannah.gnu.org/bugs/?63589>. Thanks to Bjarni
+ Ingi Gislason for the report.
+
+2023-02-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Drop XFAIL test. It was written with an unclear
+ understanding of how DWB (AT&T) and Heirloom Doctools troff
+ behaved. The individual checks might come back, modified.
+
+ * src/preproc/tbl/tests/table-lacks-spurious-top-border.sh:
+ Delete.
+
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Drop it.
+ (tbl_XFAIL_TESTS, XFAIL_TESTS): Drop now empty assignment and
+ unnecessary update, respectively.
+
+2023-02-04 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+ Update gnulib submodule
+
+ gnulib now points on sha1 4e9fcc7b84fcac07a3e5a3cd5f66d1ff320dc8e8
+
+2023-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Fix bugs using boxes or vertical rules at table edges on
+ nroff devices, particularly when combined with region or column
+ expansion.
+
+ * src/preproc/tbl/table.h (class table): Add `GAP_EXPAND`
+ enumeration constant. James Clark seems to have designed GNU
+ tbl carefully to avoid distinguishing region expansion from
+ column expansion in a categorical way, but I needed a way for
+ formatting-time logic to know which was in use. (Column
+ expansion, the "x" modifier, expands columns--i.e., text.
+ Region expansion expands [or compresses] the _gaps_ between
+ columns.)
+ * src/preproc/tbl/main.cpp (process_options): Set `GAP_EXPAND`
+ flag in table if "expand" region option seen.
+ * src/preproc/tbl/table.cpp: Add new macro `LEFTOVER_FACTOR_REG`
+ to name a new roff register for the remainder of gap-expansion
+ space when the amount of space available for expansion is
+ divided by the number of gaps.
+ (table::compute_overall_width): If _not_ expanding a table in
+ either respect and in nroff mode, reduce line length by 1n for
+ each of any left and right border (because the vertical lines
+ eat character cells). This prevents bordered or boxed tables
+ from being overset even when they use neither expansion feature.
+ (table::compute_separation_factor): If gap-expanding a table,
+ store any remainder from the division used to compute the
+ separation factor into the new `LEFTOVER_FACTOR_REG`.
+ (table::compute_column_positions): Insert that remainder into
+ the gap before the last (rightmost) column of the table. This
+ _could_ be done more elegantly by spreading each en in a
+ symmetric way across a subset of the gaps. (It is necessarily a
+ subset by the pigeonhole principle.) But it didn't seem worth
+ the effort for a feature (region expansion) that few users
+ employ. (Usually what you want is the "x" column modifier.)
+ Alternatively, "forget it, Jake--it's a terminal emulator".
+
+ * src/preproc/tbl/tbl.am (tbl_XFAIL_TESTS): Remove now-passing
+ tests.
+
+ Fixes <https://savannah.gnu.org/bugs/?63640> and
+ <https://savannah.gnu.org/bugs/?63749>.
+
+2023-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp (table::compute_column_positions):
+ Stop multiplying the gaps at the left and right edges of a table
+ {which occur when it is boxed or has a leading and/or trailing
+ vertical line} by the column separation factor. Only interior
+ column gaps should be spread. This change prevents tables using
+ the "expand" region option from being overset (exceeding the
+ line length), but might not (yet) fully expand to that length on
+ low-resolution devices due to integer roundoff.
+
+2023-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp (table::compute_total_separation)
+ (table::compute_separation_factor, table::compute_widths): Add
+ comments to generated roff output to assist the mystified user.
+
+2023-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Refactor.
+
+ * src/preproc/tbl/table.cpp:
+ * src/preproc/tbl/table.h: Rename `compute_expand_width` to
+ `compute_overall_width`, since this member function is used on
+ _all_ tables, not just those undergoing column or gap expansion.
+ For instance, in a post-groff 1.22.4 development, it throws a
+ diagnostic if an unexpanded table overruns the line length.
+ * src/preproc/tbl/table.cpp (table::compute_widths): Update call
+ site of `compute_overall_width`.
+ * src/preproc/tbl/table.cpp: Split the roff register behind the
+ `EXPAND_REG` C++ preprocessor macro into two, adding
+ `AVAILABLE_WIDTH_REG`. Annotate the distinction.
+ (compute_overall_width): Annotate. Move and conditionalize
+ logic so as not to produce as much unnecessary roff output.
+
+2023-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/main.cpp (main): Avoid reading from invalid
+ memory upon failure to open an input file.
+
+ Fixes <https://savannah.gnu.org/bugs/?63751>.
+
+2023-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/eqn/lex.cpp (get_delimited_text): Avoid reading
+ from invalid memory when throwing diagnostic. Duplicate
+ `filename` string, then free it on all paths out of function.
+
+ Fixes <https://savannah.gnu.org/bugs/?63214>.
+
+2023-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Add more tests.
+
+ * src/preproc/tbl/tests/boxes-and-vertical-rules.sh:
+ * src/preproc/tbl/tests/expand-region-option-works.sh:
+ * src/preproc/tbl/tests/x-column-modifier-works.sh: Do it.
+
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run tests.
+ (tbl_XFAIL_TESTS): Add; future changes will resolve these.
+
+2023-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp (table::compute_column_positions):
+ If a table has "left separation" (it is boxed, or has a vertical
+ rule on the left-hand side), increase the first column's start
+ register value by 1n, for symmetry with the right-hand size.
+
+ * src/preproc/tbl/tests/check-horizontal-line-length.sh:
+ * src/preproc/tbl/tests/check-line-intersections.sh:
+ * src/preproc/tbl/tests/check-vertical-line-length.sh: Update
+ output expectations.
+
+ * src/preproc/tbl/tbl.am (tbl_XFAIL_TESTS): Remove now-passing
+ test.
+
+ See <https://savannah.gnu.org/bugs/?61597> for background.
+
+2023-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp (table::compute_total_separation):
+ Trivially refactor; rename loop indices so it's obvious which
+ dimension of a matrix they're referring to.
+
+2023-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp (table::determine_row_type)
+ (table::compute_widths, table::do_row): Boolify some local ints.
+
+2023-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Refactor handling of vertical lines in format. Validate
+ input more strictly. Add diagnostics when vertical lines are
+ redundant with box borders.
+
+ * src/preproc/tbl/main.cpp (process_format): Shift diagnostic
+ about excess vertical lines in a sequence at the beginning of a
+ row description to later, after the first proper column
+ descriptor has been interpreted. Normalize a sequence of more
+ than two consecutive vertical lines to 2 when they occur at the
+ beginning of a row description. Unconditionally update
+ `list->vline` and reset `vline_count` once we start looking for
+ modifiers, since we know we've finished any sequence of vertical
+ lines, and at the end of a row definition. Rename and retype
+ loop variable int `success` to Boolean
+ `is_valid_modifier_sequence`. Drop now-invalid assertion.
+ * src/preproc/tbl/table.cpp (table::add_vlines): Throw new
+ diagnostics when vertical lines are redundant with box borders.
+ Add assertion to ensure we got a valid vertical line value (0,
+ 1, or 2) from `process_format`. Throw these only once per table
+ format, not for every row.
+
+2023-01-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/main.cpp (process_table): Trivially refactor.
+ Rename `form` to `fmt` to imply "format", not "form".
+
+2023-01-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/main.cpp (process_format): Throw error
+ diagnostic if more than 2 vertical lines are specified at the
+ beginning of a row definition.
+
+ Fixes <https://savannah.gnu.org/bugs/?63731>.
+
+2023-01-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/main.cpp (process_format): Recast diagnostic
+ message to refer to character by its Unicode name and generalize
+ to accurately cover additional circumstance of excess '|'
+ symbols at end of row definition.
+
+2023-01-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/ms.ms: Remove redundant initializations.
+
+2023-01-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/ms.ms: Define appropriate hyphen-minus mapping on 'cp1047'
+ output device.
+
+2023-01-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/s.tmac (TE): Enable no-space mode after outputting the
+ display distance vertically, replacing any inter-paragraph
+ distance that might follow.
+
+2023-01-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Fix misleading diagnostic message.
+
+ * src/preproc/html/pre-html.cpp (main): The suggestion should be
+ to re-run the formatter (groff, troff), not "pre-grohtml", with
+ a different output driver since the document may be malformed.
+
+2023-01-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/main.cpp (process_format): Fix code hygiene
+ nit: nullify `list` pointer after freeing its target.
+
+2023-01-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Really fix Savannah #63449.
+
+ * src/preproc/tbl/main.cpp (process_format): "Or" on the
+ `HAS_TOP_VLINE` flag if the format specification begins with a
+ "|"; the beginning is a separate state in the FSM used to parse
+ the description. I missed it in commit 0e93ab4102, 1 December.
+
+ Fixes <https://savannah.gnu.org/bugs/?63449>.
+
+2023-01-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/tests/\
+ do-not-overdraw-page-top-in-nroff-mode.sh: Correct erroneous
+ check of test output, and add two more test cases.
+
+2023-01-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Move the saving of the hyphenation mode from
+ the "top level" to...
+ (mY): ...this new macro.
+ (SY, mQ, MR): Call `mY` before disabling hyphenation.
+
+ Problem introduced by me in commit 096c2f0567, 16 February.
+ "an-ext.tmac" gets sourced by "an.tmac" before any
+ command-line setting of the `HY` register is handled, so (for
+ groff) the stored hyphenation mode was the default for the
+ language, not reflecting user disablement. The synopsis macros,
+ which do not have an alternate implementation in "an.tmac" for
+ leverage of groff features, were causing hyphenation to be
+ resurrected (after `YS`) even if the user had disabled it.
+ Saving the hyphenation mode anew upon entry to these macros is
+ arguably inefficient, but it is more correct since a man page
+ could conceivably manipulate the automatic hyphenation mode
+ {even if that's not recommended outside of tbl(1) text blocks}.
+
+2023-01-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Add regression test for hyphenation getting wrongly
+ restored by `YS`, `ME`, `UE`, and `MR` macros.
+
+ * tmac/tests/an_HY-register-works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2023-01-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (Sh, Ss): Narrow scope of font remappings
+ lexically and restrict remapping to the heading font family (if
+ any) to avoid undesired remapping of fonts in page headers if,
+ say, a (sub)section heading begins just prior to a page
+ break--which is ugly anyway and should be avoided, but the
+ package has no keep macros and solving that problem in an
+ automatic way promises to be complex.
+
+2023-01-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (MT, UR): Throw style warning if macro called
+ without (exactly one) argument.
+
+2022-12-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am (doc/groff-man-pages.pdf): Set (sub)section
+ headings in Helvetica bold in compiled man pages, as a test and
+ demonstration of the `HF` feature's application to both man(7)
+ and mdoc(7) documents.
+
+2022-12-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `HF` string.
+
+ * tmac/doc.tmac (initialization): Add logic supporting `HF`
+ string just as our man(7) implementation does. If the font name
+ ends with `B` (as the default does), set
+ `doc-remap-I-style-in-headings` register and extract font
+ family, which can be empty (as is the default).
+ * tmac/mdoc/doc-common (Sh, Ss): If
+ `doc-remap-I-style-in-headings` register set, perform (and
+ unwind) font remapping of italic to bold-italic face.
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Define `doc-Sh-font` in terms of `HF`.
+
+ * tmac/tests/doc_heading-font-remapping-works.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+ * tmac/groff_mdoc.7.man (Options): Document it.
+ * NEWS: Update item.
+
+ Fixes last part of <https://savannah.gnu.org/bugs/?63046>.
+
+2022-12-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Revise "fallback" character definitions in several
+ respects for Unicode characters from General Punctuation block.
+
+ * tmac/fallbacks.tmac: Comment out fallbacks for U+200B, U+2010,
+ U+2011, and U+201[89CD], due to ineffectuality or apparent groff
+ bugs. Redefine U+2012 fallback to include hair space (\^)
+ around synthetic figure dash. Redefine U+2016 to use `\[ba]`
+ special characters instead of ordinary `|` characters to dodge
+ possible character translations by user.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?63354>. Thanks to
+ Dave Kemper for the (multifarious) discussion.
+
+2022-12-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Invoking groff, Built-in Registers):
+ * man/groff.7.man (Writable predefined registers):
+ * src/roff/groff/groff.1.man (Environment):
+ * src/roff/troff/troff.1.man (Environment): Replace erroneous
+ reference to ctime(3) with localtime(3).
+
+ Fixes <https://savannah.gnu.org/bugs/?63509>. Thanks to Bjarni
+ Ingi Gislason for the report.
+
+2022-12-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Fix potential problem(s) in trap handler.
+
+ * src/roff/groff/tests/smoke-test_html_device.sh: Move call of
+ `cleanup` function from end of script to after the tests that
+ generate temporary files have been run, and before script
+ possibly exits with status 77 to skip some checks. Within trap
+ handler, mask trapped signals while running handler.
+ (cleanup): Reset trap dispositions to default after removing
+ files; once the temporary files are gone, we no longer need a
+ trap handler. One might already be running however, and this
+ ensures that its "suicide" ("kill -s INT $$") will succeed.
+
+2022-12-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `FT` register.
+
+ * tmac/doc.tmac (initialization): Add logic supporting `FT`
+ register just as our man(7) implementation does.
+ * tmac/mdoc/doc-common (doc-set-up-titles): Plant footer trap in
+ validated user-requested location.
+ * tmac/groff_mdoc.7.man (Options): Document it.
+ * NEWS: Update item.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?63046>.
+
+2022-12-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac: Fix code style nit: use `as` requests to
+ avoid overlong input lines.
+
+2022-12-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac: Inform user we're ignoring their "-rD1" setting
+ if also formatting HTML; parallels groff man(7) behavior.
+
+2022-12-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac: Trivially refactor. Relocate handling of `D`
+ command-line register to prepare for greater synchronization
+ with groff man(7).
+
+2022-12-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp: Trivially refactor. Rename
+ {portion of} internal register to include an interword hyphen
+ for readability.
+
+2022-12-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Change default line length to 6.5 inches.
+
+ * tmac/s.tmac (par@load-init): Do it.
+
+ * doc/groff.texi (ms Document Control Settings):
+ * doc/ms.ms (Document control settings):
+ * tmac/groff_ms.7.man (Document control settings): Document it.
+
+ * tmac/tests/s_honor-MINGW-when-two-columns.sh:
+ * tmac/tests/s_mark-column-start-correctly.sh: Update test
+ expectations.
+
+ * NEWS: Add item.
+
+2022-12-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (TH): Relocate `an-break-body-text` trap to be
+ one half-inch above footer (instead of twice the footer
+ distance). I reason that anyone who customizes `FT` is doing so
+ to overprint some kind of material at the bottoms of pages, or
+ simply to make the margin larger. (One then wonders why we
+ don't have an `HD` register for the top.) Also remove register
+ when done with it.
+ * tmac/groff_man.7.man.in (Options) <FT>: Document this.
+
+2022-12-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (TH): Trivially refactor. Rename
+ `an-footer-location` to `an*footer-location` and set page traps
+ in order descending the page.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `X` register.
+
+ * tmac/doc.tmac (initialization): Add logic supporting `X`
+ register just as our man(7) implementation does.
+ * tmac/groff_mdoc.7.man (Options): Document it.
+ * NEWS: Update item.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?63046>.
+
+2022-12-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Add unit test for `X` register.
+
+ * tmac/tests/doc_X-register-works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-12-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac (Nm): Fix `if` -> `ie` typo/thinko.
+
+ Fixes <https://savannah.gnu.org/bugs/?63527>. Thanks to John
+ Gardner for the report.
+
+2022-12-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/doc_Nm-works.sh: Add more checks.
+
+2022-12-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/smoke-test_html_device.sh: Add checks for
+ inlining of images when tbl(1) or eqn(1) used.
+
+2022-12-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/andoc.tmac (reload-man): Unplant `doc-break-body-text`
+ trap, added in commit 892703b17e, 6 September. Its survival
+ into man(7) pages didn't seem to cause any problems but I have
+ no confidence that will remain true forever.
+
+2022-12-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (initialization): Fix problem with `FT` register
+ validation. Small but valid values were being rejected due to
+ inappropriate use of scaling operator. Also throw user a bone
+ by expressing what size '1v' is for the output device, in basic
+ units.
+
+2022-12-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man, mdoc]: Fix Savannah #63500. Support use of `P` (initial
+ page number) register when batch rendering, regardless of
+ switching macro packages between man(7) and mdoc(7) or setting
+ of `C` (continuous numbering) register. (`P` without `C` means
+ "start numbering each rendered document at \n[P]".)
+
+ * tmac/an.tmac (an-end): Call `an*break-page-with-new-number`
+ instead of invoking `bp`.
+ (an*break-page-with-new-number): If `P` is set and `C` is not,
+ use value of `P` as the next page number.
+ (TH): If `C` register is set, remove `P` register after ending a
+ previous document.
+ (initialization): If `P` is set, assign the page number using
+ the `pn` request if the transition to the first formatted page
+ has not yet occurred; otherwise update page number register `%`
+ directly. Also ignore it with diagnostic if `ps4html` register
+ {for grohtml's internal use} is set. Add explanatory comment.
+
+ * tmac/mdoc/doc-common (Dd): If `C` register is set, remove `P`
+ register after ending a previous document.
+ (doc-end-macro): Call `doc-break-page-with-new-number` instead
+ of invoking `bp`.
+ (doc-break-page-with-new-number): If `P` is set and `C` is not,
+ use value of `P` as the next page number.
+ * tmac/doc.tmac (initialization): If `P` is set, assign the page
+ number using the `pn` request if the transition to the first
+ formatted page has not yet occurred; otherwise update page
+ number register `%` directly. Also ignore it with diagnostic if
+ `ps4html` register (for grohtml's internal use) is set. Add
+ explanatory comment.
+
+ Fixes <https://savannah.gnu.org/bugs/?63500>.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `P` register.
+
+ * tmac/doc.tmac (initialization): Add logic supporting `P`
+ register just as our man(7) implementation does.
+ * tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+ nroff): Document it.
+ * NEWS: Update item.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?63046>.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Add unit tests for man/mdoc `P` register.
+
+ * tmac/tests/an_P-register-works.sh:
+ * tmac/tests/andoc_P-register-works.sh:
+ * tmac/tests/doc_P-register-works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run tests.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man, mdoc]: Refactor. Rename a Boolean register to more
+ clearly communicate its purpose. This also reverses its sense.
+
+ * tmac/an.tmac (TH): Rename `an-is-first-page-of-document` to
+ `an*need-titles-reset`. Drop redundant store. Reverse sense of
+ test.
+ (initialization): Initialize it to zero.
+
+ * tmac/mdoc/doc-common (Dd): Rename
+ `doc-is-first-page-of-document` to `doc-need-titles-reset`.
+ Drop redundant store. Reverse sense of test.
+ (initialization): Initialize it to zero.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Add future regression test for header/footer
+ mishandling that wasn't already covered (not a live bug; was
+ exposed by attempted refactoring).
+
+ * tmac/tests/andoc_check-an-to-doc-transition.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man, mdoc]: Trivially refactor.
+
+ * tmac/an.tmac (an-start-new-document): Rename this...
+ (an*break-page-with-new-number): ...to reflect its reduced
+ responsibility.
+
+ * tmac/mdoc/doc-common (doc-start-new-document): Rename this...
+ (doc-break-page-with-new-number): ...to reflect its reduced
+ responsibility.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man, mdoc]: Refactor to separate page number management from
+ header trap management.
+
+ * tmac/an.tmac (an-start-new-document): Stop removing
+ `an-header` trap.
+ (TH): Clear the trap here even if not continuously rendering,
+ and call `an-start-new-document`.
+
+ * tmac/mdoc/doc-common (doc-start-new-document): Stop removing
+ `doc-header` trap.
+ (Dd): Clear the trap here even if not continuously rendering,
+ and call `doc-start-new-document`.
+
+2022-12-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common: Refactor for better parallelism with our
+ man(7) implementation and to prepare for a synchronized change
+ to both.
+ (Dd): Move open-coded (inlined) operations from here...
+ (doc-start-new-document): ...to this new macro.
+ (doc-end-macro): Drop unnecessary register assignment. `Dd`
+ takes care of it if there is a subsequent mdoc(7) document.
+
+2022-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Fix off-by-one error in generated diagnostic message.
+
+ * src/preproc/tbl/table.cpp: Define new preprocessor macro,
+ `PREVIOUS_PAGE_REG`.
+ (table::init_output): Compute value for register named using
+ `PREVIOUS_PAGE_REG`, use it in diagnostic, and then remove it.
+ Also fix verb tense in message.
+
+2022-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Expose the fact of a table's boxedness via a troff
+ register so that macro packages can make more intelligent
+ decisions about space requirements (since box borders occupy
+ significant space on nroff devices).
+
+ * src/preproc/tbl/table.cpp: Define new preprocessor macro,
+ `IS_BOXED_REG`.
+ (table::do_top): Initialize "boxedness" register.
+
+2022-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/s.tmac (TH): Clarify computation and diagnostic message.
+
+2022-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Fix Savannah #61878.
+
+ * src/preproc/tbl/table.cpp: Define new preprocessor macro,
+ `STARTING_PAGE_REG`.
+ (table::define_bottom_macro): Have the formatter issue a warning
+ if an unkept, boxed table ends on a different page than it
+ began.
+ (table::do_top): Save current page number when table begins.
+
+ Fixes <https://savannah.gnu.org/bugs/?61878>.
+
+2022-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Regression-test Savannah #61878.
+
+ * src/preproc/tbl/tests/\
+ warn-on-long-boxed-unkept-table.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+2022-12-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp: Write comments to generated output;
+ these correspond to functions in this file and to major
+ operations of table construction.
+ (init_output, compute_widths, define_bottom_macro, do_row)
+ (do_top, do_bottom): Do it.
+
+2022-12-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Trivially refactor. Rename class `constant_int_reg` to
+ `readonly_register`. Say "readonly" instead of "const" to
+ try to avoid confusion with C++ constness. Drop "int" because
+ integer-valued registers are the norm, not the exception.
+
+ * src/roff/troff/column.cpp (init_column_requests):
+ * src/roff/troff/div.cpp (init_div_requests):
+ * src/roff/troff/input.cpp (top level, init_input_requests):
+ * src/roff/troff/node.cpp (init_node_requests):
+ * src/roff/troff/reg.h: Do it.
+
+2022-12-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Trivially refactor. Rename class `constant_reg` to
+ `readonly_text_register`. Say "readonly" instead of "const" to
+ try to avoid confusion with C++ constness. Say "text" because
+ this class is _mostly_ used for interpolation of string-valued
+ registers like the version registers `.x`, `.y` and `.Y`.
+ Nevertheless there are some abuses (apparently because the
+ constructors for register classes don't accept integer
+ parameters for initialization--why?).
+
+ * src/roff/troff/input.cpp (top level)
+ (readonly_text_register::readonly_text_register)
+ (readonly_text_register::get_string)
+ (main, init_registers, init_requests): Do it.
+
+2022-12-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Trivially refactor. Rename `number_reg_dictionary` to
+ `register_dictionary`. It's shorter _and_ non-abbreviated _and_
+ matches our documentation.
+
+ * src/roff/troff/column.cpp (init_column_requests):
+ * src/roff/troff/div.cpp (page_number, init_div_requests):
+ * src/roff/troff/env.cpp (print_env, init_env_requests)
+ (init_hyphen_requests):
+ * src/roff/troff/input.cpp (length_request)
+ (interpolate_number_format, do_register, do_if_request, main)
+ (init_registers, init_input_requests):
+ * src/roff/troff/node.cpp (get_register, init_node_requests):
+ * src/roff/troff/reg.cpp (top level, define_number_reg)
+ (inline_define_reg, alter_format, remove_reg, alias_reg)
+ (rename_reg, print_number_regs):
+ * src/roff/troff/reg.h: Do it.
+
+2022-12-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Add regression test.
+
+ * tmac/tests/an_link-trailing-text-hugs-previous.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-12-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/fallbacks.tmac: Really use troff-mode fallbacks only on
+ typesetting devices; because this macro file is loaded so early,
+ we cannot rely on ".if t". Thanks to Dave Kemper for the
+ discussion in Savannah #63354.
+
+2022-12-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Use more mnemonic register names, thanks to
+ the recent freeing up of some name space.
+ - mJ -> mH: saved automatic hyphenation mode
+ - mX -> mE: formatting in EX/EE context (Boolean)
+
+2022-12-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdf.tmac: Drop deletion of unused string `PDFHREF.TEXT`.
+
+2022-12-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (an-end, AT, UC, DT, PD, SH, IP, BI, BR, IB, IR)
+ (RB, RI, OP, an*end-hyperlink, MR): Refactor; "nop"ify macros
+ that produce formatted output or call other macros using string
+ interpolations--except where we can't: see Savannah #63470.
+
+2022-12-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (R): Drop macro definition, which implements a
+ hack for people who try to use "R" as a font style macro. This
+ doesn't seem to happen much in actual practice (though perhaps
+ the diagnostic this hack produces is responsible for suppression
+ of the mistake). Retaining it interferes with the
+ "nop"-ification of this macro file.
+ * NEWS: Add item.
+
+2022-12-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Use truly traditional hyphenation mode on
+ non-groff-compatible formatters.
+
+2022-12-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Update test coverage and expectations.
+
+ * tmac/tests/an_ME-punct-hyphenates.sh: Test both "an.tmac" and
+ "an-ext.tmac" implementations of `ME`.
+ * tmac/tests/an_UE-punct-hyphenates.sh: Test both "an.tmac" and
+ "an-ext.tmac" implementations of `UE`.
+ * tmac/tests/an_UE-breaks-before-long-URIs.sh: Update test
+ expectations. I appear to have inadvertently fixed some
+ inelegant rendering.
+
+2022-12-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Rename to reflect code reorganization.
+
+ * tmac/tests/an-ext_ME-punct-hyphenates.sh:
+ * tmac/tests/an-ext_MT-body-hyphenates.sh:
+ * tmac/tests/an-ext_UE-breaks-before-long-URIs.sh:
+ * tmac/tests/an-ext_UE-punct-hyphenates.sh:
+ * tmac/tests/an-ext_UR-body-hyphenates.sh: Rename these...
+ * tmac/tests/an_ME-punct-hyphenates.sh:
+ * tmac/tests/an_MT-body-hyphenates.sh:
+ * tmac/tests/an_UE-breaks-before-long-URIs.sh:
+ * tmac/tests/an_UE-punct-hyphenates.sh:
+ * tmac/tests/an_UR-body-hyphenates.sh: ...to these.
+
+ * tmac/tmac.am (tmac_TESTS): Reflect renames.
+
+2022-12-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Remove groff-feature-dependent code for
+ hyperlink management, greatly reducing the size of the file,
+ which we permissively license and encourage people to copy
+ around. Drop register definitions corresponding to
+ groff-specific output device names. Drop definition and use of
+ `mL` and `mR` strings for angle brackets; no observable change
+ on non-groff formatters. Recognize `mG` register to enable
+ testing of these macros even if the formatter is groff.
+ (mV): Radically simplify. This internal "back-end" for `MT` and
+ `UR` now just stores its argument in a string, `m1`.
+ (mQ): Radically simplify. This internal "back-end" for `ME` and
+ `UE` now just disables automatic hyphenation, formats the saved
+ `m1` string between angle brackets, suffixes it with the
+ optional argument, and restores automatic hyphenation.
+ (UR, MT): Call `mV` with one argument, not nine.
+ (UE, ME): Call `mQ` with one argument, not nine.
+
+ * tmac/tests/an-ext_MR-works.sh: Add test of this file's
+ simplified `MR` implementation.
+ * tmac/tests/an-ext_MT-works.sh:
+ * tmac/tests/an-ext_UR-works.sh: Move tests of groff-specific
+ hyperlink output from here...
+ * tmac/tests/an_MT-works.sh:
+ * tmac/tests/an_UR-works.sh: ...to these new files.
+ * tmac/tests/an_MR-works.sh:
+ * tmac/tests/an_MT-works.sh:
+ * tmac/tests/an_UR-works.sh: Add tests for valid HTML formatting
+ of hyperlinks, which experience shows is a bit fragile in the
+ face of diversion manipulation and output line continuation.
+
+ * tmac/tmac.am (tmac_TESTS): Run new tests.
+
+2022-12-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Support `mG` register: clear it to force the
+ loading of this file's macros even if they have an
+ implementation in tmac/an.tmac and the formatter claims groff
+ compatibility. This is to ease these macros' testing under
+ groff and keep the implementations here simple.
+ * tmac/an.tmac: Initialize `mG` register to 1 if not set on
+ command line.
+
+2022-12-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Initialize `mX` register.
+
+2022-12-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Define `mC` string (constant-width typeface
+ used by `EX`/`EE` macros) as `R` in nroff mode. Thanks to
+ Russ Allbery for prompting me to think more about the
+ limitations of Solaris troff. Implementations do varying
+ things with the "previous" font restored by `\fP` or an
+ unargumented `.ft` if a requested font is not found.
+
+2022-11-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Fix Savannah #63449.
+
+ * src/preproc/tbl/table.h (class table): Add new enumeration
+ constants for use with `flags` member variable: `HAS_TOP_VLINE`
+ and `HAS_TOP_HLINE`, which track properties of the table.
+ Unlike others, these have no correspondence to table region
+ options.
+ * src/preproc/tbl/main.cpp (process_format): Add new local
+ Boolean to track whether we're interpreting a format for the
+ first row. Use this to "or" on the `HAS_TOP_VLINE` or
+ `HAS_TOP_HLINE` flags if "|" or [_-] are encountered in the
+ first row's format, as appropriate.
+ (process_data): "Or" on `HAS_TOP_HLINE` if a single or double
+ horizontal line is used as the first row's data.
+ * src/preproc/tbl/table.cpp (do_top): On nroff mode devices, add
+ one vee of space above the table if we're going to be drawing an
+ unintersected vertical rule above the table's top.
+
+ Fixes <https://savannah.gnu.org/bugs/?63449>.
+
+2022-11-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Regression-test Savannah #63449.
+
+ * src/preproc/tbl/tests/\
+ do-not-overdraw-page-top-in-nroff-mode.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+2022-11-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/main.cpp (struct input_entry_format)
+ (input_entry_format::input_entry_format)
+ free_input_entry_format_list, process_format): Trivially
+ refactor. Rename `pre_vline` to `vline_count`.
+
+2022-11-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp
+ (vertical_rule::contribute_to_bottom_macro, table::print)
+ (table::init_output, table::divide_span)
+ (table::compute_expand_width, table::define_bottom_macro)
+ (table::do_bottom): Produce roff output that is more readable,
+ for maintainability. Indent control lines inside macro
+ definitions. Standardize form of `if`, `ie`, and `el` requests.
+ Some output will not be indented because it is produced within
+ narrowly-scoped C++ functions (set_troff_location,
+ table::print_single_hline, table::print_double_hline,
+ table::do_row), I haven't verified that each one is called from
+ a consistent troff indentation level, and I'm not sure it's a
+ win to parameterize those functions in the indentation level.
+
+2022-11-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Fix Savannah #61909.
+
+ * src/preproc/tbl/table.cpp (SAVED_INTER_WORD_SPACE_SIZE)
+ (SAVED_INTER_SENTENCE_SPACE_SIZE): Add new preprocessor macros.
+ (block_entry::do_divert): Restore saved inter-word and
+ inter-sentence space when formatting a text entry.
+ (table::init_output): When a table region begions, save the
+ values of inter-word and inter-sentence space. Add request to
+ the reset macro to restore saved inter-word and inter-sentence
+ space when leaving table region.
+ (table::do_top): Set inter-sentence space to be equal to
+ inter-word space. This way spaces are "literal" in ordinary
+ table extries (but not text blocks).
+
+ Fixes <https://savannah.gnu.org/bugs/?61909>.
+
+2022-11-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Regression-test Savannah #61909.
+
+ * src/preproc/tbl/tests/\
+ save-and-restore-inter-sentence-space.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+2022-11-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Suppress line numbering when formatting tables, and
+ restore it afterward.
+
+ * src/preproc/tbl/table.cpp: Revert much of commit b69062693's
+ {2011-07-20} changes to this file. They were too complex for me
+ to understand, and permitted Savannah #60140 to persist (or
+ caused it).
+ (ROW_START_LINE_REG, ROW_SAVE_LINE_REG, ROW_MAX_LINE_REG)
+ (REPEATED_NM_SET_MACRO, REPEATED_NM_SUS_MACRO): Drop
+ preprocessor macros.
+ (SAVED_NUMBERING_LINENO, SAVED_NUMBERING_SUPPRESSION_COUNT): Add
+ new preprocessor macros.
+ (table::init_output, table::print_single_hline)
+ (table::print_double_hline, table::define_bottom_macro)
+ (table::do_row, table::do_top, table::do_bottom): Drop old
+ logic.
+
+ (table::init_output): When the table begins, save the current
+ line number register `ln` and the count of remaining lines to be
+ suppressed (the new `.nn` register). Then suppress numbering
+ for the next 2 billion+ lines of output, with a groveling
+ apology to the elegance police.
+ (table::do_bottom): Restore saved value of `.nn`. If numbering
+ was active (even if suppressed), restore it with `nm` request.
+ If it wasn't, disable it, in case it was turned on inside the
+ table region.
+
+ Fixes <https://savannah.gnu.org/bugs/?60140>. Thanks to Hans
+ Bezemer for noting the practical significance of this bug.
+
+2022-11-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Regression-test Savannah #60140.
+
+ * src/preproc/tbl/tests/save-and-restore-line-numbering.sh: Do
+ it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+2022-11-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Implement new `.nn` register to report the remaining
+ count of lines to have their numbering suppressed.
+
+ * src/roff/troff/env.h (class environment): Declare new member
+ function `get_no_number_count()`.
+ * src/roff/troff/env.cpp (get_no_number_count): Define new
+ member function, returning value of member variable
+ `no_number_count`.
+ (init_env_requests): Define new ".nn" register and attach it to
+ `get_no_number_count()`.
+
+ * doc/groff.texi (Miscellaneous): Document it. Include example
+ of use to determine whether current output line will be
+ numbered. Also clarify meaning of register; `.nn` is not
+ decremented except when output line numbering is enabled.
+ * man/groff.7.man (Read-only registers): Document it.
+
+ * src/roff/groff/tests/dot-nn_register_works.sh: Test it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+
+ * NEWS: Add item.
+
+ See <https://lists.gnu.org/archive/html/groff/2022-11/\
+ msg00153.html>.
+
+2022-11-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/fallbacks.tmac: Comment out four of the fallback
+ character definitions for (preconv'd) Unicode character input
+ added to address Savannah #58930 (corresponding to \[dg], \[dd],
+ \[%0], and \[rn]; they are failing for not yet understood
+ reasons involving "macros" attached to groff character info
+ structs, and the semantics of what it means for a character to
+ "exist" per the 'c' conditional operator. Fixes regression when
+ using "tty-char.tmac" (which nroff loads by default). Problem
+ introduced by me in commit 132182bd71, 23 October. The hope is
+ to resolve this issue post-groff 1.23.0. Thanks to Dave Kemper
+ for the report and discussion in Savannah #63332.
+
+2022-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac (SY, YS, mV): Remove `mA`, `mI`, and `mT`
+ registers when done with them.
+
+2022-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/node.h (character_exists):
+ * src/roff/troff/node.cpp (character_exists): Boolify.
+
+2022-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [doc]: Add make(1) dependency.
+
+ * doc/doc.am (doc/groff-man-pages.pdf): Add dependency on our
+ FreeEuro font since we embed it.
+
+2022-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Refactor generation of "freeeuro.pfa" to make more
+ economical use of existing infrastructure, per a suggestion from
+ Deri James. This also puts the file where gropdf's "download"
+ file can find it when running it in a separate build directory.
+ We use it to generate "groff-man-pages.pdf".
+
+ * font/devps/freeeuro.pfa: Rename this...
+ * font/devps/freeeuro.ps: ...to this. We can now use the suffix
+ rule that also applies to "symbolsl.ps" and "zapfdr.ps".
+
+ * font/devps/devps.am (DEVPSFONTFILES): Move "freeeuro.pfa" from
+ here...
+ (DEVPSFONTFILES_GENERATED): ...to here.
+ (EXTRA_DIST): Ship the "new" "freeeuro.ps" file.
+
+2022-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devps/psstrip.sed: Stop stripping comment lines in
+ general instead of preserving only ones that use the form in the
+ Document Structuring Conventions. This way we won't strip
+ copyright notices, like Werner Lemberg's in the FreeEuro font.
+ Thanks to Deri James for pointing this out.
+
+2022-11-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ tmac/an-ext.tmac: Refactor to reduce code size.
+
+ * tmac/an-ext.tmac: Refactor to reduce code size. `UE` and `ME`
+ have nearly identical implementations so...
+
+ (mQ): Define new macro to perform the requisite actions, and...
+
+ (UE, ME): Make these into wrappers calling mQ.
+
+2022-11-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Add unit tests for `MT/ME` and `UR/UE`.
+
+ * tmac/tests/an-ext_MT-works.sh:
+ * tmac/tests/an-ext_UR-works.sh: Do it.
+
+ * tmac/tmac.am (tmac_TESTS): Run tests.
+
+2022-11-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl: Throw warning if paper format is
+ unrecognized.
+
+2022-11-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl (Msg): Align more closely with
+ diagnostic message format prescribed by GNU Coding Standards:
+ emit space (only) prior to message severity.
+
+2022-11-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/meref.me.in: Drop unnecessary initialization parameters
+ from document. The line and title length do not need to be set
+ in troff mode; the document lays out fine for a variety of paper
+ formats if these are not forced to 6.5 inches. Also drop
+ redundant initialization of `pp` register.
+
+2022-11-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Fix Savannah #63377.
+
+ * tmac/doc.tmac (Nm): Properly leverage new
+ `doc-in-name-section` variable. Set page topic `doc-topic-name`
+ to the first encountered argumentful `Nm` call in the "Name"
+ section while handling other "Name" section concerns, instead of
+ later after deciding we're not in the "Synopsis" section.
+ Problem caused by me when fixing antediluvian mdoc bug in commit
+ 0d85615c62, 5 November.
+
+ Fixes <https://savannah.gnu.org/bugs/?63377>. Thanks to John
+ Gardner for the report.
+
+2022-11-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Add tests for `Nm` macro.
+
+ * tmac/tests/doc_Nm-works.sh: Do it. Test regression reported
+ in Savannah #63377. Also ensure that we handle the case where
+ multiple `Nm` items are declared in the "Name" section (as might
+ happen in library man pages).
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-11-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/papersize.tmac: Improve integration with mm(7) macro
+ package. If a paper format has been selected, set `W` register
+ to new line length (if not already set on command line).
+ Similarly, set `O` register to 1 inch for the symmetric
+ horizontal margins otherwise assumed by this macro file. This
+ means that "groff -mm" and "groff -dpaper=letter -mm" are _not_
+ synonymous (when groff is configured to use U.S. letter as the
+ default paper format), because groff mm(7) uses a page offset of
+ 0.963 inches on typesetters for compatibility with DWB mm.
+ * NEWS: Add item.
+
+ See discussion in <https://lists.gnu.org/archive/html/\
+ groff/2022-11/msg00081.html> and (some) follow-ups.
+
+2022-11-16 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ * src/devices/gropdf/gropdf.pl: If the argument to the paper
+ format option '-p' matches a recognized format but includes a
+ trailing 'L' or 'l' ("legalL" or "a4l", for example), rotate the
+ document's MediaBox.
+
+2022-11-16 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ * src/devices/gropdf/gropdf.pl: Fix incorrect hotspot placement
+ if page is in landscape orientation.
+ (FixRect): Perform coordinate transform if page is rotated.
+ (Rotate): New function performs relevant trigonometry.
+
+ Fixes <https://savannah.gnu.org/bugs/?63380>. Thanks to Blake
+ McBride for the report.
+
+2022-11-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/e.tmac: Integrate better with papersize.tmac by no longer
+ forcing line (and title) length to 6 inches for typesetters on
+ initialization. Gather default line length from output device
+ description, possibly modified later (by other macro file or
+ input). No change to terminal ("nroff mode") output.
+ * NEWS: Add item.
+
+2022-11-16 Peter Schaffter <peter@schaffter.ca>
+
+ * tmac/papersize.tmac: If a paper format has been selected,
+ smuggle right margin setting to mom(7) if not overridden by the
+ user. See discussion in <https://lists.gnu.org/archive/html/\
+ groff/2022-11/msg00081.html> and (some) follow-ups.
+
+2022-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am (doc/groff-man-pages.pdf)
+ (doc/groff-man-pages.utf8.txt): Add dependencies on new
+ `TMAC_PACKAGE_MAN` and `TMAC_PACKAGE_MDOC` convenience macros.
+
+2022-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tmac.am (TMAC_PACKAGE_MAN, TMAC_PACKAGE_MDOC): Define
+ convenience macros for in-tree documents to depend on.
+
+2022-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac: Trivially refactor. Rename `an-section` to
+ `an*section`.
+
+2022-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grolbp/lbp.cpp (usage): Tweak usage message. The
+ output driver should be perfectly capable of handling output
+ from non-GNU (but device-independent) troffs.
+
+2022-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grops/ps.cpp (usage): Employ more informative
+ metasyntactic variable names in usage message. Also summarize
+ program's function and direct reader to man page if help
+ explicitly requested (inferred from identity of output stream).
+
+2022-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac: Trivially refactor for congruence with
+ documentary terminology. Rename strings and macros.
+ - an-title -> an*topic
+ - an-abbreviate-page-title -> an*abbreviate-page-topic
+ - an-title-abbv -> an*topic-abbv
+ - an-title-string -> an*topic-string
+ - an-title-length -> an*topic-length
+ - an-title-length-prev -> an*topic-length-prev
+ - an-title-new-length -> an*topic-new-length
+ - an-page-title-style -> an*topic-style
+ (TH): Recast diagnostic message to refer to "section", not
+ "volume" title.
+
+2022-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Refactor to reduce code size. `UR` and `MT`
+ have identical implementations so...
+ (mV): Define new macro to perform the requisite actions, and...
+ (UR, MT): Make these into wrappers calling mV.
+
+2022-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac (UR, MT): Fix problem with incorrect line
+ lengths and occasional "can't adjust" warnings when using
+ hyperlinks. Reduce the line length within the diversion by the
+ amount of indentation used in the context. Without this, lines
+ were getting set too short. (You might think they'd be too
+ long, but when creating a new environment, the _formatter's_
+ default line length is used; that's 65n on terminal devices.)
+
+2022-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Add test to ensure that link text (when the hyperlink
+ itself is not formatted because the device supports
+ hyperlinking) uses the correct line length and is adjusted.
+
+ * tmac/tests/an_adjust-link-text-correctly.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run tests.
+
+2022-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/devpdf.am: Refactor.
+ (MOSTLYCLEANFILES): Populate macro incrementally, adjacent to
+ the targets that build the files to be cleaned. This will
+ enable cleaner refactoring in the future.
+ (DEFAULT_BASE35_FONTS): Add new macro storing the targets of the
+ PostScript Level 2 standard base 35 font descriptions.
+ (devpdffont_DATA): Populate using `DEFAULT_BASE35_FONTS`.
+ (URW_BASE35_FONTS): Add new macro, empty if [!HAVE_URW_FONTS];
+ and [HAVE_URW_FONTS] otherwise naming the `U` foundry font
+ description counterparts of the `DEFAULT_BASE35_FONTS`.
+ (devpdffont_DATA): Append `URW_BASE35_FONTS`.
+ ($(DEFAULT_BASE35_FONTS) $(URW_BASE35_FONTS)): Assert dependency
+ on "font/devpdf/download". This isn't literally true, but
+ BuildFoundries generates all of these together, so if the
+ "font/devpdf/download" target rule runs successfully, the font
+ description files named in these macro expansions will be
+ generated too.
+
+2022-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Add new command-line option to
+ specify the generated font description's "spacewidth" parameter;
+ in commit bf7f6862c3, 2021-09-24, I made libgroff complain if
+ this directive is missing (since any font, even a "special" one,
+ can be selected as current and the formatter's behavior when
+ encountering an input space should be well-defined under that
+ circumstance). Adding this option enables a well-formed font
+ description to be produced.
+ * src/utils/afmtodit/afmtodit.pl (usage):
+ * src/utils/afmtodit/afmtodit.1.man (Synopsis, Options):
+ Document it.
+ * NEWS: Add item.
+
+2022-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Use our own fatal exit
+ function instead of Perl's "die".
+ (croak): New subroutine emits argument as part of diagnostic
+ message and exits with status 1.
+ (usage): Exit with status 2, not 1, on usage errors.
+
+ * NEWS: Document new exit behavior.
+
+2022-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/devpdf.am (font/devpdf/download): Improve
+ comprehensibility of comments in generated "download" file.
+ Stop bracketing path element separator with spaces.
+
+2022-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/util/BuildFoundries.pl (LoadFoundry): Stop
+ capitalizing beginning of diagnostic message (per GNU Coding
+ Standards). Drop ellipsis from end since no further diagnostics
+ relevant to that message are expected. Trim trailing slashes
+ from font path elements.
+
+2022-11-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devps/devps.am: Refactor. Turn two identical target
+ rules into a (BSD-make-style, old-fashioned) pattern rule.
+
+2022-11-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac: Rechristen self "GNU roff".
+
+2022-11-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/pic/pic.ypp: Slightly refactor. Rename parameter
+ `form` (format) to `fmt` to make its nature as an abbreviation
+ clear.
+ (format_number, do_sprintf): Reorder null pointer equality
+ comparisons to avoid inadvertent lvalue assignment.
+ (do_sprintf): Declare lists of valid format conversion
+ specifiers and modifiers explicitly instead of as happenstance
+ literals. Recast diagnostic messages to refer to "invalid", not
+ "bad" input; refer to input keyword correctly as "sprintf" (not
+ "snprintf"); and report the identity of the invalid conversion
+ specifier we reject.
+
+2022-11-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac (Fl, doc-flag-recursion, doc-print-recursive)
+ (doc-print-prefixes, Ar, Nm, Pa, Xr, doc-do-func, Fn)
+ (doc-do-func-args, Fo): Remove now-relic resets of type size to
+ previous value. Since commit 5125754cdf, 23 February, no mdoc
+ macro ever changes the type size.
+
+2022-11-08 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ [gropdf]: Cater for invalid entries in download file.
+
+ * src/devices/gropdf/gropdf.pl: Test if path in the "download"
+ file points to a readable file. Also change order so that the
+ first valid entry is used as the font to embed. This replaces
+ previous order where last found entry is used.
+
+ Fixes <https://savannah.gnu.org/bugs/?62950>.
+
+2022-11-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Set page topic in roman in "Name" section.
+
+ * tmac/doc.tmac (Nm): If in the "Name" section of the page, set
+ argument(s) with the `No` (normal formatting) macro instead of
+ handling them...normally. Since `Nm`'s usual behavior is to set
+ the next argument in boldface, in this circumstance it is set in
+ roman. Aligns page rendering with man(7) and fixes a bug
+ documented in the 4.3BSD-Reno mdoc.samples(7) page (1990-06-22),
+ upon which the groff_mdoc(7) page is based.
+ * tmac/groff_mdoc.7.man (Bugs): De-document bug.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?62926>.
+
+2022-11-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common: Add internal register
+ `doc-in-name-section` to keep track of whether a macro is called
+ within the "Name" section of the document, to prepare a means of
+ fixing a long-standing bug with `Nm`.
+ (Sh): Canonicalize capitalization of section heading sooner.
+ Set or clear `doc-in-name-section` based on result.
+ (Rd): Add new register to dump.
+ * tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+ Handle new register.
+
+2022-11-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Use font CR, not CB, for `Cm` ("command modifier") and
+ `Fl` ("flag") macros on typesetters.
+
+ * tmac/mdoc/doc-ditroff (doc-Cm-font, doc-Fl-Font): Switch to
+ Courier roman from Courier bold. This congrues better with
+ other `Li` literals, which were not in boldface.
+
+2022-11-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-nroff (doc-Li-Font): Switch from roman to bold.
+ On typesetters, the use of Courier (roman) plainly distinguishes
+ unquoted literals from their context. On terminals there was no
+ such visible distinction. Fortunately, in groff_mdoc(7) itself,
+ this does not result in a blinding blitz of boldface because the
+ `Ql` (quoted literal) macro is so often used, and it maintains
+ the roman style. This change further aligns groff mdoc(7) with
+ groff man(7) style conventions. (Also see how we handle
+ literals for typesetters and terminals in the "ms.ms" document.)
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Make `Sx` macro perform quotation, not italicization.
+ It's thorougly inconsistent with English composition practices
+ to refer to (sub)section headings within a document as if they
+ were major works.
+
+ * tmac/doc.tmac (Sx): Implement.
+ * tmac/mdoc/doc-ditroff (doc-Sx-font):
+ * tmac/mdoc/doc-nroff (doc-Sx-font): Delete.
+ * tmac/groff_mdoc.7.man (Section Cross References): Rename...
+ ((Sub)section cross references): ...to this. Recognize
+ existence of `Ss` macro, curiously overlooked before.
+ * NEWS: Add item.
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Drop now-unused `doc-pageref` string. It was nowhere
+ interpolated outside of state management macros.
+
+ * tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+ * tmac/mdoc/doc-common: Do it.
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (doc-header, doc-footer): Revise for
+ clarity and to use correct typefaces for titles.
+ (doc-header): Add new strings to ease title construction.
+ `doc-xref` stores the fully formatted page topic and section
+ number, e.g., "troff(1)"; `doc-abbv` stores the its potentially
+ abbreviated form when it is too long to fit.
+ (doc-footer): Use `doc-xref` as above. Stop setting the `Os`
+ and `Dd` parameters in the ("semantic"?) font used for the
+ page's section number (probably unnoticed all these years
+ because the font used to render that was (Times) roman).
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-common: Rename strings for clarity.
+ - doc-document-title -> doc-page-topic
+ - doc-document-title-saved -> doc-page-topic-saved
+ * tmac/mdoc/doc-common: Use new name.
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff (doc-page-topic-font):
+ * tmac/mdoc/doc-nroff (doc-page-topic-font): Set man page topic
+ names in italics.
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Rename strings for clarity.
+ - doc-caption-font -> doc-page-topic-font
+ - doc-caption-font2 -> doc-page-section-font
+ * tmac/mdoc/doc-common (doc-header, doc-footer): Use new names.
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac: Delete suppression of `Pa` font selection in a
+ "Files" section. This special handling was not documented.
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff (doc-Pa-font): Set file specifications
+ in italics on typesetters. (Terminals already use italics.)
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff (doc-Xr-font):
+ * tmac/mdoc/doc-nroff (doc-Xr-font): Set man page topic cross
+ references in italics.
+
+2022-11-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Rename `doc-Tn-font-shape` to
+ `doc-Tn-font` for better parallelism with other font selection
+ strings for mdoc macros, since the `Tn` macro no longer
+ manipulates the type size.
+ * tmac/doc.tmac (Tn): Use new name.
+
+2022-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Debugging): Fix misleading claim. The
+ arguments to the `tm`, `tmc`, and `tm1` requests are not read in
+ copy mode. For example, you don't need to double backslashes to
+ get them to interpolate registers or strings.
+
+2022-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (an-end):
+ * tmac/mdoc/doc-common (doc-end-macro): Ensure that document
+ footer appears in continuous rendering mode even when a final
+ pending output line in the document is 1v from the page bottom.
+ Replace `fl` call with `br`, which IMO has clearer semantics.
+ Extend page length by 1v before doing so if the current vertical
+ position is within 1v of the page bottom.
+
+ Thanks to Alex Colomar for the report.
+
+2022-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man, mdoc]: Regression-test special case of continuous
+ rendering when the last pending output line in the document is
+ 1v from the (notional) page bottom.
+
+ * tmac/tests/an_output-footer-when-continuously-rendering.sh:
+ * tmac/tests/doc_output-footer-when-continuously-rendering.sh:
+ Do it.
+ * tmac/tmac.am (tmac_TESTS): Run tests.
+
+2022-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (TE): Update diagnostic to mention another
+ failure mode: a man page that is simply a `so` request requires
+ soelim(1) to be run if the sourced page uses tbl(1).
+
+2022-11-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/xditview/xditview.am
+ ($(GXDITVIEW_GROFF_VERSION_H)): Run `$(MKDIR_P)` and `printf` as
+ separate rule commands in order to use them with `$(AM_V_at)`
+ and `$(AM_V_GEN)`, respectively. Prevents noise from build.
+
+ Fixes <https://savannah.gnu.org/bugs/?63302>. Thanks to Bjarni
+ Ingi Gislason for the report.
+
+2022-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [eqn]: Fix Savannah #63299.
+
+ * src/preproc/eqn/main.cpp: Revise input file line number
+ handling.
+ (read_line): Stop dealing with `current_lineno` here; it's now
+ up to its caller (`do_file()`) to manipulate the line number.
+ (do_file): When reading new file, initialize `current_lineno` to
+ 1 instead of 0. Reset it to zero when encountering EOF (so that
+ diagnostics will not include a line number at all). When
+ performing nested call to `read_line()` to gather '.EN' from
+ input, increment the line number. Write correct line number in
+ output groff `lf` requests; in groff, its first argument assigns
+ the number of the _next_ input line. Increment line number at
+ end of outer `read_line()` loop.
+
+ Fixes <https://savannah.gnu.org/bugs/?63299>. Thanks to Alex
+ Colomar for the report.
+
+2022-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [eqn]: Regression-test Savannah #63299.
+
+ * src/preproc/eqn/tests/\
+ diagnostics-report-correct-line-numbers.sh: Do it.
+ * src/preproc/eqn/eqn.am (eqn_TESTS, TESTS, EXTRA_DIST): Run
+ test.
+
+2022-10-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl (fail, warn, construct_command)
+ (version): Restore trailing newlines to `print`ed output. They
+ went missing when I removed the assignment of the output record
+ separator in commit 6f2e367836, 24 October. Thanks to Dave
+ Kemper for catching this.
+
+2022-10-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/preconv/preconv.cpp: Trivially refactor. Rename
+ `default_encoding` to `fallback_encoding` for clarity. Update
+ comments and debugging diagnostic messages accordingly.
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grolj4]: Absorb lj4_font(5) man page into grolj4(1).
+
+ * src/devices/grolj4/lj4_font.5.man: Delete, moving content...
+ * src/devices/grolj4/grolj4.1.man (Fonts): ...hither.
+
+ * doc/doc.am (GROFF_MAN_PAGES1):
+ * src/devices/grolj4/grolj4.am (man5_MANS, EXTRA_DIST): Stop
+ formatting and shipping removed page.
+
+ * src/roff/groff/groff.1.man:
+ * src/utils/hpftodit/hpftodit.1.man: Drop references to page.
+
+ Fixes <https://savannah.gnu.org/bugs/?61819>.
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `SN` register to configure subsection heading
+ indentation.
+
+ * tmac/doc.tmac: Recognize `SN` register if set on command line
+ and use groff man(7)-compatible default if it is not.
+ * tmac/mdoc/doc-common (Ss): Use this register instead of a
+ literal.
+ * tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+ nroff): Document it.
+ * NEWS: Update item.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?62926>.
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `IN` register to configure paragraph
+ indentation.
+
+ * tmac/doc.tmac: Recognize `IN` register if set on command line
+ and use groff man(7)-compatible defaults if it is not.
+ * tmac/mdoc/doc-common (Sh): Use this register instead of
+ `doc-paragraph-indentation`.
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Stop setting pargraph indentation
+ defaults here.
+ * tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+ nroff): Document it.
+ * NEWS: Update item.
+
+ * tmac/tests/doc_Mt-works.sh:
+ * tmac/tests/doc_indents-correctly.sh: Update test expectations.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?62926>.
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (Sh): Fix code style nit. Set paragraph
+ indentation absolutely rather than incrementally. mdoc(7)
+ doesn't have relative inset macros like man(7)'s `RS`/`RE`, so
+ the relative measurement could mislead the reader. (The
+ section heading itself uses an indentation of 0.)
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Fix Debian #1022179.
+
+ * tmac/mdoc/doc-common (Ss): Indent entire subsection heading by
+ 3 ens, even if it breaks across output lines. (Change and
+ restore indentation explicitly instead of using a temporary
+ indent to achieve this. Also indent absolutely by 3n instead of
+ retreating by one quarter inch.)
+
+ Fixes <https://bugs.debian.org/1022179>. Thanks to ĐœĐ°Đ± for the
+ report.
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/doc_indents-correctly.sh: Add regression test for
+ Debian #1022179.
+
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Fix misleading register name.
+
+ * tmac/mdoc/doc-common (Sh):
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Rename `doc-subheader-indent` to
+ `doc-paragraph-indentation`, because the latter is what it's
+ used for.
+
+2022-10-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_POPPLER): Improve shell code portability.
+ Per the GNU Autoconf manual, "The -a, -o, '(', and ')' operands
+ are not present in all implementations, and have been marked
+ obsolete by Posix 2008. ...portable uses of test should never
+ have more than four arguments, and scripts should use shell
+ constructs like '&&' and '||' instead."
+
+2022-10-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/preconv/preconv.cpp: Alter usage message handling.
+ (usage): Summarize purpose of program and steer reader to man
+ page (only) if help was explicitly requested, and exit
+ successfully from here...
+ (main): ...instead of calling scope.
+
+2022-10-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/preconv/preconv.cpp (usage): Use more
+ communicative metasyntactic variable names.
+ * src/preproc/preconv/preconv.1.man (Synopsis, Options): Align
+ with updated usage message.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/html/pre-html.cpp: Alter usage message handling.
+ (usage): Summarize purpose of program and steer reader to man
+ page (only) if help was explicitly requested, and exit
+ successfully from here...
+ (main): ...instead of calling scope.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grolbp/lbp.cpp: Alter usage message handling.
+ (usage): Summarize purpose of program and steer reader to man
+ page (only) if help was explicitly requested, and exit
+ successfully from here...
+ (main): ...instead of calling scope.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grolbp/lbp.cpp (main): Handle `getopt_long()`
+ return value more idiomatically.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grolbp/lbp.cpp: Fix code style nits.
+ (main): Use standard C library symbols `EXIT_SUCCESS` and
+ `EXIT_FAILURE` instead of integer literals as arguments to
+ `exit()`. Add assertion.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grotty/tty.cpp: Alter usage message handling.
+ (usage): Summarize purpose of program and steer reader to man
+ page (only) if help was explicitly requested, and exit
+ successfully from here...
+ (main): ...instead of calling scope.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grotty/tty.cpp: Fix code style nits.
+ (main): Use standard C library symbols `EXIT_SUCCESS` and
+ `EXIT_FAILURE` instead of integer literals as arguments to
+ `exit()`. Replace `assert(0)` call with communicative
+ predicate.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/groff.cpp: Alter usage message handling.
+ (synopsis, help): Coalesce these two functions...
+ (usage): ...into this one. Summarize purpose of program and
+ steer reader to man page only if help was explicitly requested,
+ rather than blitzing user with text upon a usage error. Also
+ drop option summary from usage message, as it duplicates
+ groff(1).
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Alter usage message handling.
+ (help): Rename this subroutine...
+ (usage): ...to this. Summarize purpose of program and steer
+ reader to man page only if help was explicitly requested, rather
+ than blitzing user with text upon a usage error. Also drop
+ option summary from usage message, as it duplicates grog(1).
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Drop relic code and comments.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Migrate expansion of Perl interpreter in shebang.
+ Use the same technique as afmtodit, mmroff, gropdf, and pdfmom.
+
+ * src/utils/grog/grog.am (grog): Replace "@PERL@" instead of
+ '^\(#! \).*perl'.
+ * src/utils/grog/grog.pl: Use "@PERL@" in shebang.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [afmtodit]: Give program a usage message.
+
+ * src/utils/afmtodit/afmtodit.pl: Add new scalar `want_help` of
+ Boolean sense. Recognize new long option `--help`, attached to
+ `$want_help`. Stop stripping off directory name components from
+ program name when emitting diagnostics. No other groff program
+ does this (well, gropdf did until recently), and it might save
+ users some confusion if they're working with multiple copies of
+ afmtodit.
+ (usage): New subroutine reports usage message. If help was
+ explicitly requested, summarize purpose of program and steer
+ reader to man page.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [afmtodit]: Migrate expansion of Perl interpreter in shebang.
+ Use the same technique as mmroff, gropdf, and pdfmom.
+
+ * src/utils/afmtodit/afmtodit.am (afmtodit): Replace "@PERL@"
+ instead of "/usr/bin/perl".
+ * src/utils/afmtodit/afmtodit.pl: Use "@PERL@" in shebang.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [gropdf] Give program a usage message.
+
+ * src/devices/gropdf/gropdf.pl: Add new scalar `want_help` of
+ Boolean sense. Recognize new long option `--help`, attached to
+ `$want_help`.
+ (usage): New subroutine reports usage message. If help was
+ explicitly requested, summarize purpose of program and steer
+ reader to man page.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/xditview/xditview.c (Syntax): "#if 0" out
+ reference to `-noPolyText` option, whose effect is likewise
+ bracketed in another file.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (enable_warning, disable_warning):
+ Recast diagnostic messages for clarity.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [pfbtops]: Fix code style and diagnostic nits.
+
+ * src/utils/pfbtops/pfbtops.c (error): Exit with `EXIT_FAILURE`
+ status (from standard C library) instead of status 2.
+ (main): Exit with `EXIT_SUCCESS` status when writing version or
+ help information. Exit with status 2 when dying due to usage
+ error. Use `fprintf()` and `strerror()` to construct error
+ message when dying due to inability to open input file instead
+ of using `perror()`, which anonymizes its caller and thus should
+ never be used in serious work. Avoid it like `gets()`.
+ * NEWS: Add item for exit status changes.
+
+ Continues the long process of fixing Savannah #52463.
+
+2022-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man pages]: Don't document macro package compatibility wrapper
+ directory if it's not used.
+
+ * Makefile.am (.man): Use sed to replace
+ '@COMPATIBILITY_WRAPPERS@' in man page text with value of
+ `compatibility_wrappers` shell variable. Document its purpose.
+ * src/preproc/eqn/eqn.1.man (Description):
+ * src/preproc/grn/grn.1.man (Options):
+ * src/roff/groff/groff.1.man (Installation directories):
+ * src/roff/troff/troff.1.man (Environment): Mention
+ `@SYSTEMMACRODIR@` only if `@COMPATIBILITY_WRAPPERS@` expands to
+ something other than "no" (it could be "yes" or "manual").
+
+ Thanks to Alexander Kanavin and Jeremy Puhlman for the report.
+
+2022-10-21 Robert Yang <liezhi.yang@windriver.com>
+
+ * font/devpdf/util/BuildFoundries.pl:
+ * src/devices/gropdf/gropdf.pl:
+ * src/devices/gropdf/pdfmom.pl: Replace use of '-w' in shebang
+ line with "use warnings;".
+
+2022-10-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/fallbacks.tmac: Define fallback characters for many code
+ points from the Unicode General Punctuation Block. This is to
+ ease migration from other documentation formats; in many cases
+ there are more idiomatic *roff ways of getting results that
+ typeset better and are amenable to fine tuning. For instance,
+ Unicode defines spaces and dashes of various discrete widths;
+ when typesetting with *roff, you can have a space or dash (among
+ other things) of any length achievable by the output device.
+ * tmac/ps.tmac: Migrate non-breaking hyphen fallback character
+ definition from here to the foregoing.
+
+ Fixes <https://savannah.gnu.org/?58930>. Thanks to Dave Kemper
+ for the report and discussion.
+
+2022-10-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac:
+ * tmac/s.tmac: Escape newlines when opening conditional blocks.
+
+ Fixes <https://savannah.gnu.org/?63197>. Thanks to Bjarni Ingi
+ Gislason for the report and Dave Kemper for the quick fix.
+
+2022-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grodvi/dvi.cpp (usage):
+ * src/devices/grohtml/post-html.cpp (usage):
+ * src/devices/grolbp/lbp.cpp (usage):
+ * src/devices/grolj4/lj4.cpp (usage):
+ * src/devices/grops/ps.cpp (usage):
+ * src/devices/grotty/tty.cpp (usage):
+ * src/devices/xditview/xditview.cpp (usage):
+ * src/preproc/eqn/main.cpp (usage):
+ * src/preproc/grn/main.cpp (usage):
+ * src/preproc/html/pre-html.cpp (usage):
+ * src/preproc/pic/main.cpp (usage):
+ * src/preproc/preconv/preconv.cpp (usage):
+ * src/preproc/refer/refer.cpp (usage):
+ * src/preproc/soelim/soelim.cpp (usage):
+ * src/preproc/tbl/main.cpp (usage):
+ * src/roff/groff/groff.cpp (synopsis, help):
+ * src/roff/nroff/nroff.sh:
+ * src/roff/troff/input.cpp (usage):
+ * src/utils/addftinfo/addftinfo.cpp (usage):
+ * src/utils/hpftodit/hpftodit.cpp (usage):
+ * src/utils/indxbib/indxbib.cpp (usage):
+ * src/utils/lkbib/lkbib.cpp (usage):
+ * src/utils/lookbib/lookbib.cpp (usage):
+ * src/utils/pfbtops/pfbtops.c (usage):
+ * src/utils/tfmtodit/tfmtodit.cpp (usage):
+ * src/utils/xtotroff/xtotroff.c (usage): Update usage message.
+ Present different modes of operation on separate output lines.
+ Sort options in English lexicographic order. Document help
+ option(s) as last mode of operation.
+
+2022-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl: Revise handling of argument 0.
+ Rename scalar `progname` to `prog` for brevity (and preparation
+ for writing a usage message). Also stop stripping off directory
+ name components from it. No other groff program does this, and
+ it might save users some confusion if they're working with
+ multiple copies of gropdf.
+
+2022-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Migrate terminology from "paper size" to "paper format" or
+ "paper dimensions" as appropriate in documentation and
+ diagnostic messages. "Format" implies an orientation (which can
+ be overridden in many cases) whereas size does not. When only
+ the magnitudes of measurements are at issue (mainly for internal
+ purposes), use the term "dimensions".
+
+ * NEWS:
+ * PROBLEMS:
+ * doc/groff.texi:
+ * m4/groff.m4 (GROFF_PAGE):
+ * man/groff_font.5.man:
+ * man/groff_tmac.5.man:
+ * src/devices/grodvi/dvi.cpp (main):
+ * src/devices/grolbp/grolbp.1.man:
+ * src/devices/grolbp/lbp.cpp (main):
+ * src/devices/grolj4/grolj4.1.man:
+ * src/devices/grolj4/lj4.cpp (lj4_printer::lj4_printer, main):
+ * src/devices/grolj4/lj4_font.5.man:
+ * src/devices/gropdf/gropdf.1.man:
+ * src/devices/grops/grops.1.man:
+ * src/devices/grops/ps.cpp (main):
+ * src/roff/groff/groff.1.man:
+ * tmac/papersize.tmac: Do it.
+
+2022-10-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff (doc-left-parenthesis)
+ (doc-right-parenthesis, doc-left-bracket, doc-right-bracket):
+ Drop thin and hair space escape sequences from these string
+ definitions. (Also, doc-right-bracket was inconsistent with
+ doc-left-bracket, the former inserting horizontal motion only
+ before the bracket character.) Eliminates excess space when
+ using Pq, Po, Pc and Bq, Bo, Bc macros and formatting for
+ typesetters, and aligns output with behavior of `Pq` and `Bq` as
+ documented in groff_mdoc(7).
+
+ Fixes <https://bugs.debian.org/1021795>. Thanks to ĐœĐ°Đ± for the
+ report.
+
+2022-10-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff: Use groff-canonical typeface names in
+ font selection escape sequences. Migrate 'C' to 'CR' and 'CO'
+ to 'CI'. (Admittedly, "Courier oblique" is more pedantically
+ correct than "Courier italic". But the iron ball of Unix troff
+ history and its style trio [later quartet] of "R", "I", "B"
+ {then "BI"} will not be ignored.)
+
+2022-10-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff: Drop nilpotent type size escape
+ sequences from string definitions.
+
+2022-10-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Document a CSTR #54 erratum regarding \n(st and \n(sb.
+
+ * doc/groff.texi (Page Motions):
+ * man/groff.7.man (Writable registers):
+ * man/groff_diff.7.man (New registers): Do it.
+
+ * PROBLEMS: Further clarify. Note DWB and Heirloom behavior.
+
+2022-10-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/eqn/main.cpp (read_line): Fix switched test
+ consequents when updating `current_lineno`.
+
+2022-10-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/xtotroff/xtotroff.c (main): Annotate "xtotroff" as a
+ GNU program in version information.
+
+2022-10-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/xditview/xditview.am
+ ($(GXDITVIEW_GROFF_VERSION_H): Perform correct substitution to
+ get groff version string into `Version_string` C symbol.
+ Continues commit c73decb58f, 9 October.
+
+2022-10-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.1.man (Files): Fix ordering error.
+
+ Fixes <https://savannah.gnu.org/bugs/?63228>. Thanks to Bjarni
+ Ingi Gislason for the report.
+
+2022-10-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/eqn/lex.cpp (get_delimited_text): Clear line
+ number when hitting EOF.
+ * src/preproc/eqn/main.cpp: Revise end-of-file handling. Clear
+ line number upon reaching EOF so that we don't report a nonsense
+ value one greater than the number of lines in the input file.
+ (read_line): Boolify. Make static (local linkage only), since
+ it has no external callers. Introduce new Boolean variable
+ `is_end_of_file`. Clear `current_lineno` if EOF, and increment
+ it otherwise.
+ (do_file, main): Clarify diagnostic messages.
+
+2022-10-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [eqn]: Improve diagnostics involving unprintable characters.
+
+ * src/preproc/eqn/main.cpp (input_char_description): New
+ function constructs a human-readable string describing
+ characters.
+ (read_line, inline_equation, main): Call new function and adjust
+ diagnostic message wording to accommodate the phrase it returns.
+
+ Fixes <https://savannah.gnu.org/bugs/?63218>.
+
+2022-10-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [eqn]: Improve diagnostics.
+
+ * src/preproc/eqn/lex.cpp (file_input::~file_input):
+ * src/preproc/eqn/main.cpp (main): Die if `fclose()` fails and
+ report underlying system error.
+ (inline_equation): Identify inline equation context.
+
+2022-10-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/e.tmac (2c, 1c): Throw diagnostic if changing columnation
+ with a footnote pending. This isn't necessarily an error per
+ se, but in many cases it will flag an undesirable page layout
+ due to the limited flexibility of me(7)'s footnote support at
+ present. See <https://savannah.gnu.org/bugs/?63176>.
+
+2022-10-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/eqn/main.cpp: Fix code style nits.
+ (usage): Align output with man page. Document separate
+ invocation modes separately.
+ (main): Use standard C library symbols `EXIT_SUCCESS` and
+ `EXIT_FAILURE` with `exit()` calls instead of integer literals.
+ Replace `assert(0)` call with communicative predicate. Check
+ return value of `fclose()`, and exit with fatal error if it
+ fails. Distinguish `ferror()` status and `fflush(stdout)`
+ failures when cleaning up before exit.
+
+2022-10-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (read_color_draw_node): Clarify
+ diagnostic.
+
+2022-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/dvi.tmac: Always render \[aq] as a neutral apostrophe.
+ Thanks to the TC fonts, we can do this even when the default CM
+ text fonts are in use.
+
+ Fixes <https://savannah.gnu.org/bugs/?63200>.
+
+2022-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/ec.tmac: Remove apparently unnecessary remappings of
+ styles (and reassertion of style slots in the font mounting
+ position list, albeit in an unusual order (RBI instead of RIB)).
+ This code frustrated the rendering of man pages with post-1.22.4
+ groff for the 'dvi' output device when using EC fonts. Instead
+ remap the T and H family typefaces in all four styles
+ explicitly. (The CW and CWI faces were already handled.) Also
+ add remappings of groff+PostScriptish font names "CB" and "CBI"
+ to CW EC faces of normal weight, corresponding to dvi.tmac; see
+ commits 529e2ca0c4, 2002-03-23 and c9741da6c0, 2021-05-06.
+
+ Fixes <https://savannah.gnu.org/bugs/?63194>.
+
+2022-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/an_works-with-ec.sh: Add regression test for
+ Savannah #63194.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/ec_works.sh: Add unit test to validate use of EC
+ fonts when "-mec" option given.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/latin2.tmac:
+ * tmac/latin5.tmac:
+ * tmac/latin9.tmac: Perform the character remapping shenanigans
+ of the fix for Savannah #63112 only if the output device is
+ "latin1" (a terminal using an 8-bit character encoding). Only
+ then can we be sure that Latin-1 glyphs will be unavailable when
+ other encodings are used and that `\N` escape sequences will
+ identify correct glyph indices in a font (because there is no
+ font per se accessible to groff--simply a terminal implementing
+ a character encoding).
+
+2022-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl (GetType1): Clarify diagnostic.
+ When failing to open a font file for embedding in a PDF, mention
+ this context.
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.tables: Update against Unicode 15.
+ No substantive changes.
+
+ Fixes <https://savannah.gnu.org/bugs/?63188>.
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac: If URW fonts were located, add the directory
+ where they were found to the configuration report.
+
+ Attempts to fix <https://savannah.gnu.org/bugs/?62860> (2/2).
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4: Try to make gropdf's search for URW font files
+ more deterministic. To disambiguate cases where multiple--not
+ necessarily identical--copies may be found on the system, search
+ _only_ in the directory given to the `--with-urw-fonts-dir`
+ configure option, if present. This populates the "Foundry" file
+ generated by the build, causing gropdf to search there first.
+ (GROFF_URW_FONTS_PATH): Stop `AC_SUBST`ing `urwfontsdir` here.
+ (GROFF_URW_FONTS_CHECK): `AC_REQUIRE` `GROFF_URW_FONTS_PATH` to
+ be run first. If `urwfontsdir` is not null, search only there
+ for URW fonts. Assign `urwfontsdir` the value of the directory
+ in which the fonts are found. Assign it an empty value if none
+ are found. Either way, `AC_SUBST` the variable.
+
+ Attempts to fix <https://savannah.gnu.org/bugs/?62860> (1/2).
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl (LoadFont): Clarify diagnostic.
+ gropdf opens "fonts" in two distinct ways. On the one hand, it
+ opens groff font description files for essentially all
+ nontrivial output. On the other, it may open actual Type 1 font
+ files for embedding in a PDF. Make failure of the former case
+ less confusable with the latter.
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Document new XN/XH and related macros.
+
+ * doc/groff.texi (Creating a table of contents):
+ * doc/ms.ms (Creating a table of contents):
+ * tmac/groff_ms.7.man (Creating a table of contents): Do it.
+
+ Fixes <https://savannah.gnu.org/bugs/?63110>.
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [gxditview]: Support `-version`, `--version` option. As a C
+ program, gxditview had no access to the (C++) libgroff
+ `Version_string` symbol, so construct a header file to store
+ this datum at build time. If groff gets other user-facing C
+ programs, we should consider generating this header in
+ src/include instead.
+
+ * src/devices/xditview/xditview.am: Generate "groff_version.h"
+ file.
+ (GXDITVIEW_GROFF_VERSION_H): Define new macro.
+ ($(GXDITVIEW_GROFF_VERSION_H)): Define target to generate file.
+ (XDITVIEW_GENHDRS): Add $(GXDITVIEW_GROFF_VERSION_H).
+
+ * src/devices/xditview/xditview.c: Include new header file.
+ (Syntax): Report newly supported options.
+ (main): Recognize and handle new options.
+
+ * src/devices/xditview/gxditview.1.man (Synopsis): Document
+ them.
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [gxditview]: Update usage message production and contents.
+
+ * src/devices/xditview/xditview.c: Use C99 Boolean type.
+ (Syntax): Accept additional Boolean argument indicating whether
+ the usage message is to be issued due to an error. Write
+ message to stderr if so, and stdout otherwise. Stop presuming
+ length of output line; guessing where to wrap is unreliable due
+ to variable terminal width and length of argv[0]. Write one
+ line per invocation mode of the program. Stop duplicatively
+ documenting standard X Toolkit options. Exit with standard C
+ library `EXIT_FAILURE` status if there was an error, and
+ `EXIT_SUCCESS` otherwise.
+ (main): Refactor to prepare for `--version` support.
+
+ * src/devices/xditview/gxditview.1.man (Synopsis): Sync list of
+ options with usage message.
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Recognize "--version" as
+ synonym for "-v". To achieve this, use Getopt::Long instead of
+ Getopt::Std.
+ * src/utils/afmtodit/afmtodit.1.man (Synopsis, Options):
+ Document it.
+
+2022-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/pdfmom.pl: Recognize "--version" as synonym
+ for "-v".
+ * src/devices/gropdf/pdfmom.1.man (Synopsis, Description):
+ Document it.
+
+2022-10-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl (version): Identify as a GNU program.
+
+2022-10-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grolj4/grolj4.1.man (Typefaces): Add new
+ subsection.
+
+ Fixes <https://savannah.gnu.org/bugs/?60929>. Thanks to T. Kurt
+ Bond for the report.
+
+2022-10-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/meref.me.in (Columnated Output): Document persistence of
+ `$s` register value across columnation mode changes.
+
+ Fixes <https://savannah.gnu.org/bugs/?62717>. Thanks to Dave
+ Kemper for the report.
+
+2022-10-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/meref.me.in: Annotate empty default arguments more
+ consistently.
+
+ Fixes <https://savannah.gnu.org/bugs/?62801>. Thanks to Dave
+ Kemper for the report.
+
+2022-10-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/meref.me.in: Fix documentation error.
+ (Summary) <\_>: Describe as "underrule", not "underscore".
+ These are distinct: the latter is a glyph; the former is drawn
+ by typesetters and rendered with SGR attributes on terminals.
+
+2022-10-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * NEWS: Advise users of changes to "name" directive handling in
+ font description files.
+
+ Fixes <https://savannah.gnu.org/bugs/?61423>. Thanks to Dave
+ Kemper for the report.
+
+2022-10-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/number.cpp: Refactor and fix code style nits.
+ Boolify and rename static (local) functions.
+ - parse_expr -> is_valid_expression
+ - start_number -> is_valid_expression_start
+ - parse_term -> is_valid_term
+ Rename preprocessor macro `SCALE_INDICATOR_CHARS` to
+ `SCALING_UNITS`.
+ (is_valid_expression, is_valid_term): Rename parameters and
+ demote them from `int` to `bool`.
+ - scaling_indicator -> scaling_unit (no demotion)
+ - parenthesised -> is_parenthesized
+ - rigid -> is_mandatory
+ (is_valid_expression_start, is_valid_expression, is_valid_term):
+ Return Boolean rather than integer literals.
+ (get_vunits, get_hunits, get_number_rigidly, get_number)
+ (get_integer): Update call sites of renamed functions. Replace
+ Boolean-valued integer literals used as Booleans with Boolean
+ literals and annotate their purposes. (See <https://\
+ stackoverflow.com/questions/38076786/\
+ why-doesnt-c-support-named-parameters>.)
+ (get_vunits, get_hunits, get_number, get_integer): Replace `0`
+ in assertions with a communicative predicate. In all of these
+ it's an unhandled `switch()` case.
+
+2022-10-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (do_expr_test, do_zero_width): Use
+ better terminology in diagnostic messages.
+
+2022-10-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Fix Savannah #63151.
+
+ * src/roff/troff/input.cpp (read_draw_node): Throw "delim"
+ warning diagnostic when a drawing escape sequence ends the line
+ without a closing delimiter.
+
+ Fixes <https://savannah.gnu.org/bugs/?63151>.
+
+2022-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/fallbacks.tmac: Define fallbacks for characters in ISO
+ Latin-{2,5,9} but not in Latin-1.
+
+ Fixes <https://bugs.debian.org/782903>. Thanks to Rafal Pietrak
+ for the report.
+
+2022-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Fix Savannah #63149.
+
+ * src/roff/troff/reg.cpp (alter_format): Throw comprehensible
+ diagnostic when input delete character encountered in register
+ format.
+
+ Fixes <https://savannah.gnu.org/bugs/?63149>.
+
+2022-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Describe an input delete character comprehensibly.
+
+ * src/roff/troff/input.cpp (token::description): The delete
+ character (ISO 127 decimal, EBCDIC 7) is a valid `TOKEN_CHAR`
+ but is not printable. Don't attempt to output it literally in
+ diagnostics; describe it in a phrase instead.
+
+2022-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Apply consistent terminology.
+
+ * src/roff/troff/input.cpp: Rename functions to better align
+ with our documentation, and decouple their names from an
+ assumption of diagnostic severity. Also give them imperative
+ names since they are called for their side effects, not their
+ return values.
+ - empty_name_warning -> diagnose_missing_identifier
+ - non_empty_name_warning -> diagnose_invalid_identifier
+ (diagnose_missing_identifier): Refer to absent operand as
+ "identifier", not "name", in diagnostic messages since the
+ latter (strictly) refers to the request/macro/string/diversion
+ name space, and this function is also used to gather register
+ identifiers.
+
+2022-10-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Fix Savannah #63112 (3/3).
+
+ * tmac/latin2.tmac: Replace characters that ISO Latin-1 has but
+ Latin-2 doesn't. Map characters that ISO Latin-2 has and
+ Latin-1 doesn't to their numeric code points.
+
+2022-10-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Regression-test Savannah #63112 (3/3).
+
+ * tmac/tests/latin2_works: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Fix Savannah #63112 (2/3).
+
+ * tmac/latin5.tmac: Replace characters that ISO Latin-1 has but
+ Latin-5 doesn't. Map characters that ISO Latin-5 has and
+ Latin-1 doesn't to their numeric code points.
+
+2022-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Regression-test Savannah #63112 (2/3).
+
+ * tmac/tests/latin5_works: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Fix Savannah #63112 (1/3).
+
+ * tmac/latin9.tmac: Replace characters that ISO Latin-1 has but
+ Latin-9 doesn't. Map characters that ISO Latin-9 has and
+ Latin-1 doesn't to their numeric code points.
+
+2022-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Regression-test Savannah #63112 (1/3).
+
+ * tmac/tests/latin9_works: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp: Refactor to parallelize logic in
+ similar routines; namely, those handling escape sequences that
+ accept newlines as argument delimiters.
+
+2022-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp: Fix inconsistencies in handling of
+ escape sequences that accept newlines as delimiters. Some threw
+ spurious warnings as in Savannah #63011; others failed to treat
+ a newline-terminated escape sequence also as the ending of an
+ input line.
+ (do_name_test, do_zero_width): Suppress spurious warning.
+ (do_zero_width, do_width, do_special): Synthesize newline to
+ terminate input line.
+
+2022-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/\
+ some_escapes_accept_newline_delimiters.sh: Add test cases for
+ `\A` and test formatted output of escape sequences, not just the
+ absence of diagnostics from permitted use of newlines as
+ argument delimiters.
+
+2022-09-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libdriver/input.cpp (do_file): Make use of
+ positioning commands before the first page is started fatal
+ errors; they suggest ill-formed input. The 'p' command
+ clobbers the vertical position anyway. (See
+ https://bugs.debian.org/421437 for discussion.)
+
+2022-09-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdf.tmac: Add inclusion guard; if a `pdfmark` macro is
+ already defined, skip inclusion of this file. Unfortunately
+ there are multiple name collisions with pdfmark.tmac.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp:
+ * src/roff/troff/request.h: Trivially refactor. Boolify
+ `interpolate_macro` and `request::invoke`. Also rename
+ parameter `no_next` to `do_not_want_next_token`, exposing
+ potentially confusing interface design.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (spring_trap, interpolate_string)
+ (interpolate_string_with_args): Improve error diagnostics: when
+ a sprung trap or an interpolation fails because it's being
+ attempted on a request, say so explicitly and _name_ it. If the
+ argument to the trap-planting request or to a string
+ interpolation escape sequence is itself an interpolation, this
+ name might not be obvious. Consider:
+ .wh \n[pos] \*[mac]
+ .em \*[mac]
+ .itc 1 \*[mac]
+ \*[\*[mac]]
+ Supplying this information requires no additional overhead.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (interpolate_string): Trivially
+ refactor. Rename function parameter from `s` to `nm` to more
+ obviously align with `interpolate_string_with_args()`.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (do_zero_width, token::description)
+ (interpolate_string, interpolate_string_with_args)
+ (token::get_char): Revise diagnostic messages to stop presuming
+ the identity of the escape character.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (set_escape_char): Recast error
+ message to describe attempted operation and tell the user what
+ we're doing about being instructed to use an invalid escape
+ character.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (read_size): Be more helpful to
+ ambiguous type size escape sequence users; offer advice in
+ terms of the current escape character.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/groff.cpp (main): Fix SEGV when exiting
+ gxditview. The `postdriver` pointer always referred to
+ allocated memory except when the `-X` option was given; it was
+ then assigned the address of a #defined string literal. It was
+ thus statically allocated and an error to attempt to `free()`
+ it. Duplicate the string on the heap instead so that we can
+ clean up uniformly regardless of postprocessor. Problem caused
+ by me when introducing `xexit()` in commit 6769e56aab, 20 June.
+
+2022-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/e.tmac (@o, n2, sk (f, ++): Consistently call `@err`
+ macro with `do`.
+
+2022-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/e.tmac: Initialize new register `_f`, the value of `$m`
+ {column count} of the previous pending footnote, to zero,
+ meaning there is no previous pending footnote.
+ (@o): Emit diagnostic when flushing footnotes into a different
+ column layout than the pending footnote last added. Set `_f` to
+ zero.
+ ((f): Emit diagnostic when enqueueing footnote using a different
+ column layout than the previous pending footnote used. Set `_f`
+ to `$m`.
+
+ Fixes <https://savannah.gnu.org/bugs/?58736>. Thanks to Dave
+ Kemper for the report and discussion.
+
+2022-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/e.tmac: Explicitly initialize and annotate internal
+ register `?f`.
+
+2022-09-08 Nikita Ivanov <nikita.vyach.ivanov@gmail.com>
+
+ * tmac/ps.tmac: Fallback definitions for glyphs that usually
+ come from special fonts should use `schar` instead of `fchar`.
+ {Define fallback special characters using `schar` instead of
+ `fchar` for glyphs that we do not expect to find in text fonts;
+ that is, they don't have bold, italic, and bold-italic stylistic
+ variants. This means all special character definitions in the
+ file except for rules, ligatures, and digraphs. Problem dates
+ back to a series of commits from March 2002 to February 2003,
+ straddling the introduction of the `schar` request in November
+ 2002. --GBR}
+
+ Fixes <https://savannah.gnu.org/bugs/?62955>.
+
+2022-09-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Slightly simplify new `XN` macro feature to align it more
+ closely with Berkeley TOC macro behavior; don't prepend the
+ table of contents entry with the section number (`\*[SN]`). If
+ desired, a document can define `XN-REPLACEMENT`. This does not
+ regress "pdfmark.ms" because it uses an alternative, older
+ implementation of these features from "spdf.tmac".
+
+ * tmac/s.tmac (XH-UPDATE-TOC): Update comments.
+ (XN-REPLACEMENT): Do it.
+
+2022-09-20 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdf.tmac (pdf*href-I): Call `pdf:error` macro by its
+ correct name. Both this macro file and
+ contrib/pdfmark/pdfmark.tmac seem to want to use the 'pdf'
+ prefix for their macro names, with much confusing overlap.
+ Problem dates back to commit 87046b2948, 2011-07-26.
+
+2022-09-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_URW_FONTS_CHECK): If Ghostscript or awk are
+ unavailable, skip only the prepopulation of the URW font search
+ path instead of the entire check. This way we still locate the
+ URW fonts if they are in one of several standard locations.
+
+ Fixes <https://savannah.gnu.org/bugs/?62775>.
+
+2022-09-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Trivially refactor.
+
+ * src/roff/troff/input.cpp (do_name_test): Boolify and rename
+ local variables to..."impredicate" their names.
+ - bad_char -> got_bad_char
+ - some_char -> got_some_char
+
+2022-09-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grodvi, ...]: Trivially refactor.
+
+ Tidy up #includes of the "assert.h" header, which we locally
+ provide to ensure a C99-conformant implementation. Drop
+ inclusion of header from files that don't directly need it, add
+ it where they do, and spell the inclusion consistently with
+ double quotes to cue the reader of its local status.
+
+ * src/devices/grodvi/dvi.cpp:
+ * src/devices/grolj4/lj4.cpp:
+ * src/libs/libdriver/printer.cpp:
+ * src/preproc/eqn/box.cpp:
+ * src/preproc/eqn/delim.cpp:
+ * src/preproc/eqn/pile.cpp:
+ * src/preproc/eqn/script.cpp: Add inclusion.
+
+ * src/include/driver.h:
+ * src/libs/libgroff/fontfile.cpp:
+ * src/preproc/eqn/eqn.h:
+ * src/preproc/html/pushback.cpp:
+ * src/preproc/refer/refer.h:
+ * src/preproc/tbl/table.h:
+ * src/utils/addftinfo/addftinfo.cpp: Drop inclusion.
+
+ * src/include/itable.h:
+ * src/include/stringclass.h:
+ * src/libs/libbib/linear.cpp:
+ * src/libs/libbib/search.cpp:
+ * src/libs/libgroff/color.cpp:
+ * src/libs/libgroff/font.cpp:
+ * src/libs/libgroff/nametoindex.cpp:
+ * src/libs/libgroff/prime.cpp:
+ * src/libs/libgroff/searchpath.cpp:
+ * src/preproc/html/pre-html.cpp:
+ * src/preproc/preconv/preconv.cpp:
+ * src/preproc/soelim/soelim.cpp:
+ * src/utils/indxbib/indxbib.cpp:
+ * src/utils/lkbib/lkbib.cpp:
+ * src/utils/lookbib/lookbib.cpp: Respell inclusion.
+
+ Fixes <https://savannah.gnu.org/bugs/?63079>. Thanks to Bjarni
+ Ingi Gislason for the report.
+
+2022-09-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff, ...]: Trivially refactor.
+
+ Boolify and rename internal library function from
+ `invalid_input_char` to `is_invalid_input_char`.
+
+ * src/include/lib.h: Do it.
+
+ * src/libs/libgroff/font.cpp (text_file::next_line):
+ * src/preproc/eqn/lex.cpp (file_input::read_line):
+ * src/preproc/eqn/main.cpp (read_line, main):
+ * src/preproc/pic/lex.cpp (file_input::read_line,
+ simple_file_input::get, simple_file_input::peek):
+ * src/preproc/pic/main.cpp (top_input::get, top_input::peek)
+ (do_file):
+ * src/preproc/refer/command.cpp (input_stack::push_file):
+ * src/preproc/refer/refer.cpp (do_file, do_bib):
+ * src/roff/troff/env.cpp (environment::make_tag):
+ * src/roff/troff/input.cpp (file_iterator::fill)
+ (file_iterator::peek, get_char_for_escape_parameter)
+ (transparent_translate, read_request, asciify)
+ (input_char_description, read_string, transparent_file,
+ set_string): Update call sites.
+
+2022-09-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Tweak diagnostic messages.
+
+ * src/roff/troff/input.cpp (token::description)
+ (input_char_description): Consistently use articles in
+ descriptive noun phrases.
+
+2022-09-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Tweak diagnostic messages.
+
+ * src/roff/troff/input.cpp (non_empty_name_warning): Say
+ "identifier", not "name", in diagnostic message; it can be
+ thrown for attempted assignments to invalid register
+ identifiers, and some of our documentation refers to identifiers
+ in the name space shared by requests, macros, strings, and
+ diversions as "names".
+
+ * src/roff/troff/env.cpp (hyphen_trie::read_patterns_file):
+ * src/roff/troff/input.cpp (get_char_for_escape_parameter)
+ (token::usable_as_delimiter, non_empty_name_warning)
+ (pipe_source, psbb_locator::psbb_locator, open_request)
+ (opena_request, define_class, pipe_output, system_request):
+ Consistently say "_is_ not allowed". The zero copula poses too
+ great a risk of incomprehension IMO.
+
+2022-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Add internal string `doc-Lk-font` to manage the typeface
+ in which to render URIs.
+
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Add it. Use roman instead of (Courier)
+ bold. This is more consistent with man(7)'s `UR` and less with
+ mandoc(1).
+
+ * tmac/doc.tmac (Lk): Use it instead of `doc-Sy-font`.
+
+2022-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Fix Savannah #59738.
+
+ * tmac/doc.tmac (Lk): Process further macro arguments more like
+ other macros do, calling `doc-print-recursive`. This permits
+ recognition of end-of-sentence punctuation in the argument list.
+
+ Fixes <https://savannah.gnu.org/bugs/?59738>.
+
+2022-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Regression-test Savannah #59738.
+
+ * tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh: Do
+ it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Fix code style nit. Rename `doc-arg-limit` to
+ `doc-arg-count`. This register doesn't track any sort of limit
+ on the number of arguments you can give to an mdoc(7) macro, or
+ anything like that. It is simply a count of the number of
+ arguments visible to the currently operating macro.
+
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-common:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff:
+ * tmac/mdoc/doc-syms: Do it.
+
+2022-09-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [docs]: Fix errors in documentation regarding which escape
+ sequences accept newlines as argument delimiters, and other
+ inaccuracies.
+
+ * doc/groff.texi (Escape Sequences): Cover general cases before
+ exceptional ones. Leaders can be used as argument delimiters.
+ Call out letters and numerals as (usually) usable as well.
+ Correct an almost completely inaccurate list of escape sequences
+ that accept a newline as an argument delimiter: \A, \b, \o, \w,
+ \X, and \Z do; \B does not. Correct example of use of newline
+ as delimiter with \o escape sequence. Stop referring to the
+ decimal point as an "operator". Drop "newline" from a list of
+ prohibited delimiters by several escape sequences since it has
+ already been discussed.
+
+ * man/groff.7.man (Escape sequences): Replace weaksauce cross
+ reference to our Texinfo manual with a proper discussion of
+ acceptable delimiters in escape sequences, synced with the
+ foregoing change. Stop using quotation marks around escape
+ sequences, except for "\ " which obviously needs it.
+
+ Fixes <https://savannah.gnu.org/bugs/?63002>. Thanks to Dave
+ Kemper for the report.
+
+2022-09-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Don't throw a spurious warning when using newline as
+ delimiter with the few escape sequences that permit this.
+
+ * src/roff/troff/input.cpp (do_overstrike, do_bracket, do_width)
+ (do_special): Do it.
+
+ Fixes <https://savannah.gnu.org/bugs/?63011>. Thanks to Bjarni
+ Ingi Gislason for the report and Dave Kemper for the discussion.
+
+2022-09-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Add regression test for Savannah #63011.
+
+ * src/roff/groff/tests/\
+ some_escapes_accept_newline_delimiters.sh: Do it.
+ * src/roff/groff/groff.am (groff_TESTS): Run it.
+
+2022-09-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (do_special): Fix code style nit;
+ align function definition with declaration (internal linkage).
+
+2022-09-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grops/ps.cpp (ps_printer::special)
+ (resource_manager::process_file): Fix code style nit. Mark
+ static structs initialized within functions and never modified
+ thereafter as `const`. This attempts to work around an apparent
+ false positive from AddressSanitizer. If it doesn't pacify
+ ASAN, please explain to me how constant structure members
+ initialized to string literals and pointers to functions within
+ the translation unit can ever be null. If that is infeasible,
+ please report a bug to your compiler vendor.
+
+ Fixes (addresses, at any rate) https://savannah.gnu.org/bugs/\
+ ?61643>. Thanks to Bjarni Ingi Gislason for the report.
+
+2022-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Refactor: relocate most rendering option handling to
+ "doc.tmac" from "doc-ditroff" and "doc-nroff", cutting down on a
+ lot of duplication. The `S` register retains separate handling.
+
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Do it.
+
+2022-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-ditroff (doc-setup-page-layout): In troff mode,
+ if the user does not define the `LL` register, use the device's
+ default line length, not 6.5 inches. If the user does not
+ define the `LT` register, make the default line length for
+ titles the same as the regular line length, not 6.5 inches
+ independently of it. This is consistent with man(7)'s handling
+ of `LL` and `LT`.
+
+2022-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `AD` string to set default adjustment mode.
+
+ * tmac/mdoc/doc-common (Sh): Set adjustment mode to
+ user-specified default, not troff's default (and not only in
+ troff mode).
+
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Process `AD` string setting from command
+ line as man(7) does.
+
+ * tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+ nroff): Document it.
+
+ * NEWS: Add and update items.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?63046>.
+
+2022-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac (doc-tag-list): Fix code style nit: don't give
+ `ad` request a numeric argument. Say `l` instead of `0`.
+
+2022-09-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Align inter-paragraph spacing with man(7).
+
+ * tmac/mdoc/doc-common: Use `doc-paragraph-space` when spacing
+ prior to section and subsection headings instead of spacing by
+ the 1v default.
+ * tmac/mdoc/doc-ditroff: Align inter-paragraph distance amount
+ in troff mode with man(7), reducing to 0.4v from 0.5v.
+
+2022-09-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-nroff: Map monospaced fonts (CR, CB, CI, CBI) to
+ standard styles as man(7) has done for 15 years. This silences
+ warnings from the formatter when a man page attempts to use
+ fonts from the Courier family in tbl(1) tables, which is about
+ the only place a reasonable man page attempts such a thing.
+
+2022-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Stop prefixing center header with name of operating
+ system. This was hard-coded to "BSD" and stuck on all mdoc(7)
+ pages using a default manual section number, regardless of host
+ operating system. Bad idea. Further, the argument to the `Os`
+ call, if any, or a default, is always disclosed in the left
+ footer.
+
+ * tmac/mdoc/doc-common: Do it.
+ (Dt): Initialize `doc-volume` as empty and annotate it;
+ calling the macro with a numeric second argument overrides the
+ fallback default of "LOCAL". A slash is no longer needed to
+ separate a recognized architecture string from the OS name, so
+ drop it.
+
+ * tmac/tests/doc_smoke-test.sh: Update test expectations.
+
+2022-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Drop dead code. The register
+ `doc-volume-operating-system-ateol`, introduced in groff 1.18
+ {July 2002}, was being tested but never set to a nonzero value.
+ In fact, it seems never to have been.
+
+ * tmac/mdoc/doc-common: Get rid of it...
+ (Dt): ...and the dependent block.
+
+2022-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Make `Ux` render "Unix" in mixed case.
+
+ * tmac/mdoc/doc-syms (Ux): Do it. Also remove local string
+ after we're done with it.
+
+ Continues work begun prior to groff 1.22.4 release.
+
+2022-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Align spacing around headers with man(7).
+
+ * tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+ * tmac/mdoc/doc-common (Rd):
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Stop defining, saving, and restoring
+ `doc-header-space`.
+
+ * tmac/mdoc/doc-common (doc-header): When starting new document
+ and not continuously rendering, space by one half-inch instead
+ of by the now-defunct `doc-header-space` amount (which,
+ strictly, should not have applied to this measurement). If
+ continuously rendering, extend page length by 1v to accommodate
+ header line. After formatting header, if not continuously
+ rendering, space to 1 inch below first text baseline.
+
+2022-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Support `C` register for consecutive page numbering.
+
+ * tmac/mdoc/doc-common (Dd): Reset page number to 1 upon new
+ document only if not consecutively numbering.
+
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Process `C` register setting from command
+ line as man(7) does.
+
+ * tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+ nroff): Document it.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?63046>.
+
+2022-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Align trap management more closely with man(7).
+
+ * tmac/mdoc/doc-common: Call new macro (see below)
+ `doc-set-up-continuous-rendering` when initializing, if that
+ mode is configured.
+ (doc-ne): New macro replaces `ne` request
+ in continuous rendering mode. It extends the page length by the
+ amount in the argument or by 1v if none given.
+ (doc-bp): New macro replaces `bp` request in continuous
+ rendering mode, setting the page length to the vertical drawing
+ position.
+ (doc-set-up-continuous-rendering): New macro renames requests to
+ emplace the foregoing.
+ (Dd): Interpret this macro call strictly as starting a new
+ mdoc(7) document. (andoc.tmac already makes this assumption,
+ and has for over 20 years. groff_mdoc(7) and mandoc_mdoc(7)
+ also prescribe the sequence `Dd`, `Dt`, `Os`.) We require this
+ invariant even more rigidly now because it's the only way we can
+ be sure that we can process multiple documents while rendering
+ headers and footers with information corresponding to the
+ appropriate document. (man(7)'s `TH` has an advantage here in
+ that calling it is "atomic": from its arguments alone you can
+ obtain everything you need to know to format the header and
+ footer. In mdoc(7), permuting the initialization macro order
+ reliably produces chaos.) Break the page (if necessary)
+ _before_ processing any arguments (instead of after), to flush
+ the previous page's footer. Stop calling `doc-set-up-titles`
+ here; we don't have enough information to do that yet. Also
+ stop writing the PDF bookmark here, because `doc-document-title`
+ and `doc-section` will not reflect the new page content yet.
+ (Os): Once the `doc-operating-system` string content has been
+ determined, call `doc-set-up-titles`, write the PDF bookmark for
+ the page, and call `doc-header`, causing the page header to be
+ formatted. These changes further imply a stronger requirement
+ on initialization macro ordering being canonical.
+
+ Fixes <https://savannah.gnu.org/bugs/?62774> (7/7).
+
+2022-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Trivially refactor. Relocate string and macro
+ definition within file. mdoc(7) mandates that the document
+ setup macros `Dd`, `Dt`, and `Os` be called in that order;
+ arrange their definitions accordingly, for maintainability.
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Refactor. Rename strings and macro for clarity. These
+ things don't only affect headers.
+ - doc-header-string -> doc-pageref
+ - doc-header-string-saved -> doc-pageref-saved
+ - doc-setup-header -> doc-set-up-titles
+
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-common: Do it.
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Refactor. There is no difference in
+ `doc-header-string` and `doc-setup-header` between the files
+ "doc-ditroff" and "doc-nroff", so define them only once, in
+ "doc-common".
+
+ * tmac/mdoc/doc-common:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Do it.
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Align footer management more closely with man(7).
+
+ * tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+ * tmac/mdoc/doc-common (Rd):
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Stop defining, saving, and restoring
+ `doc-footer-space`.
+
+ * tmac/mdoc/doc-common (doc-break-body-text): New macro, called
+ only when not continuously rendering, schedules a page break.
+ (doc-footer): Stop vertically spacing by `doc-footer-space`,
+ instead relying upon a trap to move us here.
+
+ * tmac/mdoc/doc-ditroff (doc-setup-header):
+ * tmac/mdoc/doc-nroff (doc-setup-header): Set traps at the end
+ of the page where man(7) does by default; break the body text at
+ 1 inch from the page bottom, and write the footer at œ inch.
+
+ * tmac/mdoc/doc-nroff (doc-setup-header): Add 1/6 em "thin
+ space" between man page name and parenthesized section, for
+ precise parity with doc-ditroff implementation. (`\|` does not
+ take up any character cells on nroff devices.)
+
+ Fixes <https://savannah.gnu.org/bugs/?62774> (6/7).
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (Dt, Dd): Emit diagnostic warnings if
+ macros called with no arguments.
+
+ Fixes <https://savannah.gnu.org/bugs/?62774> (5/7).
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Fix code style nit: stop using Control+G as an escape
+ sequence argument delimiter. This is not necessary in groff and
+ hasn't been for at least thirty years. See the node/section
+ "Implementation Differences" of our Texinfo manual. Our mdoc
+ implementation does not operate in compatibility mode, so using
+ control characters like this obfuscates input to no advantage.
+
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-common:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff:
+ * tmac/mdoc/doc-syms: Do it.
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (doc-footer): Pull more footer concerns
+ into this macro. Don't bail out if continuously rendering;
+ instead, format the appropriate footer text if we are. For now,
+ break the page only if we are not continuously rendering.
+ (doc-end-macro): Call `doc-footer` instead of formatting footer
+ here.
+
+ Fixes <https://savannah.gnu.org/bugs/?62774> (4/7).
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (doc-end-macro): When continuously
+ rendering, set the page reference (e.g., "ls(1)") in the right
+ footer instead of repeating the left footer. Thanks to Ingo
+ Schwarze for the discussion.
+
+ * tmac/tests/doc_smoke-test.sh: Update expectations of footer
+ regression test.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?62926>.
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (doc-end-macro): Reset strings to reduce
+ info leaks from one man page to the next.
+
+ Fixes <https://savannah.gnu.org/bugs/?62774> (3/7).
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (Dt): Stop reinitializing `doc-volume`
+ and `doc-section`. This is the job of package initialization
+ {and, soon, the end-of-input macro}.
+
+ Fixes <https://savannah.gnu.org/bugs/?62774> (2/7).
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common: Populate default date string
+ `doc-date-string` with "UNDATED".
+ (Dd, Dt, Os): Make more orthogonal: stop touching
+ `doc-topic-name`. It is "doc.tmac"'s job to initialize it and
+ the `Nm` macro's job to update it.
+ (Dd): Do nothing if given no arguments. (You can still blank
+ out the document date with an explicitly empty argument:
+ .Dd ""
+ .)
+
+ Fixes <https://savannah.gnu.org/bugs/?62774> (1/7).
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common: Change `doc-default-operating-system`
+ string from "BSD" to "GNU", per discussion with Ingo Schwarze.
+ See <https://lists.gnu.org/archive/html/groff/2022-07/\
+ msg00280.html>.
+
+ * tmac/tests/doc_smoke-test.sh: Update expectations of footer
+ regression test.
+
+2022-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/mdoc/doc-common (Dt): Delete lingering and useless
+ definition of `doc-command-name` string. Thanks to Steffen
+ Nurpmeso for the report. See commit e9e92ee008, 27 August.
+
+2022-09-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/pic/pic.ypp (not_lower_than): Emit deprecation
+ warning for use of 'rand()' with a (non-empty) argument. The
+ man page has declared it thus for over 30 years, at least since
+ groff 1.02 (June 1991).
+
+2022-09-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/pic/pic.ypp (object_spec): Emit deprecation
+ diagnostic for "plot" command. The man page has declared it
+ thus for over 30 years, at least since groff 1.02 (June 1991).
+
+2022-09-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/pic/pic.ypp (placeless_element): Explicitly say
+ that an unsafe command is being ignored in diagnostic.
+
+2022-09-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/eqn/main.cpp (main): Drop man page reference from
+ deprecation diagnostics. The man page might be installed with a
+ prefix determined at configuration time, and that's too much
+ trouble to mess with for construction of a message. Trust the
+ user of these ancient options to try reading the man page with
+ the same name as the command.
+
+2022-09-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [docs]: Revise discussion of measurements.
+
+ * doc/groff.texi: Drop Texinfo @codequote* command brackets
+ around revised sections; relevant nodes have been reviewed for
+ correct glyph usage. Move concept index entries for obsolescent
+ term "machine units" to same location as "basic units".
+ Bump document date.
+ (Measurements): Rewrite presentation. We have already
+ introduced page geometry concepts, including the concept of
+ basic units.
+ (Motion Quanta): New subsection node; introduce this concept
+ much sooner, right after measurement units. Relocate
+ documentation of `.H` and `.V` registers from a miscellaneous
+ read-only register list here. Introduce example of rounding to
+ horizontal motion quantum.
+ (Default Units): Revise discussion. Stop abusing @result
+ notation in example.
+ (Built-In Registers): Relocate `.H` and `.V` as above.
+
+ * man/groff.7.man: Sync with Texinfo content updates.
+
+ Fixes <https://savannah.gnu.org/bugs/?61432>. Thanks to Bjarni
+ Ingi Gislason for the report.
+
+2022-09-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Drop groff_filenames(5) document. It says nothing accurate that
+ is not covered elsewhere.
+
+ * contrib/groff_filenames: Delete.
+ * doc/doc.am (GROFF_MAN_PAGES): Drop.
+ * src/roff/groff/groff.1.man: Drop cross reference to it.
+ * NEWS: Add item.
+
+ Fixes <https://savannah.gnu.org/bugs/?61818>.
+
+2022-09-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/tbl.1.man (Table data): Generalize discussion
+ of roff control line use in tables.
+ (Examples): Illustrate how to embed a comment in a table.
+
+2022-08-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * NEWS: man(7)'s `TS` no longer adds vertical space. See commit
+ 7ec36dc9b9, 30 July.
+
+2022-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/eqn/main.cpp (main): Issue deprecation warning
+ upon use of '-p' or '-s' options. The eqn(1) man page has
+ documented these as deprecated since at least groff 1.02 (June
+ 1991). Don't count on them sticking around another 30 years.
+
+2022-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/eqn/main.cpp (main): Clarify error diagnostics
+ regarding invalid option arguments. Identify the option being
+ handled at the time and characterize the argument as "invalid",
+ not "bad".
+
+2022-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [eqn]: Drop support for undocumented '-D' option. It has been
+ undocumented, and issued a warning of its obsolescence upon use,
+ for 30 years, since groff 1.06 (September 1992). That's plenty
+ long enough for a deprecation cycle.
+
+ * src/preproc/eqn/main.cpp (main): Do it.
+ * NEWS: Add item.
+
+2022-08-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: (EX, EE): Always break line, even if call invalid.
+
+ * tmac/an.tmac (EX, EE):
+ * tmac/an-ext.tmac (EX, EE): Do it. Ingo Schwarze pointed out
+ that page authors will expect breaking semantics from these
+ macros even if using them in an ill-formed way. In a
+ well-formed document, the breaks are redundant but harmless (the
+ later `nf` and `fi` requests, respectively, also cause breaks).
+
+2022-08-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Trivially refactor.
+
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-common: Rename string `doc-command-name` to
+ `doc-topic-name`; the former is misleading for man pages not in
+ sections 1, 6, or 8.
+
+2022-08-25 Bjarni Ingi Gislason <bjarniig@vortex.is>
+
+ * man/groff_char.7.man: Fix bad example syntax.
+
+ Fixes <https://savannah.gnu.org/bugs/?62959>.
+
+2022-08-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mdoc]: Trivially refactor.
+
+ * tmac/mdoc/doc-common:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Stop using "Null" as an empty string
+ indicator when comparing a string interpolation to an empty
+ parameter will serve just as well; it is also more idiomatic.
+ The string in question, `doc-section`, is never formatted if it
+ is empty anyway; the very tests at issue, which populate
+ `doc-header-string`, ensure this.
+
+2022-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/env.cpp (environment::set_family): Throw error
+ if user requests a font family that (when combined with the
+ current style) can't be resolved to a real font name. Fixes a
+ regression introduced by me in commit d8cb8cf9d8, 2021-09-15,
+ arising from a revision of font selection logic in node.cpp to
+ enable a bunch of _other_ font error diagnostics.
+
+ Fixes <https://savannah.gnu.org/bugs/?62941>. Thanks to Dave
+ Kemper for the report and two useful end points for a bisection.
+
+2022-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/env.cpp (environment::set_family): Add some
+ paranoia. Add `assert()`s on the previous font mounting
+ position still being valid and the font family dictionary lookup
+ not returning a null pointer. Add an early return for the
+ latter case (which should be impossible).
+
+2022-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/node.cpp (font_family::make_definite):
+ Refactor. Rename parameter from inscrutable `i` to
+ `mounting_position`. Add `assert()` to enforce invariant: we're
+ passed a mounting position that is nonnegative. Use `pos` as
+ short alias of parameter once we're into the function body.
+ Relocate conditional branches to front-load early returns as
+ well as those requiring little code to handle. This reduces the
+ average indentation level of the function, a readability win.
+
+2022-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Restore robustness to `EE` misuse.
+
+ * tmac/an.tmac: Add `an*is-in-example` register to track state
+ of within-exampleness. Not doing so can cause a spurious use of
+ `EE` to wrongly set the inter-paragraph distance to zero.
+ (TH): Initialize register.
+ (EX): Test register; if set, ignore macro call and, if
+ `CHECKSTYLE` warnings are on, throw diagnostic. Set register.
+ (EE): Test register; if clear, ignore macro call and, if
+ `CHECKSTYLE` warnings are on, throw diagnostic. Clear register.
+
+ * tmac/an-ext.tmac (EX, EE): Similar, using `mX` register.
+ Because AT&T troff had no `return` request, invert the sense of
+ the tests and put the entire macro bodies inside conditionals.
+
+ This regressed post-1.22.4. Thanks to Ingo Schwarze for the
+ report and a proposed patch.
+
+2022-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac: Refactor. Rename `mX` to `mZ` so we can use
+ `mX` for an "in-example" state register in a future commit.
+ Rename `mE` to `mF` to store the current font's mounting
+ position. Bizarrely, `mF` was not already used for this
+ purpose.
+
+2022-08-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+ Trivially refactor. Use separate string constant for invariant
+ material. (This will make it easier to, for example, store the
+ diagnostic level strings in an array that can be indexed by
+ their corresponding `enum` type.)
+
+2022-08-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (fatal_with_file_and_line)
+ (error_with_file_and_line, debug_with_file_and_line): Align more
+ closely with GNU Coding Standards regarding diagnostics: don't
+ suffix the colon after the program name with a space when
+ location information follows.
+
+2022-08-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grohtml/grohtml.1.man: Fix erroneous claim.
+ Images are not generated when "baseline rules" or "box rules"
+ are encountered in the input. These are troff special
+ characters; the former is converted to an underscore and the
+ latter to U+2502, "box drawings light vertical". This remains
+ true even if a series of them is drawn with the `\l` escape
+ sequence. (I also checked vertical line drawing with `\L`.
+ grohtml's handling of that provoked a rather wet eructation from
+ my lower esophageal sphincter--the output is assuredly not
+ correct. But it's still not an image.)
+
+2022-08-22 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ Bug #62934 - after glyph remapped mark it as used
+
+ When many glyphs are remapped from code points above 255
+ such as writing documents in cyrillic with the U-TR fonts,
+ gropdf starts reusing code points in the range 128-255.
+ If subsequently one of those code points is actually required,
+ such as \(em (code 138), and it has been replaced by a
+ cyrillic, then it needs to be mapped to another free code.
+
+ To determine if a particular code point is free each glyph
+ has a USED flag. The bug was caused because after remapping
+ \(em to the next free glyph the USED flag was not set. So the
+ next new cyrillic character to be entered was given the same
+ code point as had been allocated to \(em.
+
+ * src/devices/gropdf/gropdf.pl: Set the USED flag on remapped
+ glyphs.
+
+ Fixes <https://savannah.gnu.org/bugs/?62934>.
+
+ Thanks to Nikita Ivanov for spotting the problem and testing
+ the fix.
+
+2022-08-20 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ Bug #62923 - problem using aliased glyphs
+
+ With a large font if 2 characters above the 255 code
+ point limit are aliased, the aliased glyph has incorrect meta
+ data.
+
+ * src/devices/gropdf/gropdf.pl: Instead of duplicating a pointer
+ to the font metadata, duplicate the data itself. Then, if the
+ glyph is remapped to a code point under 256, the metadata is
+ preserved.
+
+ Fixes <https://savannah.gnu.org/bugs/?62923>. Thanks to Nikita
+ Ivanov for the report.
+
+2022-08-18 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ [gropdf]: Improve parsing of troff font files.
+
+ * src/devices/gropdf/gropdf.pl: Allow the glyph code number
+ to be octal or hex as well as a decimal number. If entity_name
+ is missing use name instead.
+
+2022-08-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Support pic(1) "flyback" feature.
+
+ * tmac/s.tmac (PF): Add macro; it does what `PE` formerly did,
+ minus vertical spacing.
+ (PE): Call `PF` and vertically space as before.
+
+ * doc/groff.texi (ms Insertions):
+ * doc/ms.ms (Tables, figures, equations, and references):
+ * tmac/groff_ms.7.man (Tables, figures, equations, and
+ references): Document it.
+
+ * NEWS: Add item.
+
+ Fixes <https://savannah.gnu.org/bugs/?60558>.
+
+2022-08-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/s.tmac (@PS): Validate better; check for 2 arguments
+ exactly.
+
+2022-08-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [pic]: Recognize `.PY` as synonym of `.PF`.
+
+ * src/preproc/pic/main.cpp:
+ * src/preproc/pic/pic.h: Add new Boolean variable,
+ `want_alternate_flyback` to record `.PY` usage.
+
+ * src/preproc/pic/main.cpp (top_input::get, top_input::peek):
+ Recognize it. Update diagnostic messages to mention it.
+ (main): Define `PY` troff macro as empty if not defined.
+
+ * src/preproc/pic/troff.cpp (troff_output::finish_picture):
+ Don't advance the vertical position if `want_alternate_flyback`.
+ Write out the `PY` macro call if it was on the input.
+
+ * src/preproc/pic/pic.1.man: Document it.
+
+ * tmac/pic.tmac (PY): Define the same as `PF`.
+
+ * NEWS: Add item.
+
+ Fixes <https://savannah.gnu.org/bugs/?62901>.
+
+2022-08-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [pic]: Refactor `flyback_flag`.
-2010-12-06 UKAI Fumitoshi <ukai@debian.or.jp>
- Colin Watson <cjwatson@debian.org>
+ * src/preproc/pic/main.cpp:
+ * src/preproc/pic/pic.h:
+ * src/preproc/pic/troff.cpp: Rename to `want_flyback`.
- Add Japanese localization.
+ * src/preproc/pic/main.cpp:
+ * src/preproc/pic/pic.h: Demote type from `int` to `bool`.
- * tmac/ja.tmac: New file.
- * tmac/Makefile.sub (NORMALFILES): Updated.
+ * src/preproc/pic/main.cpp (top_input::get, top_input::peek):
+ Use parentheses to clarify operation precedence.
-2010-12-06 Colin Watson <cjwatson@debian.org>
- Daiki Ueno <ueno@unixuser.org>
+2022-08-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- Implement support for character classes.
+ * src/preproc/eqn/eqn.1.man: Expand to include lists of
+ recognized primitives and predefined macros.
- This patch uses standard C++ headers, contrary to the rest of groff.
- Ideally, everything in groff should be updated to do the same.
+2022-08-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/font.h (glyph_to_unicode): New function.
+ * NEWS: Add item for new groff mm `V` register support.
- * src/libs/libgroff/font.cpp (glyph_to_unicode): Implement it.
- (font::contains, font::get_code): Use it.
+2022-08-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/charinfo.h: Include <vector> and <utility>.
- (charinfo): New members `ranges' and `nested_classes'.
- New member functions `get_unicode_code' and `get_flags'.
- New member functions `add_to_class', `is_class', and `contains'.
- (charinfo::overlaps_horizontally, charinfo::overlaps_vertically,
- charinfo::can_break_before, charinfo::can_break_after,
- charinfo::can_break_after, charinfo::ends_sentence,
- charinfo::transparent,, charinfo:ignore_hcodes): Use `get_flags',
- which handles character classes also.
+ * src/preproc/eqn/lex.cpp (do_delim): Recognize "delim on" even
+ in compatibility mode, enabling tbl to toggle eqn delimiter
+ recognition when it is run in compatibility mode as well.
+ * src/preproc/eqn/eqn.1.man (Controlling delimiters): Update.
+ * NEWS: Add item.
- * src/roff/troff/input.cpp (char_class_dictionary): New global
- variable.
- (define_class): New function.
- (init_input_requests): Register `class'.
+ Fixes <https://savannah.gnu.org/bugs/?62852>. Thanks to Bjarni
+ Ingi Gislason for the report.
- (charinfo::get_unicode_code, charinfo::get_flags,
- charinfo::contains): Implement it.
+2022-08-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS, doc/groff.texinfo (Character Classes), man/groff_diff.man,
- man/groff.man: Document it.
+ * tmac/an.tmac (TH): Fix spurious complaint from `CHECKSTYLE`
+ feature when a custom manual section title is declared for a
+ standard section number. Thanks to Quentin Monnet for the
+ report.
-2010-11-11 Anton Shepelev <anton.txt@gmail.com>
+2022-07-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- [grohtml]: Improve texinfo documentation.
+ * tmac/pdfpic.tmac: Finish incomplete string renames. Continues
+ 0fd6ab6b4c, 21 January.
+ pdfpic*file-name -> pdfpic*file-name-base
+ pspic-args -> pdfpic*pspic-args
- * doc/groff.texinfo (grohtml): Insert man page description, slightly
- extended.
+2022-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-11-11 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac (TS): Stop inserting space before tables. Unlike
+ ms(7), man(7) has no concept of "displays" and thus none of
+ "display distance". It is up to the page author to use
+ paragraphing macros around tables if vertical space is desired.
+ And not up to us to impose it.
- Fix crash in tbl with option `nospaces'.
- Reported by Louis Guillaume <louis@zabrico.com>.
+ Fixes <https://savannah.gnu.org/bugs/?62841>.
- * src/libs/libgroff/string.cpp (string::remove_spaces): If input
- data consists of spaces only and thus reduces to nothing, set `sz'
- to 0.
+2022-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-11-02 Ulrich Spörlein <uqs@spoerlein.net>
+ [man]: Regression-test Savannah #62841.
- [mdoc]: Complete previous patch and document OpenBSD releases.
+ * tmac/tests/an_TS-adds-no-vertical-space.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * tmac/doc-common (doc-operating-system-NetBSD): Add versions 5.0,
- 5.0.1, and 5.0.2.
- (doc-operating-system-OpenBSD-*): New strings.
- (doc-operating-system-FreeBSD-*): Add version 8.1.
- (doc-operating-system-DragonFly-*): Add versions 2.2, 2.4, 2.6, and
- 2.8.
- (Os): Handle DragonFly and OpenBSD.
+2022-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_mdoc.man: Document OpenBSD releases.
- Add DragonFly release 2.8.
+ * src/preproc/tbl/table.cpp (table::do_bottom): Avoid
+ overprinting a double-boxed table's bottom border on nroff
+ devices.
-2010-11-02 Ulrich Spörlein <uqs@spoerlein.net>
+2022-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- [mdoc]: Improve man page.
+ [tbl]: Expand regression test for Savannah #49390. Check for
+ overlap of double box borders, too.
- * tmac/groff_tmac.man: Fix prologue macro order.
- Update NetBSD, FreeBSD, and DragonflyBSD version numbers.
- Other minor layout improvements.
+ * src/preproc/tbl/tests/\
+ do-not-overlap-bottom-border-in-nroff.sh: Do it.
-2010-11-02 Anton Shepelev <anton.txt@gmail.com>
+2022-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- [grohtml] Improve man page.
+ [tbl]: Fix Savannah #49390.
- * src/devices/grohtml/grohtml.man: Document two-pass handling of
- input data.
+ * src/preproc/tbl/table.cpp (table::do_bottom): Avoid
+ overprinting a boxed table's bottom border on nroff devices.
-2010-09-19 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?49390>. Thanks to Osamu
+ Sayama for the report.
- [groff] Don't use prefix for preconv.
- Reported by Dorai Sitaram <ds26gte@yahoo.com>
+2022-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/groff.cpp (main): Fix it.
+ [tbl]: Regression-test Savannah #49390.
-2010-07-28 Larry Kollar <kollar@windstream.net>
+ * src/preproc/tbl/tests/\
+ do-not-overlap-bottom-border-in-nroff.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
- * doc/groff.texinfo, man/groff.man: Document `!' operator better.
+2022-07-28 Deri James <deri@chuzzlewit.myzen.co.uk>
-2010-06-28 Jan Vcelak <jvcelak@redhat.com>
+ [gropdf]: Improve slant application to lowercase Greek letters.
+ <https://lists.gnu.org/archive/html/groff/2022-07/msg00210.html>
- * src/roff/troff/node.cpp (make_node): Adding missing `%'.
- Reported in
- http://lists.gnu.org/archive/html/bug-groff/2010-06/msg00022.html
+ * tmac/pdf.tmac: Slant only if the glyph is sourced from a
+ special font, not a regular (text) font containing Greek glyphs.
-2010-06-05 Larry Jones <lawrence.jones@siemens.com>
+2022-07-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_diff.man: Document \n[.P].
+ * tmac/s.tmac: Add italic correction support to `I` and `BI`
+ macros. Call `par*define-font-macro` with newly recognized
+ third argument indicating that italic corrections should be
+ applied.
+ (par*define-font-macro): Apply the corrections if directed.
-2010-06-04 Werner LEMBERG <wl@gnu.org>
+2022-07-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Updated.
+ * src/roff/troff/input.cpp (input_char_description): Clear
+ static buffer on every entry to the function so that calling it
+ twice in succession where the second call populates the buffer
+ with less data than the first doesn't leave garbage characters
+ in a diagnostic message. Problem appears to date back to 1991
+ or earlier.
-2010-06-04 Denis M. Wilson <dmw@oxytropis.plus.com>
+ Fixes <https://savannah.gnu.org/bugs/?62813>.
- afmtodit: Add option `-o' to specify an output file.
+2022-07-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit.pl: Implement it.
- * src/utils/afmtodit.man: Document it.
+ * src/roff/troff/input.cpp (token::usable_as_delimiter):
+ (do_non_interpreted, interpolate_arg): Recast diagnostic
+ messages for clarity.
-2010-06-04 Larry Jones <lawrence.jones@siemens.com>
+2022-07-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_diff.man: Document \n[.O].
+ * tmac/e.tmac: Initialize section number registers. Fixes
+ warnings when starting section numbering at a depth greater than
+ 1.
-2010-05-30 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?62812>.
- Fix metric files for devps families A, BM, and font ZCMI.
- Problem reported by Denis M. Wilson <dmw@oxytropis.plus.com>.
+2022-07-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/{AB, ABI, AI, AR, BMB, BMBI, BMI, BMR, ZCMI}:
- Regenerated, using correct AFM files (from the Adobe Core 35 fonts
- with 229 glyphs).
+ * m4/groff.m4 (GROFF_PAGE): Use 'grep -q' instead of redirecting
+ standard output to null device. The '-q' option was
+ standardized in POSIX Issue 5 (1997) or earlier. Also drop the
+ redirection of the standard error stream; we have already
+ checked the file named in "$descfile" for existence and
+ readability. grep should thus not emit diagnostic messages.
-2010-05-28 Werner LEMBERG <wl@gnu.org>
+2022-07-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- Don't use obsolete intermediate output command `F'.
- Reported by Krzysztof Zelechowski <giecrilj@stegny.2a.pl>
+ * m4/groff.m4 (GROFF_PAGE): Macro used awk(1) without
+ `AC_REQUIRE`-ing a relevant macro or checking for its existence.
+ Fortunately, sed is powerful enough for our needs. Remove
+ dependency on awk. Cope with "search" directive in resolv.conf
+ having multiple arguments. Match "domain" directive in same
+ file instead of "dom", which I cannot find attested (this logic
+ dates to 1991). Rename `dom` shell variable to `domains` for
+ clarity, since its multiplicity could be greater than 1.
- * src/roff/troff/nodes.cpp (troff_output_file::really_put_filename):
- Replace `F' command with `x F'.
+2022-07-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-05-24 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_PAGE): Refactor: drop AC_DEFINE of
+ `PAGEA4`. This symbol appears to be a relic; it is nowhere
+ tested or dereferenced.
- * PROBLEMS: Document that mdoc doesn't work with test-groff.
- Reported by Krzysztof Zelechowski <giecrilj@stegny.2a.pl>
+2022-07-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-05-22 Werner LEMBERG <wl@gnu.org>
+ * tmac/tty-char.tmac: Drop definition of \[sd] special
+ character. This was superseded by commit 78e666246c, 8 May,
+ which defined a fallback for the character in tty.tmac instead.
+ Thanks to Dave Kemper for the catch.
- Document preconv in texinfo.
+2022-07-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo: Mention preconv and its related command line
- options for groff.
- Add stubs for direct preconv documentation.
- Sort groff options and environment variables.
+ * tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+ Skip test if "pdfinfo" command not available.
-2010-05-22 Werner LEMBERG <wl@gnu.org>
+2022-07-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- Use DESC's `unicode' keyword for grotty.
+ [build]: Add sanity checks for font description file generation
+ for PDF output device, prompted by discussion with Ingo
+ Schwarze. See <https://lists.gnu.org/archive/html/groff/\
+ 2022-06/msg00094.html>.
- Consequently, no longer check directly for the `utf8' device name
- which prevented the creation of arbitrarily called output device
- directories like `devunicode'.
+ * font/devpdf/tests/basic-fonts-present.sh:
+ * font/devpdf/tests/urw-fonts-present.sh: Add files.
- Problem reported by Christopher Yeleighton <giecrilj@stegny.2a.pl>
- in Savannah bug #29895.
+ * font/devpdf/devpdf.am (font_devpdf_TESTS): Add the former test
+ unconditionally, and the latter only if `HAVE_URW_FONTS`.
- * src/devices/grotty/tty.cpp (tty_printer): Remove `is_utf8' member.
- Replace all ocurrences with `font::is_unicode'.
- (tty_printer::tty_printer): Remove argument.
+2022-07-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grotty/grotty.man: Document `unicode' keyword.
+ * font/devpdf/devpdf.am: Refactor to simplify. Now that
+ symbol.map lives in the "devpdf/generate" directory along with
+ the other map files, it doesn't need a dedicated Makefile target
+ to produce it.
+ (DEVPDFFONTMAP_1, DEVPDFFONTMAP_2): Coalesce and rename to...
+ (devpdffontmapdata): ...this.
+ (font/devpdf/map/symbol.map:): Drop target.
+ (devpdffontmap_DATA, font/devpdf/download): Update dependencies.
-2010-05-19 Werner LEMBERG <wl@gnu.org>
+2022-07-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- Update symbol tables for devps font generation.
+ * font/devpdf/util/BuildFoundries.pl (LoadFoundry): Recast
+ diagnostic message so that the user understands the consequence
+ of failure to locate a Type 1 font file (that isn't one of the
+ base 14 PostScript level 1 fonts): the font will be unavailable
+ for the "pdf" output device.
- * font/devps/generate/textmap: Sort alphabetically.
- Replace tabs with spaces.
+2022-07-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/generate/symbolchars: Update list to remove duplicates
- which have already been added to `textmap' on 2007-04-09.
+ * font/devpdf/util/BuildFoundries.pl (LoadFoundry): Separate
+ lists of Type 1 font names with spaces as well as commas, for
+ better diagnostic message readability. Also begin message in
+ lowercase (per GNU Coding Standards).
- * font/devps/symbolmap: Regenerated.
+2022-07-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/*: Regenerate font definition files.
+ * font/devpdf/util/BuildFoundries.pl (LoadFoundry): Verify that
+ `$foundrypath->[$j]` is defined before operating on it.
-2010-05-09 Colin Watson <cjwatson@debian.org>
+2022-07-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- Handle ditroff command `Dt' without argument gracefully.
+ [afmtodit]: Clarify diagnostic message.
- Without this patch, grotty goes into an infinite loop if it tries to
- process
+ * src/utils/afmtodit/afmtodit.pl: When we have excess Adobe
+ Glyph List mappings for a groff special character identifier
+ {making the reverse mapping from groff special character to font
+ glyph name ambiguous}, report that we're ignoring the excess.
+ Use "print STDERR" instead of Perl "warn" built-in since we want
+ diagnostic messages to start with the name of the program
+ emitting them.
- x T utf8
- x res 240 24 40
- x init
- p1
- Dt
+2022-07-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/input.cpp (get_integer_arg): Emit a fatal error
- on a non-integer argument, bringing the code into line with the
- behaviour documented in the header comment.
- (get_possibly_integer_args): Terminate the loop on a non-integer
- argument.
- (next_arg_begin): Return newline or EOF after emitting the
- corresponding error, rather than continuing on to the next line.
+ [build]: Name and place PS->groff glyph name maps consistently.
-2010-05-01 Werner LEMBERG <wl@gnu.org>
+ * font/devps/symbolmap: Rename from this...
+ * font/devps/generate/symbol.map: ...to this.
- * doc/groff.texinfo: Improve documentation of \R escape.
+ * font/devpdf/devpdf.am (font/devpdf/map/symbolmap): Rename
+ target...
+ (font/devpdf/map/symbol.map): ...to this.
+ (font/devpdf/map/symbol.map): Copy "devps" version of file from
+ its new location in the "generate" subdirectory.
-2010-03-10 Werner LEMBERG <wl@gnu.org>
+ * font/devpdf/Foundry.in: Reflect rename.
- * doc/groff.texinfo: Document \n[DD] register.
- Updated version stuff.
+ * font/devps/generate/Makefile (symbolmap): Rename target...
+ ($(srcdir)/symbol.map): ...to this.
-2010-03-10 Larry Kollar <kollar@windstream.net>
+ * font/devps/devps.am (DEVPSGENFILES, EXTRA_DIST):
+ * font/devps/generate/Makefile (S, EURO $(SPECIALFONTS), clean):
+ * src/utils/afmtodit/afmtodit.1.man: Reflect rename and
+ relocation.
- * tmac/groff_ms.man: Document \n[DD] register.
- Problem reported by Ted.
+ * font/devps/generate/dingbats.rmap: Rename from this...
+ * font/devps/generate/dingbats-reversed.map: ...to this.
-2010-02-25 Colin Watson <cjwatson@debian.org>
+ * font/devps/devps.am (DEVPSGENFILES):
+ * font/devps/generate/Makefile (ZDR):
+ * src/utils/afmtodit/afmtodit.1.man: Reflect rename.
- Use named signals for `trap' in shell scripts.
+ * font/devps/generate/lgreekmap: Rename from this...
+ * font/devps/generate/slanted-symbol.map: ...to this.
- * contrib/eqn2graph/eqn2graph.sh, contrib/grap2graph/grap2/graph.sh,
- contrib/pic2graph/pic2graph.sh: Do it.
+ * font/devps/devps.am (DEVPSGENFILES):
+ * font/devps/generate/Makefile (SS):
+ * src/utils/afmtodit/afmtodit.1.man: Reflect rename.
-2010-02-25 Werner LEMBERG <wl@gnu.org>
+ * font/devps/generate/textmap: Rename from this...
+ * font/devps/generate/text.map: ...to this.
- Fix angle brackets in grohtml.
- Reported by Colin Watson <cjwatson@debian.org>.
+ * font/devpdf/Foundry.in:
+ * font/devpdf/devpdf.am (DEVPDFFONTMAP_1):
+ * font/devps/devps.am (DEVPSGENFILES):
+ * font/devps/generate/Makefile (TEXTMAP):
+ * src/devices/gropdf/gropdf.1.man:
+ * src/devices/grops/grops.1.man:
+ * src/utils/afmtodit/afmtodit.1.man: Reflect rename.
- * src/devices/grohtml/post-html.cpp (get_html_entity): Add U+27E8
- and U+27E9.
+2022-07-10 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-02-24 Colin Watson <cjwatson@debian.org>
+ * doc/doc.am (doc/ms.ps): Add dependency on "eqn", and call
+ groff with "-e" option.
+ * src/utils/grog/tests/smoke-test.sh: Update expected "grog"
+ output for the ms.ms document.
- Add new FreeBSD and Posix versions.
+2022-07-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc-common: Add FreeBSD versions 7.2, 7.3, and 8.0
- * tmac/doc-syms: Add Posix 2008
- * tmac/groff_mdoc.man: Document it.
+ * doc/doc.am (doc/ms.ps): Add dependency on "tbl".
-2010-02-16 Larry Kollar <kollar@windstream.net>
+2022-07-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- tbl: Add `nowarn' option.
+ * src/roff/troff/node.cpp (suppress_node::tprint): Add source
+ file line number after its name when emitting "grohtml-info", to
+ aid debugging.
- * src/preproc/tbl/table.h (table): Add `NOWARN' enumeration value.
+2022-07-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/main.cpp (process_options),
- src/preprox/tbl/table.cpp (table::compute_expand_width,
- table::compute_separation_factor): Handle `NOWARN'.
+ * src/roff/troff/node.cpp (get_register, get_string): Reorder
+ null pointer inequality comparisons; they don't need to be in a
+ funny order because it's pretty hard to mistype `!=` as an
+ assignment operator. Annotate them as null pointers to ease any
+ future migration to ISO C++11. Use primitive type constructor
+ instead of C-style cast operator; this seems more idiomatic.
- * src/preproc/tbl/tbl.man, NEWS: Document it.
+2022-07-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-02-08 Larry Kollar <kollar@windstream.net>
+ * src/preproc/html/pre-html.cpp (generateImages): Flush the
+ standard error stream after writing to it in a loop.
- * tmac/www.tmac (www-li-ol): Fix indentation if more than 10 items.
+2022-07-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-02-04 Larry Kollar <kollar@windstream.net>
+ * tmac/s.tmac (RP): Recognize new optional arguments
+ `no-renumber` and `no-repeat-info`, the latter as a synonym for
+ the existing `no`. The former suppresses the page number
+ manipulation that normally occurs. Drop now-unnecessary `pn 0`
+ request.
+ (top level, cov*first-page-init, RP, cov*print): Rename
+ `cov*rp-format` to `cov*use-rp-format` for clarity.
+ (cov*break-page): New macro breaks the cover page at the end,
+ resetting next page number to 1 only if desired by user.
+ (cov*print, cov*rp-print): Call `cov*break-page` instead of
+ invoking `bp`.
- Improve `tbl' warnings.
+ * doc/groff.texi (Document Description Macros) <RP>:
+ * doc/ms.ms (Document description macros) <RP>:
+ * tmac/groff_ms.7.man (Document description macros) <RP>:
+ Document them.
- * src/preproc/tbl/table.cpp (table::compute_expand_width,
- table::compute_separation_factor): Add file name strings to
- warnings.
+ * NEWS: Add item.
-2010-01-23 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-07-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- Fix `MC' macro of the ms package.
+ * tmac/s.tmac: Rename register `cov*rp-no` to
+ `cov*rp-no-repeat-info`.
- * tmac/s.tmac (@MC): Define `pg*col-top' after the paragraph has
- been initialized. Otherwise, using this example,
+2022-07-08 Deri James <deri@chuzzlewit.myzen.co.uk>
- .nh
- .nf
- .kern 0
- .pl 6c
- .ll 70n
- .MC 30n
- Text for multiple columns.
- Text for multiple columns.
- Text for multiple columns.
- Text for multiple columns.
- Text for multiple columns.
+ * font/devpdf/util/BuildFoundries.pl (LocateFile): Some systems
+ store .afm files in a parallel directory to the Type 1 files,
+ restore original path after checking for parallel directory.
- the columns start at different vertical positions.
+2022-07-07 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-01-23 Larry Kollar <kollar@alltel.net>
+ * font/devpdf/devpdf.am (font/devpdf/download): Call
+ "BuildFoundries" with new `--strict` option so that the build
+ fails if the AFM files for the URW fonts can't be found.
- * tmac/www.tmac (www-li-{ul,ol,dl}): Handle `PORPHANS' register.
+2022-07-07 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-01-23 Larry Kollar <kollar@alltel.net>
+ * font/devpdf/util/BuildFoundries.pl: Add Boolean-valued scalar
+ `beStrict` (defaults false) and new command-line option
+ `--strict` to make it true.
+ (LoadFoundry): Check return value of subroutine `LocateAF`.
+ Emit diagnostic if it is null, as a warning if not "strict", and
+ fatal if so.
- PROBLEMS: Document some Mac OS issues.
+2022-07-07 G. Branden Robinson <g.branden.robinson@gmail.com>
-2010-01-02 Deri James <deri@chuzzlewit.demon.co.uk>
+ * font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries): Add
+ dependency on "afmtodit" since "BuildFoundries" calls this
+ program when generating groff font description files from URW
+ fonts.
- Don't hardcode `ps' device.
- This is needed for cooperation with gropdf.
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/troff.cpp (troff_output::text): Use GROPS_REG.
+ [ms]: Fix Savannah #62690.
-2009-12-31 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (P1, SC, UC, P2): Drop undocumented support for
+ document-private macros used by Kernighan & Cherry's
+ "Typesetting Mathematics -- User's Guide (Second Edition)".
- Make patterns with uppercase letters work.
- Problem reported by Bjarni Ingi Gislason <bjarniig@rhi.hi.is>.
+ Fixes <https://savannah.gnu.org/bugs/?62690>.
- * src/roff/troff/input.cpp (init_hpf_code_table): Use `cmlower'.
- * doc/groff.texinfo, man/groff_diff.man: Update documentation of
- `hpfcode' request.
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-11-24 Maurice van der Pot <griffon26@kfk4ever.com>
+ [ms]: Fix Savannah #62688.
- Fix double frees and memory leaks.
+ * tmac/s.tmac (DE): Set no-space mode when ending displays.
+ (@EN): Set no-space mode after outputting the display distance
+ so that it doesn't combine with inter-paragraph space.
- * src/roff/troff/env.cpp (environment::make_tag): Use local object.
- * src/roff/troff/input.cpp (input_stack::check_end_diversion): Free
- `diversion_state' here.
- (interpolate_arg): Fix memory leaks.
- * src/roff/troff/mtsm.cpp (mtsm::pop_state): Don't free `sp->state'.
+ Fixes <https://savannah.gnu.org/bugs/?62688>.
-2009-11-20 Paulo Ricardo Zanoni <pzanoni@mandriva.com>
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * */*.cpp: Replace `printf(string);' with `printf("%s", string);'.
+ [ms]: Regression-test Savannah #62688.
-2009-10-28 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/s_no-excess-space-around-displays.tmac: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- Document limitations with `#' characters, tbl, and eqn.
- Problem reported by Michael Kain <mcain6925@comcast.net>.
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/eqn.man, src/preproc/tbl/tbl.man: Do it.
+ [ms]: Fix Savannah #62687.
-2009-10-26 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (@MC): Honor `MINGW` register even when setting
+ only two columns, as clearly implied by our documentation.
- * tmac/doc-common (Dx): Define register.
+ Fixes <https://savannah.gnu.org/bugs/?62687>.
-2009-10-26 Jörg Sonnenberger <joerg@britannica.bec.de>
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- Implement `%U' in mdoc for URL references.
+ [ms]: Regression-test Savannah #62687.
- * tmac/doc-common (%U): New register.
- (Rd): Handle `doc-url-count' and `doc-url-name'.
+ * tmac/tests/s_honor-MINGW-when-two-columns.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * tmac/doc.tmac (doc-url-count, doc-url-name): New registers.
- (doc-save-global-vars, doc-restore-global-vars, doc-reset-reference,
- doc-print-reference): Handle `doc-url-count' and `doc-url-name'.
- (%U): New macro.
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS, tmac/groff_mdoc.man: Document `%U' macro.
+ [ms]: Fix Savannah #62686.
-2009-09-09 Jari Aalto <jari.aalto@cante.net>
+ * tmac/s.tmac (@MC): Set no-space mode before doing a paragraph
+ reset, not after: we don't want vertical space at the top of the
+ first column when entering multi-column mode, because then it
+ doesn't align with the tops of subsequent columns.
- * src/roff/groff/groff.man: Point to troff(1) for `-w' and `-W'.
+ Fixes <https://savannah.gnu.org/bugs/?62686>.
-2009-09-08 Werner LEMBERG <wl@gnu.org>
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- [troff]: Fix hyphenation problem with kerned letters.
- Problem reported by Steve Izma <sizma@golden.net>.
+ [ms]: Regression-test Savannah #62686.
- * src/roff/troff/node.cpp
- (kern_pair_node::add_discretionary_hyphen): Compute `tf' using the
- first node, `n1'. `n2' might be another kerning node, and the
- `get_tfont' member function isn't defined then.
+ * tmac/tests/s_mark-column-start-correctly.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2009-09-01 Michael Cain <mcain6925@comcast.net>
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- [pic] Fix a border case for arc computation.
+ * tmac/s.tmac (IX): Drop.
+ * NEWS: Add item.
- * src/preproc/pic/object.cpp (object_spec::make_arc): It can happen
- that test `radius < d' in the loop is satisfied, but the difference
- in the two values is on the order of 1e-10. If `radius' is small,
- doubling the value can lead to a fairly gross error.
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- The original code appears to have been intended to deal with the
- situation when radius is orders of magnitude less than `d'. The
- replacement code simply assigns `radius' the smallest value that
- avoids problems with the floating point code further on in the
- routine.
+ * tmac/s.tmac: Add "sorry" implementations for documented but
+ unsupported Unix Version 7 ms macros. This way it's easier to
+ tell when a historical document needs one and this case is
+ distinguishable from a document-private macro warned about with
+ "groff -w mac".
-2009-08-14 Roger Leigh <rleigh@debian.org>
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_char.man: Fix white heart and diamond unicode values.
+ * tmac/s.tmac (UX): Drop undocumented support for this macro.
+ This implementation isn't consistent with historical ones, which
+ identified the trademark holder. But doing that is a problem,
+ so just stop trying to cope. Also, spelling Unix in full caps
+ was an imposition by the AT&T legal department on the CSRC.
-2009-07-29 Werner LEMBERG <wl@gnu.org>
+ "The name Unix is a trademark, originally owned by Bell Labs and
+ subsequently traded off like a baseball card among a number of
+ companies." -- Ben Klemens
- * tmac/hyphen.fr: Fix typo which prevents hyphenation.
- Reported by Seb <sbb@tuxfamily.org>.
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-06-25 Werner LEMBERG <wl@gnu.org>
+ [ms]: Replace incomplete documentation of unimplemented macros.
- Make groff compile on Interix.
- Reported by Jay Krell <jay.krell@cornell.edu>.
+ * doc/groff.texi (Missing ms Macros):
+ * doc/ms.ms (AT&T ms macros not appearing in groff ms): Drop,
+ replacing with...
- * configure.ac: Call AC_USE_SYTEM_EXTENSIONS.
+ * doc/groff.texi (Unix Version 7 ms Macros Not Implemented by
+ groff ms):
+ * doc/ms.ms (Unix Version 7 ms macros not implemented by groff
+ ms):
+ * tmac/groff_ms.7.man (Unix Version 7 macros not implemented by
+ groff ms): ...these.
- * src/include/lib.h [__INTERIX]: Define _ALL_SOURCE.
+2022-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure: Regenerated.
+ * src/roff/troff/input.cpp (do_translate): Throw an error
+ diagnostic when the user attempts to translate space characters.
+ {By contrast, translating _to_ [unbreakable, unadjustable]
+ spaces is an old troff hack often seen as ".tr ~ ", and largely
+ superseded by groff's "\~" escape sequence, now widely supported
+ by other troffs.}
-2009-05-29 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?60803>. Thanks to T. Kurt
+ Bond and Oliver Corff for the report.
+
+2022-07-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/pipeline.c: Refactor. Drop function rename via
+ preprocessor macro usage. Declare and define `c_error` by its
+ correct name.
+ (run_pipeline): Update call sites. Stop flushing standard error
+ stream after calling libgroff's `error` function (which
+ `c_error` wraps); libgroff already guarantees this operation.
+
+2022-07-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (abort_request): Flush the standard
+ error stream before exiting, to improve chances of user seeing
+ any message as arguments to the `ab` request.
+
+2022-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/html/pre-html.cpp
+ (char_buffer::run_output_filter): Die if platform supports
+ neither `fork()` nor `spawn()` for child process creation.
+
+2022-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/html/pre-html.cpp (cleanup): Add function to tidy
+ memory before exiting.
+ (main): Register aforementioned function with `atexit()`. Die
+ if registration fails.
+
+2022-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/html/pre-html.cpp (do_file): Die if `fclose()`
+ fails; such a situation suggests a pretty hosed environment.
+
+2022-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/html/pre-html.cpp (checkImageDir): If `mkdir()`
+ fails, use `strerror()` to report the underlying problem.
+
+2022-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/html/pre-html.cpp: Refactor. Drop unnecessary
+ prototype for static function. Use idiomatic C++98 null pointer
+ constant. Annotate it as null pointer to ease any future
+ migration to ISO C++11. Boolify. Use C++98 bool data type
+ instead of preprocessor macros `TRUE` and `FALSE`. Demote some
+ global Boolean variables from `int` to `bool` and rename some to
+ be more clear: `show_progress` -> `want_progress_report`;
+ `debugging`; `eqn_flag` -> `need_eqn`.
+ (make_message): Rename this...
+ (make_string): ...to this. Align more closely with contemporary
+ version of example from Linux man-pages printf(3) page. Use
+ `vsnprintf()` to determine size of memory buffer needed prior to
+ allocation instead of iteratively growing it until it is large
+ enough. Always die if `vsnprintf()` fails: this function now
+ always returns a valid pointer if it returns at all.
+ (makeFileName, setupAntiAlias, imageList::createPage,
+ imageList::createImage): Update call sites to use
+ `make_string()`.
+ (char_buffer::can_see): Demote return type from `int` to `bool`.
+ (char_buffer::skip_spaces): Drop unused member function.
+ (char_buffer::read_file, makeTempFiles): Demote return type from
+ `int` to `void`. Stop returning after calling functions that
+ don't return.
+ (char_buffer::read_file): Call `sys_fatal()` if `fread()`
+ returns an error, similarly to other calls into the standard C
+ library that this file makes. Improve check for error from
+ `fread()` by not regarding a return value of zero when the
+ end-of-file indicator is set as an error condition.
+ (makeFileName, checkImageDir, char_buffer::run_output_filter,
+ scanArguments): Call `fatal()` instead of `error()` and then
+ `exit(1)`.
+ (makeFileName, scanArguments): Dismiss Shlemiel the Painter:
+ save return value of `strlen()` and call `strcpy()` multiple
+ times instead of mixing `strcpy()` and `strcat()`; the latter
+ approach rescans the string unnecessarily.
+ (char_buffer::run_output_filter): Stop passing unnecessary null
+ pointer argument to diagnostic message functions. Stop calling
+ `fflush()` after libgroff diagnostic function, which always
+ {ultimately} flushes the standard error stream itself.
+ (makeTempFiles, do_file, main): Boolify.
+ (makeTempFiles, do_file): Reorder null pointer equality
+ comparisons to avoid inadvertent lvalue assignment.
+ (scanArguments, main): Use `EXIT_SUCCESS` and `EXIT_FAILURE`
+ constants from C library instead of integer literals for exit
+ status.
+ (do_file): Demote return type from `int` to `bool`. Return
+ Boolean literals. Drop conditional with empty consequent.
+ (main): Declare local variables closer to the points of use.
+ Stop trying to be a register allocator: stop reusing loop index
+ variable `i` as integer storage for another (albeit related)
+ purpose; introduce `operand_index` instead. Clarify logic by
+ splitting combined initialization and comparison operations, and
+ by testing function return value directly instead of storing it
+ in a pointless temporary. Use `EXIT_SUCCESS` and `EXIT_FAILURE`
+ constants from C library instead of integer literals for exit
+ status.
+
+2022-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/groff.cpp (run_commands): Trivially refactor.
+ Rename variable for clarity; add comment.
+
+2022-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/html/pre-html.cpp
+ (char_buffer::run_output_filter): Return wait status of child
+ process.
+ (char_buffer::run_output_filter, main): Rename local variable
+ `status` to `wstatus` to recognize distinction between exit
+ status (a 7-bit quantity) and wait status (a wider type).
+ (main): Issue fatal diagnostic if child process exited with
+ nonzero status. Since the child's output to the standard error
+ stream is lost, advise re-running with different output driver
+ to see them. This unhappy shortcoming is filed as Savannah
+ #62673. Explicitly return zero otherwise.
+
+ Fixes <https://savannah.gnu.org/bugs/?60782>.
+
+2022-06-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/ab_works.sh: Add regression test for
+ Savannah #60782.
+
+2022-06-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Trivially refactor.
+
+ * src/roff/troff/input.cpp (token::next): Rename statement label
+ to use documentary terminology.
+ * src/roff/troff/node.cpp (make_composite_node)
+ (make_glyph_node): Make functions static since nothing outside
+ this translation unit calls them.
+ * src/roff/troff/node.cpp (make_glyph_node): Refactor optional
+ argument and its usage. Put it down, flip it, and reverse it.
+ That is, demote its type from `int` to `bool`, invert its sense,
+ and rename it since it affects warning, not error, diagnostics.
+ (character_exists): Update only call site of `make_glyph_node()`
+ that uses non-default argument value.
+
+2022-06-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Adjust diagnostic message text to clarify and better
+ match terminology used in documentation.
+
+ * src/roff/troff/input.cpp (set_escape_char, do_overstrike)
+ (do_bracket, do_name_test, do_width, do_special):
+ * src/roff/troff/node.cpp (suppress_node::tprint): Migrate from
+ "escape" to "escape sequence".
+
+ * src/roff/troff/node.cpp (make_composite_node)
+ (make_glyph_node): Clarify what went wrong.
+
+ * src/roff/troff/input.cpp (token::get_char)
+ (check_missing_character): Migrate from "normal character" to
+ "ordinary character" (see groff_char(7)).
+
+2022-06-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Rename a function for clarity.
+
+ * src/roff/troff/input.cpp (add_to_node_list): Rename this...
+ (add_to_zero_width_node_list): ...to this.
+ (do_zero_width): Update call site.
+ * src/roff/troff/token.h: Update declaration.
+
+2022-06-22 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/groff.cpp (handle_unknown_desc_command):
+ Refactor to skip unnecessary string comparisons. We explicitly
+ return in the final case instead of falling off the end of this
+ void function for consistency if additional cases are added.
- pic: Fix handling of nested positions.
- Reported by Doug McIlroy <doug@cs.dartmouth.edu>.
+2022-06-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/pic.y: Split `expr' into `expr_lower_than' and
- `expr_not_lower_than' so that we can handle
+ * src/roff/groff/groff.cpp (handle_unknown_desc_command):
+ Partially revert commit 64dc40d23a, 19 June. I forgot to save
+ and restore the previous values of the globals
+ `current_filename` and `current_lineno`, and, noticing that this
+ function has 3 return paths, decided that it's cheaper just to
+ go back to `error_with_file_and_line()`.
- (1/3)<(1/2)<foo,bar>,baz>
+2022-06-21 Deri James <deri@chuzzlewit.myzen.co.uk>
- correctly. Without the patch, `(1/3)<(1/2)' is handled prematurely
- as a comparison.
+ [gropdf]: Add more search paths to the Foundry file.
-2009-05-07 Werner LEMBERG <wl@gnu.org>
+ * font/devpdf/Foundry.in: Use the directory specified with the
+ config flag --with-urw-fonts-dir to populate the default foundry
+ as well as the U foundry. Important to populate the download
+ file with font files to embed the fonts not part of the base
+ pdf fonts or if user wants all fonts embedded.
- Accept \0 and friends within \o.
- Reported by Doug McIlroy <doug@cs.dartmouth.edu>.
+2022-06-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/token.h (token): Add TOKEN_HORIZONTAL_SPACE
- enumeration value together with `horizontal_space' member function.
- Add `do_overstrike' as a friend.
+ * tmac/an-ext.tmac (UR, MT): Fix problem with hyphenation
+ occurring before the end of the line when the line length was
+ not the device default (common for man pages at the terminal)
+ and hyperlinks were enabled. The issue is that the new
+ environment we created inherits the default environment's line
+ length (its state at troff initialization, prior to macro
+ package loading and configuration). This latent issue was
+ exposed by post-groff 1.22.4 changes to enable the hyphenation
+ of link text and add the hyperlink feature. Fix it by copying
+ the line length at the time the macro is called, which is
+ necessarily after man(7) sets up the line length, to the new
+ environment.
- * src/roff/troff/input.cpp: Use TOKEN_HORIZONTAL_SPACE for \0, \|,
- \^, and \h.
- Update all affected places.
- (do_overstrike): Remove `static' attribute.
- Accept all escapes which produce a fixed horizontal space.
+2022-06-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-04-24 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grops/psrm.cpp (resource_manager::output_prolog):
+ (resource_manager::supply_resource):
+ (resource_manager::read_download_file): Update diagnostic
+ message language and report underlying problem encountered by
+ system when failing to open files. This will probably be the
+ text for ENOENT in most cases, but should help avoid frustration
+ in those where it isn't.
- Use straight quotes where appropriate.
- Reported by Reuben Thomas <rrt@sc3d.org>.
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff.man: Do it.
+ * src/devices/grops/psrm.cpp
+ (resource_manager::read_download_file): Align diagnostic message
+ wording with gropdf in the same circumstance.
-2009-04-14 Werner LEMBERG <wl@gnu.org>
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- Fix documentation of `em' request.
- Reported by Joachim Walsdorff
- <Joachim.Walsdorff@urz.uni-heidelberg.de>.
+ [troff]: Throw warning in font category when a font selection
+ escape sequence is used after the output line continuation
+ escape sequence on an input line, because it is ignored.
- * doc/groff.texinfo (End-of-input Traps): Rewrite.
+ * src/roff/troff/env.cpp (environment::set_font): Do it.
-2009-04-10 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Warnings):
+ * src/roff/troff/troff.1.man (Warnings): Document it.
- Fix a memory leak in troff for -Thtml.
- Reported by Urs Eggli <Urs.Eggli@zuerich.ch>.
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/node.h (node::~node): Move to...
- * src/roff/troff/node.cpp: Here. Free `state' and `push_state'.
+ * src/roff/troff/env.cpp (font_change): Boolify.
-2009-04-01 Werner LEMBERG <wl@gnu.org>
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc.tmac: Call `ec' before mapping characters.
+ * src/devices/gropdf/gropdf.pl (LoadFont): Revise error message
+ when a font can't be found for embedding. User failure to add
+ an entry for locating the font file seems a more likely scenario
+ than outright corruption of the file.
-2009-03-07 Werner LEMBERG <wl@gnu.org>
- Gunnar Florus <http://florus.no>
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- Improve configuration.
+ * src/roff/troff/env.cpp (font_change): Warn upon selection of a
+ nonexistent font name.
- * configure.ac: Read `VERSION' and `REVISION' files to provide
- proper values for AC_INIT.
- * Makefile.in: Use `@datarootdir@' and `@docdir@' so that
- configure's `--datarootdir' and `--docdir' options are honoured.
- Documentation is now by default installed into something like
- `/usr/local/share/doc/groff-1.20.1'.
+ Fixes <https://savannah.gnu.org/bugs/?62656>.
- * configure: Regenerated.
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-02-21 Colin Watson <cjwatson@debian.org>
- Werner LEMBERG <wl@gnu.org>
+ [troff]: Revise `environment::set_font` to return Boolean value
+ indicating success of font selection operation.
- Add a new `file' warning category.
+ * src/roff/troff/env.cpp (environment::set_font):
+ * src/roff/troff/env.h (environment::set_font): Do it.
- * src/roff/troff/troff.h (warning_type): Add WARN_FILE.
- * src/roff/troff/input.cpp (DEFAULT_WARNING_MASK): Include
- WARN_FILE.
- (warning_table): Add `file' category.
- (macro_source): Convert error on missing macro file to a
- warning.
- * NEWS, doc/groff.texinfo (I/O, Warnings), man/groff_diff.man,
- src/roff/troff/troff.man: Document new warning category.
+ This prepares the way for a fix for Savannah #62656.
-2009-02-18 Werner LEMBERG <wl@gnu.org>
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo: Improve documentation of `lsm' request.
+ * src/roff/groff/groff.cpp: Use single exit path, freeing
+ memory allocated for strings.
+ (xexit): Add `exit()` wrapper; free allocated memory.
+ (main): Use it in all three exit paths.
-2009-02-14 Werner LEMBERG <wl@gnu.org>
+2022-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- Implement a leading spaces macro request, `lsm', in analogy to
- `blm'.
- Implement two new number registers, \n[lsn] and \n[lss], which hold
- the number of spaces and the horizontal space, respectively, which
- would be inserted if the macro registered by `lsm' wasn't called.
+ * src/roff/groff/groff.cpp: Refactor to be more meticulous with
+ memory. Add globals `saved_path`, `groff_bin_path`, and
+ `groff_font` to store pointers into the process environment
+ returned by `putenv()`; once used, they need to remain valid for
+ the lifetime of the program.
+ (xstrdup): Add `strdup()` wrapper: dies if `strdup()` fails.
+ (main): Split nested `strsave()` and `xputenv()` (until recently
+ `putenv()`) calls. Free duplicate strings prior to exit.
- * src/roff/troff/input.cpp (leading_spaces_macro_name,
- leading_spaces_number, leading_spaces_space): New global
- variables.
- (leading_spaces_macro): New function.
- (process_input_stack) <token::TOKEN_SPACE>: Handle `lsm'.
- (init_input_requests): Register `lsm', \n[lsn], and \n[lss].
+2022-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo
- (Leading Spaces Traps): Document new requests and registers.
+ * src/roff/groff/groff.cpp (main): Rename temporary variable to
+ avoid shadowing one in enclosing scope, which can lead to
+ cut-and-paste errors (ask me how I know).
-2009-02-10 Denis M. Wilson <dmw@oxytropis.plus.com>
+2022-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff.man: Document missing number registers (`$$', `.b',
- `.F', `.j', `.k', `.L', `.O', `.P', `.R', `opmaxx', `opmaxy',
- `opminx', `opminy').
+ * src/roff/groff/groff.cpp: Slightly refactor to indirect
+ `putenv` calls through an error-checking wrapper.
+ (xputenv): Add new function to die if `putenv()` fails.
+ (main): Update call sites to use it.
- * doc/groff.texinfo: Document missing `.R' register.
- Add `.U' to register index.
+2022-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-19 Werner LEMBERG <wl@gnu.org>
+ [groff]: Add information to diagnostic messages.
- Fix incorrect grops color state before \X'...'.
- Problem reported by Miklos Somogyi <msom@netspace.net.au>.
+ * src/roff/groff/groff.cpp (main): Report underlying system
+ error if `putenv()` fails.
+ (handle_unknown_desc_command): Set globals `current_filename`
+ and `current_lineno` from `filename` and `lineno` arguments
+ passed to us to we can use the simpler interface of `error()`
+ rather than `error_with_file_and_line()`.
- * src/devices/grops/ps.cpp (ps_printer::special): Check color state
- before doing a PS special and flush buffer.
- Update called functions.
+2022-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-09 Werner LEMBERG <wl@gnu.org>
+ [libgroff]: Update return type of `font::load_desc` function to
+ enable more informative diagnostics from callers.
-Version 1.20.1 released
-=======================
+ * src/include/font.h (font::load_desc): Change return type from
+ `bool` to `const char` pointer.
+ * src/libs/libgroff/font.cpp (font::load_desc): Return null
+ pointer literal on failed `open()` or validation failures.
+ Return filespec on success.
- `gnu.png' isn't needed any more.
+ * src/libs/libdriver/input.cpp (do_file):
+ * src/preproc/grn/main.cpp (getres):
+ * src/roff/groff/groff.cpp (main):
+ * src/roff/troff/input.cpp (main): Compare `font::load_desc()`
+ return value to null pointer literal instead of treating it as a
+ Boolean.
- * doc/Makefile.in: Don't handle or create `gnu.png'.
- Update all affected targets.
+ * src/roff/groff/groff.cpp (main): Report full filespec of
+ troublesome "DESC" file when complaining of missing "postpro"
+ directive.
- * doc/Makefile.sub: Don't handle or create `gnu.png'.
- Update alll affected targets.
+2022-06-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+ * src/roff/groff/groff.cpp: Add new Boolean global,
+ `need_postdriver`, and initialize it true.
+ (main): Make `need_postdriver` false if the `-X` or `-Z` options
+ are given. Test it later. This prevents groff from exiting
+ with a fatal error if an output driver is not available, but
+ also not required. Also reorder null pointer equality
+ comparison to avoid inadvertent lvalue assignment.
- `gnu.eps' was missing in the tarball.
- Problem reported by Patrik GrÀser.
+ Fixes <https://savannah.gnu.org/bugs/?62640>.
- (PROCESSEDEXAMPLEFILES): Remove `gnu.eps'.
- (MOSTLYCLEANNOTSRCDIRADD): Fix names of info files.
- (install_data): Handle `gnu.eps' specially.
+2022-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * MORE.STUFF: Mention texi2html's troff backend.
- Mention http://groff.ffii.org/groff/contrib.
+ * src/roff/groff/groff.cpp (help): Revise usage message for
+ expressiveness and clarity.
- * README: Mention `MORE.STUFF'.
+2022-06-21 Deri James <deri@chuzzlewit.myzen.co.uk>
- * NEWS, doc/webpage.ms, doc/groff.texinfo: Updated.
+ [gropdf]: Correct display of pathnames used.
-2009-01-08 Werner LEMBERG <wl@gnu.org>
+ * font/devpdf/util/BuildFoundries.pl: Convert array to
+ string of pathnames.
- * */Makefile.* (CLEANADD, CLEANNOTSRCDIRADD, CLEANDIRADD): Renamed
- to...
- (MOSTLYCLEANADD, MOSTLYCLEANNOTSRCDIRADD, MOSTLYCLEANDIRADD): This.
+2022-06-21 Deri James <deri@chuzzlewit.myzen.co.uk>
-2009-01-06 Werner LEMBERG <wl@gnu.org>
+ [gropdf]: Fix to gropdf.
- Remove heuristics for LIBEXT.
+ * src/devices/gropdf/gropdf.pl: If pdfbookmark was called
+ within 5p of top of page (e.g. straight after a .bp when
+ \n[nl] was zero) the click destination would be off by a
+ page.
- * configure.ac: Provide LIBEXT.
- * Makefile.in: Use it.
+2022-06-19 Ingo Schwarze <schwarze@openbsd.org>
- * configure: Regenerated.
+ * font/devpdf/devpdf.am: Always build PDF font description
+ files.
-2009-01-05 Werner LEMBERG <wl@gnu.org>
+ Build font/devpdf/download and the various TR, TB, CR etc.
+ files in the same directory even when they are not required
+ by the build because USE_GROPDF is unset, usually because
+ ghostscript is either unavailable or deliberately disabled
+ by the person running the build. These files need to be
+ built and installed anyway, and can be used on the target
+ system when the required infrastructure is available at run
+ time.
-Version 1.20 released
-=====================
+2022-06-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-05 Werner LEMBERG <wl@gnu.org>
+ [docs]: Revise introduction of vertical spacing concept to avoid
+ render inference that the formatter will compute a vertical
+ spacing appropriate to the type size automagically--it will not.
- * */*: Update FDL 1.1 to FDL 1.3.
+ Fixes <https://savannah.gnu.org/bugs/?62617>. Thanks to Dave
+ Kemper for the report.
-2009-01-05 Werner LEMBERG <wl@gnu.org>
+2022-06-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * */*: Update copyright year.
+ [docs]: Revise discussion of end-of-sentence detection.
-2009-01-05 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Filling):
+ * man/roff.7.man (Concepts): Do it. "Spaces" is a now a term
+ with a much more restricted usage. Emphasize the input context,
+ now explicitly identified as plain text files with Unix line
+ endings.
- * MANIFEST: Updated.
+ Fixes (one hopes) <https://savannah.gnu.org/bugs/?62593>.
+ Thanks to Ingo Schwarze for the report and Dave Kemper for the
+ discussion.
-2009-01-05 Werner LEMBERG <wl@gnu.org>
+2022-06-10 Deri James <deri@chuzzlewit.myzen.co.uk>
- * doc/texinfo.tex (\key): Fix excessive whitespace.
- (\texinfoversion): Tag file as patched.
+ [gropdf]: Changes to BuildFoundries.
-2009-01-05 Werner LEMBERG <wl@gnu.org>
+ * font/devpdf/util/BuildFoundries.pl: Collect search paths into
+ an array rather than a colon delimited string, this allows
+ the @PATH_SEPARATOR@ character (':' or ';') to be used to
+ delimit paths yielded by the command 'gs -h' but still use ':'
+ to delimit paths in the Foundry file. This means the same
+ Foundry file can be used on all systems.
- * tmac/s.tmac (@TS, TE, @EQ, @EN), tmac/an-old.tmac (TS, TE, EQ,
- EN), tmac/e.tmac (TS, TE, EQ, EN): Set line length to a large value
- if processed with -Thtml.
+ * font/devpdf/Foundry.in: Add more likely paths to find the URW
+ fonts.
-2009-01-04 Werner LEMBERG <wl@gnu.org>
+2022-06-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (TS, TE, EQ, EN): Set line length to a large value
- if processed with -Thtml to avoid warning messages (from code
- inserted by tbl, for example).
+ [build]: Weaken dependency on TeX, instead using it (to generate
+ the DVI and PDF forms of our Texinfo manual) only if it is
+ available.
-2009-01-04 Gunnar Florus <http://florus.no>
+ * m4/groff.m4 (GROFF_USE_TEX_CHECK): Check for presence of 'tex'
+ executable in path. Set shell variable `groff_use_tex` to "yes"
+ if present, and "no" otherwise. This check runs only if the
+ 'makeinfo' and 'texi2dvi' version checks have already passed.
- * */*: Update GPL2 to GPL3.
+ * configure.ac: Run the new check. Set Automake conditional
+ `USE_TEX` only if shell variable `groff_use_tex` is "yes".
+ Report whether "groff.dvi" and "groff.pdf" are (re-)buildable.
-2009-01-04 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am: Parameterize names of groff.{dvi,pdf} targets as
+ Make macros `GROFF_DVI` and `GROFF_PDF`. Define them only if
+ `USE_TEX`. Do _not_ update `EXTRA_DIST` macro; leave the
+ literal file names there because we require that distribution
+ archives contain these files.
+ (.texi.dvi, .texi.pdf): Update suffix rules to check `USE_TEX`
+ and fail, complaining of missing 'tex' program, if these targets
+ are attempted without it being true. Only manually specifying
+ the file names as targets to 'make' or attempting to generate a
+ distribution archive without TeX present should cause these
+ errors.
- * Makefile.in (dist): Don't use soft links but copy files to
- preserve the file's time stamps.
- * Makefile.sub (configure): Remove `autom4te.cache'.
+ * INSTALL.REPO: Update dependency information.
-2009-01-04 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?62592>. Thanks to Deri
+ James for the report.
- * tmac/de.tmac: Fix German date strings. Reported by Axel Kielhorn.
+2022-06-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-04 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am (.texi.dvi, .texi.pdf, $(DOC_GNU_EPS)): Quote names
+ of programs when aborting because they're missing.
- * doc/texinfo.tex: Updated from `texinfo' CVS repository.
- * doc/txi-en.tex: New file from `texinfo' CVS repository.
+2022-06-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-04 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_PROG_MAKEINFO, GROFF_PROG_TEXI2DVI):
+ Largely revert commit d5013ededc, 21 May: run checks for
+ 'makeinfo' and 'texi2dvi' programs regardless of presence of
+ ".tarball-version" file. Their presence is a necessary (but not
+ sufficient) condition for refresh of formatted forms of our
+ Texinfo manual if the source is modified.
- * font/make-Rproto: Moved to...
- * font/util/make-Rproto: Here.
+ Begins addressing <https://savannah.gnu.org/bugs/?62592>.
- * Makefile.in (NOMAKEDIRS): Add `m4', `font/devps/old', and
- `font/util'.
+2022-06-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-04 Werner LEMBERG <wl@gnu.org>
+ [build]: Rename some groff Autoconf macros to better match
+ Autoconf's own naming conventions.
- * src/roff/troff/TODO: Mention local variables.
+ * m4/groff.m4 (GROFF_MAKEINFO): Rename to...
+ (GROFF_PROG_MAKEINFO): ...this.
+ (GROFF_TEXI2DVI): Rename to...
+ (GROFF_PROG_TEXI2DVI): ...this.
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+ * configure.ac:
+ * m4/groff.m4 (GROFF_TEXI2DVI): Update call sites.
- * contrib/hdtbl/examples/col_rowspan_colors.roff,
- contrib/hdtbl/examples/color_boxes.roff,
- contrib/hdtbl/examples/color_nested_tables.roff,
- contrib/hdtbl/examples/color_table_cells.roff,
- contrib/hdtbl/examples/color_transitions.roff,
- contrib/hdtbl/examples/short_reference.roff: Minor improvements.
+2022-06-07 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac (SH, SS, B, I, SM, SB): Set input trap with `it`
+ instead of `itc` for better Unix Version 7 man(7) compatibility.
- * doc/webpage.ms: Updated.
+ Fixes <https://savannah.gnu.org/bugs/?51468>. Also see
+ discussion at
+ https://lists.gnu.org/archive/html/groff/2022-06/msg00020.html
+ et sequentia (amid a vigorous bikeshedding of `\&`'s name).
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+2022-06-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS, doc/groff.texinfo, font/devps/*, VERSION, REVISION: Prepare
- for version 1.20.
+ [man]: Regression-test use of input traps.
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/an_use-input-traps-correctly.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * src/preproc/tbl/table.cpp (table::compute_expand_width,
- table::compute_separation_factor): In warning messages, don't refer
- to pages but to input line numbers.
+2022-06-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+ * src/devices/gropdf/gropdf.pl (LoadDesc): Validate device
+ description file for essential directives and acceptable values
+ as grops(1) does.
- * tmac/groff_ms.man: Improve formatting of tables.
+2022-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+ [troff, grohtml, grops, grotty]: Update wording of diagnostic
+ messages to refer to "motion quantum" rather than "resolution"
+ where appropriate.
- * tmac/www.tmac (www->): Handle XHTML.
- (HTML</p>): Handle non-HTML devices.
- (www:url_check_tag): Avoid warnings.
+ * src/devices/grohtml/post-html.cpp
+ (html_printer::html_printer):
+ * src/devices/grops/ps.cpp (ps_printer::ps_printer):
+ * src/devices/grotty/tty.cpp (tty_printer::set_char)
+ (tty_printer::add_char, tty_printer::end_page):
+ * src/roff/troff/env.cpp (line_length, title_length): Do it.
+
+2022-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl: Do more "DESC" file validation.
+ (LoadDesc): Bomb out gracefully if any of "unitwidth", "res", or
+ "sizescale" missing from "DESC" file. This prevents Perl
+ warnings about use of uninitialized values, and undoubtedly
+ mangled output.
+
+2022-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl: Revise diagnostic message
+ handling.
+ (top level): Add new scalar `progname` to house executable name.
+ (Msg): Output messages in format recommended by GNU Coding
+ Standards manual. Identify who's talking (Savannah #52463).
+ Rename `lev` scalar to `fatal` since it is used only as a
+ Boolean for immediately exiting with failure status. Report
+ diagnostic severity as part of message.
+ (Warn, Die): Add new subroutines through which all diagnostics
+ are now emitted.
+ (top level): Migrate a use of Perl `die` builtin to our `Die`.
+ (top level, ToPoints, LoadDownload, LoadDesc, do_x, GetPoints,
+ LoadSWF, LoadPDF, LoadStream, BuildStream, ParsePDFHash,
+ LoadFont, GetType1, GetChunk, RemapChr, do_N): Migrate `Msg(0,
+ ...)` calls to `Warn` and `Msg(1, ...)` to `Die`. Begin
+ messages in lowercase (GNU Coding Standards). Recast a few
+ messages for clarity.
+
+ Continues the long process of fixing Savannah #52463.
+
+2022-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl (Load_Config): Drop unused
+ subroutine and its commented-out call site, which came in that
+ way in July 2011.
+
+2022-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/gropdf/gropdf.pl (LoadFont): Warn if a font to be
+ embedded in PDF output cannot be located in the "download" file.
+
+ Fixes <https://savannah.gnu.org/bugs/?62572>. Thanks to Deri
+ James.
+
+2022-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/a4.tmac: Drop file from distribution. It has been
+ superseded by papersize.tmac for nearly 20 years.
+ * tmac/tmac.am (TMACNORMALFILES): Delete reference.
+ * NEWS: Add item.
+
+ Fixes <https://savannah.gnu.org/bugs/?62569>.
+
+2022-06-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Parameterize X11-related man pages, so they don't get
+ spuriously generated (and not cleaned) when building with X11
+ support disabled.
+
+ * Makefile.am (.man): Fix logic nit: drop unnecessary removal of
+ target before clobbering it with sed.
+ * src/devices/xditview/xditview.am (GXDITVIEW_MAN1): Add new
+ macro, expanding to nothing if `WITHOUT_X11` and to the target
+ name otherwise.
+ (man1_MANS): Append `GXDITVIEW_MAN1` expansion, not a literal.
+ * src/devices/xditview/xditview.am (XTOTROFF_MAN1): Add new
+ macro, expanding to nothing if `WITHOUT_X11` and to the target
+ name otherwise.
+ (man1_MANS): Append `XTOTROFF_MAN1` expansion, not a literal.
+ * doc/doc.am (GROFF_MAN_PAGES1): Append foregoing expansions
+ instead of literals.
+
+2022-06-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac: Add `AM_CONDITIONAL`: `HAVE_URW_FONTS`, so our
+ Automake files can more easily cope with their absence.
+ * font/devpdf/Foundry.in: Add easily matched phrases to
+ comments, to clearly delimit the URW foundry portion of the file
+ so it can be omitted if those fonts are absent.
+ * font/devpdf/devpdf.am (font/devpdf/Foundry): Generate file
+ differently depending on `HAVE_URW_FONTS`; keep the existing
+ procedure if true, and delete the URW section from the generated
+ file otherwise, avoiding diagnostic messages from afmtodit(1)
+ and our BuildFoundries script.
+
+ Fixes <https://savannah.gnu.org/bugs/?62570>.
+
+2022-06-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries):
+ Generate script using the `PATH_SEPARATOR` Automake macro.
+ * font/devpdf/util/BuildFoundries.pl: Add `pathsep` scalar to
+ house the build-time path separator.
+ (LocateFile): Use it.
+ (LoadFoundry, CheckFoundry): Stop using spaces as part of the
+ path separation delimiter. It is not idiomatic.
+
+2022-06-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac: Explicitly identify poppler tools in report.
+
+2022-06-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/util/BuildFoundries.pl: Trivially refactor. Drop
+ unused hash `foundry`. Drop scalar `warn` that was set and
+ updated but never tested.
+
+2022-06-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/util/BuildFoundries.pl: Alter script to write to
+ the standard output stream instead of (re)writing a file named
+ "download" in the current working directory. This recovers from
+ a problem I introduced in commit 6e62be835d, 2 May, as an
+ unforeseen side effect of improving build parallelism so that
+ the "download" file wouldn't be read until it was fully
+ populated. As a side benefit, this approach is more Unixy, and
+ less dependent on $PWD.
+ (top level): Stop calling `WriteDownload` with an argument.
+ (LoadFoundry): Close only the file handle of interest when done,
+ not all of them (including `STDOUT`, which we now need).
+ (CheckFoundry): Same--just for cleanliness, since at present
+ running the script in 'check' mode doesn't write to any streams.
+ (WriteDownload): Stop taking an argument and manipulating file
+ handles. Write download file to standard output.
+ (LoadDownload, WriteDownload): Drop `top` scalar, used as a
+ mutex to serialize read and write access to "download" file; it
+ is no longer needed since the "download" file is now only read.
+
+2022-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Rename shell variables and Autoconf/Automake macros of
+ Boolean sense to have names more like logical predicates and
+ avoid doofy "DONT" nomenclature.
+
+ * m4/groff.m4 (GROFF_MAKE_RM): Rename shell variable
+ `groff_is_rm_defined` to `groff_make_defines_rm` (purely for
+ clarity; it already had a good name).
+ (GROFF_MAKE_RM): Rename this...
+ (GROFF_MAKE_DEFINES_RM): to this, to make parallelism obvious,
+ and enabling...
+ * configure.ac: ...rename of `MAKE_DONT_HAVE_RM` to
+ `MAKE_DEFINES_RM` with sense of test reversed. Also interpolate
+ `GROFF_MAKE_DEFINES_RM` instead of `GROFF_MAKE_RM`. This in
+ turn enables...
+ * Makefile.am: ...revision of conditional from
+ `MAKE_DONT_HAVE_RM` to "!`MAKE_DEFINES_RM`".
+
+2022-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_URW_FONTS_PATH)
+ (GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_APPDEFDIR_OPTION)
+ (GROFF_UCHARDET): Recast help strings to more closely parallel
+ structure and style of Autoconf's own help strings.
+ (GROFF_WITH_COMPATIBILITY_WRAPPERS): Recast to tighten wording.
+
+2022-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac:
+ * m4/groff.m4 (GROFF_APPDEFDIR_OPTION, GROFF_APPDEFDIR_DEFAULT)
+ (GROFF_APPDEFDIR_CHECK): Rename m4 macros and shell variable
+ from "*appres*" to "*appdef*. Update interpolation sites.
+
+ * configure.ac:
+ * m4/groff.m4 (GROFF_APPDEFDIR_CHECK): Further rename this...
+ (GROFF_APPDEFDIR_NOTICE): ...to this, for consistency with other
+ post-report output macros.
+
+ * Makefile.am:
+ * PROBLEMS:
+ * doc/automake.mom:
+ * src/devices/xditview/xditview.am: Update interpolation sites
+ of `appresdir`.
+
+ * Makefile.am:
+ * src/devices/xditview/gxditview.1.man:
+ * src/roff/groff/groff.1.man: Update interpolation sites of
+ `APPRESDIR`.
+
+ * NEWS: Add item.
+
+2022-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_X11, GROFF_UCHARDET): Drop redundant
+ messages (which are easily overlooked amid the torrent of
+ "checking" output anyway). Discovery failures of X11 and the
+ uchardet library are already parts of the configuration report
+ at or near the end of output.
+
+2022-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_PNMTOPS_NOSETPAGE): Partially revert change
+ from 21 May and document why in a comment.
+
+2022-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/an-old.tmac, tmac/doc.tmac: For -Tutf8, map \-, -, ', and `
- conservatively to ASCII for the sake of easy cut and paste.
+ * tmac/troffrc: Skip loading of "papersize.tmac" if not in troff
+ mode.
-2009-01-03 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?62238>. Thanks to Bjarni
+ Ingi Gislason for the report.
- * NEWS: Mention hdtbl.
+2022-05-31 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-02 Werner LEMBERG <wl@gnu.org>
+ * configure.ac: Report use of "g" prefix for commands and macro
+ package compatibility wrappers.
+ * m4/groff.m4 (GROFF_G): Fix code style nits. Update
+ indentation to match recent practice.
+
+2022-05-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac: Fix code style nits and tweak report. Stop
+ superfluously using braces for shell parameter expansions that
+ don't require them. The shell is not make(1). Say
+ "installation _directory_ prefix" since another kind of prefix
+ can be used by groff (the "g" in front of command and macro
+ package names shared with AT&T troff).
- * tmac/groff_mdoc.man: Update OS version string listing.
+2022-05-31 Dave Kemper <saint.snit@gmail.com>
-2009-01-02 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi: Fix content and style nits.
+ - Remove redundancy ("fixed-width... character that can't be
+ adjusted").
+ - Fix incorrect word ("environment value" -> "environment
+ variable").
+ - Add or change the placement of a couple tie{}s to comport
+ with style-guide recommendation.
+ - Grammarify.
+ - Clarify and tighten wording.
- * config.rpath, m4/codeset.m4, m4/glibc21.m4, m4/iconv.m4,
- m4/lib-link.m4, m4/lib-prefix.m4, src/include/localcharset.h,
- src/libs/libgroff/config.charset, src/libs/libgroff/localcharset.c,
- src/libs/libgroff/ref-add.sin, src/libs/libgroff/ref-del.sin:
- Updated from `gnulib' git repository.
+ Fixes <https://savannah.gnu.org/bugs/?62551>.
- * configure: Regenerated.
+2022-05-30 G. Branden Robinson <g.branden.robinson@gmail.com>
-2009-01-02 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/node.cpp (font_position): If mounting a font
+ fails and a third argument was given (to the `fp` request),
+ report its value in the diagnostic message. This could reveal a
+ prohibited attempt at directory traversal. See commit
+ a891161bc9, 7 November.
- * tmac/ptx.tmac: New file.
+2022-05-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS, man/groff_tmac: man: Document it.
+ * src/libs/libgroff/fontfile.cpp (font::open_file): Refactor.
+ Move more logic, including memory allocation, inside conditional
+ that accepts only file names without '/' characters, skipping
+ unnecessary work in the alternative. Annotate use of zero
+ literals as null pointers to ease any future migration to ISO
+ C++11. Add 'const' qualifier to variable that doesn't require
+ modification (and which is used in the LHS of an equality
+ comparison, so that clumsy operator misuse will provoke a
+ compiler warning).
-2008-12-30 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?62532>. Thanks to Bjarni
+ Ingi Gislason for the report.
- Fix more quoting issues.
+2022-05-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (BCL, BGIMG, PIMG, MPIMG, LNS): For the sake of
- XHTML, quote more arguments.
- (IMG): Fix quoting.
+ * configure.ac: In configuration report, say that we're
+ reporting compiler options along with the compiler executable.
+ Fix leftover test(1) comparison with garbage, overlooked in
+ commit faa22d89d2, 20 May.
-2008-12-30 Werner LEMBERG <wl@gnu.org>
+2022-05-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- Fix quoting issues in www.tmac.
+ * doc/doc.am (doc/meintro_fr.ps): Build with '-t' option.
- * tmac/www.tmac (www:url_breaks_splitted): Renamed to...
- (www:url_breaks_split): This.
- (www->): New string to close tag singletons like <img> or <hr>. In
- XHTML mode (not implemented yet), this has to be changed from `>' to
- `/>'.
- (IMG): Don't use </img>
- Use www->.
- (PIMG, MPIMG): Don't use </img>
- Use www->.
- Fix doublequote issues.
- (HR): Don't use </hr>.
- Use www->.
- (LNS): Fix doublequote issues.
+ Fixes <https://savannah.gnu.org/bugs/?62542>. Thanks to Bjarni
+ Ingi Gislason for the report.
-2008-12-24 Michail Vidiassov <master@iaas.msu.ru>
+2022-05-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc-common: Add entries for Mac OS X and FreeBSD.
+ * src/roff/groff/groff.1.man (Options) <-l>: Handle case where
+ no default print spooler is configured, and report formatter
+ behavior correctly if it isn't.
-2008-12-22 Alexey Gladkov <legion@altlinux.ru>
+ Fixes <https://savannah.gnu.org/bugs/?62535>. Thanks to Bjarni
+ Ingi Gislason for the report.
- * contrib/groffer/perl/roff2.pl: Fix syntax error.
+2022-05-28 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-12-15 Werner LEMBERG <wl@gnu.org>
+ * Makefile.am (.man): Process '@PSPRINT@' substitutions with
+ "makevarescape.sed".
- * NEWS: Mention `preconv'.
+2022-05-26 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-11-12 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_PROG_YACC, GROFF_MAKEINFO, GROFF_TEXI2DVI):
+ Fix logic error in detection of build scenario: the presence of
+ a ".git" directory is not an indicator that we're not building
+ from a distribution archive, because we might be building from a
+ snapshot archive (which also lacks it). Instead, perform checks
+ required only by builds from Git checkouts and snapshot archives
+ if the ".tarball-version" file is not present.
- Implement `x' specifier for expanded columns. Contrary to old DWB
- tbl, more than a single `x' specifier can be used. At the same
- time, remove most of the code from change 2007-02-09 which collides
- with the new implementation.
+2022-05-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/main.cpp (format): Add `expand' array.
- (format::format, format::~format): Updated.
- (input_entry_format): Add `expand' field.
- (input_entry_format::input_entry_format): Updated.
- (input_entry_format::debug_print): Handle `expand'.
- (process_format): Handle `x' specifier.
- (process_data): Updated.
+ * Makefile.am (EXTRA_DIST): Ship "HACKING" file.
- * src/preproc/tbl/table.cpp (AVAILABLE_REG, COLCOUNT_REG): Remove.
- (EXPAND_REG): New macro.
- (table_entry::divert, block_entry::divert,
- alphabetic_block_entry::divert): Add parameter to control whether
- expanded columns shall be handled.
- (block_entry::do_width): Remove.
- (block_entry::do_divert): Add parameter to control whether expanded
- columns shall be handled.
- Treat expanded columns like columns with a minimum width.
- Remove `experimental' code.
- (table::table, table::~table, table::allocate): Updated.
- (table::set_expand_column): New function.
- (table::count_block_columns): Replace with...
- (table::count_expand_columns): This function.
- (table::divide_span): Handle expanded columns the same as equal
- columns.
- (table::sum_columns): Add parameter to control whether expanded
- columns shall be handled.
- (table::compute_available_block_width): Replace with...
- (table::compute_expand_width): This function.
- (table::compute_total_separation): New function, taking code from
- `compute_separation_factor'.
- (table::compute_separation_factor): Simpler code. The check for the
- `EXPAND' flag has been moved to the caller.
- (table::compute_widths): Add `top-level' changes to handle expanded
- blocks.
+2022-05-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/table.h (table): New field `total_separation'.
- Remove `blockflag' array.
- Add `expand' array.
- Update member function declarations.
+ * bootstrap.conf: Add "pkg-config" to `buildreq`. Not having it
+ causes pretty horrible macro expansion problems and diagnostics
+ when 'autoreconf' is run; they're still pretty bad even if you
+ use `AC_REQUIRE` and `m4_pattern_forbid`. So just demand it.
- * src/preproc/tbl/tbl.man: Document `x' specifier.
- Expand documentation to cover all aspects of Lesk's tbl reference.
+2022-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Document `x' specifier.
+ * font/devps/S:
+ * font/devps/symbolmap: Drop excess mapping of `*U` special
+ character. groff maps it to the Adobe Glyph List name
+ 'Upsilon1'. (The AGL 'Upsilon' is a homoglyph of the Latin
+ capital 'Y'.)
+ * PROBLEMS: De-document build-time warning, now resolved.
-2008-11-08 Werner LEMBERG <wl@gnu.org>
+2022-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/tbl.man: Restructuring.
- Improve text block documentation.
+ * src/utils/afmtodit/afmtodit.tables: Regenerate using Unicode
+ 14.0. No substantive changes.
-2008-11-07 Werner LEMBERG <wl@gnu.org>
+2022-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/table.cpp (table::compute_widths): Use default
- scaling operator for minimum width. Without this fix, `lw3' (or
- `lw(3)' would be handled as a column with a minimum width of 3u
- instead of 3n.
-
-2008-11-05 Werner LEMBERG <wl@gnu.org>
-
- * tmac/doc-common (Dt): Start a new page if necessary and set up
- headers.
-
- * tmac/andoc.tmac (reload-doc): Simplify due to change in
- doc-common.
+ * src/utils/afmtodit/make-afmtodit-tables: Refactor. Drop
+ unused variable `prog`. Use value of `CPP` from environment (if
+ defined) and use parameter expansion to apply a default if null
+ or not set. Use for loop to eliminate duplicative if statement.
+ Test input files for readability, not just existence. Use more
+ portable test(1) and shell syntax. Swap usage error and fatal
+ error exit statuses; using "1" for failure and "2" for usage
+ errors is more common in shell scripts I've seen. Update usage
+ message to put non-literal parameter in full caps, and clarify
+ its name. Update comment blocks written to generated files to
+ further clarify data provenance.
- * NEWS: Document it.
+2022-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-10-18 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_PRINT): Refactor. Stop performing checks
+ for spooler options if none is available. Stop redundantly
+ reporting command name used for spooling PostScript files. If
+ an option is required for spooling DVI files, report it alone
+ instead of repeating the command name as well.
- * src/preproc/tbl/main.cpp (process_format): Rename `x' and `X' to
- `m' and `M', respectively.
- Sort entries in `switch' block.
- * src/preproc/tbl/tbl.man: Updated.
- Sort key entries; other minor improvements.
+2022-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-10-17 Werner LEMBERG <wl@gnu.org>
+ Fix insensitivity of groff(1) man page to configured spooler.
- * src/preproc/tbl/table.cpp (table::compute_available_block_width):
- New function.
- (table::compute_widths): Replace some code with new function
- (shifted to a more appropriate place).
- * src/preproc/tbl/table.h: Updated.
+ * Makefile.am (.man): Replace `@PSPRINT@` in man page sources
+ with name of configured print spooler command.
+ * src/roff/groff/groff.1.man (Options) <-l>: Use configured
+ print spooler command instead of literal 'lpr'.
-2008-10-16 Werner LEMBERG <wl@gnu.org>
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc-common (doc-operating-system-*), tmac/groff_mdoc.man: Add
- NetBSD 4.0.1.
+ * m4/groff.m4 (GROFF_UCHARDET_CHECK): Fix grammar nit in failure
+ message when user demands uchardet support but the library
+ cannot be located.
-2008-10-13 Werner LEMBERG <wl@gnu.org>
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_mdoc.man: Update documentation on BSD-like OS string
- versions.
+ * m4/groff.m4 (GROFF_CHECK_GROHTML_PROGRAMS): Fix logic error in
+ computation of verb to be used in notice message.
-2008-10-10 Werner LEMBERG <wl@gnu.org>
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/roff.man, doc/groff.texinfo: Improve the history part. This
- is based on input from Tom Van Vleck <thvv@multicians.org>.
+ * m4/groff.m4 (GROFF_PROG_YACC, GROFF_URW_FONTS_CHECK)
+ (GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_UCHARDET_NOTICE):
+ Improve shell code portability. Per the GNU Autoconf manual,
+ "The -a, -o, '(', and ')' operands are not present in all
+ implementations, and have been marked obsolete by Posix 2008.
+ ...portable uses of test should never have more than four
+ arguments, and scripts should use shell constructs like '&&' and
+ '||' instead."
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/sqrt.cpp (sqrt_box::compute_metrics): Assure that
- value of `rst' register is not zero, as can happen for the HTML
- output device. Otherwise, there are too many loops, and we get a
- stack overflow because of recursion.
+ * src/roff/groff/groff.1.man (Installation directories): Don't
+ output a tagged paragraph for the X11 application defaults
+ directory if the build symbol '@APPRESDIR@' is not defined (that
+ is, we didn't build with X11 support).
-2008-10-05 Stephen Gildea <http://www.gildea.com/stephen/>
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/ref/ref.cpp (reference::compute_sort_key): Do
- not insert SORT_SEP before the first field, so that sort_key
- has the same format as before the patch of 2003-08-23.
+ * m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK): Fix code style
+ nits. Use lowercase for shell variables we define. Don't quote
+ literal operands to test(1) that don't contain syntactically
+ shell-significant characters. Update indentation to match
+ recent practice.
-2008-10-04 Werner LEMBERG <wl@gnu.org>
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc-common (doc-operating-system-*): Update releases.
+ * m4/groff.m4 (GROFF_URW_FONTS_NOTICE): Don't emit the notice if
+ Ghostscript isn't available, since it was a prerequisite for
+ the `GROFF_URW_FONTS_CHECK` macro in the first place.
- * tmac/an-old.tmac (an-extra1, an-extra2, an-extra3): Initialize.
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/andoc.tmac: Rewritten, based on a preliminary version from
- Tadziu Hoffmann. It can now process multiple man pages with both
- man and mdoc formats intermixed.
+ [build]: Add print spooler determination to configuration
+ report.
- * NEWS, tmac/groff_man.man, tmac/groff_mdoc.man,
- man/groff_tmac.man: Document it.
+ * m4/groff.m4 (GROFF_PRINT): Add shell variable
+ `groff_have_spooler` to house the name of the print spooler
+ {"lp" or "lpr"} or the word "no".
+ * configure.ac: Report determined spooler, or its absence.
-2008-10-04 Werner LEMBERG <wl@gnu.org>
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (do_suppress): Make \O[3], \O[4], and
- \O[5] non-transparent w.r.t. beginning-of-line recognition (similar
- to the other \O variants).
+ * src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Skip
+ seekability check of the standard input stream if there is no
+ controlling terminal.
- * tmac/www.tmac (TS, TE, EQ, EN): Don't use .als for setting up
- default macros. This causes endless loops (at least for TE).
+ Fixes <https://savannah.gnu.org/bugs/?62506>. Thanks to Bjarni
+ Ingi Gislason for the report.
- * doc/groff.texinfo: Improve documentation of `.als'.
+2022-05-24 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-10-03 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_CHECK_GROHTML_PROGRAMS): Migrate from
+ `AC_FOREACH` to `m4_foreach` to avoid obsolescence warning from
+ GNU Autoconf 2.70 or later.
- * src/devices/grops/grops.man, src/roff/troff/troff.man,
- src/preproc/soelim/soelim.man: Correct documentation of -I switch.
- Reported by Larry Kollar.
- Other minor formatting issues.
+ Fixes <https://savannah.gnu.org/bugs/?61059>. Thanks to Bjarni
+ Ingi Gislason for the report.
-2008-10-02 Werner LEMBERG <wl@gnu.org>
+2022-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/trace.tmac: Much improved.
- (trace-full): New register to be set on the command line; it
- controls whether number and string register assignments get traced
- also.
- (!!c): New macro for comments.
- (rm): New traced macro.
- (de, de1, am, am1): Use \\[xxx]\\ calling method to pass \$0 to
- `!!xxx'; this makes doc.tmac completely traceable.
- Trace call of .de and friends also.
+ * man/groff.7.man: Rename "pilot" list macros for man(7) from
+ `BL`/`EL` to `LS`/`LE`, per suggestion from Alejandro Colomar.
- * tmac/groff_tmac.man, NEWS: Update.
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-09-30 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_MAKEINFO, GROFF_TEXI2DVI): Check for
+ makeinfo(1) and texi2dvi(1) programs only if building from Git,
+ not a distribution archive.
- Restore behaviour of \$0 if a macro is called with string syntax
- (problem caused by change on 2008-09-29).
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (input_iterator, input_stack,
- macro_iterator): Add `get_macro_name' member function.
- (interpolate_string): Use it.
+ * doc/doc.am (doc/meintro_fr.ps): Call groff with `-K utf8`
+ instead of `-k`, in case the "configure" script didn't find
+ uchardet (and preconv(1) thus can't auto-detect an encoding).
-2008-09-29 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?59463>.
- Make \\*[xxx]\\ within a macro (with `xxx' a macro too) work as
- expected. Without the patch,
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- .de aaa
- \\*[bbb]\\
- . tm \\$*
- ..
- .de bbb
- . shift
- ..
- .aaa 1 2 3
+ * src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Skip
+ a check if /dev/stdin is not a character special device.
- prints `2 3' instead of `1 2 3'.
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (input_iterator, input_stack,
- macro_iterator): Add `get_arg_list' member function.
- (macro): Add `is_a_string', `is_string', and `clear_string_flag'
- members.
- Update constructors and operators.
- (arg_list): Add copy constructor.
- (macro_iterator): Add optional argument to constructor to indicate
- whether arguments shall be inherited from calling macro.
- (interpolate_string): If string argument is a macro, push a macro
- iterator on the stack.
- (do_define_macro): Call clear_string_flag if macro data contains a
- newline.
+ * m4/groff.m4 (GROFF_PDFTOOLS): Rename this...
+ (GROFF_POPPLER): ...to this.
+ * configure.ac: Update call site.
- * src/roff/troff/request.h: Updated.
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-09-29 Eric S. Raymond <esr@snark.thyrsus.com>
+ * m4/groff.m4 (GROFF_UCHARDET_CHECK): Rename this...
+ (GROFF_UCHARDET_NOTICE): ...to this.
+ * configure.ac: Update call site.
- * doc/pic.ms: Fold in documentation of pic2plot(1) capabilities.
- Improve the documentation of text objects.
+ * m4/groff.m4 (GROFF_UCHARDET_NOTICE): Tighten wording of
+ message reported to user.
-2008-09-28 Eric S. Raymond <esr@snark.thyrsus.com>
+ Fixes <https://savannah.gnu.org/bugs/?59481>. Thanks to Dave
+ Kemper for the report.
- * contrib/pic2graph, contrib/pic2graph.man, contrib/eqn2graph,
- contrib/eqn2graph.man: Tweak scripts to cope with incompatible
- changes in ImageMagick crop options. Document the bugs.
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-09-28 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_PNMTOOLS_CAN_BE_QUIET)
+ (GROFF_PNMTOPS_NOSETPAGE): Skip check if prerequisite not met.
- If a macro is called as a string, inherit value of \n[.br] from the
- caller. This is useful for `trace.tmac'.
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (string_iterator): New members
- `with_break' and `get_break_flag'.
- (string_iterator::string_iterator): Updated.
+ * m4/groff.m4 (GROFF_URW_FONTS_CHECK): Rename this...
+ (GROFF_URW_FONTS_NOTICE): ...to this.
+ (GROFF_URW_FONTS): ...and this...
+ (GROFF_URW_FONTS_CHECK): ...to this.
+ (GROFF_URW_FONTS_NOTICE): Give lengthy notice message a one-line
+ summary.
+ * configure.ac: Update call sites.
- * doc/groff.texinfo: Improve documentation of \$0 and string syntax
- calling of macros.
- Document behaviour of \n[.br] within strings.
+2022-05-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-09-26 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_URW_FONTS): Refactor. If our prerequisites
+ are not met (availability of 'awk' and 'gs'), don't even run the
+ check logic or print a "checking" message.
- * tmac/trace.tmac: Add copyright message.
- Use `.de1' where possible to make source code more readable.
- (so, mso, als, rn): Restore escape character before executing the
- request.
- (de, de1, am, am1): Trace `.foo' also if called as `\\[foo]'.
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-09-24 Werner LEMBERG <wl@gnu.org>
+ Handle missing programs required to construct files needed at
+ runtime by gropdf more gracefully. Rename and refactor
+ configuration-time logic to be more understandable.
- Fix incompatibility between `.de1' and `.do'. Without this change,
- the following snippet
+ * configure.ac:
+ * m4/groff.m4: Rename `GROFF_PDFDOC_PROGRAMS` macro to
+ `GROFF_CHECK_GROPDF_PROGRAMS`. Rename shell variable
+ `make_pdfdoc` to `use_gropdf`. Set it explicitly to "no" or
+ "yes" instead of null or not null.
- .de1 xx
- . tm \\n(.C
- ..
- .cp 1
- .do xx
+ * configure.ac:
+ * m4/groff.m4:
+ * doc/doc.am: Rename `BUILD_PDFDOC` to `USE_GROPDF`.
- prints 1 instead of 0.
+ * configure.ac: Call `GROFF_GROPDF_PROGRAM_NOTICE`.
- * src/roff/troff/input.cc (do_request): If a macro gets processed,
- call tok.next().
- (interpolate_macro): Add optional argument. Update callers.
- (request::invoke): Add optional argument.
- (macro::invoke): Add optional argument to delay call of tok.next().
+ * doc/doc.am: Bracket definition of `PROCESSEDDOCFILES_PDF`
+ macro and `$(PROCESSEDDOCFILES_PDF)` dependency declaration in
+ Automake `if USE_GROPDF` conditional. This prevents attempts
+ to build PDF documents using groff that are doomed to fail.
- * src/roff/troff/request.h (request_or_macro): Add argument to
- `invoke' member. Update all derived classes.
+ * m4/groff.m4: Refactor gropdf runtime-dependency program check.
+ Split into two macros: one (`GROFF_CHECK_GROPDF_PROGRAMS`)
+ performs the check, the other (`GROFF_GROPDF_PROGRAM_NOTICE`)
+ issues a notice at the end of the configuration process if at
+ least one program was not found. Rename `docnote` shell
+ variable to `gropdf_notice`. Tighten wording of notice. Drop
+ unused `make_install_pdfdoc` and `make_uninstall_pdfdoc` shell
+ variables.
- * doc/groff.texinfo: Improve documentation of .do request.
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-09-09 Werner LEMBERG <wl@gnu.org>
+ Handle missing programs required at runtime by grohtml more
+ gracefully. Rename and refactor configuration-time logic to be
+ more understandable.
- * tmac/an-old.tmac (FT): Initialize properly. Reported by Tadziu
- Hoffmann.
+ * configure.ac:
+ * m4/groff.m4: Rename `GROFF_HTML_PROGRAMS` macro to
+ `GROFF_CHECK_GROHTML_PROGRAMS`. Rename shell variable
+ `make_htmldoc` to `use_grohtml`. Set it explicitly to "no" or
+ "yes" instead of null or not null.
-2008-09-06 Werner LEMBERG <wl@gnu.org>
+ * configure.ac:
+ * m4/groff.m4:
+ * doc/doc.am: Rename `BUILD_HTML` to `USE_GROHTML`.
- * tmac/doc-common (Dd, Os, Dt): Reset `doc-command-name' to make
- `.Nm' work properly if next manual page is printed.
+ * configure.ac: Call `GROFF_GROHTML_PROGRAM_NOTICE`.
-2008-08-20 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am: Bracket definition of `PROCESSEDDOCFILES_HTML`
+ macro and `$(PROCESSEDDOCFILES_HTML)` dependency declaration
+ in Automake `if USE_GROHTML` conditional. This prevents an
+ attempt to build an HTML version of the "pic.ms" document that
+ is doomed to fail (noisily).
- * src/preproc/tbl/tbl.man: Document computation of element widths.
+ * m4/groff.m4: Refactor grohtml runtime-dependency program
+ check. Split into two macros: one
+ {`GROFF_CHECK_GROHTML_PROGRAMS`} performs the check, the other
+ {`GROFF_GROHTML_PROGRAM_NOTICE`} issues a notice at the end of
+ the configuration process if at least one program was not found.
+ Rename `html_docnote` shell variable to `grohtml_notice`.
+ Tighten wording of notice. Drop unused `make_install_htmldoc`
+ and `make_uninstall_htmldoc` shell variables.
-2008-08-20 Alexey Gladkov <legion@altlinux.ru>
- Werner LEMBERG <wl@gnu.org>
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add default encoding option -D to preconv and groff.
+ * m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_NOTICE): Add newline at
+ end of buggy Ghostscript notification, so that the multiple
+ possible lengthy notices after the configuration report have
+ blank lines separating them.
- * src/preproc/preconv/preconv.cpp (default_encoding): Make it an
- array.
- Update all users.
- (main): Handle new option -D.
- (usage): Updated.
- * src/preproc/preconv/preconv.man: Updated.
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/groff.cpp (main): Handle new option -D.
- (synopsis, help): Updated.
- * src/roff/groff/groff.man: Updated.
+ Check for m4 program at configuration time.
-2008-07-26 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_PROG_M4): Define new macro to perform the
+ check and error out if the program is missing.
+ * configure.ac: Call the new macro.
+ * tmac/tmac.am (tmac/groff_man.7.man)
+ (tmac/groff_man_style.7.man): Use the new implicitly AC_SUBST-ed
+ variable `M4` to run the program.
- * tmac/eqnrc (.EQ, .EN): Provide default definitions. Reported
- by Denis M. Wilson.
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (.EQ, .EN, .TS, .TE): Fix definitions.
+ * m4/groff.m4 (GROFF_PROG_YACC): Update wording of error
+ message: we search for "yacc", so report it as missing if it is
+ not found (along with "byacc" and "bison").
-2008-07-24 Denis M. Wilson <dmw@oxytropis.plus.com>
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- New options -f and -k for afmtodit.
+ * configure.ac: Fix shell style nits. Get rid of string
+ {non-}nullity tests and comparisons involving concatenation with
+ garbage (usually "x"). See 13 November entry regarding m4. Use
+ idiomatic shell "brace style" for control structures.
- * src/afmtodit/afmtodit.pl: New options `-f NAME' sets the internal
- name of the groff font.
- New option `-k' disables output of kerning data.
- * src/afmtodit/afmtodit.man, NEWS: Document new options.
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-07-18 Werner LEMBERG <wl@gnu.org>
+ Trivially refactor libgroff allocator configuration.
- * src/preproc/tbl/table.cpp (table::compute_separation_factor): Emit
- warning messages if table gets squeezed.
- (table::compute_widths): Fix computation of AVAILABLE_REG.
- Emit warning if table is wider than line length.
+ * m4/groff.m4 (GROFF_USE_GROFF_ALLOCATOR): Update description of
+ configuration flag to clarify that it's implemented in a
+ library. Rename shell variable to prefix it with "groff_",
+ putting it in an ad hoc name space as with other variables. If
+ feature disabled, set variable to literal "no".
+ * configure.ac: Use renamed variable and interpolate it directly
+ into configuration report, simplifying shell logic.
- * src/preproc/tbl/tbl.man: Minor improvements.
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-05-02 Larry Jones <lawrence.jones@siemens.com>
+ * configure.ac: Revise configuration report for intelligibility.
+ Add report of C++ compiler and flags used: we compile much more
+ C++ than C code so this seems appropriate. Report Perl
+ interpreter version so that we can collect build reports and
+ turn the ratchet past Perl 5.6.1 at some point. Fix X11
+ "resources" misnomer (application defaults are what is meant).
+ Rephrase generally.
- * contrib/chem/Makefile.sub (README, examples/README): In makefiles,
- the `$<' macro is only guaranteed to be defined in inference rules,
- not in explicit target rules. Since there is only one input file in
- the places where it is used, the `$?' macro (which is guaranteed to be
- defined for both kinds of rules) is a suitable replacement.
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * hdtbl/examples/fonts_n.in, hdtbl/examples/fonts_n.in: Most
- versions of ls don't have a `--color' option.
+ * Makefile.am (EXTRA_DIST): Ship "ChangeLog.122" in distribution
+ archive. Overlooked in commit c11995df16, 19 February 2021.
-2008-04-30 Larry Jones <lawrence.jones@siemens.com>
+2022-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.comm (depend.temp): Add `EXTRA_CCFLAGS'.
+ * src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
+ Fix portability problem: POSIX says that "od -c" (and "od -t c")
+ are supposed to emit printing characters as defined by the
+ underlying locale, but GNU coreutils od doesn't do this and
+ macOS od does. Set `LC_ALL` to "C" when running it to force
+ 3-digit octal reporting of characters with their eighth bit set.
-2008-04-29 Larry Jones <lawrence.jones@siemens.com>
+ Fixes <https://savannah.gnu.org/bugs/?62357>. Thanks to John
+ Gardner for the report. Also see <https://pubs.opengroup.org/\
+ onlinepubs/9699919799/utilities/od.html>.
- * src/eqn/script.cpp (script_box::output): Portability fix.
+2022-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-04-05 Dorai Sitaram <ds26gte@yahoo.com>
+ * INSTALL.extra (In Case of Trouble): Add advice on using the
+ test suite, particularly if it fails.
- Add better support for `.TAG #<label>' in non-HTML documents: In
- case of a forward reference in a call to .URL, write `(see below)'.
- In case of a backwards reference use the page number instead. The
- reference gets stored in a string `TAG_<label>' and can be
- overridden while calling `.TAG' with its new optional argument --
- this is useful for a second-pass system which resolves forward
- references.
+ Fixes <https://savannah.gnu.org/bugs/?62478> (one hopes).
- * tmac/www.tmac (www:url_check_tag): New function.
- (URL): Use it.
- (TAG): Add optional argument to define string `TAG_<label>'.
+2022-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-03-24 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Input Line Traps): Expand discussion. The
+ `it` and `itc` requests count neither input lines (strictly) nor
+ text lines. Instead, they count input lines that _directly
+ produce formatted output_ (and, in the case of `itc`, are not
+ "interrupted" or continued with the `\c` escape sequence). This
+ is useful--empty requests and requests that don't put nodes on
+ the output don't break things--but does demand some explanation.
+ Clarify and provide example.
+ * man/groff.7.man (Escape sequence short reference) <it>: Sync.
- * tmac/trace.tmac (so, mso): Added.
+2022-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (PIMG): Replace `.ie' (without `.el') with `.if'.
- If used with -mtrace, and this clause was active, the macro was
- executed twice.
+ * src/roff/troff/env.cpp (environment::choose_breakpoint): Tweak
+ diagnostic message ("can't" -> "cannot").
+ * doc/groff.texi (Breaking): Update example.
- * tmac/pspic.tmac (PSPIC): Accept option `-C' for orthogonality.
- This makes `.PIMG -C <file>' (from www.tmac) work on non-HTML
- devices.
- * man/groff_tmac.man: Document it.
+2022-05-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-02-26 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Copy Mode):
+ * man/groff.7.man (Copy mode): Fix omission; `\?` is interpreted
+ in copy mode.
- * src/roff/troff/input.cpp: s/safer_flag/unsafe_flag/.
- Update all occurrences so that \n[.U] works as advertised. Bug
- reported by Dorai Sitaram.
+2022-05-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-02-17 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (PT): Unclutter name space; remove
+ `pg*saved-page-number-format` string when we're done with it.
- * doc/groff.texinfo: Improve documentation of .cf request.
+2022-05-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-01-19 Werner LEMBERG <wl@gnu.org>
+ [tbl]: Add unit tests, including one XFAIL for bad behavior.
- * src/preproc/html/pre-html.cpp (usage): Don't describe options but
- mention that it should never be called stand-alone.
+ * src/preproc/tbl/tests/check-horizontal-line-length.sh:
+ * src/preproc/tbl/tests/check-line-intersections.sh:
+ * src/preproc/tbl/tests/check-vertical-line-length.sh:
+ * src/preproc/tbl/tests/table-lacks-spurious-top-border.sh: Do
+ it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run tests.
+ (tbl_XFAIL_TESTS, XFAIL_TESTS): Expect one test failure.
- * tmac/groff_www.man, doc/groff.texinfo, man/groff_font.man,
- man/groff_tmac.man, man/groff_out.man, README, README.MinGW,
- src/roff/groff/groff.man: Mention -Txhtml.
+2022-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_font.man, man/groff_tmac.man, man/roff.man: Revised.
+ * src/devices/grotty/tty.cpp (tty_printer::add_char): Modify
+ diagnostic message: what gets written "above [the] first line"
+ might not be a character (glyph) per se, but a line (rule) from
+ a drawing command, and in fact the occurrence of these from
+ boxed tables is the most common cause of this message I've seen.
-2008-01-16 Werner LEMBERG <wl@gnu.org>
+2022-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/font.cpp (font::contains, font::get_code):
- Handle single-letter names correctly.
+ [grotty]: Do more input validation.
- * doc/groff.texinfo, man/groff_diff.man: Extend documentation of \^
- and \|.
- * NEWS: Updated.
+ * src/devices/grotty/tty.cpp (tty_printer::draw): Throw warning
+ if an unsupported geometric primitive is encountered.
+ (tty_printer::line): Throw warning if a line is diagonal. Die
+ if length of a horizontal or vertical line is not a multiple of
+ the appropriate motion quantum of the device (troff should never
+ emit such nonsense, and currently doesn't appear to).
-2008-01-15 Werner LEMBERG <wl@gnu.org>
+2022-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_font.man: Revised.
+ * src/preproc/tbl/tbl.1.man (Miscellaneous): Document GNU tbl's
+ use of `#T` and `T.` registers.
-2008-01-14 Werner LEMBERG <wl@gnu.org>
+2022-05-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff.man: Mention glyph and characters.
- Minor other updates.
- * man/groff_char.man: Minor updates.
- * man/groff_diff.man: Better clarification between characters and
- glyphs.
+ * src/roff/troff/input.cpp (read_color_draw_node): Tweak
+ diagnostic message to better distinguish drawing commands and
+ device control commands.
-2008-01-12 Werner LEMBERG <wl@gnu.org>
+2022-05-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo: Fix top-level structure to make it compilable
- again with all texinfo modes. Reported by Jörg van den Hoff
- <j.van_den_hoff@fzd.de>.
+ [grohtml]: Mitigate double-free problem exposed by malformed
+ input.
-2008-01-11 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/mtsm.h (struct statem): Place member variable
+ `issue_no` behind `DEBUGGING` preprocessor symbol, omitting it
+ from production and ordinary development builds.
+ * src/roff/troff/mtsm.cpp (no_of_statems): Place global variable
+ behind `DEBUGGING` preprocessor symbol, omitting it from
+ production and ordinary development builds.
+ (statem::statem): Make constructor trivial if `DEBUGGING` not
+ defined in preprocessor; it manipulates only `issue_no` and
+ `no_of_statems`, which are synchronized.
+ (statem::statem {copy}): Gate assignment of `issue_no` member
+ variable from copy constructor behind `DEBUGGING` preprocessor
+ symbol.
+ (statem::flush, mtsm::inherit): Gate debugging output, already
+ runtime-gated on `debug_state` symbol, of `issue_no` member
+ variable, so that we don't reference it when it is not declared.
- * doc/pic.ms: Mention that compass points of line objects are
- arbitrarily located.
+ See <https://savannah.gnu.org/bugs/?62040>.
-2008-01-06 Werner LEMBERG <wl@gnu.org>
+2022-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/node.cpp (left_italic_corrected_node::add_self):
- Don't remove itself if there is no glyph associated with the node
- yet. This happens, for example, in this situation:
+ [refer]: Rename a test artifact; it's a bibliographic database
+ file, not a refer(1) command file.
- .ll 15000u
- .ft I
- x x
- (\,f
+ * src/preproc/refer/tests/artifacts/62124.ref: Rename this...
+ * src/preproc/refer/tests/artifacts/62124.bib: ...to this.
+ * src/preproc/refer/refer.am (EXTRA_DIST):
+ * src/preproc/refer/tests/report-correct-line-numbers.sh: Use
+ new name.
-2008-01-05 Werner LEMBERG <wl@gnu.org>
+2022-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_char.man, man/groff.man: Revised.
+ * src/preproc/refer/command.cpp (process_commands): Begin
+ migration to use existing global variables for location reports
+ in diagnostic messages. Save current file name and line number
+ before calling `command_loop()` and restore them afterward.
+ Also decrement line counter before entering that loop because it
+ would be too far advanced by one due to the final newline on a
+ parsed input line.
- * src/preproc/eqn/lex.cpp (troff_defs): Fix typo.
+2022-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2008-01-04 Werner LEMBERG <wl@gnu.org>
- * */*: s/Osanna/Ossanna/.
+ * src/preproc/refer/refer.cpp (main): Report system error on
+ `fflush()` failure. POSIX Issue 5 a.k.a. SUSv2 (1997) specifies
+ several possible `errno` values this C standard library function
+ can set; see
+ <https://pubs.opengroup.org/onlinepubs/007908799/xsh/fflush.html>.
- * */*.man: Replace .URL with .UR/.UE (except in groff_www.tmac).
- Replace .MTO with .MT/.ME (except in groff_www.tmac).
- Insert `\:' in URLs where appropriate.
- Don't include www.tmac (except in groff_www.tmac).
+2022-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff.man (.ESC[]): Fix font of closing bracket.
- (.ESCq): Fix font of closing quote character.
- Many other improvements.
+ [refer]: Refactor: drop unused version of function (taking only
+ a `const char *` parameter).
-2007-12-30 Bernhard Fisseni <bfi@ikp.uni-bonn.de>
+ * src/preproc/refer/command.cpp (process_commands): Drop
+ definition.
+ * src/preproc/refer/command.h (process_commands): Drop
+ declaration.
- * src/devices/grohtml/post-html.cc
- (html_printer::writeHeadMetaStyle): Fix CSS output.
+2022-05-04 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-12-29 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/refer/refer.cpp (do_file): Fix another off-by-one
+ line number reporting bug exposed by fix for Savannah #62391.
- * tmac/ec.tmac: Add CM fonts to the .fspecial lines; those fonts
- contain additional glyphs (like some uppercase Greek letters).
+2022-05-04 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-12-06 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/refer/tests/report-correct-line-numbers.sh: Add
+ more regression tests.
- * NEWS: Updated.
+2022-05-04 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-12-06 Colin Watson <cjwatson@debian.org>
+ [refer]: Trivially refactor: boolify.
- * src/roff/nroff/nroff.sh: Add options -w and -W.
- * src/roff/nroff/nroff.man: Document them.
+ * src/preproc/refer/command.cpp (input_stack::push_file): Demote
+ and rename local variable from `int` to `bool`.
+ (bol): Renamed from this...
+ (is_at_beginning_of_line): ...to this.
-2007-12-06 Karl Berry <karl@freefriends.org>
+2022-05-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/hyphenex.pl: Update header output.
+ [refer]: Trivially refactor.
-2007-11-29 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/refer/command.cpp (input_stack::push_file):
+ * src/preproc/refer/refer.cpp (do_file): Drop unnecessary
+ construction of integer from integer (return type of `getc()`)
+ in argument to error diagnostic functions; parallelizes with
+ other diagnostic function calls.
- * src/devices/grotty/tty.cpp (tty_printer::line): Fix line lengths.
+2022-05-04 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-11-20 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/refer/command.cpp: Refactor to simplify.
+ (get_location): Demote return type from `int` to `void`. The
+ function only ever returned a `1` literal.
+ (input_stack::error): Update call site to stop uselessly testing
+ return value of `get_location()`.
- * doc/pic.ms: Add Heinz-JĂŒrgen's 3d boxes example.
+2022-05-03 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-11-17 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am (dist-info-bits, install_infodoc, dist-gnueps): Fix
+ logic error. When checking both source and build trees for
+ files to copy, break after successfully copying the files, not
+ after the first iteration of the loop unconditionally. This
+ caused the Info documents not to be installed from out-of-tree
+ builds, and potentially would prevent them and doc/gnu.eps from
+ being included in the distribution archive if for some reason
+ they didn't build and that build failure were not treated as an
+ error. Problems introduced by me in commits e78bd20d54, 27
+ March, and d79c3f3a4a, 11 November.
- * src/roff/nroff/nroff.sh: Handle GROFF_TYPESETTER environment
- variable. Problem reported by Michael G Schwern
- <schwern@pobox.com>.
+2022-05-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/nroff/nroff.man: Document it.
- Other minor updates.
+ * m4/groff.m4 (GROFF_APPRESDIR_OPTION): Update comments and
+ human-readable output to (1) stop claiming that existing
+ gxditview application defaults in the installation directory
+ will be backed up; this is no longer true as of commit
+ c66cb7725f, 3 April; and (2) refer to these files as
+ "application defaults", not "resources". (X11 application
+ defaults are client-side and mandatory [for Xt-based programs];
+ X resources are stored server-side and need not be configured to
+ determine an X client's geometry and rendering.)
-2007-11-17 Heinz-JĂŒrgen Oertel <hj.oertel@t-online.de>
+2022-05-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devX100-12/devX100-12.am (devX100_12_fontdir):
+ * font/devX100/devX100.am (devX100_fontdir):
+ * font/devX75-12/devX75-12.am (devX75_12_fontdir):
+ * font/devX75/devX75.am (devX75_fontdir): Define macros without
+ an extra "font/" layer in the directory hierarchy.
- * src/groff/preproc/pic/lex.cpp (table): Add box attributes
- `xslanted' and `yslanted'.
+ Fixes problem introduced by me in commit 3c82cbbfe5, 27
+ February.
- * src/groff/preproc/pic/object.cpp (object_spec::object_spec):
- Initialize `xslanted' and `yslanted'.
- (graphic_object): Add methods `set_xlanted' and `set_yslanted'.
- (closed_object): Ditto.
- Add members `xslanted' and `yslanted'.
- (box_object::print): Use them.
- (object_spec::make_object): Handle slant values.
- * src/groff/preproc/pic/object.h (IS_XSLANTED, IS_YSLANTED): New
- constants.
- (object_spec): Add members `xslanted' and `yslanted'.
- * src/groff/preproc/pic/pic.y (XSLANTED, YSLANTED): New left-valued
- tokens.
- Add rules for them.
-
- * src/groff/preproc/pic/pic.man, NEWS, doc/pic.ms: Document above
- changes.
+2022-05-03 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-11-16 Werner LEMBERG <wl@gnu.org>
+ * font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries): Spell
+ dependency on `$(SH_DEPS_SED_SCRIPT)` using that macro expansion
+ instead of a literal file name. See doc/automake.mom.
- * tmac/hyphenex.pl: Generate copyright notice (this has been
- approved by Barbara Beeton).
- * tmac/hyphenex.us: Updated.
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-11-10 Michail Vidiassov <master@iaas.msu.ru>
+ * src/preproc/eqn/eqn.am (MAINTAINERCLEANFILES):
+ * src/preproc/pic/pic.am (MAINTAINERCLEANFILES):
+ * src/preproc/refer/refer.am (MAINTAINERCLEANFILES): Preserve
+ byacc/bison output artifacts unless "maintainer-clean"ing. Per
+ the GNU Automake manual, "The intermediate files generated by
+ yacc (or lex) will be included in any distribution that is made.
+ That way the user doesnât need to have yacc or lex."
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * Makefile.am: Stop manually handling "test-groff". Per the
+ GNU Automake manual, "If configure built it, then distclean
+ should delete it." This is taken care of automatically if we
+ don't interfere.
+ (BUILT_SOURCES, MOSTLYCLEANFILES): Drop "test-groff".
- * tmac/doc-syms (doc-str-St--susv3): New string.
- * tmac/groff_mdoc.man: Document it.
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-11-08 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/eqn/eqn.am (neqn): Produce temporary file first
+ and set its permissions before moving it into place. If
+ anything in the future ever has a dependency on it, this avoids
+ a race where the file exists, satisfying a dependency, but
+ execution is attempted before its `x` permission bit is set.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Ensure that we install *.me source files, but don't
+ include them in the distribution archive.
+
+ * doc/doc.am (dist_otherdoc_DATA): Move `$(GENERATEDDOCFILES)`
+ from here...
+ (nodist_otherdoc_DATA): ...to here.
+ (.PRECIOUS): Add `$(GENERATEDDOCFILES)` so that make(1) doesn't
+ automatically remove "intermediate" objects in the .me.in -> .me
+ -> .ps chain.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Handle "gnu.eps" file better.
+
+ * doc/doc.am (GENERATEDDOCFILES): Remove `$(DOC_GNU_EPS)`.
+ (EXTRA_DIST): Ship `$(DOC_GNU_EPS)` in distribution archive.
+ ($(DOC_GNU_EPS)): Simplify rule commands; stop trying to copy
+ the file around since it will either be (1) in the distribution
+ archive from which a build is performed; or (2) missing because
+ a build is being done from Git, in which case we expect the PNM
+ tools to be available.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am (clean_otherdoc): Drop target: it doesn't seem to
+ accomplish anything.
+ (clean_infodoc): Drop target, moving its rules into...
+ (maintainer-clean-local): ...this. Drop deps, both gone now.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am (distclean-local): Drop target: stop cleaning
+ generated forms of our Texinfo manual with the "distclean"
+ target. They ship with the distribution archive and should
+ remain in the tree even if the user needs to re-./configure.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Fix problems exposed by high build parallelism.
+
+ * font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries)
+ (font/devpdf/DESC, font/devpdf/Foundry): Drop
+ unnecessary removal of target prior to creating it.
+ (font/devpdf/Foundry): Add creation of destination build
+ directory as other targets do.
+ (font/devpdf/download): Create dedicated target instead of
+ lumping its generation under the stamp file. Add missing
+ dependencies on `$(DEVPDFFONTMAP_1)`, `$(DEVPDFFONTMAP_2)`,
+ `font/devpdf/Foundry` and `font/devpdf/enc/text.enc`. Remove
+ now-unnecessarily complicated "forgery" of "GEN" line in quiet
+ builds. Tweak format of comment written to "download" file to
+ make field identities clearer. Construct output (with multiple
+ shell commands) in temporary file so it is not read prematurely
+ by the "BuildFoundries" script. Move target into place as the
+ last step.
+ (font/devpdf/stamp): Relocate target to follow its dependencies.
+ Add dependency on "font/devpdf/download".
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Tweak diagnostic messages in BuildFoundries script.
+
+ * font/devpdf/util/BuildFoundries.pl (LoadFoundry)
+ (WriteDownload, CheckFoundry): Recast for specificity and
+ consistent style.
+ (Die): Stop reporting line number with fatal errors; none of the
+ call sites are parsing input.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [refer]: Fix off-by-one error in line number for some
+ diagnostics.
+
+ * src/preproc/refer/command.cpp (input_item::get_location):
+ Decrement reported line number by one after looping over input
+ so that we report the line number as it was before the last
+ newline character seen. This off-by-one error was partially
+ masked by...
+ * src/preproc/refer/refer.cpp (do_file): ...initialization of
+ `current_lineno` to zero. However, for syntax problems (as
+ opposed to the semantic problems of refer(1) command
+ processing), this could result in complaints about the line
+ number before they occurred, even on "line zero". Initialize
+ the variable to 1.
+
+ Fixes <https://savannah.gnu.org/bugs/?62391>.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/refer/tests/report-correct-line-numbers.sh: Add
+ regression test for Savannah #62391.
+
+2022-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/tfmtodit/tfmtodit.cpp (usage): Tweak usage message.
+ Condense `-v` and `--version` into a single output line with
+ brace and pipe notation, which we do not use in our man pages,
+ but consistently do in our usage messages. Use lowercase for
+ option arguments since they are separated from option flag
+ letters by space. Call `fprintf()` once instead of 3 times.
+
+2022-05-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/refer/refer.cpp (main): Tweak wording of
+ diagnostic messages to refer to options consistently and to
+ characterize input as "invalid" rather than "bad".
+ (usage): Document --version option. Use more informative
+ metasyntactic variable names. Organize usage message
+ consistently with our others, and stop wrapping the output
+ lines: we know neither the width of the terminal nor the length
+ of the `program_name` string we're interpolating. See commit
+ b4de44f0, 19 July 2021.
+
+2022-05-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (string_iterator::backtrace): Fix
+ spurious output when `mac.filename` is empty. Provoked by:
+ $ printf '\\(' | troff -b
+
+2022-05-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/refer/refer.cpp: Trivially refactor. Demote
+ global variable `recognize_R1_R2` from integer to Boolean.
+ (main, do_bib): Give expressions to `assert()` meaningful
+ content.
+ (is_list): Demote return type from `int` to `bool`.
+ (do_file): Demote and rename integer local variables
+ `start_of_line` to Boolean `at_start_of_line`.
+ (is_list, do_file): Reorder equality comparisons to avoid
+ inadvertent lvalue assignment.
+
+2022-05-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Reduce and rationalize in-tree document dependencies.
+ This eliminates spurious rebuilds of numerous documents
+ {including the 380+-page groff-man-pages collections}. It also
+ fixes missing dependencies when using the build's groff to
+ generate PostScript documents.
+
+ * .gitignore: Drop old name of devpdf stamp file.
+ * doc/.gitignore: Drop now-unused "example.stamp" file.
+ * doc/doc.am (PROCESSEDDOCFILES_HTML, PROCESSEDDOCFILES_PDF)
+ (PROCESSEDDOCFILES_TXT): Add new macros grouping targets by the
+ format/output driver used to produce them, to better organize
+ dependencies for their generation.
+ (PROCESSEDDOCFILES): Redefine as simply the expansions of the
+ foregeoing.
+ (PROCESSEDFILES_DEPS_HTML, PROCESSEDFILES_DEPS_HTML,
+ PROCESSEDFILES_DEPS_PDF, PROCESSEDFILES_DEPS_TXT): Add new
+ macros defining prerequisites for production of the
+ corresponding output document formats.
+ ($(PROCESSEDDOCFILES_HTML), $(PROCESSEDDOCFILES_PDF),
+ $(PROCESSEDDOCFILES_PS), $(PROCESSEDDOCFILES_TXT)): Declare the
+ dependencies using expansions of the foregoing macros.
+ (MOSTLYCLEANFILES): Drop "doc/automake.pdf", now part of
+ `PROCESSEDDOCFILES_PDF`.
+ (doc/automake.pdf): Drop dependencies already supplied by
+ `PROCESSEDFILES_DEPS_PDF`.
+ (HTMLDOCFILES): Drop macro. "doc/pic.html" is now in the
+ expansion of `PROCESSEDDOCFILES_HTML`.
+ (htmlpic_DATA): Redefine as expansion of
+ `PROCESSEDDOCFILES_HTML` instead of `HTMLDOCFILES`.
+ (PROCESSEDEXAMPLEFILES_HTML) [BUILD_HTML]: Define as
+ "doc/webpage.html", otherwise as empty.
+ (PROCESSEDEXAMPLEFILES_PS): Contain "doc/webpage.ps" and
+ "doc/grnexampl.ps".
+ (PROCESSEDEXAMPLEFILES): Redefine as expansions of
+ `PROCESSEDEXAMPLEFILES_HTML` and `PROCESSEDEXAMPLEFILES_PS`.
+ ($(PROCESSEDEXAMPLEFILES_HTML), $(PROCESSEDEXAMPLEFILES_PS)):
+ Declare dependencies using `PROCESSEDFILES_DEPS_HTML` and
+ `PROCESSEDFILES_DEPS_PS`, respectively.
+ (HTMLEXAMPLEFILES): Drop macro. "doc/webpage.html" is now in
+ the expansion of `PROCESSEDDOCFILES_HTML`.
+ (nodist_htmlexamples_DATA): Drop macro, no longer needed.
+ ($(PROCESSEDDOCFILES_PS)): Relocated and redefined above.
+ ($(PROCESSEDEXAMPLEFILES) $(PROCESSEDDOCFILES)): Drop overbroad
+ dependency declarations in favor of the above.
+ (MOSTLYCLEANFILES, doc/examples.stamp): Drop generation and
+ removal of unnecessary stamp file.
+ (doc/pic.html, doc/webpage.html): Add explicit dependency on
+ required preprocessors. Drop redundant and spurious
+ dependencies.
+ * font/devhtml/devhtml.am (MOSTLYCLEANFILES)
+ (font/devhtml/stamp): Generate and remove stamp file to enable
+ reliable target dependencies for build-time generation of HTML
+ documents by groff.
+ * font/devpdf/devpdf.am (MOSTLYCLEANFILES, font/devpdf/stamp):
+ Rename stamp file from "font/devpdf/build_font_files".
+ (font/devpdf/stamp): Drop unnecessary dependency on "afmtodit".
+ * font/devps/devps.am (MOSTLYCLEANFILES, font/devps/stamp):
+ Generate and remove stamp file to enable reliable target
+ dependencies for build-time generation of PostScript documents
+ by groff.
+ * font/devutf8/devutf8.am (MOSTLYCLEANFILES)
+ (font/devutf8/stamp): Generate and remove stamp file to enable
+ reliable target dependencies for build-time generation of
+ UTF-8-encoded text documents by groff.
+
+ Fixes <https://savannah.gnu.org/bugs/?62084>; thanks to
+ Sergei Trofimovich for the report. Also fixes
+ <https://savannah.gnu.org/bugs/?62297>; thanks to Bjarni Ingi
+ Gislason for the report.
+
+2022-04-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Fix code style nits in Automake files.
+
+ * doc/doc.am: Put spaces around (Auto)make variable assignments,
+ for consistency with the rest of this .am file, and our others.
+ * font/devpdf/devpdf.am (font/devpdf/build_font_files): Use
+ shell '>' operator instead of touch(1).
+ * font/devhtml/devhtml.am (font/devhtml/DESC):
+ * font/devps/devps.am (font/devps/DESC): Construct target in
+ temporary file, since doing so is a multi-step process, moving
+ it to the target name when it is complete and usable by
+ dependencies.
+
+2022-04-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/refer/refer.cpp (main): When complaining of
+ unrecognized option, report the entire option string (after
+ the leading dash), not just its first character.
+
+2022-04-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libgroff/error.cpp: Trivially refactor. Explicitly
+ compare pointer lvalues to null pointers instead of punningly
+ treating them as Booleans. Annotate use of zero literals as
+ null pointers to ease any future migration to ISO C++11.
+
+2022-04-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (an*abbreviate-inner-footer): Clean up better
+ before early returns. Remove temporary registers.
+
+2022-04-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/fallbacks.tmac: Add fallbacks for U+02C6 MODIFIER LETTER
+ CIRCUMFLEX ACCENT and U+02DC SMALL TILDE to Basic Latin
+ characters.
- * src/preproc/preconv/preconv.cpp (emacs_to_mime): Add `utf-16be',
- `utf-16le', `utf-16be-with-signature', `utf-16le-with-signature'.
- (is_comment_line): Handle '\" and '\# also.
+2022-04-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/preconv/preconv.man: Revise and make complete.
+ [tests]: Fix portability problem. Don't pass echo(1) arguments
+ containing backslashes because implementations handle them
+ differently. Use printf(1) instead. Thanks to Bertrand
+ Garrigues for reporting the problem and confirming the fix on
+ his build host.
-2007-10-25 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/e_chapter-titles-work.sh:
+ * tmac/tests/e_ld-works.sh:
+ * tmac/tests/localization-works.sh: Do it.
- * tmac/cs.tmac: New file holding Czech strings, contributed by
- Marcela Maslanova <mmaslano@redhat.com>.
- * tmac/hyphen.cs, tmac/hyphenex.cs: New hyphenation pattern files
- for Czech, taken from CTAN.
- * LICENSES: Updated.
- * tmac/Makefile (NORMALFILES): Add Czech stuff.
- * doc/groff_tmac.man: Mention cs.tmac.
+2022-04-27 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-10-21 Werner LEMBERG <wl@gnu.org>
+ * src/devices/gropdf/gropdf.pl (ppsz): Recognize "com10" (U.S.
+ commercial envelope) paper format.
- * src/roff/troff/input.cpp (do_ps_file): Handle `%X' in header
- comments correctly. Reported by Frank Jahnke
- <jahnke@sonatabio.com>.
+ Addresses the original issue reported in
+ <https://bugs.debian.org/1009248>. We have however broadened
+ its scope; see <https://savannah.gnu.org/bugs/?62344>.
-2007-10-02 Ruslan Ermilov <ru@FreeBSD.org>
+2022-04-27 Dave Kemper <saint.snit@gmail.com>
- * tmac/doc-common, tmac/groff_doc.man: Add FreeBSD 6.2, document
- FreeBSD 5.5 and 7.0.
+ * src/devices/gropdf/gropdf.pl (ppsz): Recognize ISO B-series
+ paper formats using strings of the form "b0-b6", not "isob0-b6",
+ for consistency with libgroff and papersize.tmac.
- * tmac/doc-syms: Give better names for System V releases.
+ Fixes <http://savannah.gnu.org/bugs/?62346>.
-2007-09-25 Gaius Mulley <gaius@glam.ac.uk>
+2022-04-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/Makefile.in, doc/Makefile.sub (.ms.html): Add -P-V switch to
- the production of html files.
- (pic.html): Ditto.
- Remove background colour switch.
- (.SUFFIXES, clean): Handle *.xhtml files.
+ * doc/doc.am: Refactor to simplify. Ingo's removal of the
+ "--with-doc" "configure" option, among other changes, clears the
+ way to remove many phony targets and simplify dependencies
+ involving generation of the 5 formats of our Texinfo manual.
+ (build_infodoc, doc, doc_all, doc_txt, dvi, doc_dvi, pdf,
+ doc_pdf, html, doc_html): Drop phony targets.
+ (all): Depend directly on doc/groff.{info,txt,html,dvi,pdf}.
+ * NEWS: Add item since "make doc" is no longer necessary and
+ will do nothing.
- * src/devices/grohtml/grohtml.man: Document that -V option now
- generates an HTML-4.01 validator or XHTML validator.
+2022-04-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/html-text.cpp (html_text::end_tag,
- html_text::start_tag): Suppress <small>, <big>, and <color> tags if
- we are inside a <pre> block.
+ [tbl]: Handle `\R` sequences in text blocks robustly.
- * src/devices/grohtml/post-html.cpp
- (html_printer::handle_valid_flag): Add a parameter to indicate
- whether it needs to generate a paragraph block.
- (html_printer::write_navigation): Updated.
- (html_printer::do_file_components): Generate an HTML-4.01 blue
- validator button also.
+ * src/preproc/tbl/table.cpp (table::add_entry): Fix SEGV when
+ repeating glyph table entry syntax (`\Rx`) used in a text block.
+ Lift extraction of entry string to be done unconditionally,
+ rather than in 5 different special cases. This frees us up to
+ rewrite the entry if necessary, changing '\R' to '\&' inside a
+ text block. Recast diagnostic to describe the problem
+ clearly--"bad repeated character" suggests that something is
+ wrong with the "argument" to `\R`, when really the problem is
+ the _context_.
-2007-09-23 Axel Kielhorn <A.Kielhorn@web.de>
+ Fixes <http://savannah.gnu.org/bugs/?62366>.
- * man/groff.man: Fix URL of CSTR 54.
+2022-04-27 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-09-23 Werner LEMBERG <wl@gnu.org>
+ [tbl]: Regression-test Savannah #62366.
- * man/groff_char.man: Normalize character set names as defined
- by IANA. Based on a patch from Axel Kielhorn.
+ * src/preproc/tbl/tests/\
+ do-not-segv-when-backslash-R-in-text-block.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
- * src/preproc/refer/label.y: Undo change from 2007-09-19.
+2022-04-26 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-09-19 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/string.cpp (string::extract): Check return
+ value of `malloc()` for nullity, and only poke into the buffer
+ returned if it is valid. Discovered while troubleshooting
+ Savannah #62366.
- * src/roff/troff/input.cpp (interpolate_arg): Remove compiler
- warning.
+2022-04-23 Bertrand Garrigues <bertrand.garrigues@laposte.net>
- * src/preproc/eqn/pile.cpp (pile_box::output, matrix_box::output):
- Remove compiler warning.
-
- * src/preproc/refer/label.y: Remove compiler warning.
-
- * src/preproc/pic/pic.y: Remove doubled token entries.
-
-2007-09-19 Gaius Mulley <gaius@glam.ac.uk>
-
- * doc/groff.texinfo: Document new .O register and add cross
- reference entries.
-
- * NEWS: Updated.
-
- * src/devices/grohtml/grohtml.man: Document new -V and -y options.
-
- * src/devices/grohtml/html-table.cpp: Add support for XHTML 1.1.
- (html_table:: emit_colspan, html_table::emit_td): New methods.
- (html_table::emit_col): Use html_table::emit_td.
- (html_table::emit_table_header): Use html_table::emit_colspan if
- dialect xhtml is specified.
- (html_table::finish_row): Updated.
-
- * src/devices/grohtml/html-table.h (html_table): Declare
- emit_colspan, emit_td.
-
- * src/devices/grohtml/html-text.cpp: Modified tags to comply with
- xhtml if this dialect was requested.
-
- * src/devices/grohtml/html-text.h (html_dialect): New enumeration.
- (html_text): Add new variable `dialect'.
-
- * src/devices/grohtml/post-html.cpp: Modify header tags to be XHTML
- compliant.
- (valid_flag, groff_sig, dialect): New global variables.
- (html_printer::handle_valid_flag, html_printer::do_math,
- html_printer::write_html_anchor, html_printer::write_xhtml_anchor,
- html_printer::do_math, html_printer::handle_valid_flag): New
- methods.
- (html_printer::emit_line, html_printer::emit_raw,
- html_printer::do_check_center, html_printer::write_title,
- write_rule, html_printer::writeHeadMetaStyle, generate_img_src,
- html_printer::begin_page): Altered to be XHTML compliant.
- (html_printer::write_header): Updated.
- (html_printer::troff_tag): Call do_math.
- (html_printer::insert_split_file, html_printer::do_file_components,
- html_printer::write_navigation): Create XHTML file components if
- necessary and also produces a groff signature if requested.
- (~html_printer): Call writeHeadMetaStyle at appropriate places
- depending upon html_dialect.
- (html_printer::special): Handle new tags `html<?p>' and `math<?p>'.
- (main): Added options -x, -V, and -y.
- (usage): Updated.
-
- * src/preproc/eqn/box.cpp: Create a distinction between
- the MathML device and the XHTML device.
- (do_text): Issue a newline at the end of the equation if XHTML was
- specified.
- (box::top_level): Prefix the output of an equation by the .MATHML
- macro.
- (output_string): Suppress \n if XHTML was specified.
-
- * src/preproc/eqn/main.cpp (xhtml): New global flag.
- (inline_equation): Skip leading spaces after inline equation for
- XHTML device.
- (main): Set `xhtml' flag if `-Tmathml:xhtml' is specified.
-
- * src/preproc/eqn/eqn.h (xhtml): New external flag.
-
- * src/preproc/eqn/text.cpp (entity_table): Fix typo.
-
- * src/preproc/html/pre-html.cpp (html_dialect): New enumeration.
- (dialect, eqn_flag): New global variables.
- (html_system): Improve debugging support.
- (alterDeviceTo): Test for -Txhtml when altering device to the image
- device and reset to -Txhtml.
- (addZ): Renamed to...
- (addArg): This.
- Introducea a general parameter.
- (print_args): New debugging function.
- (char_buffer::run_output_filter): Use print_args and addArg rather
- than addZ.
- (char_buffer::do_html, char_buffer::do_image): Add -rxhtml=1 command
- line parameter as an argument to the html generation of text when
- xhtml is needed. Include -e on the command line if mathml is
- required.
- (scanArguments): Allow -e, -V, -y and -x options.
- -V, -y are handled by the back end. -e sets `eqn_flag'.
- -x determines HTML dialect.
-
- * src/roff/groff/groff.cpp (possible_command): New method
- `clear_name'.
- (main): Set eflag if -e is present on command line.
- Set is_xhtml if -Txhtml is present.
- Pass `-x x' to the HTML pre and post processors.
- Pass `-e' to the HTML pre processor if required.
- Pass `-Tmathml:xhtml' to eqn if XHTML is requested.
-
- * src/roff/troff/input.cpp (init_input_requests): Introduce new
- number register `\n[.O]'.
-
- * tmac/s.tmac: (LP): Use .nop for semantic sugar.
- (cov*ab-init) reformat.
- (@EQ): Use EQN-HTML-IMAGE and friends rather than HTML-IMAGE.
- (CHECK-FOOTER-AND-KEEP): Define FS, FE such that they use
- <cite></cite> for the html device rather than generate images for
- footnotes.
-
- * tmac/troffrc-end: Define EQN-HTML-IMAGE,
- EQN-HTML-IMAGE-END, EQN-HTML-IMAGE-RIGHT,
- EQN-HTML-IMAGE-LEFT, EQN-HTML-IMAGE-INLINE,
- EQN-HTML-DO-IMAGE, EQN-HTML-IMAGE-END as null strings.
-
- * tmac/www.tmac: (HTML<?p>): New macro.
- (MATH<?p>): New macro.
- (IMG, PIMG, MPIMG, HR): Use XHTML compliant syntax.
- (www-emit-ltag): New macro.
- (www-push-li): Updated.
- (ULS): Ensure that tags are balanced in order by use of
- www-emit-ltag.
- (ULE): Likewise: Use www-emit-ltag and shut down paragraphs in
- order.
- (OLS, OLE, DLS, DLE): Ditto.
- <global>: Define EQ and EN to EQN-HTML-IMAGE and EQN-HTML-IMAGE-END
- respectively.
- (www-li-ul, www-li-ol, www-li-dl): Updated.
- (EQN-HTML-IMAGE, EQN-HTML-IMAGE-RIGHT, EQN-HTML-IMAGE-LEFT,
- EQN-HTML-IMAGE-INLINE, EQN-HTML-DO-IMAGE, EQN-HTML-IMAGE-END,
- MATHML): New macros.
+ gnulib: replace non-recursive-gnulib-prefix-hack with
+ automake-subdir option
+
+ 'non-recursive-gnulib-prefix-hack' is deprecated by gnulib's
+ commit f8eed11b15e9141d061900e4068ea1f3ba9b63f6 and replaced by
+ '--automake-subdir'.
-2007-09-17 Werner LEMBERG <wl@gnu.org>
+ * bootstrap.conf:
+ (gnulib_modules): Remove option
+ 'non-recursive-gnulib-prefix-hack'.
+ (gnulib_tool_option_extras): Add option '--automake-subdir'.
+ (bootstrap_post_import_hook): Remove the invocation of
+ 'build-aux/prefix-gnulib-mk'.
- * man/groff_font.man: Document `unicode' keyword.
- * doc/groff.texinfo (DESC File Format): Synchronize with
- groff_font.man.
+ * doc/automake.mom: update documentation accordingly.
-2007-09-15 Werner LEMBERG <wl@nu.org>
+ Fixes <http://savannah.gnu.org/bugs/?61708> and
+ <https://savannah.gnu.org/bugs/?62205> , issues reported and fix
+ suggested by Bjarni Ingi Gislason <bjarniig@rhi.hi.is>. Fix
+ also suggested by Werner LEMBERG <wl@gnu.org> (see
+ <https://repo.or.cz/ttfautohint.git/commit/a938fc63cb55ef48393a924d7083b13c1352d294>).
- * man/groff.man: Document `\_'.
- * doc/groff.texinfo: Ditto.
- Remove references to `\@' which isn't a valid escape sequence in
- groff.
+2022-04-23 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+ Update gnulib submodule
- * tmac/unicode.tmac: Add ` and '.
- * tmac/html.tmac: Load unicode.tmac.
+ * gnulib now points on c8b8f3bbcde37a53cd226f4c9cebd0dde6aca37f
-2007-09-14 Werner LEMBERG <wl@gnu.org>
+ * bootstrap: merge the latest version from gnulib/build-aux
+ {groff's bootstrap has a patch for OS X}.
- * tmac/unicode.tmac: Make `-' a pure input character by mapping it
- to `hy'.
+ * bootstrap.conf: update copyright date.
- * src/roff/troff/input.cpp (init_charset_table): Handle `hy'.
+2022-04-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-09-11 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (XH-UPDATE-TOC): Modify Keith Marshall's new XN/XH
+ feature to indent TOC entries by section heading depth. The
+ increment is 2 ens per depth level.
- * src/libs/libgroff/string.cpp (string::remove_spaces): Fix memory
- allocation.
+2022-04-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/table.cpp (table::allocate): Initialize
- `blockflag' array.
+ * tmac/s.tmac (XA): Drop apparently useless `ll` request. It
+ doesn't do anything according to my tests.
-2007-09-10 Keith Marshall <keith.d.marshall@ntlworld.com>
+2022-04-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * README.MinGW: Add warnings about use of MSYS-RXVT, and about
- defective GnuWin32 versions of netpbm/libpng.
+ * src/preproc/refer/label.ypp: Drop redundant declaration of
+ `yyparse`. Both byacc 20140715 and GNU Bison 3.3.2 supply the
+ the function prototype themselves. Addresses
+ "-Wredundant-decls" warning from GCC.
-2007-07-15 Keith Marshall <keith.d.marshall@ntlworld.com>
+ Fixes <https://savannah.gnu.org/bugs/?43569>.
- * tmac/s.tmac (cov*first-page-init): Remove invoking trap, to avoid
- possible recursion.
+2022-04-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-07-11 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/grn/hdb.cpp (DBGetType): Lower fatal diagnostics
+ to errors when encounting invalid element type characters.
+ Return a value interpreted by our caller as an error indication
+ instead. Helps compilers determine that we're not implicitly
+ falling through our cases. Addresses "-Wimplicit-fallthrough"
+ warnings from GCC.
- * gendef.sh: Add shebang.
+ Fixes https://savannah.gnu.org/bugs/?54702>.
-2007-07-05 Werner LEMBERG <wl@gnu.org>
+2022-04-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/papersize.tmac: Fix dimensions of executive paper format.
- Reported by John Rupley <rupley@u.arizona.edu>.
+ * src/preproc/grn/hdb.cpp (DBRead): Add more validity checking.
+ Verify that the number of conversions returned by fscanf() is as
+ expected instead of throwing this information away--abort
+ processing ("giving up" like pic(1) does) if it does not.
+ Consistently report this abandonment in diagnostic messages.
+ Similarly validate pointer returned by fgets(). Soften handling
+ of invalid text condition from fatal error, introduced in
+ commit eb4f0675e, 16 August, to a normal one with abandonment of
+ Gremlin file. Addresses "-Wunused-result" warnings from GCC.
-2007-07-02 Keith Marshall <keith.d.marshall@ntlworld.com>
+2022-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/s.tmac (cov*first-page-init): Emit error message if not in
- top-level environment.
+ * src/preproc/grn/main.cpp (conv): Throw an error diagnostic
+ when failing to open a Gremlin picture file.
-2007-06-12 Werner LEMBERG <wl@gnu.org>
+2022-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/xditview/TODO, NEWS: Updated.
- * src/devices/xditview/Makefile.sub (install_data, uninstall_sub):
- Handle `GXditview-color'.
- * src/devices/xditview/gxditview.man: Updated.
+ [man]: Fix extraneous space in output after `ME` or `UE` when
+ mandoc wrapper is used.
- * m4/groff.m4 (GROFF_APPRESDIR_CHECK): Updated.
- * m4/codeset.m4, m4/glibc21.m4, m4/iconv.m4, m4/lib-link.m4: Updated
- from `gnulib' git repository.
+ * tmac/an-ext.tmac (UE, ME): Double backslashes in macro
+ definitions when interpolating `.$` register (just like we tell
+ everyone else to do). This one was interesting to track down.
+ When using just `-man`, the problem never manifested; only with
+ `-mandoc`. The difference is that with the former, the `.$`
+ register is initialized to zero; with the latter, because `TH`
+ is aliased to another macro (then unaliased), `.$` has the
+ argument count to the `TH` macro, not to the macros actually
+ being called. This caused the wrong branch of a conditional to
+ be taken and put an extra space node on the output.
- * configure.ac: Updated.
- * configure: Regenerated (using autoconf 2.61).
+ Fixes <https://savannah.gnu.org/bugs/?62044>.
- * config.guess, config.sub: Updated from `config' CVS repository.
- * config.rpath, install-sh, mkinstalldirs: Updated from `gnulib' git
- repository.
+2022-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-06-12 Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
+ * tmac/cp1047.tmac:
+ * tmac/latin1.tmac:
+ * tmac/latin2.tmac:
+ * tmac/latin5.tmac:
+ * tmac/latin9.tmac: Stop remapping input soft hyphen characters
+ with `tr` requests in character encoding macro files. The
+ formatter does this for us now.
- * src/devices/xditview/GXditview.ad: Split off color definitions
- into...
- * src/devices/xditview/GXditview-color.ad: This new file.
+2022-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-06-08 Fabrice MĂ©nard <menard.fabrice@wanadoo.fr>
+ [troff]: Translate 8-bit NBSP and SHY on input.
- * tmac/fr.tmac: Handle chapter system for `me'.
+ * src/roff/troff/input.h: Define constant integers for "input"
+ no-break spaces and soft hyphens for EBCDIC and non-EBCDIC
+ (presumably ASCII/ISO 8859/Unicode) systems.
-2007-06-05 Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
+ * src/roff/troff/input.cpp (token::next): Translate the input
+ character codes for NBSP to \~ and SHY to \%.
- * src/devices/xditview/xditview.c (main): Add support for
- accelerators.
+ Fixes <https://savannah.gnu.org/bugs/?58962>. Thanks to Dave
+ Kemper for the report, code review, and his suggestion to push
+ more work to compile time.
- * src/devices/xditview/GXditview.ad: Updated.
- Make widget more colourful.
+2022-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-05-30 Werner LEMBERG <wl@gnu.org>
+ [groff]: Regression-test Savannah #58962.
- * tmac/groff_mdoc.man: Convert `-' to `\-' where appropriate.
- Recommend `tbl' instead of `-column' lists for more complicated
- cases.
+ * src/roff/groff/handle_special_input_code_points.diff: Do it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
-2007-05-21 Werner LEMBERG <wl@gnu.org>
+2022-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/ps.cpp (ps_printer::set_char): Handle subfonts
- correctly.
+ * src/roff/troff/input.cpp (do_if_request): Clarify diagnostic;
+ at the point it is thrown, we know not merely that we're in a
+ conditional expression, but processing an output comparison
+ operator.
-2007-04-10 Werner LEMBERG <wl@gnu.org>
+2022-04-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- In pic, make rounded boxes work with colors. Reported by Urs Eggli
- <Urs.Eggli@zuerich.ch>.
+ * doc/groff.texi:
+ * doc/ms.ms:
+ * man/groff.7.man: Characterize "roff language" in the singular,
+ not the plural, emphasizing the similarity of extant specimens.
- * src/preproc/pic/common.h (common_output), src/preproc/pix/output.h
- (output): Add color parameter to `rounded_box' member function.
+ * doc/groff.texi (Conventions Used in This Manual): Add
+ paragraph discussing denotations of "groff" and "roff".
- * src/preproc/pic/common.cpp (common_output::rounded_box): Use it.
+ Fixes <https://savannah.gnu.org/bugs/?62233>. Thanks to John
+ Gardner and Dave Kemper for the discussion.
- * src/preproc/pic/object.cpp (box_object::print): Pass `color_fill'
- to `out->rounded_box'.
+2022-04-12 Ingo Schwarze <schwarze@openbsd.org>
-2007-04-09 Michail Vidiassov <master@iaas.msu.ru>
+ Delete the harmful, ill-designed, buggy, and essentially
+ unmaintained and untested --with-doc option of the configure
+ script.
- * font/devps/generate/textmap: Add Greek letters and some more.
+ * configure.ac: Delete five AM_CONDITIONAL variables, one
+ autoconf(1) macro call, and some related diagnostic output.
+ * doc/doc.am: Delete two BUILD_EXAMPLES and one BUILD_OTHERDOC
+ conditional and use BUILD_HTML instead of BUILD_HTMLEXAMPLES.
+ * m4/groff.m4: Delete the GROFF_DOC_CHECK macro and simplify the
+ macros GROFF_HTML_PROGRAMS, GROFF_INSTALL_INFO, GROFF_MAKEINFO,
+ and GROFF_PDFDOC_PROGRAMS. This also deletes more than thirty
+ configuration variables.
+ * Makefile.am: Delete comments about 16 variables that are no
+ longer set.
+ * NEWS: Add details regarding the rationale.
- * src/utils/afmtodit/afmtodit.tables: Change values of `Delta',
- `Omega', and `mu' to the ones from aglfn.txt.
+2022-04-12 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-04-08 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * src/preproc/preconv/preconv.cpp (unicode_entity): Convert
+ input U+00A0 to \~ as troff would, not to \[u00A0].
- * tmac/s.tmac (SN): Define unconditionally.
- (SN-STYLE): New string; define.
+ Fixes <https://savannah.gnu.org/bugs/?62300>.
- * NEWS, tmac/groff_ms.man, doc/groff.texinfo (SN-STYLE): Document it.
+2022-04-11 Deri James <deri@chuzzlewit.myzen.co.uk>
-2007-03-22 Werner LEMBERG <wl@gnu.org>
+ [gropdf] fails to deal with 255th glyph in font.
- * tmac/pspic.tmac: Fix harmless numeric overflow warning. Reported
- by Jörg van den Hoff <j.van_den_hoff@fzd.de>.
+ * src/devices/gropdf/gropdf.pl: a pdf font can only contain 255
+ glyphs. The array which holds the glyph names also holds the
+ start position (zero) as first element, it is legal for it to
+ contain 256 elements, so truncate to 256 (not 255).
-2007-03-20 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?62294>.
- * tmac/trace.tmac (rn): Added.
- (nr, ds, ds1, as, as1, substring): Restore escape character while
- executing the macro.
- (nr): Remove dead code.
+2022-04-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/box.cpp (box::top_level): Use \E in string
- definitions to make them traceable.
+ [localization]: Define hyphenation mode registers for Japanese
+ and Chinese. They are set to zero but must be defined so that
+ macro packages can rely on their existence without causing 'reg'
+ warnings.
-2007-03-19 Werner LEMBERG <wl@gnu.org>
+ * tmac/ja.tmac:
+ * tmac/zh.tmac: Do it.
- * src/roff/troff/input.cpp (get_copy): Add third argument to control
- whether \E shall be expanded.
- (get_char_for_escape_name): Allow \E.
+2022-04-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-03-15 Werner LEMBERG <wl@gnu.org>
+ [tests]: Add test for multi-lingual man(7) scenario.
- * tmac/s.tmac (MO, CH, pg*OH, pg*EH, pg*OF, pg*EF, *, [., .],
- par*define-font-macro, \[hooko]): Use \E to make it traceable.
+ * tmac/tests/localization-works.sh: Test two more cases. Ensure
+ that the 'trap bit' (hyphenation value 2, which has nothing to
+ do with any language) is preserved when switching locales back
+ from a CJK language, since those languages' modes
+ unconditionally clear it. We test Japanese and Chinese; we have
+ no localization macro file for Korean at this time.
- (ref*field): Add argument to control the space between previous and
- current argument.
- Update all callers.
- (ref*add-N): Fix handling of opening parenthesis. Problem reported
- by Jörg van den Hoff <j.van_den_hoff@fzd.de>.
+2022-04-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-03-14 Werner LEMBERG <wl@gnu.org>
+ [man]: Slightly refactor `an*abbreviate-inner-footer`.
- * tmac/trace.tmac (als): Added.
- (de, de1, am, am1): Make traced macros aliased with .als work.
+ * tmac/an.tmac (an*abbreviate-inner-footer): Discard
+ unnecessary string.
-2007-02-25 Werner LEMBERG <wl@gnu.org>
+2022-04-09 Ingo Schwarze <schwarze@openbsd.org>
- * src/devices/xditview/TODO: Add some more items.
+ Fix the configuration of texi2dvi.
- * Makefile.comm (.man.n): Add @APPRESDIR@.
- Sort entries.
+ * m4/groff.m4: Set groff_have_texi2dvi if texi2dvi(1) is
+ available and usable, even if the availability was specified by
+ the user by manually providing the configure variable
+ PROG_TEXI2DVI, and not only if it was autodetected.
+ Also, set the PROG_TEXI2DVI Makefile variable to the name of
+ the texi2dvi program specified by the user or autodetected,
+ and not to the string "found", such that this Makefile variable
+ can be used for invoking the program.
+ * doc/doc.am: Call the texi2dvi program specified by the user
+ or autodetected rather than hardcoding "texi2dvi". This lets
+ the groff build succeed on systems where the first texi2dvi
+ in the $PATH is an old version unfit for groff's purposes.
- * src/devices/xditview/gxditview.man: Document GXditview resource
- file.
- Other documentation enhancements based on a patch from Jörg.
+2022-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-02-25 Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
- Joerg van den Hoff <j.van_den_hoff@fzd.de>
+ [man]: Abbreviate long `TH` arguments more carefully.
- * src/devices/xditview/GXditview.ad: Make all keys work regardless
- of the current mouse position.
+ * tmac/an.tmac: Do it.
+ (an*scan-string-for-backslash): Add new helper macro.
+ (an*abbreviate-inner-footer): Rewrite. Use the foregoing and a
+ different technique to compute available space and shorten the
+ string.
-2007-02-20 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?62257>.
- * tmac/groff_man.man: Revised to improve visual appearance.
- Reduce use of future tense.
+2022-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_trace.man: Revosed to improve visual appearance.
+ [man]: Add regression test for Savannah #62257.
-2007-02-19 Eric S. Raymond <esr@snark.thyrsus.com>
+ * tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh:
+ Do it.
+ * tmac/tmac.am (tmac_TESTS): Run it.
- Make groff.man viewer-portable.
+2022-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff.man: Eliminate use of .eo/.ec.
- (.REQ): Surround args 2 through N with quotes. This will enable us
- not to rely on the shift request, which is nonportable.
- (ExecFF): Remove. The code is simpler without it.
+ * tmac/an.tmac: Trivially refactor. Rename strings `an-ifoot`
+ to `an*ifoot` and `an-outer-footer-text` to `an*ofoot`.
-2007-02-18 Eric S. Raymond <esr@snark.thyrsus.com>
+2022-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_www.man: Viewer-portability fixes.
+ * tmac/an.tmac: Refactor. Abbreviate page title and inner
+ footer only once per document instead of once per page.
+ Exception: the legacy macros `AT` and `UC` change the inner
+ footer, so re-abbreviate it if they are called.
+ (TH, AT, UC): Call abbreviation macros from here...
+ (an-header, an-footer): ...instead of here.
-2007-02-16 Eric S. Raymond <esr@snark.thyrsus.com>
+2022-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff.man: Remove some unneeded code and a no-longer-used
- inclusion of the www macros.
+ * tmac/an.tmac: Refactor: initialize header/footer environment
+ only once. Also rename it to `an*env-header-and-footer`.
+ (TH): Do it here...
+ (an-header, an-footer): ...instead of here.
-2007-02-12 Werner LEMBERG <wl@gnu.org>
+2022-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/table.cpp (compute_span_width): Fix use of
- AVAILABLE_REG.
- (table::compute_widths): Simplify.
+ * tmac/an.tmac: Trivially refactor.
+ (an*prepare-page-title): Rename this...
+ (an*abbreviate-page-title): ...to this.
+ (an-prepare-inner-footer): And this...
+ (an*abbreviate-inner-footer): ...to this.
+ (an-header, an-footer): Update call sites.
-2007-02-11 Werner LEMBERG <wl@gnu.org>
+2022-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/table.h: Don't include `stdbool.h'.
- (table): Replace `bool' type with `char' for orthogonality.
- Update all users.
+ * src/preproc/eqn/other.cpp (hmotion_box::output): Fix typo in
+ generated MathML diagnostic message.
- * src/preproc/tbl/table.cpp (block_entry::do_divert): Fix usage of
- AVAILABLE_REG and COLCOUNT_REG.
- (table::table): Fix order call of initializers.
- (table::~table): Deallocate `blockflag'.
+2022-04-07 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-02-09 Eric S. Raymond <esr@snark.thyrsus.com>
+ * doc/doc.am (EXTRA_DIST): Add "groff.dvi" and "groff.pdf" to
+ ensure that the GNU-released groff distribution archive contains
+ our Texinfo manual in these formats. (This doesn't increase the
+ build-dependency requirements unless you want to "make dist", in
+ which case it _should_.)
- A try at the new rule for block column allocation is now enabled by
- the new `experimental' global option: The horizontal space up to the
- right margin which is not used by columns without text blocks is
- evenly distributed to the columns with text blocks.
+2022-04-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- It doesn't work right as yet; there appears to be some error in the
- computation of `3avail', the available line length. The purpose of
- this patch is (a) to make experimenting with other formulas easy,
- and (b) leave the infrastructure for flag `experimental' in place
- for future experiments. Do not document any behavior associated
- with this flag!
+ [ms]: Add nroff mode fallback for `UL` macro.
- * src/preproc/tbl/table.h: Include `stdbool.h'.
- (table): Make `flags' public.
- Add `count_block_columns' function.
- Add `blockflag' array.
- Add `EXPERIMENTAL' enumeration value.
+ * tmac/s.tmac (UL): On nroff devices, bracket the first argument
+ with \(ul (underline rule) special character escape sequences.
+ {In plain language, '.UL "like this"' renders "_like this_".}
+ See corresponding 12 February change to "tmac/e.tmac".
- * src/preproc/tbl/table.cpp (AVAILABLE_REG, COLCOUNT_REG): New
- macros.
- (table_entry): New member `parent' so that class and subclass
- members can set a parent field. Update all users.
- (block_entry::do_divert): Handle `EXPERIMENTAL' flag.
- (block_entry::do_width): Set the parent's `blockflag'.
- (table::allocate): Handle `blockflag'.
- (table::count_block_columns): New function.
- (compute_span_width): Adjust AVAILABLE_REG.
- (table::compute_widths): Handle COLCOUNT_REG and AVAILABLE_REG.
-
- * src/preproc/tbl/main.cpp (process_options): Handle `experimental'
- option.
+2022-04-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-02-08 Zhao, Yu (William) <yzhao2@alcatel-lucent.com>
+ * doc/doc.am: Drop unnecessary `-I` options to groff.
+ (DOC_GROFF): There is no need to look at the top of the build
+ directory for any file inclusions.
+ (doc/webpage.html): There is no need to look in `doc_builddir`
+ for file inclusions, since that is the current working directory
+ when "webpage.ms" is processed.
- * src/devices/grodvi/dvi.cpp (draw_dvi_printer::draw) <'e'>: Set
- line thickness.
+2022-04-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-02-08 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am: Trivially refactor. Use `RM` macro idiomatically.
+ Automake ensures that it is defined to call an `rm` command with
+ the `-f` option, and this in turn ignores failures to delete
+ nonexistent files, so...
+ (uninstall_doc_examples, uninstall-pdf): Stop adding superfluous
+ `-f` flag.
+ (clean_infodoc uninstall-pdf, uninstall-html): Stop prefixing
+ command with `-` to ignore error exit status.
+ (uninstall-html): Drop superfluous `-r` flag; we're only
+ deleting files with this command, not directories.
- * man/groff_out.man (offset): Make it work reliably.
+2022-04-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-02-07 Eric S. Raymond <esr@snark.thyrsus.com>
+ * doc/doc.am: Trivially refactor shell style in rule commands.
+ The placement of `&&` was inconsistent. Always begin a
+ continued rule line with it, and don't give it its own
+ indentation level. In general, operators adjacent to line
+ continuations should _follow_ the continuations because they are
+ easier for humans to spot at the (possibly indented) beginning
+ of a physical line.
- * man/groff_out.man: Simplify some font changes so \fP is less
- likely to do something surprising.
-
- * man/groff_out.man: We can simplify the command macros still
- further if we stop trying to hide structural requests inside them.
- Also, fix some instances of \} at start of line without a dot, and
- make some font changes explicit in strings.
-
- * man/groff_out.man: Cleanup -- remove now-unneeded uses of .do and
- .cp.
-
- * man/groff_out.man: Final step: Reduce x-command, get rid of eo/ec
- calls and fix macros to do without them. File should now be
- viewer-portable.
-
- * man/groff_out.man: Fourth step: Eliminate use of eqn in favor of
- micromotions that produce the same visual result and can be lifted
- to XML-DocBook.
-
- * man/groff_out.man: Third step: Reduce Da-comand, fix a
- call-sequence bug in the original.
-
- * man/groff_out.man: Second step: Reduce D-commmand and D-command+,
- move font-change escapes to portable form.
+2022-04-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_out.man: First step in macro simplification; eliminate
- list1..n, simplify .offset and .index_offset so they no longer
- require groff-specific features or eqn (instead, use troff
- micromotions for subscripting).
+ * Makefile.am: Rename `TFLAG` macro, which means "tmac flag", to
+ `MFLAG`, because it expands to `-M` options to groff, not the
+ `-T` option, which can be bewildering.
+ * doc/doc.am (DOC_GROFF): Update expansion site.
+
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Rename `DOC_GROFF_ONLY` to `DOC_GROFF`.
+
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Refactor. Drop ghastly hack used to get file
+ names into troff diagnostics when reading from standard input.
+ We've refactored so that it no longer does, making the hack
+ unnecessary. For the same reason, no users of the `DOC_GROFF`
+ macro remain, so delete it. Add comments to explain what
+ `DOC_SED` and `DOC_GROFF_ONLY` are for.
+
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Refactor.
+ (doc/pic.html, doc/webpage.html): Drop indirection of source
+ document through `DOC_SED` macro. It was not necessary since
+ neither of these documents are parameterized in configuration
+ options (that is, they don't contain @VERSION@ or @g@).
+
+2022-04-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Trivially refactor.
+ (doc/webpage.html): Tidy up dependency list. Create directory
+ using the same macro interpolation we use to change into it.
+
+2022-04-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Refactor and fix error in builds in remote
+ out-of-source-tree builds exposed by pending commit and `make
+ distcheck`. The images generated for the pic.html and
+ webpage.html files were being built in the wrong directory, and
+ subsequently not found by an install rule.
+ (imagedir): Add comment explaining purpose of macro. It should
+ _not_ be used with any file specifications relative to the
+ source or build trees--it is for installation directories only.
+ (htmldocimagedir, exampleimagedir): Drop macros.
+
+ (doc/pic.html, doc/webpage.html): Replace interpolations of
+ `imagedir` with literal "img", since these files are being
+ generated within the build tree: the directory name is known.
+
+ (mostlyclean_doc, install_doc_htmldoc, install_doc_examples):
+ Replace interpolations of `htmldocimagedir` relative to
+ `doc_builddir` with "img" literals.
+
+ (install_doc_htmldoc, uninstall_doc_htmldoc): Interpolate
+ concatenation of `htmldocdir` and `imagedir` instead of
+ `htmldocimagedir` (relative to `DESTDIR`).
+ (install_doc_examples, uninstall_doc_examples): Interpolate
+ concatenation of `exampledir` and `imagedir` instead of
+ `exampleimagedir` (relative to `DESTDIR`).
+
+2022-04-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Refactor. Relocate "doc/grnexampl.ps" target to
+ group it with other me(7) documents. Put addition of
+ "doc/examples.stamp" to `MOSTLYCLEANFILES` adjacent to its
+ target rule. Relocate same rule so that it precedes the target
+ depending on it (make(1) might not benefit from this, but human
+ readers can).
+
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Refactor.
+ (DOC_GROFF_ONLY): Drop preprocessor options from groff command.
+ This macro is now, simply, a way to run the in-tree groff: no
+ assumptions about preprocessors, macro packages, or output
+ device are made.
+ (doc/pic.html, doc/webpage.html): Add only necessary
+ preprocessor options after expansion of `DOC_GROFF_ONLY`.
+
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Refactor. Add explicit dependencies of compiled
+ man page documents on preprocessors needed to generate them. In
+ their target rules, explicitly use groff's preprocessor options,
+ freeing us up to simplify the `DOC_GROFF_ONLY` macro.
+
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Rationalize dependencies. Drop dependency of
+ `PROCESSEDEXAMPLEFILES` and `PROCESSEDDOCFILES` on expansion of
+ `hdtbltmac_DATA`, because nothing in this directory uses the
+ hdtbl package. Move dep of same expansions on "gnu.eps" to
+ "doc/webpage.html", which actually uses it. Put the numerous
+ dependencies of "doc/pic.html" and "doc/webpage.html" in a
+ parallel ordering so that they are easier for humans to
+ evaluate. These targets' dependencies on `bin_PROGRAMS` and
+ `prefixexecbin_PROGRAMS` are overkill and should be reviewed at
+ a later date.
+
+2022-04-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Refactor use of target and suffix rules.
+ (doc/meintro.me, doc/meintro_fr.me, doc/meref.me): Add target
+ rules, with lengthy, exasperated comment about lack of feature
+ parity in various make(1) implementations.
+ (doc/meintro_fr.ps): Add target rule, as this seems to be the
+ only way to keep GNU Make from ignoring a '_fr.me._fr.ps' suffix
+ rule in favor of '.me.ps', which doesn't call preconv (and
+ doesn't need to--and moreover we don't want to build English
+ me(7) documents with the `-mfr` option). Depend on `preconv`.
+ (doc/webpage.ps): Convert from suffix rule to target rule.
+ (doc/ms.ps, doc/pic.ps, doc/webpage.ps): Add target rules and
+ dependencies.
+ (.ms.ps): Add commented-out suffix rule (since nothing uses it,
+ but might in the future).
+ (doc/meintro_fr.ps, .me.ps, doc/pic.ps, doc/webpage.ps): Migrate
+ expansions of `DOC_GROFF` to `DOC_GROFF_ONLY` to prepare for a
+ forthcoming simplification.
+
+2022-04-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Clean generated doc files better. doc/me*.me were
+ getting left behind in the build tree.
+ (MOSTLYCLEANFILES): Add `GENERATEDDOCFILES`. This includes
+ `DOC_GNU_EPS`, so...
+ (clean_maintdoc): Drop phony target that manually removes it.
+ (maintainer-clean-local): Drop dependency on foregoing.
+
+2022-04-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/xditview/xditview.am (install_xditview)
+ [!WITHOUT_X11]: Stop backing up existing "GXditview" and
+ "GXditview-color" application defaults files. There is no
+ symmetric restoration of them in the uninstall target, and it
+ seems like unjustifiable complexity to add such. These are
+ groff-specific file names, installed (by default) to /usr,
+ not /etc, so they are not going to be "configuration files" in
+ Debian-based systems, for example (and likely not elsewhere).
+ There are other ways to supersede application defaults for
+ programs using the X Toolkit Intrinsics.
+
+2022-04-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Stop treating "gnu.eps" as an "example" file; it
+ is also used by pdfmark's cover.ms, which is ordinary
+ documentation. We therefore must not omit it when building.
+ (install-data-hook): Add dependency on new phony target,
+ "install_doc_gnu_eps".
+ (install_doc_examples): Move installation of "gnu.eps" from
+ here...
+ (install_doc_gnu_eps): ...to here. Also refactor the loop we
+ use to locate the file to follow a more idiomatic pattern.
-2007-02-06 Eric S. Raymond <esr@snark.thyrsus.com>
+2022-04-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/eqn.man: Minor corrections.
+ * doc/doc.am (dist-info-bits, install_infodoc, dist-gnueps): Fix
+ code style nit: use consistent "brace style" in conditionals and
+ loops.
- * tmac/an-ext.tmac: Change .UR/.UE and .MT/.ME so the start macro no
- longer takes a second argument that is pasted to the end of the
- generated text. Instead, the end macro takes an argument that does
- the same thing.
+2022-04-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/ditroff.man, man/groff_diff.man, man/groff.man,
- man/groff_out.man, man/groff_tmac.man, man/roff.man,
- src/roff/groff/groff.man, src/roff/grog/grog.man,
- tmac/groff_man.man, tmac/groff_trace.man: Update accordingly.
-
- * src/roff/troff/troff.man: .SY and .YS are canned macros now,
- so we can use them here.
-
-2007-02-05 Eric S. Raymond <esr@snark.thyrsus.com>
+ * doc/doc.am (mostlyclean_doc): When cleaning, try harder to
+ remove the image directory created by the "pic.html" and
+ "webpage.html" targets.
- * src/preproc/eqn/lex.cpp, src/preproc/eqn/eqn.man:
- By popular demand, make ... set three lower dots again
- and introduce a new predefined macro 'cdots' to set
- three centered dots.
+2022-04-02 Ingo Schwarze <schwarze@openbsd.org>
-2007-02-05 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am: Stop installing doc/meintro.me.in,
+ doc/meintro_fr.me.in, and doc/meref.me.in.
- * src/preproc/eqn/eqn.man: Revised.
+2022-03-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/text.cpp (map, special_char_boc::output): Use
- `const'.
- (spacing_type): Fix typo.
- (special_to_entity): Use `const'.
- Remove unused variable.
- * src/preproc/eqn/other.cpp (font_box::output): Use `const'.
+ * doc/webpage.ms: Die horribly if `PSPIC` call fails.
-2007-02-05 Eric S. Raymond <esr@snark.thyrsus.com>
+2022-03-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grotty/grotty.man: \m[] and \M[] aren't portable,
- which is a shame as the effect was cute.
-
-2007-02-04 Eric S. Raymond <esr@snark.thyrsus.com>
-
- * man/groff_tmac.man, man/groff_diff.man: Portability conversion;
- rip out over-elaborate macrology, use .EX/.EE and .UR/.UE where
- possible, remove preamble declarations and macros that are no
- longer needed. Conversion checked using the protocol described in
- tmac/TESTING-HINTS.
-
-2007-02-03 Werner LEMBERG <wl@gnu.org>
-
- * tmac/an-old.tmac (LP, IP, HP): Use .ns to suppress additional
- vertical space.
-
-2007-02-03 Eric S. Raymond <esr@snark.thyrsus.com>
-
- * tmac/groff_man.man: Documented the extension macros, and
- added portability advice.
-
- * MORE.STUFF: More-stuff entries for doclifter and pic2plot.
-
-
- Add support for MathML output to eqn.
-
- The strategy used is very simple and relies on the fact that the box
- models of eqn and Presentation MathML differ in only trivial ways.
- It leaves the grammar and existing internal object structures
- unchanged. A new global, `output_format', is defined as an
- enumerated type with values {troff, mathml}. Most of the functions
- and methods that emit actual output acquire a top-level conditional,
- dispatching on this global, which has one arm for troff mode and one
- for MathML mode. In most cases the MathML arm is drastically
- simpler.
-
- (This strategy could be easily generalized to support other output
- formats. TeX is a possibility that leaps to mind.)
-
- The only even moderately tricky changes are in the lexer. Some of
- the predefined macros used constructs like `up', `down', `fwd',
- `back', and `vcenter' that have no equivalents in MathML. I
- attacked this problem in these ways:
-
- 1. I eliminated three uses of `back' to compose characters in favor
- of using equivalent groff specials `\(<<', `\(>>', and `\(<>'
- that did not exist when these macros were written. (This will be
- a quality improvement for troff users.)
+ * tmac/pspic.tmac (pspic*error-hook): Define (as empty).
+ * man/groff_tmac.5.man (Auxiliary packages) <pspic>: Document.
+ * NEWS: Add item.
- 2. I eliminated one use of `vcenter' by using \\(md. (Likewise...)
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- 3. I then split the table of pre-definitions in three; one large
- common table and two small troff-specific and MathML-specific
- tables. Use of troff-only operations (up, down, back, fwd,
- vcenter) is now confined to the former. The latter now uses
- `size big' and drops out the explicit positioning operations,
- counting on MathML processors to do them.
+ * doc/doc.am (doc/webpage.ps): Relocate target rule.
- POTENTIAL TROUBLE SPOTS:
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- Here are notes for reviewers on places I'm not 100% sure I've done
- the right thing:
+ * tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+ * tmac/tests/pdfpic_falls-back-to-PSPIC.sh: Remove output file
+ even when skipping test. Quote `fail` variable when checking it
+ with `test -z`.
- * In the process of preparing the troff table, I translated three
- definitions (dot_def, dotdot_def, and utilde def) that previously
- used explicit \v escapes to use `up' and `down' instead. I
- modeled the new definitions on the way `vec' and `dyad' work, but
- it's possible I got something subtle wrong.
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * I'm not certain the MathML implementation of font_box::output() is
- right, because I don't quite get what the switcheroo between
- `current_roman_font' and `old_roman_font' is supposed to
- accomplish. It does seem to generare good MathML, though.
+ * man/groff_tmac.7.man (Auxiliary packages): Tweak sboxes
+ documentation to imply ms dependency.
- Finally, I made one purely cosmetic change in `text.cpp'; I replaced
- with an enum some magic numbers for spacing types that I thought
- were too ugly to live.
+ Fixes <https://savannah.gnu.org/bugs/?62062>.
- REMAINING ISSUES:
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- The entirety of eqn is translated when `-TMathML' is specified,
- with the following exceptions...
+ * tmac/an.tmac (an*bookmark): Trivially refactor. Now that
+ we're no longer doing arithmetic on our first argument, simplify
+ our definition. Made possible by commit 3baf0e2f3, 23 February.
- Limitations that cannot be fixed include non-support for special,
- up/down/fwd/back, and vcenter.
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- Limitations that might be fixable include non-support for mark and
- lineup. I will investigate further, but if these can be implemented
- at all it's going to be in a very complicated and nasty way.
+ * src/preproc/preconv/preconv.cpp (detect_file_encoding): Demote
+ an error diagnostic to a debugging message. libuchardet has no
+ man page, and inspecting the source of the
+ `uchardet_handle_data` function we find that it effectively
+ returns a Boolean value (if the result of a
+ `reinterpret_cast`(!) is not `NS_OK`). This is useless
+ information for a user-facing tool. We're designed to muddle on
+ regardless (see preconv(1)).
- The way character boxes are output means that each digit of a
- multi-digit number gets its own <mn></mn> tag pair in the MathHTML.
- While this is not technically wrong for Presentation MathML, it is
- ugly and inefficient. Fixing this will require implementing a
- little state machine in the `text.cpp' output method.
+2022-03-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/box.cpp, src/preproc/eqn/delim.cpp,
- src/preproc/eqn/eqn.h, src/preproc/eqn/eqn.man,
- src/preproc/eqn/lex.cpp, src/preproc/eqn/limit.cpp,
- src/preproc/eqn/list.cpp, src/preproc/eqn/main.cpp,
- src/preproc/eqn/other.cpp, src/preproc/eqn/over.cpp,
- src/preproc/eqn/pile.cpp, src/preproc/eqn/script.cpp,
- src/preproc/eqn/sqrt.cpp, src/preproc/eqn/text.cpp,
- src/preproc/eqn/eqn.man: MathML output mode.
+ * src/devices/grodvi/dvi.cpp (dvi_printer::set_color)
+ (draw_dvi_printer::fill_next):
+ * src/devices/grops/ps.cpp (output::put_color):
+ * src/libs/libgroff/color.cpp (color::print_color): Construct
+ doubles instead of casting to them.
- * NEWS: Document it.
+2022-03-28 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-02-02 Eric S. Raymond <esr@snark.thyrsus.com>
+ [doc]: Refactor handling of "gnu.eps" file.
- * src/roff/groff/groff.man: Converted to use .SY/.OP/.YS
- and for cross-viewer portability. Conversion checked
- using the protocol described in tmac/TESTING-HINTS.
+ * doc/doc.am: Put "gnu.eps" in a Make macro, `DOC_GNU_EPS`.
+ ($(PROCESSEDEXAMPLEFILES) $(PROCESSEDDOCFILES),
+ doc/webpage.html, install_doc_examples): Migrate dependency to
+ `DOC_GNU_EPS`.
+ (doc/webpage.ps): Add (missing) dependency on `DOC_GNU_EPS`.
+ (DOC_GROFF_ONLY): Drop `-I` flag; it's not necessary given the
+ following.
+ (.ms.ps): Drop `-mwww` argument from suffix rule. A truly
+ generic ms document won't need it.
+ (doc/webpage.ps): Add target rule. Include `-mwww` argument.
+ (doc/webpage.ps, doc/webpage.html): Pass `-I` option to
+ `DOC_GROFF` and `DOC_GROFF_ONLY` (respectively) to enable
+ location of "gnu.eps" file. Search the build and source trees'
+ "doc" directories because the file can be generated as part of
+ the build or can come with the distribution archive.
+ (EXTRA_DIST): Drop redundant inclusion of "doc/gnu.xpm".
+ (clean_maintdoc): Add phony target to dispose of `DOC_GNU_EPS`.
+ (maintainer-clean-local): Depend on "clean_maintdoc".
-2007-02-02 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+ * tmac/tests/pdfpic_falls-back-to-PSPIC.sh: Update tests to look
+ for "gnu.eps" in "doc" directory of build tree. Give generated
+ files distinguishable names so their tests can run concurrently.
- * tmac/an-ext.tmac (ME): Don't use `\:'.
+2022-03-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/grog/grog.man: Further refinements and normalizations.
+ * doc/doc.am: Add new macro `PROCESSEDDOCFILES_PS` to isolate
+ names of targets in PostScript format. Expand this macro in
+ definition of `PROCESSEDDOCFILES` and use it to move PostScript
+ font description file dependencies of the latter and
+ `PROCESSEDEXAMPLEFILES` to the former. (At present, the
+ dependency might seem superfluous, since those files are in the
+ source distribution, but it's conceivable that in the near
+ future, they will be produced at build time from Adobe font
+ metric files; see font/devps/generate/Makefile). The "pic.html"
+ and "webpage.html" targets already had such a dependency because
+ of the way grohtml (pre-grohtml) works.
-2007-02-02 Eric S. Raymond <esr@snark.thyrsus.com>
+2022-03-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/grog/grog.man: Converted to use .SY/.OP/.YS and for
- cross-viewer portability. Conversion checked using the protocol
- described in tmac/TESTING-HINTS.
+ * INSTALL.extra: Add a section on uninstalling.
-2007-02-01 Eric S. Raymond <esr@thyrsus.com>
+2022-03-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/TESTING-HINTS: Added.
+ * doc/doc.am: Create target rule for "doc/grnexampl.ps" instead
+ of relying on a suffix rule. Explicitly depend on grn and eqn
+ executables. Produce output using their groff flags, "-ge".
-2007-02-01 Eric S. Raymond <esr@thyrsus.com>
+2022-03-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- Enable the support for Bell archaisms on .SC, so the `-r bell'
- switch is no longer needed to format old AT&T papers like
- the EQN user guide.
+ * tmac/pdfpic.tmac (PDFPIC): Fix breakage when no temporary
+ directory environment variables are defined: actually use string
+ interpolation syntax in comparand to output comparison
+ operator. Problem introduced by me in commits adc1999af and
+ 24900cf6d, 15 February.
- * tmac/s.tmac (.SC, .UC, .P1, .P2): Updated.
+2022-03-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_ms.man, doc/groff.texinfo, NEWS: Updated.
+ * font/devX100-12/devX100-12.am:
+ * font/devX100/devX100.am:
+ * font/devX75-12/devX75-12.am:
+ * font/devX75/devX75.am: Fix in-tree build; expand `fontdir`
+ instead of `abs_top_builddir` Make macro when defining Automake
+ variable for generated artifacts. Problem introduced by me in
+ commit 3c82cbbfe, 27 February. Thanks to Robert Goulding for
+ the report.
-2007-02-01 Eric S. Raymond <esr@thyrsus.com>
+2022-03-22 Ingo Schwarze <schwarze@openbsd.org>
- Add some Bell labs extensions to the -ms macros.
+ * doc/doc.am: delete redundant "SUFFIXES +=" line
- * tmac/s.tmac (.SC, .UC, .P1, .P2) [bell]: New macros.
+2022-03-22 Ingo Schwarze <schwarze@openbsd.org>
- * tmac/groff_ms.man, doc/groff.texinfo, NEWS: Document `-r bell'.
+ * doc/doc.am: fix non-portable syntax in the meintro_fr.ps
+ target: This rule requires DOC_GROFF and hence $<, so turn it
+ into a suffix rule.
-2007-01-30 Werner LEMBERG <wl@gnu.org>
+2022-03-22 Ingo Schwarze <schwarze@openbsd.org>
- * tmac/an-ext.tmac (\n[EX]): Rename to \n[mX].
- (\n[mH]): New register (set if grohtml is used).
- (\n[SY]): Rename to \n[mS].
- (\n[a]): Rename to \n[mA].
- (\n[i]): Rename to \n[mI].
- (mU): New auxiliary input trap macro.
- (UR, UE): Replace stub with real definition.
- (URL): Remove.
- (MT, ME): New macros.
- (MTO): Remove.
- (EX, EE): Don't insert vertical space.
- Use a register to store (and restore) the current font.
+ * doc/doc.am: fix non-portable syntax in the doc/me*.me targets:
+ POSIX does not define the meaning of $< in non-suffix rules, so
+ use the portable $? instead. This is adequate here because each
+ of these three rules has exactly one prerequisite.
- * man/ditroff.man, man/groff_diff.man, man/roff.man: Revised, based
- on patches from Eric Raymond.
- Fix URL addresses.
+2022-03-22 Ingo Schwarze <schwarze@openbsd.org>
-2007-01-22 Gaius Mulley <gaius@glam.ac.uk>
+ * doc/doc.am: fix non-portable syntax in the groff-man-pages.*
+ targets by using DOC_GROFF_ONLY rather than DOC_GROFF in order
+ to not use $< outside a suffix rule; DOC_GROFF functionality is
+ not needed here in the first place.
- * tmac/an-old.tmac (an-trap, HP): Make `HP' work as expected.
+2022-03-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-01-22 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac:
+ * tmac/doc.tmac: Stop remapping input hyphens on `utf8` device.
- * tmac/an-ext.tmac: Protect against being sourced twice.
- (URL, EE): Use always two backslashes.
- (MTO): New macro.
+2022-03-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-01-16 Werner LEMBERG <wl@gnu.org>
+ * tmac/doc.tmac: Stop remapping ` and ' on `utf8` output device.
+ Aligns mdoc(7) with commit 697e6db7f, 19 October 2020 (for
+ man(7)).
- * tmac/an-ext.tmac: Remove code for grodvi.
- (SY): Fix typos.
- Don't insert empty line.
- (URL, TQ): Fix typos.
+2022-03-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-01-14 Werner LEMBERG <wl@gnu.org>
+ * src/utils/afmtodit/afmtodit.pl: Fix bug introduced in commit
+ 0d451902c, 10 March. Don't store a newline in the version
+ string. Put `\n` in its interpolation context as necessary.
- * tmac/an-ext.tmac: New file, containing extension macros
- for -man. See discussion on the groff mailing list for
- background information.
- * tmac/an-old.tmac: Load an-ext.tmac.
- Decorate .ds and as with comment escapes where appropriate.
- * tmac/Makefile.sub (NORMALFILES): Add an-ext.tmac.
+2022-03-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2007-01-05 Werner LEMBERG <wl@gnu.org>
+ Install ptx.tmac.
- * src/preproc/tbl/tbl.man: Document .T# and \n[TW].
+ * tmac/tmac.am (TMACNORMALFILES): Add it.
+ * NEWS: Report availability.
-2007-01-04 Gaius Mulley <gaius@glam.ac.uk>
+ Fixes <https://savannah.gnu.org/bugs/?62201>. Thanks to Ralph
+ Corderoy for the report.
- Make -me macros ready for grohtml.
+2022-03-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/e.tmac: Load devtag.tmac.
- (need_eo_h, need_eo_tl, need_tl): New registers.
- (check_need_title, (x-html, )x-html, xp-html): New macros.
- (@h, hl, ip, @p, sh, (b, (l, EQ, EN, TS, TE, PS, PE, GS, GE, r, i,
- b, rb, bi, bx, (x, )x, xp): Adapt for use with grohtml.
- (bp): Rename to @b only if output device is not html.
+ Drop ditroff(7) document. It says nothing that is not covered
+ elsewhere.
-2007-01-01 Werner LEMBERG <wl@gnu.org>
+ * man/ditroff.7.man: Delete.
+ * doc/doc.am (GROFF_MAN_PAGES):
+ * man/man.am (man7_MANS, EXTRA_DIST): Stop processing, shipping.
+ * src/roff/groff/groff.1.man: Drop cross reference to it.
+ * NEWS: Add item.
- * man/groff_font.man: Document empty lines.
+ Fixes <https://savannah.gnu.org/bugs/?61817>.
- * src/utils/afmtodit/afmtodit.pl: Always print a header comment at
- the very beginning of the output.
- [!$opt_x]: Fix typo.
+2022-03-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/*: Regenerate font definition files.
+ [preconv]: Trivially refactor.
-2007-01-01 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/preconv/preconv.cpp: Use diagnostic message
+ functions from libgroff where possible. Explain in a comment
+ why we don't use `debug()`. Boolify and rename some variables,
+ and use Boolean literals to assign to them.
+ debug_flag -> is_debugging
+ invalid_warning -> emit_invalid_utf8_warning
+ incomplete_warning -> emit_incomplete_utf8_warning
+ Rename `expected_bytes` to `expected_byte_count`. Except for
+ the debugging flag, these are all members of `struct
+ conversion`.
+ (get_tag_lines): Migrate to `warning()`.
+ (detect_file_encoding): Migrate to `error()` and `fatal()`, as
+ appropriate.
+ (utf8::invalid, utf8::incomplete, get_tag_lines): Don't break a
+ line in the middle of a diagnostic; doing so frustrates grepping
+ and necessarily makes an assumption about the terminal width.
- * font/devps/generate/Makefile (AFMTODIT): Use -c flag.
+2022-03-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/*: Regenerate font definition files.
+ [troff]: Trivially refactor.
-2006-12-31 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/input.cpp: Rename global variable
+ `have_string_arg` to `have_multiple_params` and demote it from
+ an integer to a Boolean. Assign Boolean literals to it.
+ (read_long_escape_parameters, get_copy, token::next): Do it.
- * Makefile.in (oldfontdir): New variable.
- (MDEFINES): Add $(oldfontdir).
- (uninstall_dirs): Remove `current' link.
- Remove $(oldfontdir).
+2022-03-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.comm (oldfontsubdir): New variable.
- (install_dev): Install files collected in $(OLDDEVFILES) into
- $(oldfontsubdir).
- (uninstall_dev): Remove data in $(oldfontsubdir).
- (.man.n): Handle @OLDFONTDIR@.
+ [tbl]: Fix Savannah #62191.
- * src/devices/grodvi/grodvi.man, src/devices/grohtml/grohtml.man,
- src/devices/grolbp/grolbp.man, src/devices/grolj4/grolj4.man,
- src/devices/grotty/grotty.man, src/devices/xditview/gxditview.man:
- Document GROFF_FONT_PATH.
+ * src/preproc/tbl/main.cpp (table_input::get): Increment input
+ line counter when encountering an escaped newline; this fixes
+ inaccurate diagnostics from the formatter at any point in a
+ document after a line-continued row of table data. Also drop a
+ "perhaps" comment. I tested the surmise (setting the FSM state
+ to "START"), and it results in bad formatting.
- * src/devices/grops/grops.man: Document GROFF_FONT_PATH and
- old font description files.
+ Fixes <https://savannah.gnu.org/bugs/?62191>. Problem appears
+ to date back to groff 1.02 (June 1991) at the latest.
- * font/devps/Makefile.sub (OLDDISTFILES, OLDDEVFILES): New
- variables.
+2022-03-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/old/*: New directory, holding the previous version
- of the 35 Adobe core font description files.
+ [tbl]: Regression-test Savannah #62191.
- * font/devps/*: Regenerated the 35 Adobe core fonts, using the
- Adobe-Core35_AFMs-229.tar.bz2 bundle from ftp.dante.de.
+ * src/preproc/tbl/tests/count-continued-input-lines.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
- * NEWS: Document font update.
+2022-03-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-12-31 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Environments): Clarify environment handling.
+ * man/groff.7.man (Environments): Add new section.
- * font/devps/generate/Makefile (symbolsl.afm): Use $(srcdir).
+ Fixes <https://savannah.gnu.org/bugs/?62036>. Thanks to Dave
+ Kemper for the report and a suggested patch.
- * Makefile.comm (fonts): New (empty) target.
- * Makefile.in (TARGETS): Add `fonts'.
+2022-03-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * MANIFEST: Add `chem'.
+ * tmac/e.tmac (initialization): Define `@b` as empty if
+ formatting for HTML, because no page breaks occur in that
+ format.
- * doc/groff.texinfo (Changing Fonts): Font translations with .ftr
- can't be chained.
+ Fixes <https://savannah.gnu.org/bugs/?62039>.
-2006-12-26 Werner LEMBERG <wl@gnu.org>
+2022-03-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/grn/hdb.cpp: Include gprint.h later. From NetBSD.
+ * src/devices/grodvi/dvi.cpp (usage): Align usage message with
+ man page; disclose `-l` option.
-2006-12-19 Werner LEMBERG <wl@gnu.org>
+2022-03-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add support for German. For activation, simply use -mde or -mden
- (for traditional and new orthgraphy, respectively) as the last
- macro package.
+ * src/devices/grodvi/dvi.cpp (main):
+ * src/devices/grops/ps.cpp (main): Update diagnostic:
+ characterize bad `-w` argument as "invalid", not "bad", and
+ explicitly report it as ignored.
- * tmac/de.tmac, tmac/den.tmac, tmac/hyphen.det, tmac/hyphen.den,
- tmac/hyphenex.det: New files, partly taken from CTAN.
- * LICENSES: Updated list of hyphenation patterns.
- * man/groff_tmac.man: Mention de.tmac and den.tmac.
- * NEWS: Updated.
+ * src/devices/grodvi/dvi.cpp (main): Report invalid parameter
+ in `-w` diagnostic.
-2006-12-11 Werner LEMBERG <wl@gnu.org>
+2022-03-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- Support up to 32 macro arguments in pic (and up to 16 on EBCDIC
- hosts).
+ * src/devices/grodvi/dvi.cpp (dvi_printer::set_color)
+ (draw_dvi_printer::fill_next):
+ * src/devices/grops/ps.cpp (output::put_color):
+ * src/libs/libgroff/color.cpp (color::print_color): Explicitly
+ cast `enum` divisors to `double`; quietens
+ `-Wdeprecated-enum-float-conversion` warnings.
- * src/preproc/pic/lex.cpp (ARG1): Redefine. Update all users.
- (MAX_ARG): New macro. Use it everywhere to replace hard-coded
- limit of 9 arguments.
- (process_body): Handle argument numbers with more than a single
- digit.
- (interpolate_macro_with_args): Protect against exceeding number of
- arguments.
+ Fixes <https://savannah.gnu.org/bugs/?61964>. Thanks to Bjarni
+ Ingi Gislason for the report.
- * NEWS, src/preproc/pic/pic.man, doc/pic.ms: Document it.
+2022-03-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-12-10 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac: Recover more quickly from missing `EE` calls.
+ (initialization): Define new strings, `an*body-family` and
+ `an*example-family` to house the font families used in these
+ rendering contexts.
+ (TH, SH, SS): Restore the font family to `an*body-family`.
+ (TH): Set font style to roman as well.
+ (EX): Change to `an*example-family` instead of literal "C".
- * Makefile.in (site.exp, docheck): Commented out. Not working
- currently.
- (check): Just emit dummy message.
+ Fixes <https://savannah.gnu.org/bugs/?62187>.
-2006-12-08 Werner LEMBERG <wl@gnu.org>
+2022-03-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- During installation, create soft link from <version> to `current' in
- <datadir>/groff.
+ * tmac/e.tmac: Test register for existence before using it to
+ set hyphenation mode. A site troffrc or other local
+ customization might remove the register (which is guaranteed to
+ be set under the stock configuration) and, perversely, Heirloom
+ Doctools troff interprets a `do` request, instead of ignoring it
+ as a historical troff implementation would, so if they borrow
+ our me(7) changes, the register would be unset, interpolate
+ zero, and hyphenation would wind up disabled.
- * Makefile.comm (install): Renamed to...
- (do_install): This.
- (prefix_must_exist): Removed. Code moved to Makefile.in.
+ Fixes <https://savannah.gnu.org/bugs/?62181>. Thanks to Dave
+ Kemper for the report.
- * Makefile.in (TARGETS): Remove `install'.
+2022-03-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- (install): New target which first creates the directory given by
- --prefix, then calling `make' to do the installation, and finishing
- with the creation of the soft link.
+ [tests]: Rename test to apply naming scheme.
-2006-11-21 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/pdfpic_falls_back_to_PSPIC.sh: Rename this...
+ * tmac/tests/pdfpic_falls-back-to-PSPIC.sh: ...to this.
+ * tmac/tmac.am (tmac_TESTS): Use new name.
- * doc/Makefile.sub (uninstall_sub): Fix names for info files.
+2022-03-14 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-11-18 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grops/ps.cpp (usage): Align usage message with man
+ page synopsis.
- * man/roff.man, doc/groff.texinfo: Improve history of roff, based on
- information from Tom Van Vleck <thvv@multicians.org>.
+2022-03-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Input Line Traps): Fix error; input traps do
+ _not_ ignore control lines. Error appears to have crept in with
+ the first version of our Texinfo manual, shipped with groff 1.14
+ {December 1999}.
+
+2022-03-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devps/devps.am: Rename targets.
+ (fonts):
+ (devps_fonts): Rename these...
+ (maintainer-font-descriptions):
+ (devps_font-descriptions): ...to these. Add comments explaining
+ what they're for and why they aren't used in a build.
+
+ * font/devps/generate/Makefile: Add `outdir` variable to store
+ destination directory of font description files, and update all
+ targets that write artifacts to use this directory. This makes
+ the targets "phony", which I don't regard as a problem since the
+ generated artifacts are kept under source control, and this
+ isn't really a user-facing script (even though it gets
+ installed). I think there is a good chance that this will
+ become a shell script, because to avoid regressions we need to
+ generate the font descriptions using both the 229-glyph and
+ 314-glyph versions of the Adobe fonts' AFM files (so that we get
+ wider glyph coverage _and_ more kerning pair data) and we need
+ to add kerning information for the ellipsis (Savannah #58897).
+ (symbolsl.afm): Revise generation process to be sensitive to
+ failure.
+
+2022-03-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devps/symbolsl.afm: New file.
+ * font/devps/devps.am (EXTRA_DIST): We have long shipped
+ "symbol.afm" with the distribution archive--I don't see why we
+ don't ship "symbolsl.afm" and "zapfdr.afm" as well (metrics for
+ `SS`, the slanted symbol font, and ZDR, reversed Zapf Dingbats).
+ Like the Type 1 font descriptions themselves, this file is
+ updated only in "maintainer mode", not as part of the build.
+ Moreover, these fonts are not part of the PostScript level 2
+ base 35 fonts so their AFM files are unlikely to be readily
+ available elsewhere.
+
+2022-03-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Trivially refactor. Store the
+ program's version string in scalar `afmtodit_version` and use
+ that in the usage message and comment embedded in the output.
+
+2022-03-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Fix code style nits. Migrate
+ to the shebang line style we use in more recently modified Perl
+ scripts. Replace `-w` with `use warnings;`. Shorten an output
+ comment since the groff version string can grow long (see commit
+ 1264531310, 14 January 2018).
+
+2022-03-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Stop writing full file name to
+ the generated font description file as the "name" (i.e., don't
+ include directory components).
+
+ Fixes <https://savannah.gnu.org/bugs/?62150>. Thanks to Dave
+ Kemper for the discussion and code review.
+
+2022-03-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.1.man:
+ * src/utils/afmtodit/afmtodit.pl: Update and align man page
+ synopsis, option descriptions, and command usage output.
+
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/X.tmac: Redirect `fchar` requests for \[lq] and \[rq] to
+ \[dq] since the X11 Type 1-based text fonts encode ISO 8859-1
+ {Latin-1} and don't have typopgrapher's quotes. Drop `fchar`
+ request for \[aq], which _is_ represented, per recent changes.
+
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * /font/devX100-12/CB:
+ * /font/devX100-12/CBI:
+ * /font/devX100-12/CI:
+ * /font/devX100-12/CR:
+ * /font/devX100-12/HB:
+ * /font/devX100-12/HBI:
+ * /font/devX100-12/HI:
+ * /font/devX100-12/HR:
+ * /font/devX100-12/NB:
+ * /font/devX100-12/NBI:
+ * /font/devX100-12/NI:
+ * /font/devX100-12/NR:
+ * /font/devX100-12/TB:
+ * /font/devX100-12/TBI:
+ * /font/devX100-12/TI:
+ * /font/devX100-12/TR:
+ * /font/devX100/CB:
+ * /font/devX100/CBI:
+ * /font/devX100/CI:
+ * /font/devX100/CR:
+ * /font/devX100/HB:
+ * /font/devX100/HBI:
+ * /font/devX100/HI:
+ * /font/devX100/HR:
+ * /font/devX100/NB:
+ * /font/devX100/NBI:
+ * /font/devX100/NI:
+ * /font/devX100/NR:
+ * /font/devX100/TB:
+ * /font/devX100/TBI:
+ * /font/devX100/TI:
+ * /font/devX100/TR:
+ * /font/devX75-12/CB:
+ * /font/devX75-12/CBI:
+ * /font/devX75-12/CI:
+ * /font/devX75-12/CR:
+ * /font/devX75-12/HB:
+ * /font/devX75-12/HBI:
+ * /font/devX75-12/HI:
+ * /font/devX75-12/HR:
+ * /font/devX75-12/NB:
+ * /font/devX75-12/NBI:
+ * /font/devX75-12/NI:
+ * /font/devX75-12/NR:
+ * /font/devX75-12/TB:
+ * /font/devX75-12/TBI:
+ * /font/devX75-12/TI:
+ * /font/devX75-12/TR:
+ * /font/devX75/CB:
+ * /font/devX75/CBI:
+ * /font/devX75/CI:
+ * /font/devX75/CR:
+ * /font/devX75/HB:
+ * /font/devX75/HBI:
+ * /font/devX75/HI:
+ * /font/devX75/HR:
+ * /font/devX75/NB:
+ * /font/devX75/NBI:
+ * /font/devX75/NI:
+ * /font/devX75/NR:
+ * /font/devX75/TB:
+ * /font/devX75/TBI:
+ * /font/devX75/TI:
+ * /font/devX75/TR: Regenerate font descriptions with xtotroff,
+ using updated ISO-8859_1 map. \[aq] and \[oq] are now aliases
+ of "'" and \[ga] is an alias of "`". This change probably
+ should have been made when the X11 fonts were corrected in
+ XFree86 4.0 (March 2000). See
+ <https://www.cl.cam.ac.uk/~mgk25/ucs/quotes.html>.
+
+ Fixes <https://bugs.debian.org/243238>.
+
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libxutil/DviChar.c (ISO_8859_1_map): Fix incorrect
+ assignment of Latin-1 grave accent to \[oq] special character;
+ reassign it to the neutral apostrophe. Map \[aq] to neutral
+ apostrophe. Map \[ga] to '`'.
+
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/xtotroff/xtotroff.1.man (Options) <-d>: Document new
+ option.
+ * src/utils/xtotroff/xtotroff.c (usage): Align with man page.
+
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Manipulating Filling and Adjustment):
+ Explicitly identify the page offset as an output line property
+ that is not determined until a break occurs.
+
+ (Line Layout) <po>: Correct error; the page offset for terminal
+ devices is set by "tty.tmac", not "troffrc". (The manual has
+ been wrong for a long time; we've had it in tty.tmac since James
+ Clark put it there in 1992.) Recast and tighten wording. Drop
+ the word "horizontal"; there is no vertical page offset (as
+ such) in *roff. Replace hand-waving about unexpected results
+ with a description of the formatter's behavior. Document
+ request behavior without an argument before getting into the
+ weeds (and CSTR #54 errata). Migrate terminology from "scaling
+ indicator" to "scaling unit".
+
+ Fixes <https://savannah.gnu.org/bugs/?58035>.
+
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Expressions): Expand '|' operator explanation.
+ Split discussion of its application into horizontal and vertical
+ contexts. Add example of vertical usage.
+
+ Fixes <https://savannah.gnu.org/bugs/?60820>.
+
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp: Trivially refactor. Drop `#define`
+ that was working around a GCC 2.95-era libstdc++ problem.
+ Shorten long line.
+ (get_char_for_escape_parameter): Demote parameter from `int` to
+ `bool` and use Boolean literal for default argument. Annotate a
+ null pointer constant.
-2006-11-16 Werner LEMBERG <wl@gnu.org>
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Rename some internal functions.
+
+ * src/roff/troff/input.cpp: Do it.
+ (read_escape_name):
+ (read_long_escape_name):
+ (read_two_char_escape_name):
+ (get_char_for_escape_name):
+ (read_increment_and_escape_name): Rename these...
+ (read_escape_parameter):
+ (read_long_escape_parameters):
+ (get_char_for_escape_parameter):
+ (read_two_char_escape_parameter):
+ (read_increment_and_escape_parameter): ...to these.
+ (read_two_char_escape_parameter, read_long_escape_parameters,
+ read_escape_parameter, read_increment_and_escape_parameter,
+ get_copy, token::next): Update call sites.
- * tmac/62bit.tmac: New macro package.
- * tmac/Makefile.sub (NORMALFILES): Add it.
- * NEWS: Document it.
+2022-03-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/trace.tmac: Protect against being loaded again.
- (nr): Always show result.
+ * src/roff/troff/input.cpp (get_char_for_escape_name): Recast
+ diagnostic messages to more accurately refer to escape
+ "sequence" rather than "name". "Name" is a confusing term here,
+ given that it also applies to a group of objects sharing a name
+ space (natch): requests, macros, strings, and diversions.
+ Further, the "escape name" cited by these diagnostics is not the
+ escape function selector; that is, the character after the
+ escape character which determines how the escape sequence is to
+ be interpreted. These diagnostics are only thrown after that
+ function is known, however, when parsing of an escape sequence
+ parameter is attempted.
+ (input_char_description): Drop leading articles ("a") from
+ input character descriptions, to economize in diagnostic
+ messages this function helps produce.
+ (non_empty_name_warning): Use zero copula for economy.
- * doc/groff.texinfo (Input Encodings): Document latin-5.
+ * src/roff/troff/input.cpp (empty_name_warning, read_size)
+ (token::get_char, check_missing_character):
+ * src/roff/troff/number.cpp (start_number, parse_term): Recast
+ messages to more consistently use the form "expected X, got Y"
+ where feasible.
- * man/grof_tmac.man: Document sv, latinX, cp1047, 60bit, ec.
+ * src/roff/troff/number.cpp (start_number): Say "numeric
+ expression missing" instead of "missing number"; we don't
+ require a terminal symbol in the expression grammar here. Also
+ use `tok.description()` where we can, and remove assumption that
+ the escape character is the default.
-2006-11-13 Werner LEMBERG <wl@gnu.org>
+2022-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo (Page Location Traps) [.wh]: Give more details
- on negative trap positions.
+ * tmac/an.tmac (AT, UC, HP): Add deprecation warnings. For the
+ last, only do so if we're not inside a synopsis (SY/YS), since
+ our definition of `SY` calls `HP` internally. (This does seem
+ hypocritical. Perhaps if we knew the correct CSS incantation
+ to speak in grohtml, we could un-deprecate `HP`.)
-2006-11-10 Werner LEMBERG <wl@gnu.org>
+2022-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.comm (.man.n): Handle @DATASUBDIR@.
+ * tmac/tmac.an (M4CHECK): Rename stamp file to make its purpose
+ clearer.
-2006-11-09 Werner LEMBERG <wl@gnu.org>
+2022-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * INSTALL: Move information about external installation from
- INSTALL.gen into this file.
- Updated.
+ [man]: Tweak customization management.
- * INSTALL.gen: Update to new version (from texinfo CVS).
+ * tmac/an.tmac: Load "man.local" with `msoquiet` request, so
+ people can get rid of the file if they don't need it.
+ (PT, BT): Define these macros only if not already defined. This
+ is slightly less paranoid but far more ergonomic, given
+ interactions with the andoc wrapper. Now user-defined page
+ header traps (PT) defined in man.local can take effect on the
+ first page rendered.
-2006-11-09 Bernd Warken
+ * tmac/groff_man.7.man.in (Hooks): Document how to remove page
+ headers and/or footers entirely.
- * INSTALL.gen: Extend the file by information on `external
- installation'. Reorder the installation instruction as `normal
- installation'.
+ Fixes <https://savannah.gnu.org/bugs/?61954>.
-2006-11-08 Werner LEMBERG <wl@gnu.org>
+2022-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/Makefile.sub (install_data): Take care of proper paths while
- installing info files. Bug reported by Bernd Warken.
+ [refer,mm]: Add and use `ref*reset` macro to clean up between
+ bibilography entries.
-2006-11-06 Bernd Warken
+ * tmac/refer.tmac (]-): Move string clean up logic from here...
+ (ref*reset): ...to this new macro. Now we can also use it...
- * src/roff/grog/grog.pl: Rewrite.
- - Call by `#! /usr/bin/env perl'. That isn't replaced.
- - Rename usage() to version().
- - Use warnings.
- - For `use strict', start all global variables with an upper case
- character. Use `my' for all variables. Use several new variables.
- - Add option `-h'.
- - Add copyright to GPL and Emacs comment.
- - Handle several `-m*' options.
- - Fix handling of `-ms' and `-mm'. Add .TL and .NH.
- - Allow options after file names.
- - Allow only one `-' parameter (standard input).
- - Add option abbreviations.
- - Expand the usage information.
- - Add `chem'.
- - Add single quote "'" as additional first character and allow
- arbitrary space after the first character.
+ * contrib/mm/refer-mm.tmac (ref*][-first-pass): ...here.
- * src/roff/grog/grog.sh: Rewrite.
- - Remove option `-e' of `sed'.
- - Allow file names with space characters.
- - Add option `-h'.
- - Add copyright to GPL.
- - Handle several `-m*' options.
- - Fix handling of `-ms' and `-mm'. Add .TL and .NH.
- - Allow options after file names.
- - Allow only one `-' parameter (standard input).
- - Add option abbreviations.
- - Expand the usage information.
- - Add `chem'.
- - Add single quote "'" as additional first character and allow
- arbitrary space after the first character.
+ Problem appears to date back to refer-mm.tmac's introduction in
+ January 2011. Thanks to Bjarni Ingi Gislason for the root-cause
+ analysis and proposed fix, to which I applied the DRY principle
+ and added a reset of `ref*string` as well.
- * src/roff/grog/Makefile.sub:
- - Add copyright to GPL.
- - Remove `grog:'. Move `grog.old:' to `grog:' in order to have a
- fair chance to choose between the shell version and the Perl
- version of `grog'. This is now again comparable to grog in groff
- version 1.10.
+ Fixes <https://savannah.gnu.org/bugs/?60657>.
- * src/roff/grog/grog.man: Rewrite.
- - Move the license to GPL.
- - New sections: OPTIONS, DETAILS, EXAMPLES, COPYING.
- - Take over some setup and macros from `groffer'.
- - Add information on options.
+2022-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-10-28 Werner LEMBERG <wl@gnu.org>
+ [mm]: Regression-test Savannah #60657.
- * tmac/trace.tmac: Improve tracing of `.nr'.
- Trace `.substring' also.
+ * contrib/mm/tests/remove-stale-bib-entry-data.sh: Do it.
+ * contrib/mm/tests/artifacts/60657.ref: Add new file.
+ * contrib/mm/mm.am (mm_TESTS): Run test.
+ (EXTRA_DIST): Ship test artifact in distribution archive.
- * NEWS: Updated.
+ Thanks to Bjarni Ingi Gislason for the straightforward
+ bug reproducer.
-2006-10-28 Bernd Warken
+2022-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/roff.man, src/roff/groff/groff.man: Add `chem', fix position
- of groff development site, fix fonts.
+ [refer]: Report correct line number in bibliography file
+ diagnostics.
- * News: Add information on `chem' and `groffer'.
+ * src/preproc/refer/refer.cpp (do_bib): Set line number to 1
+ upon successfully opening a bibliography file.
-2006-10-26 Bernd Warken
+ Problem appears to date back to groff 1.02 (June 1991) at the
+ latest.
- * Makefile.in (OTHERDIRS, NOMAKEDIRS): Add `chem' bundle.
+ Fixes <https://savannah.gnu.org/bugs/?62142>.
-2006-10-26 Werner LEMBERG <wl@gnu.org>
+2022-03-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add `\$^' escape to handle the parameters to a macro as a string
- argument.
+ [refer]: Regression-test Savannah #62124.
+
+ * src/preproc/refer/tests/report-correct-line-numbers.sh: Do it.
+ * src/preproc/refer/tests/artifacts/62124.ref: Add new file.
+ * src/preproc/refer/refer.am (refer_TESTS): Run test.
+ (EXTRA_DIST): Ship test artifact in distribution archive.
- * src/roff/troff/input.h (DOUBLE_QUOTE): New special character.
+2022-03-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (input_iterator, input_stack,
- macro_iterator): Add `space_follows_arg' member function.
- (macro_iterator::add_arg): Add parameter to set the `space_follows'
- flag.
- (arg_list): Add member `space_follows'.
- Update constructor and all callers.
- (decode_args): Store discarded double quotes.
- (interpolate_args): Handle DOUBLE_QUOTE.
- Add `\$^' escape.
- (get_copy, token::next, composite_glyph_name): Handle DOUBLE_QUOTE.
+ * src/roff/troff/div.cpp
+ (top_level_diversion::transparent_output):
+ * src/roff/troff/input.cpp (transparent_translate): Suppress two
+ troublesome (i.e., more or less spurious) error diagnostics
+ about transparent output/throughput unless the environment
+ variable `GROFF_ENABLE_TRANSPARENCY_WARNINGS` is present. This
+ is a bit of a bodge until we get diversion sanitization worked
+ out. See Savannah #61407.
- * tmac/trace.tmac: Trace .nr, .ds, .ds1, .as, .as1.
+2022-03-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * docs/groff.texinfo (Parameters), man/groff.man,
- man/groff_diff.man, NEWS: Document it.
+ [preconv]: Stop assuming that the default input stream, or an
+ explicit '-' operand, is the only unseekable stream. Check
+ instead.
-2006-10-24 Bernd Warken
+ * src/preproc/preconv/preconv.cpp (do_file): Add new Boolean
+ `is_seekable`. Test the input stream with `fseek()` per a
+ suggestion from Ingo Schwarze. Report unseekability in debug
+ output and skip coding tag and uchardet tests altogether
+ {precisely paralleling our description in the preconv(1) man
+ page}. Also update debugging output to say "<standard input>"
+ instead of "-".
- * Makefile.in (NOMAKEDIRS): Add groffer subdirectories.
+ Fixes <https://savannah.gnu.org/bugs/?62131>.
-2006-10-24 Werner LEMBERG <wl@gnu.org>
+2022-03-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_trace.man: Mention problem with `\\\\'.
+ [preconv]: Regression-test Savannah #62131.
-2006-10-23 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Do
+ it.
+ * src/preproc/preconv/preconv.am (preconv_TESTS): Run test.
- * doc/groff.texinfo (Expressions): Improve documentation of `!'.
+2022-03-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/trace.tmac (return): Don't call `substring'.
+ * src/preproc/tbl/main.cpp (process_format): Update diagnostic
+ to recognize that a font mounting position is also an acceptable
+ argument to the 'f' column modifier.
-2006-09-10 Werner LEMBERG <wl@gnu.org>
+2022-02-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (read_size): Revert previous change
- w.r.t. `\s-[-...]'.
+ Refactor X11 font description generation. Integrate it with our
+ "new" (post-2014) Automake-based build system.
- * doc/groff.texinfo (Fractional Size Types): Clarify syntax of \s.
+ * src/utils/xtotroff/Makefile.in: Delete relic of old build
+ system. Also, it had a bug: it generated X11 output device
+ 'DESC' files with a "unitwidth 10" directive even for the "-12"
+ devices, which is not correct (the in-tree DESC files we've been
+ shipping for years were nevertheless correct, apparently fixed
+ by hand by James Clark in groff 1.07 [March 1993]).
-2006-09-09 Werner LEMBERG <wl@gnu.org>
+ * src/utils/xtotroff/xtotroff.am: Define `xtotroff` variable for
+ use by X11 font description generation targets below.
- * src/roff/troff/input.cpp (read_size): Fix `\s[-\n[.s]]' so that it
- behave the same as `\s-[\n[.s]]' (this is, emit a warning and set
- point size to 1). Reported by Gunnar Ritter.
- Also catch `\s-[-...]' and friends (causing an error).
+ * font/devX100-12/devX100-12.am:
+ * font/devX100/devX100.am:
+ * font/devX75-12/devX75-12.am:
+ * font/devX75/devX75.am: Add new (phony) targets, variously
+ named "devX{100,100_12,75,75_12}", to generate the corresponding
+ output device's DESC file and run xtotroff(1) to generate its
+ font description files. Be sure to set the correct "unitwidth"
+ for the "-12" devices. Add new dependency-only rule
+ "maintainer-font-descriptions" depending on these new targets
+ for convenience (and future expansion to devps and devlj4).
-2006-09-06 Werner LEMBERG <wl@gnu.org>
+ * FOR-RELEASE: Document existence of
+ "maintainer-font-descriptions" Make target and when to run it.
- * src/roff/troff/env.cpp (environment::do_break): Insert zero-width
- space only if there is no previous space. This fixes a bug which
- caused unwanted filling of the last line in a paragraph. Thanks to
- Gunnar Ritter for an analysis.
+ Running this target with the aforementioned bug fix, overwriting
+ the in-tree DESC and font description files using data gathered
+ from a running X server, results in no changes whatsoever. Say
+ what you will about X11 core font technology--it's stable.
-2006-09-03 Werner LEMBERG <wl@gnu.org>
+2022-02-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/groff.cpp (main): Pass -U flag to pic also.
- Reported by Jennifer Sayers <jenjen@isu.usyd.edu.au>.
+ Rename and ship "FontMap-X11". xtotroff(1) is not very useful
+ without a font name mapping file to read. To date it has been
+ available only in the source distribution. Remedy that. The
+ file is placed directly in the groff font directory alongside
+ the device directories because it applies to four different
+ devices, and four copies of this data are not required.
+
+ * src/devices/xditview/FontMap: Rename to...
+ * src/devices/xditview/FontMap-X11: ...this.
+
+ * LICENSES:
+ * src/devices/xditview/xditview.am (EXTRA_DIST): Reflect rename.
-2006-09-01 Nick Stoughton <nick@msbit.com>
- Werner LEMBERG <wl@gnu.org>
+ * src/devices/xditview/xditview.am (install_xditview
+ [!WITHOUT_X11], uninstall_xtdiview): (Un-)install it.
+
+ * src/utils/xtotroff/xtotroff.1.man (Files): Add section
+ documenting the presence and purpose of this file.
+
+2022-02-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [xtotroff]: Add `-d` option to produce font description files in
+ specified directory.
+
+ * src/utils/xtotroff/xtotroff.c: Do it. Add global `destdir`
+ pointer.
+ (xtotroff_exit): Add new function to clean up storage allocated
+ by `strdup()` (below) for destination directory.
+ (MapFont): Introduce new variable `file_name`, into which we
+ assemble a destination file name from `destdir` (if not null)
+ and the troff font name. Handle memory allocation failure (by
+ carefully dying). Free allocated storage on success and failure
+ paths out of the function.
+ (usage): Document new `-d` option.
+ (main): Instruct `getopt_long` to expect a `-d` flag with an
+ argument. Use `strdup()` to make a copy of any such option
+ argument. Call `xtotroff_exit()` instead of `exit()`.
- Add a request `pev' to print environment information (similar to
- `pnr' and `ptr' to print number registers and traps).
+ * src/utils/xtotroff/xtotroff.1.man: Document new `-d` option.
- * src/roff/troff/env.h (environment): Add member function print_env.
+2022-02-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [xtotroff]: Trivially refactor.
- * src/roff/troff/env.cpp: (environment::print_env): New function to
- print a given environment state.
- (print_env): New global function to iterate through the
- environments, printing each one.
- (init_env_requests): Register `pev'.
+ * src/utils/xtotroff/xtotroff.c: Boolify. Include `stdbool.h`
+ and `errno.h` headers.
+ (charExists, CanonicalizeFontName, FontNamesAmbiguous, MapFont):
+ Boolify. Demote return type from `int` to `bool` and return
+ Boolean instead of integer literals.
+ (FontNamesAmbiguous, main): Reorder equality comparisons with
+ simple left-hand sides to avoid inadvertent lvalue assignments.
+ (FontNamesAmbiguous, MapFont): Refer to font name as "invalid",
+ not "bad", in diagnostic messages.
+ (MapFont, main): Use `strerror()` instead of `perror()` so that
+ diagnostics include the program name and an indication of
+ problem severity.
+ (MapFont): Compare `FILE` stream pointer to `NULL` instead of
+ treating it as a Boolean.
+ (main): Use `EXIT_SUCCESS` and `EXIT_FAILURE` constants from C
+ library instead of integer literals for exit status.
+
+2022-02-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [pic]: Fix "unused result" compiler warning.
+
+ * src/preproc/pic/pic.ypp (placeless_element) <SH>: Check return
+ value of `system()` to quieten `-Wunused-result` warning; if it
+ is less than zero, report it to the standard error stream.
+
+2022-02-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/safer.tmac: Drop file from distribution. It contained
+ only comments.
+ * tmac/tmac.am (TMACNORMALFILES): Delete reference.
+ * NEWS: Add item. Suggest two workarounds for its absence.
+
+ Fixes <https://savannah.gnu.org/bugs/?61831>.
+
+2022-02-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac (initialization): Drop definition of
+ `doc-curr-size` register. It is no longer needed since nothing
+ internal to the package now changes the type size.
+
+ * tmac/doc.tmac (Fl, doc-print-recursive, doc-print-prefixes)
+ (doc-generic-macro, Ar, Cd, doc-do-func-decl, Fd, In, Nm, Pa)
+ (Tn, doc-enclose-string, Ef, Bd, doc-save-global-vars)
+ (doc-restore-global-vars, doc-diag-list, Xr, Dl, Vt, Ft, Fa)
+ (doc-do-func, Fn, doc-do-func-args, Fo, Fc, %A, %B, %C, %D, %I)
+ (%J, %N, %O, %P, %Q, %R, %T, %U, %V, doc-do-reference, Hf, An)
+ Lk):
+ * tmac/mdoc/doc-common (Sh, Ss, Rd):
+ * tmac/mdoc/doc-syms (Ux, Bx, At, Dx, Fx, Nx, Ox, Bsx, St, Lb):
+ Drop interpolations of the string and comments documenting that
+ each macro has a side effect on the type size.
+
+2022-02-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/doc.tmac (Tn):
+ * tmac/mdoc/doc-syms (Ux, Bx): Stop interpolating string
+ `doc-Tn-font-size` to set macro arguments at a smaller type
+ size. This leaves the string without a purpose, so...
+
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Drop definitions of `doc-Tn-font-size`.
+
+ * tmac/mdoc/doc-syms: Drop interpolations of that string from
+ numerous other string definitions.
+
+ Fixes <https://savannah.gnu.org/bugs/?60616>.
+
+2022-02-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Revert addition of man(7) `BD` register. This feature, which I
+ introduced in commit ea3b27102f (31 January) doesn't work
+ because pdf.tmac normalizes the bookmark depth. Embedding a man
+ page in a larger PDF document with appropriately nested
+ bookmarks is a project that will have to await another day (or
+ perhaps already has tools to implement it).
+
+ * tmac/an.tmac: Do it.
+ * tmac/groff_man.7.man.in: De-document it.
+
+2022-02-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdf.tmac: Add string containing the name of the macro
+ package for use in diagnostic messages.
+ (pdf:warn, pdf:error): Use it.
+
+ Continues the long process of fixing Savannah #52463.
+
+2022-02-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man,mdoc,me]: Revise hyphenation localization.
+
+ * tmac/an.tmac (an*reset-hyphenation-mode): New macro sets the
+ hyphenation mode appropriate to the locale depending on the
+ values of `cR` (continuous rendering mode) and `HY` (hyphenation
+ enablement); the latter is now interpreted as a Boolean. Define
+ new register `an*hyphenation-mode` reflecting these conditions.
+ (TH): Call the foregoing instead of invoking `hy` request.
+ (MR): Restore hyphenation mode to `an*hyphenation-mode`.
+ (initialization): Simplify; if not defined, set `HY` to 1.
+
+ * tmac/e.tmac (ld): Set the hyphenation mode here instead of in
+ initialization (which already calls this macro). Set the mode
+ to 6 for the benefit of anyone borrowing our me(7) changes, but
+ then immediately change to the mode determined by the
+ localization file.
+
+ * tmac/mdoc/doc-common (doc-hyphen-flags): Set a hyphenation
+ mode appropriate to the locale, depending on the values of `cR`
+ and `HY`.
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff: Simplify initialization; if not defined,
+ set `HY` to 1.
+
+ * tmac/cs.tmac:
+ * tmac/de.tmac:
+ * tmac/en.tmac:
+ * tmac/fr.tmac:
+ * tmac/it.tmac:
+ * tmac/sv.tmac: Before switching locales, set a flag if
+ troublesome value 2 of the hyphenation mode is set so that we
+ can preserve it. Shift man(7) and me(7) logic to follow setup
+ of the new hyphenation mode; for the former, call the new
+ `an*reset-hyphenation-mode`.
+
+ * tmac/groff_man.7.man.in:
+ * tmac/groff_mdoc.7.man: Document updated meaning of `HY`
+ register.
- * doc/groff.texinfo (Debugging), man/groff.man, man/groff_diff.man,
- NEWS: Document `pev' request.
+ * NEWS: Add item noting change of man(7) `HY`'s meaning. Update
+ existing item regarding mdoc(7)'s support for it (groff 1.22.4
+ mdoc(7) didn't recognize the register at all).
-2006-09-01 Bernd Warken
+ Fixes <https://savannah.gnu.org/bugs/?61734> (for real this
+ time?).
- * src/preproc/soelim/soelim.cpp (usage): Fix option argument of
- `-I' to `dir'.
+2022-02-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-09-01 Werner LEMBERG <wl@gnu.org>
+ [man]: Regression-test Savannah #61734.
- * src/preproc/pic/main.cpp (usage): Add missing options.
+ * tmac/tests/an_reset-hyphenation-correctly.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2006-08-25 Werner LEMBERG <wl@gnu.org>
+2022-02-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/soelim/soelim.man: Document how to insert `\' and ` '
- in file names.
+ * man/groff_char.7.man (History): Add new section.
+ (See also): Add cross reference to 1976 edition of CSTR #54.
-2006-08-19 Werner LEMBERG <wl@gnu.org>
+2022-02-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure: Regenerated.
+ * tmac/groff_man.7.man.in (Document structure macros) <EX, EE>
+ [style]: Add material cautioning writers against asoociating
+ the disablement of filling with some sort of "literal mode".
+ Document still-operational status of inter-sentence space
+ supplementation.
+ (Notes) [style]: Describe an alternative (and macro
+ call-symmetrical) means of using `RS` and `RE` with `TP`.
-2006-08-18 Keith Marshall <keith.d.marshall@ntlworld.com>
+2022-02-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * m4/groff.m4 (GROFF_MAKEINFO): Correct `makeinfo version testing
- logic; it previously caused an `expr' syntax error, if no version of
- `makinfo' was present. Also, remove dependency on `makeinfo' in VPATH
- builds, if an up to date `groff.info' is present in either `builddir'
- or in `srcdir'.
+ * doc/doc.am: Add phony targets "man-all" and "man-clean" to
+ {re-}generate and delete all man pages, respectively.
-2006-08-12 Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
+ Arguably fixes <https://savannah.gnu.org/bugs/?61167>.
- * font/devps/prologue.ps: Add BPhook.
+2022-02-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/grops.man: Document BPHook.
- Reorder some sections for better readability.
+ * Makefile.am (.man): Prefix hyphenation control escape
+ sequences to more configuration-time interpolations to prevent
+ their hyphenation: @DEVICE@, @g@, @INDEX_SUFFIX@, @PAGE@,
+ @TMAC_{AN,M,S}_PREFIX@, @TMAC_MDIR@.
-2006-08-12 Werner LEMBERG <wl@gnu.org>
+2022-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/lib.h (getlocale): New macro.
- (setlocale, LC_ALL, LC_CTYPE) [!HAVE_SETLOCALE]: Define, as
- suggested by Bruno.
+ [man]: Refactor `EX` and `EE` macros.
- * src/preproc/preconv/preconv.cpp (main): Use getlocale.
+ * tmac/an-ext.tmac: Add new `mC` string to store the font name
+ to be used for example regions. In AT&T device-independent
+ troff, "CW" was a common name, so use that. It is however a
+ terrible fit for groff's font family and style-combination
+ functionality, and is inflexible in the face of font selection
+ requests and escape sequences within the example region. (One
+ either needs to know the names of the fonts available on the
+ output device, or suffer the indignity of mixed constant-width
+ and proportional typefaces.) Relatedly, drop groff-specific
+ font remapping requests.
+ (EX, EE): Ignore definition if GNU troff is the formatter. Drop
+ font family manipulation. Drop specialized logic for groff's
+ DVI output device.
-2006-08-11 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac (initialization): Resurrect font remapping
+ requests here.
+ (EX, EE): Add new definitions, saving and restoring more state
+ and remapping DVI output device fonts to reflect the absence of
+ CWB and CWBI faces.
- Add new flag to .cflags to enable hyphenation without looking at
- hcode values.
+2022-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/charinfo.h (charinfo): New enumeration value
- `IGNORE_HCODES'.
- New member function `ignore_hcodes'.
+ * tmac/an-ext.tmac: Slightly refactor. Stop using groff's `HY`
+ register to restore the hyphenation mode, since I plan to change
+ its semantics to a Boolean value (see Savannah #61734).
+ Introduce new register `mJ` to store "1" (if not groff) and the
+ current hyphenation mode otherwise. Explain why in a comment.
+ (YS, UE, ME, MR): Restore hyphenation mode using `mJ` instead of
+ `HY`.
- * src/roff/troff/node.cpp (break_char_node::add_self,
- node::add_char): Updated.
+2022-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo, man/groff_diff.man, NEWS: Document it.
+ * tmac/an-ext.tmac: Trivially refactor. Use a better idiom
+ {seen in James Clark's changes to BSD me(7)} for conditionally
+ defining a (simple) macro.
-2006-08-09 Werner LEMBERG <wl@gnu.org>
+2022-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- Support composite Unicode characters again. Reported by Colin.
+ * src/devices/grotty/tty.cpp (tty_printer::special): Warn upon
+ encountering unrecognized device control commands using the
+ 'tty:' tag.
- * font/devhtml/R.proto: Renamed to...
- * font/devhtml/R.in: This.
+2022-02-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devutf8/R.proto: Renamed to...
- * font/devutf8/R.in: This.
- Add `charset' line.
+ [grotty]: Remove 'sgr' device control command.
- * font/make-Rproto: New script.
- * font/devhtml/R.proto, font/devutf8/R.proto: Generated.
+ * src/devices/grotty/tty.cpp (tty_printer::special): Do it.
+ * src/devices/grotty/grotty.1.man (Device control commands):
+ {De-}document it.
+ * NEWS: Add item.
-2006-07-26 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61561>.
- * README: Fix description of CVS access. Reported by Joachim.
+2022-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-07-11 Werner LEMBERG <wl@gnu.org>
+ * tmac/pdfpic.tmac: Add support for Cygwin/MinGW temporary
+ directory conventions.
- Add a request `.fzoom' and a number register `.zoom' to magnify
- fonts.
+2022-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdfpic.tmac: Search for temporary directories as groff(1)
+ does, instead of going straight to /tmp.
+ (pdfpic@get-temporary-directory): New function checks each of
+ its arguments for validity as a temporary directory; if one is
+ found, its name is left in `pdfpic*temporary-directory`.
+ (pdfpic@cleanup): Remove strings `pdfpic*temporary-directory`
+ and `pdfpic*temporary-file`.
+ (PDFPIC): Call `pdfpic@get-temporary-directory`, using the
+ contents of the environment variables $GROFF_TMPDIR and $TMPDIR,
+ and then /tmp, in that order. Store the temporary file name in
+ string `pdfpic*temporary-file`. Use this string in subsequent
+ `sy` and `so` requests.
+
+ Fixes <https://savannah.gnu.org/bugs/?62055> for Unix systems.
+
+2022-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Add test for PDFPIC fallback to PSPIC.
+
+ * tmac/tests/pdfpic_falls_back_to_PSPIC.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Tweak PDFPIC test input.
+
+ * tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+ Eliminate unnecessary blank lines from input. Also call gs(1)
+ with '-q' in addition to '-o'. (Why does the latter not imply
+ the former?!) Thanks to Deri James for the advice.
+
+2022-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdfpic.tmac: Slightly refactor.
+ (pdfpic@cleanup, PDFPIC): Rename `pdfpic*file-name` to
+ `pdfpic*file-name-base` since it is not used as a complete file
+ name (but rather a basis for an ".eps" extension).
+ (PDFPIC): When testing PDF file extension, include the "."; a
+ file name like "mxyzptlkpdf" is too dubious to accept. Also
+ explicitly compare `systat` register as equal or not equal to
+ zero, since its truth value is inverted from the expectations of
+ *roff expressions.
+
+2022-02-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdfpic.tmac (PDFPIC): Refactor PDFPIC_NOSPACE handling.
+ Stop shelling out to create, and then sourcing, a temporary file
+ just to obtain the value of an environment variable. groff
+ already has the `\V` escape sequence for that purpose (it's even
+ safe!). Check that the value of $GROFF_PDFPIC_NOSPACE is a
+ valid numeric expression before assigning it to a register.
+ Trivially, use '=' instead of '==' as an equality operator.
+ *roff languages do not use '=' as an assignment operator, and I
+ believe the '==' synonym to be a sop to C programmers.
+
+2022-02-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Stop attempting to adjust pargraph tag lines.
+
+ * tmac/an.tmac (TP): Disable adjustment inside the diversion.
+ (an-write-paragraph-tag): Restore adjustment outside of it.
+
+ Fixes <https://savannah.gnu.org/bugs/?62051>.
+
+2022-02-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/e.tmac (@z): Conceal bare tab after request name (exposed
+ by no longer stripping the macro file). See commit ad0575f20, 9
+ December.
+
+2022-02-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grops,troff]: Migrate to term "scaling unit" in diagnostics.
+
+ * src/devices/grops/ps.cpp (ps_printer::do_import):
+ * src/roff/troff/input.cpp (warnscale_request):
+ * src/roff/troff/number.cpp (parse_term): Do it.
+
+2022-02-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [me]: Add nroff mode fallback for `u` macro.
+
+ * tmac/e.tmac (u): On nroff devices, bracket the first argument
+ with \(ul (underline rule) special character escape sequences.
+ {In plain language, '.u "like this"' renders "_like this_".}
+
+ I regard this as a cosmetic and semantic improvement; since the
+ quarter-em vertical motions used in troff mode were ignored in
+ nroff mode, the effect was not underlining but a sort of
+ strike-through, visible only at spaces in the argument. The use
+ of this macro was thus invisible in nroff output if no spaces
+ were present in the argument. This is probably the best we can
+ do without a fatter interface to terminal device capabilities.
+
+2022-02-12 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/font.h (font): Add member variable `zoom'.
- Add member functions `set_zoom' and `get_zoom'.
- Remove `static' attribute from `scale' member function.
-
- * src/libs/libgroff/font.cpp (font::font): Updated.
- (scale_round): New version with three parameters to handle zoom
- factor.
- (font::scale, font::get_width): Handle zoom factor.
- (font::set_zoom, font::get_zoom): New functions.
- (font::load): Handle `zoom' while computing `space_width'.
-
- * src/roff/troff/env.h: Declare `env_get_zoom'.
- (environment): Add member function `get_zoom'.
-
- * src/roff/troff/env.cpp (environment::get_zoom): New function.
- (init_env_requests): Initialize `.zoom' register.
-
- * src/roff/troff/node.cpp (font_info): New member functions
- `set_zoom' and `get_zoom'.
- (tfont): New member function `get_zoom'.
- (env_get_zoom): New function.
- (troff_output_file::set_font): Handle zoom factor.
- (font_zoom_request): New function.
- (init_node_requests): Initialize `fzoom' request.
-
- * docs/groff.texinfo (Changing Fonts), man/groff.man,
- man/groff_diff.man, NEWS: Document `fzoom' request and `.zoom'
+ [me]: Simulate boxed text support on nroff devices with ISO 6429
+ color escape sequences.
+
+ * tmac/e.tmac (bx): Do it. Add further fallback for non-groff
+ formatters in nroff mode, bracketing the boxed argument with '|'
+ glyphs.
+ * doc/meref.me.in: Document it.
+
+ Fixes <https://savannah.gnu.org/bugs/?62038>.
+
+2022-02-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [me]: Rename registers `$v` -> `tv`, `$V` -> `dv`.
+
+ * tmac/e.tmac: Do it. Also include much commentary (including
+ some from James Clark in 1992) attempting to illuminate the
+ confusing history (and naming) of `$[rRvV]`.
+
+ * doc/meref.me.in: Document it. Introduce new terms
+ "text vertical spacing" and "display vertical spacing" earlier
+ and use them to condense and clarify discussions of their use.
+
+ * NEWS: Add item.
+
+ Fixes <https://savannah.gnu.org/bugs/?61710>.
+
+2022-02-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Deferring Output): Add new node introducing
+ and motivating environments, diversions, and traps.
+
+2022-02-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Add more compatibility mode guards.
+
+2022-02-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/pdf.tmac: Add compatibility mode guards so that we can
+ run even if troff is given the -C option. Resurrect your
+ vintage 1975 Sixth Edition Unix manuals from '.deth' and format
+ them in PDF today!
+
+ Fixes <https://savannah.gnu.org/bugs/?61995>.
+
+2022-02-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/andoc.tmac: Prefix diagnostic with package file name
+ literally.
+
+2022-02-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Trivially refactor.
+
+ * tmac/an.tmac (an*localize): Rename to...
+ (an*localize-strings): ...this.
+ (TH): Update call site.
+
+2022-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [docs]: Present several fundamental concepts.
+
+ * doc/groff.texi (Page Geometry):
+ * man/roff.7.man (Concepts): Add new node/section.
+ - page geometry
+ - basic units
+ - device resolution
+ - drawing position
+ - text baseline
+ - page offset
+ - vertical spacing
+ - page break
+
+ Fixes the remainder of <https://savannah.gnu.org/bugs/?58035>.
+
+2022-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [me]: Add page length insufficiency check.
+
+ * tmac/e.tmac (@h): Port Keith Marshall's page length checker
+ from ms(7).
+
+ Fixes <https://savannah.gnu.org/bugs/?61034> and
+ <https://savannah.gnu.org/bugs/?61428>.
+
+2022-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [me]: Add test for insufficient page length error.
+
+ * tmac/tests/e_rejects-too-short-page-lengths.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [me]: Slightly refactor.
+
+ * tmac/e.tmac (@h): Use groff default scaling operator in
+ conditional expression. Add `do` requests so that the logic for
+ checking the line length works in compatibility mode. Also move
+ misplaced parenthesis in conditional expression.
+
+2022-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Refactor insufficient page length check.
+
+ * tmac/s.tmac (pg@top): Drop extraneous closing parenthesis from
+ numeric expression. Change operator from '>' to '>='; a page
+ length right at the boundary causes a spurious extra page break
+ when a paragraphing macro is used to initialize the document.
+ Condense diagnostic emission using the @error macro instead of
+ duplicating it. Change indentation to fit the style of the rest
+ of the file (use hard tabs). If aborting, truncate the page
+ length to the current vertical position so that we don't
+ uselessly output further vertical space.
+
+2022-02-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Add test for insufficient page length error.
+
+ * tmac/tests/s_rejects-too-short-page-lengths.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-02-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [me]: Vertically space delayed text like other annotations.
+
+ * tmac/e.tmac ((d): Set vertical spacing using percentage in
+ `$V` register.
+ ()d): Restore vertical spacing using percentage in `$v`
register.
- * src/roff/troff/TODO: Updated.
+ Fixes <https://savannah.gnu.org/bugs/?61973>.
-2006-07-10 Werner LEMBERG <wl@gnu.org>
+2022-01-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo (Drawing Requests): Improve documentation of
- \D'P ...'.
+ [build]: Expand '@PAGE@' when generating man pages.
-2006-07-02 Werner LEMBERG <wl@gnu.org>
+ * Makefile.am (.man): Substitute the './configure'd paper format
+ for @PAGE@.
+ * src/roff/groff/groff.1.man: Use it.
- * man/groff_tmac.man: Document usage of .PSPIC within diversions.
+2022-01-31 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-07-01 Werner LEMBERG <wl@gnu.org>
+ [man]: Trivially refactor an-ext.tmac.
- * tmac/pspic.tmac: Make .PSPIC work for all devices.
- Print image file name for devices which don't support PS image
- inclusion.
- Handle multiple inclusions.
- Add lots of comments.
+ * tmac/an-ext.tmac (EX, EE): Do a better job of keeping the
+ name space promise made in comments at the top of the file.
+ Rename `sP` register to `mP`. Problem introduced by me in
+ commit 69895ec20, 15 January 2020. Also rename `la` and `ra`
+ strings to `mL` and `mR`, respectively. These (undocumented)
+ string names date back to commit 259929625, 15 January 2007.
- * tmac/dvi.tmac, tmac/html.tmac, tmac/ps.tmac: Don't load
- pspic.tmac.
+ * tmac/groff_man.7.man.in (Files) <an-ext.tmac>: Document the
+ aforementioned promise.
- * tmac/troffrc: Load pspic.tmac.
+2022-01-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_tmac.man: Update .PSPIC documentation.
+ [man]: Refactor PDF bookmark support.
- * NEWS: Updated.
+ * tmac/an.tmac (an*bookmark): New internal macro calls
+ `pdfbookmark` (only if the output device is 'pdf').
+ (initialization): Migrate macro appendments to appropriate
+ definitions. Two cases...
+ (SH, SS): ...were straightforward.
+ (initialization): Another (for the man page title) was poorly
+ placed when appended to the `TH` macro, skipping over the page
+ header. Move it instead...
+ (PT): ...here. But to keep this bookmark from being generated
+ on every page of a document, we need a new variable
+ `an*was-TH-bookmark-emitted` which is tested here and assigned
+ once one bookmark corresponding to a `TH` call has been written.
+ (TH): Initialize `an*was-TH-bookmark-emitted` to zero.
+ (SS): Write the bookmark _before_ the subsection heading text.
+ (initialization): Drop short-lived `BM` register. It seems
+ harmless to unconditionally include bookmarks in PDF output. A
+ PDF tool can strip them out if they're not desired, and viewers
+ seem capable of minimizing or reducing the navigation pane (if
+ they even offer one in the first place).
+
+ * tmac/an.tmac (initialization): Rename new `BN` register to
+ `BD`...
+ * tmac/groff_man.7.man.in (Options) <BD>: ...and document it.
+ Also document `PT`'s new bookmarking responsibility.
-2006-06-29 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?58949> and
+ <https://savannah.gnu.org/bugs/?58950>.
- * src/roff/troff/input.cpp (interpolate_macro):
- s/probably/possibly/, as suggested by Keith.
+2022-01-31 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-06-28 Werner LEMBERG <wl@gnu.org>
+ [grohtml,groff,nroff,troff]: Tweak usage message.
- Add support for \D'p...' to grotty.
+ * src/devices/grohtml/post-html.cpp (usage):
+ * src/roff/groff/groff.cpp (synopsis):
+ * src/roff/nroff/nroff.sh:
+ * src/roff/troff/input.cpp (usage): Partly revert commit
+ 06ae7b0b8, 16 January. Move an ellipsis back inside a bracketed
+ operand (that is, an optional one). On reflection, I think this
+ notation makes it clearer that the command can be meaningfully
+ run without operands.
- * src/devices/grotty/grotty.cpp (tty_printer::draw): Move most of
- its code to...
- (tty_printer::line): This function.
- (tty_printer::draw): Rewritten; just call either draw_line or
- draw_polygon.
- (tty_printer::draw_line, tty_printer::draw_polygon): New functions.
+2022-01-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/papersize.tmac: Slightly refactor. Use new `stringdown`
+ request instead of a combination of `tr`, `di`, `asciify`, and
+ `chop`.
+
+2022-01-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grotty/grotty.man, NEWS: Document it.
+ [man]: Slightly refactor.
-2006-06-27 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac (an-prepare-page-title): Rename to...
+ (an*prepare-page-title): ...this. Also simplify numeric
+ expression. Add comment regarding necessity of correct
+ environment.
- * src/preproc/refer/command.h (have_bibliography): New variable
- declaration.
+ (an-header): Update call site of `an*prepare-page-title`.
- * src/preproc/refer/command.cpp (bibliography_command): Set
- `have_bibliography'.
+ (TH): Move planting of `an-header` trap from out of the midst of
+ footer trap management. Add comments.
+
+ (an-header): Move `pl` and `sp` requests from here...
+ (PT): ...to here. While it's conceptually nice to have these
+ macros consist solely of `tl` requests, it doesn't yield enough
+ power to those who want to redefine them. Add comment.
+
+ (an-footer, BT): ...simile.
+
+2022-01-27 Dave Kemper <saint.snit@gmail.com>
+
+ [man pages]: Add more references to pic(1)'s .PF.
+
+ * contrib/chem/chem.1.man:
+ * contrib/pic2graph/pic2graph.1.man:
+ * src/utils/grog/grog.1.man: Do it.
+
+ Fixes <https://savannah.gnu.org/bugs/?61949>.
+
+2022-01-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Implement PDF bookmark support for man pages. Limitation: A
+ {sub}section can only be bookmarked if it is specified in the
+ arguments to the `SH` or `SS` requests, not on the next line in
+ an input trap. Thanks to Deri James for providing the
+ fundamentals (blame me for any weird bits).
+
+ * tmac/an.tmac (an-prepare-page-title): Define a new string,
+ `an*page-ref-string`, which is the man page's own reference
+ {such as "groff(1)"} without any abbreviation, ellipsis, or font
+ selection or italic correction escape sequences.
+ (SS): Define a new string, `an*subsection-heading`, storing the
+ macro arguments (if any). These could contain font selection
+ escape sequences, for instance, a fact that becomes important
+ later.
+ (initialization):
+ - Recognize `BM` register to enable PDF bookmarks (only on the
+ 'pdf' output device); defaults on. Recognize `BN` register to
+ set a base level/depth for the bookmarks; this is to ease
+ embedding of man pages in other PDF documents that already use
+ bookmarks. The default is 0. The registers are not yet
+ documented.
+ - If the output device is 'pdf' and bookmarks are enabled, set
+ `PDFOUTLINE.FOLDLEVEL` and `PDFHREF.VIEW.LEADING` registers
+ {recognized by 'pdf.tmac'}. Append to `TH`, `SH`, `SS` to get
+ the `an*page-ref-string`, `an-section-heading`, and
+ `an*subsection-heading` bookmarks in the document at the
+ applicable levels.
+
+ * tmac/mdoc/doc-common: Add straw-man implementation--it doesn't
+ support the `BM` and `BN` configuration parameters yet. (This
+ is enough to get bookmarks for the groff_mdoc(7) page to
+ correctly appear in the new 'groff-man-pages.pdf' document.)
+ (Dt, Sh, Ss): If the output device is 'pdf', place bookmarks in
+ the document at levels 1, 2, and 3.
+
+ Fixes <https://savannah.gnu.org/bugs/?58950>.
- * src/preproc/refer/refer.cpp: Initialize `have_bibliography'.
- (output_references): Emit warning only if `have_bibliography' is
- set.
+2022-01-26 Deri James <deri@chuzzlewit.myzen.co.uk>
-2006-06-15 Michail Vidiassov <master@iaas.msu.ru>
+ [gropdf]: Allow multiline text in .pdfinfo
- * font/devps/Makefile.sub (DISTFILES): Add freeeuro.afm.
- * font/devps/generate/Makefile (clean): Don't remove symbolsl.afm
- and zapfdr.afm.
+ * src/devices/gropdf/gropdf.pl: Use either '\\\\\\\\n' or
+ '\[u000a]' as line separators in the string.
-2006-06-15 Werner LEMBERG <wl@gnu.org>
+2022-01-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/tbl.man: Document limitations of .TS/.TE within a
- macro (as suggested by Tadziu Hoffmann).
+ * tmac/trans.tmac: Further follow up commit c64fd60dff. If the
+ `andoc` wrapper is being used, perform man(7) localization (not
+ just when `an` is loaded).
-2006-06-12 Werner LEMBERG <wl@gnu.org>
+2022-01-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/tbl.man: Add example for use of .TS/.TE within a
- macro (as suggested by Tadziu Hoffmann).
+ [man pages]: Fix options used to generate compilations.
-2006-06-05 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am (doc/groff-man-pages.pdf): Drop `-rU0` option (it's
+ unnecessary since we don't yet have PDF hyperlink support in
+ this document). Add `-rC1` option to enable continuous page
+ numbering.
+ (doc/groff-man-pages.utf8.txt): Drop `-rC1 -rU1`. Continuous
+ page numbering is superfluous since page numbers are not shown
+ in continuous rendering mode. Stop turning on OSC 8 defaults;
+ we don't know if the document will be viewed with a supporting
+ pager+terminal combination, and further we don't yet have a
+ mechanism for making `MR` man page cross references internal to
+ the document when they indicate groff man pages.
- * tmac/strip.sed: Strip `\#' also.
+2022-01-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo (Operators in Conditionals): Document usage of
- \? for string comparison.
+ [man pages]: Ship compilations in UTF-8 text and PDF.
-2006-06-04 Werner LEMBERG <wl@gnu.org>
+ Localization support and the resolution of Savannah #61266 have
+ made it practical to batch-render all of groff's man pages as a
+ single giant document. Provide PDF and UTF-8 text (with ECMA-48
+ escape sequences, but not the italic attribute or OSC 8
+ sequences).
- * doc/groff.texinfo: Add more index entries for copy-in mode.
- (Changing Fonts) <.ft>: Document that a font definition file must
- not be called `DESC'.
+ Reasons for this addition include: {1} it is now possible,
+ whereas I don't believe it was in any previous groff release;
+ {2} many people still don't realize how much more pleasant
+ reading typeset man pages can be (while a subjective assessment,
+ I'm not alone[1]); {3} providing these forms permits full-text
+ searching of groff's entire man page corpus via the PDF viewer
+ or a pager like "less -R", the latter without sacrificing the
+ style variations of the text that aid the reader to comprehend
+ the material; {4} sentimentally, it honors the 50th anniversary
+ of the first Unix manual (dated 3 November 1971)
+ <https://www.bell-labs.com/usr/dmr/www/1stEdman.html>.
-2006-05-31 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am (PROCESSEDDOCFILES): Add
+ 'doc/groff-man-pages.{pdf,utf8.txt}'.
+ (GROFF_MAN_PAGES{1,2,3}): Add new macro storing names of all man
+ pages generated in the build tree. Motivate the reason for 3
+ variables in a comment (it's due to groff locale switching).
+ (GROFF_MAN_PAGES_ALL): Add convenience macro for use in
+ dependency lists required by...
+ ('doc/groff-man-pages.{pdf,utf8.txt}'): ...these targets.
+ Generate pages with the lint dial turned all the way up.
- * src/roff/troff/input.cpp (token::next) <\N>: Catch negative values
- here.
+ Fixes <https://savannah.gnu.org/bugs/?61900>.
- * doc/Makefile.sub (EXAMPLEFILES): Move gnu.eps to...
- (PROCESSEDEXAMPLEFILES): Here.
+ [1] "The manual was intended to be typeset; some detail is
+ sacrificed on terminals." (man(1), _Unix Time-Sharing System
+ Programmer's Manual_, Eighth Edition, Volume 1, February 1985)
-2006-05-30 Werner LEMBERG <wl@gnu.org>
+2022-01-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/font.cpp (font::load): Reject fonts called
- `DESC'.
- Reduce number of false positives for `.if F ...' conditionals.
- Improve warning messages.
+ [man]: Commit c64fd60dff was not quite cooked. The localized
+ strings (in English) for the manual section titles need to be
+ set at every document load (i.e., when `TH` is called), but only
+ if the groff locale is "english". When switching locales, these
+ strings were getting "stuck" in their non-English translations
+ even when returning to an English page.
-2006-05-29 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac (an*localize): New macro initializes strings.
+ (TH): Call `an*localize` if the locale is "english".
+ (initialization): Drop initialization of section title strings.
- * tmac/Makefile.sub: Add copyright notice.
- (NORMALFILES): Add man.tmac and ms.tmac.
- (SPECIALFILES): Remove man.tmac and ms.tmac.
- (CLEANADD): Remove man.tmac-sed and ms.tmac-sed.
- (install_data, uninstall_sub): Don't handle man.tmac and ms.tmac
- specially.
- (stamp-sed): Don't handle man.tmac and ms.tmac.
- Remove obsolete components in sed's regexp.
+ Continues fixing <https://savannah.gnu.org/bugs/?61734>.
- * doc/Makefile.sub (EXAMPLEFILES): Add gnu.eps.
+2022-01-24 Deri James <deri@chuzzlewit.myzen.co.uk>
- * Makefile.in (OTHERDIRS, NOMAKEDIRS): Add hdtbl.
+ [gropdf]: Fix Savannah #61908
-2006-05-28 Werner LEMBERG <wl@gnu.org>
+ * src/devices/gropdf/gropdf.pl: Adjust text position when
+ given landscape media (i.e -P-l).
- * doc/groff.texinfo (History): Correct death circumstances of Joe
- Ossanna.
+ Fixes <https://savannah.gnu.org/bugs/?61908>.
-2006-05-27 Werner LEMBERG <wl@gnu.org>
+ Thanks to KUBO Koichi for finding the problem and supplying a
+ patch.
- * tmac/an-old.tmac (an-do-tag): Simplify.
+2022-01-24 Deri James <deri@chuzzlewit.myzen.co.uk>
-2006-05-26 Werner LEMBERG <wl@gnu.org>
+ * src/devices/gropdf/gropdf.pl: A fix to importing pdf
+ versions > 1.4.
- * tmac/an-old.tmac (an-do-tag): Make margin characters work.
- (an-header, an-p-footer): Use named environment.
+2022-01-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/env.cpp (environment::copy): Copy margin character
- node.
+ [grotty]: Skip part of test if locale doesn't support UTF-8.
-2006-05-21 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
+ Skip test of 'utf8' output device if locale lacks UTF-8 support.
+ But if the 'ascii' or 'latin1' test cases have already failed,
+ report that instead.
+
+ Fixes <https://savannah.gnu.org/bugs/?61891>. Thanks to Bjarni
+ Ingi Gislason for the report.
- * tmac/trace.tmac (de1): Fix serious typo (.di -> .do) and minor
- omissions.
+2022-01-23 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
-2006-05-11 Keith Marshall <keith.d.marshall@ntlworld.com>
+ [man pages]: Fix typos.
- * src/roff/groff/groff.man: Remove superfluous word `intermediate'.
+ Fixes <https://savannah.gnu.org/bugs/?61430>.
-2006-05-10 Keith Marshall <keith.d.marshall@ntlworld.com>
+2022-01-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/groff.man: Update copyright notice.
- Improved wording to describe effect of `-Z' option.
+ [tmac]: Fix style nits in test.
-2006-05-06 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+ - Emit complaints about test environment to standard error.
+ - Replace lingering literal file name with variable expansion.
+ - Skip test if gs(1) fails, instead of reporting failure.
+ - Begin continued lines with operators, for visibility.
- * tmac/www.tmac: Decorate `.ds' with trailing `\"' where missing.
- Normalize handling of `"' in arguments.
- (PIMG): Remove debug message.
- Simplify code.
+2022-01-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-05-05 Werner LEMBERG <wl@gnu.org>
+ [grohtml]: Fix misspelled member variable.
- * src/devices/grohtml/post-html.cpp (page::add_and_encode): Don't
- swallow character immediately after `\[...]'.
- Simplify code.
+ * src/devices/grohtml/post-html.cpp (class html_printer):
+ Rename `supress_sub_sup` to `suppress_sub_sup`.
+
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [pdfpic]: Fix Savannah #58206.
+
+ * tmac/pdfpic.tmac (PDFPIC): Scrub null bytes out of pdfinfo(1)
+ output. Thanks to an anonymous contributor for the patch (the
+ commentary about it is mine, if someone wants an argument).
+
+ Fixes <https://savannah.gnu.org/bugs/?58206>.
+
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [pdfpic]: Regression-test Savannah #58206.
+
+ * tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh: Do
+ it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2006-05-02 Gaius Mulley <gaius@glam.ac.uk>
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (PIMG): Fix the HTML device specific components.
+ [pdfpic]: Refactor.
-2006-05-02 Larry Kollar <kollar@alltel.net>
+ Now that the package does not abort upon the first whiff of any
+ trouble, avoid littering groff's name spaces. Take this
+ opportunity to rename registers and strings to have obvious
+ meaning to even the casual reader.
- * tmac/www.tmac (PIMG): Really default to `-C' if the alignment
- option is missing.
+ * tmac/pdfpic.tmac: Do it.
+ (pdfpic@cleanup): New macro removes temporary strings and
+ registers.
+ (PDFPIC): Call the cleanup macro upon entry; this way, if we
+ errored out from a previous call, we avoid confusion. (We don't
+ clean up upon an error return because the leftover objects might
+ be useful for troubleshooting.) Rename registers and strings,
+ to get them under name space discipline and also to better
+ suggest their purpose.
+ - convert-pdf -> pdfpic*do-conversion
+ - pdf-offset-mode -> pdfpic*offset-mode
+ - pspic-args -> pdfpic*pspic-args
+ - pdf-offset -> pdfpic*indentation
+ - is-pdf -> pdfpic*file-extension
+ - img-file -> pdfpic*file-name
+ - pdf-wid -> pdfpic*width
+ - pdf-ht -> pdfpic*height
+ - pdf-deswid -> pdfpic*desired-width
+ - pdf-desht -> pdfpic*desired-height
+ Call cleanup macro before returning upon successful operation.
-2006-04-30 Michail Vidiassov <master@iaas.msu.ru>
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit/afmtodit.pl: New option `-c' to add font
- information as a comment in output.
- * src/utils/afmtodit/afmtodit.man, NEWS: Document it.
+ [pdfpic]: Improve robustness.
-2006-04-26 Werner LEMBERG <wl@gnu.org>
+ * tmac/pdfpic.tmac (@abort): Rename to `pdfpic@error`. This is
+ an auxiliary package, and something else could very well step on
+ the former name (or worse, we break it if we're loaded later).
+ (pdfpic@error): Stop aborting; simply report an error. It's up
+ to the user how serious `PDFPIC` macro problems are. As noted
+ in a comment, the user can easily `am pdfpic@error` to tack an
+ `ab` request onto the end of its definition. Always report
+ input file name and line number. Replace "[PDFPIC]" prefix with
+ the name of the macro file complaining, to make it easier for
+ groff non-experts to find.
+ (PDFPIC): Return upon errors. Recast diagnostic messages. Stop
+ implying that we perform any sort of probing test of file type
+ {there's no telling what pdfinfo(1) will say}. Apply new
+ 'stringdown' request so that we accept '.pdf' file name
+ extension in any lettercase. Test file argument for existence
+ before proceeding (acknowledge TOCTTOU exposure). Skip file if
+ pipeline returned a non-zero exit status or the registers into
+ which we extract the height and width are undefined (indicating
+ failure of a temporary file to be created or read). Reject
+ files with non-positive image width or height reported by
+ pdfinfo. Validate `width` and `height` arguments, if given,
+ rejecting non-positive values.
+
+ Fixes <https://savannah.gnu.org/bugs/?61892>.
- * src/devices/grohtml/post-html.cpp (html_printer::~html_printer):
- Handle current_paragraph only if it is non-NULL.
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/input.cpp (parse_x_command <'F'>, do_file
- <'F'>): Use `get_extended_arg' to behave as documented. Reported by
- Bill Ward <william.a.ward.jr@erdc.usace.army.mil>.
+ [mdoc]: Make `Pa` macro interpolate basic Latin tilde on all
+ output devices.
+
+ * tmac/doc.tmac (Pa): Do it.
+
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Fix incorrect line numbers in diagnostics. Line numbers
+ for multiple format-time diagnostics emitted by tbl(1)-generated
+ groff input were off by +5 lines.
+
+ * src/preproc/tbl/table.cpp: Fix it.
+ (NOP_NAME): Add new preprocessor symbol to construct name of
+ "nop" macro to be used as end macro for `ig` requests inside
+ macro definitions.
+ (table::init_output, table::compute_expand_list,
+ table::compute_separation_factor):
+ - Move `entry_list->set_location()` calls to more auspicious
+ locations.
+ - Replace "around line X" language in diagnostic messages with a
+ more idiomatic, and less embarrassing, simple report of an
+ integer.
+ (table::init_output):
+ - Add `entry_list->set_location()` call right before emitting
+ diagnostic about a table row not fitting on a page.
+ - Turn off eqn(1) delimiters when emitting diagnostic about a
+ boxed table not fitting on a page (necessitating `.TS H`
+ support), using new NOP_NAME-based end macro to achieve this
+ inside a macro definition.
+ (table::compute_expand_list): Suppress issue of too-wide table
+ diagnostic when the `EXPAND` table flag is set (corresponding to
+ the `expand` region option), because other code already emits
+ diagnostics in this case.
+
+ Fixes <https://savannah.gnu.org/bugs/?60598>. Problem appears
+ to date back to commit 3bc4a53a45, 2013-01-07.
+
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Add unit test for format-time diagnostics.
+
+ Ensure that the various format-time diagnostics that a
+ tbl-preprocessed document can generate (1) occur when they are
+ supposed to and (2) are appropriately suppressed by the
+ "nowarn" and/or "nokeep" region options. One of them is an
+ error and cannot be suppressed by the former, but _can_ be by
+ "nokeep", which is arguably a bug (Savannah #61878).
+
+ * src/preproc/tbl/tests/format-time-diagnostics-work.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TEST): Run test.
+
+2022-01-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Trivially refactor.
+
+ * src/preproc/tbl/table.cpp (table::compute_expand_width):
+ Declare and initialize variables closer to use. Also, the width
+ computed is compared to the line length and indentation, so use
+ these well-established *roff terms in the diagnostic message.
+
+2022-01-20 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tbl]: Fix Savannah #61854.
+
+ * src/preproc/tbl/table.cpp (compute_expand_width): To properly
+ warn if a table is too wide to fit between the indentation and
+ the right margin, we need to compute its column widths including
+ those eligible for expansion via the 'x' column modifier; we
+ cannot use the same expression that we do to determine the
+ amount of space we have to distribute among the expanded
+ columns. Iterate through columns again (the function was
+ already doing so twice), once to potentially produce the
+ warning, and then as before to distribute any available width.
+ In other words, warnings were only being emitted for too-wide
+ tables where one or more columns used the 'x' modifier.
+
+ Fixes <https://savannah.gnu.org/bugs/?61854>.
+
+2022-01-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [ms]: Don't add leaders that don't lead anywhere.
+
+ * tmac/s.tmac (toc*end-entry): If no page number string
+ `toc*num` is defined, don't interpolate its emptiness prefixed
+ with a leader (and tab). This makes "no" as the first argument
+ to `XS` and `XA` work as documented, suppressing not only the
+ page number but the leader after the entry.
+ Fixes <https://savannah.gnu.org/bugs/?61853>.
- Surround the (pseudo) file name for the .pso request with `<' and
- `>'.
+2022-01-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/node.cpp (real_output_file, troff_output_file): Add
- second parameter to `really_put_filename' and `put_filename'.
- (troff_output_file::really_put_filename): Emit `<' and `>' around
- filename if second argument is set.
- * src/roff/troff/node.h: Updated.
+ [ms]: Add regression test for Savannah #61853.
- * src/roff/troff/input.cpp (file_iterator::file_iterator,
- file_iterator::set_location): Update to changes in node.cpp.
+ * tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh: Do
+ it.
+ * tmac/tmac.am (tmac_TESTS): Run it.
-2006-04-25 Tetsurou Okazaki <okazaki@FreeBSD.org>
+2022-01-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/preconv/preconv.cpp (do_file): Fix conditional
- preprocessor expression (I18N -> HAVE_ICONV).
- (main): Fix handling of option `-h'.
- Fix conditional preprocessor expression.
+ [me]: Fix bad unit test.
-2006-04-04 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/e_chapter-titles-work.sh: Fix missing shell test at
+ end of script, which caused it to exit successfully regardless
+ of any test failures. Irritating. This is among the fruits of
+ the "never, ever use 'set -e'" tree. (This religion has a thick
+ bible: <https://mywiki.wooledge.org/BashFAQ/105>.) Fortunately,
+ all the tests pass legitimately.
+
+2022-01-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [font]: For 'ascii' and 'latin1' devices, consistently define
+ glyphs for ordinary characters before their special character
+ aliases. This parallels existing usage for the 'cp1047' device,
+ and, I think, makes the file contents slightly more accessible.
+
+ * font/devascii/R.proto:
+ * font/devlatin1/R.proto: Do it.
+
+2022-01-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Update diagnostic messages.
- Implement new number register `.br' which is set to 1 if a macro has
- been called as .foo and to 0 if called as 'bar. This is useful for
- -mtrace so that requests can be reliably traced too.
+ * src/devices/grohtml/post-html.cpp (assert_state::add)
+ (assert_state::compare, replace_negate_str)
+ (assert_state::check_value_error, make_val): Make format of
+ internal assertion system messages shorter and more mutually
+ parallel.
+ (html_printer::set_char, html_printer::set_numbered_char)
+ (html_printer::set_char_and_width): Parallelize diagnostic
+ messages with libdriver; see yesterday's commit.
+ (main): Put information in argument to `assert()`; see commit
+ 11b43053, 24 November.
- * src/roff/troff/input.cpp (input_iterator): Add virtual function
- `get_break_flag'.
- (macro_iterator): Add `with_break' member and `get_break_flag'
- function.
- Update constructors.
- (input_stack): Add function `get_break_flag'.
- (break_flag_reg): New number register class.
- (input_init_requests): Register `.br'.
+2022-01-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/TODO: Updated.
+ [nroff]: Emit usage message on usage errors.
- * tmac/trace.tmac: s/!!sp/!!!sp/.
- Modify definitions of `de', `de1', `am', and `am1' to use \n[.br].
+ * src/roff/nroff/nroff.sh: Store the usage message in a shell
+ variable instead of a here document, and sling it to the
+ standard output or standard error streams, as appropriate.
- * docs/groff.texinfo (Requests), man/groff.man, man/groff_diff.man,
- NEWS: Document it.
+2022-01-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-29 Werner LEMBERG <wl@gnu.org>
+ [grohtml,groff,nroff,troff]: Tweak usage message.
- * src/devices/grops/ps.cpp: s/must not/should not/ in warning
- messages where appropriate.
+ * src/devices/grohtml/post-html.cpp (usage):
+ * src/roff/groff/groff.cpp (synopsis):
+ * src/roff/nroff/nroff.sh:
+ * src/roff/troff/input.cpp (usage): Stop putting an ellipsis
+ inside a bracket expression (for file arguments); that suggests
+ misleading complexity.
-2006-03-28 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grohtml/post-html.cpp (usage): Also don't set
+ metasyntactic variable names in screaming capitals when they are
+ separated from option letters by space and thus can't be
+ confused with them.
- * configure.ac: Call AC_PROG_EGREP.
- * configure: Regenerated.
+2022-01-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in (EGREP): New variable.
- (MDEFINES): Add $(EGREP).
+ [libdriver]: Update diagnostic messages.
- * src/roff/grog/grog.sh: Treat .TH between .TS and .TE properly
- (bug reported by Robert Goulding <Goulding.2@nd.edu>).
- Use @EGREP@.
+ * src/libs/libdriver/printer.cpp (printer::find_font): Describe
+ the problem encountered instead of saying lamely "sorry, I can't
+ continue".
+ (printer::set_char_and_width, printer::set_numbered_char):
+ Characterize input as "invalid", not "bad"; see commit bb7512b5,
+ 17 September. When referring to font mounting position, say so.
+ (printer::set_char_and_width): Describe required input character
+ as "ordinary", not "ascii". Apart from the incorrect casing,
+ doing so better aligns with our terminology in groff_char(7),
+ groff_out(5), our Texinfo manual, and other diagnostic messages;
+ moreover, the use of "ascii" is potentially confusing to those
+ whose environments use another encoding, like UTF-8 or IBM code
+ page 1047.
- * src/roff/grog/Makefile.sub (grog, grog.old): Use $(EGREP).
+ Fixes <https://savannah.gnu.org/bugs/?61829>.
-2006-03-27 Werner LEMBERG <wl@gnu.org>
+2022-01-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add two requests `.device' and `.devicem' which are equivalent to
- `\X' and `\Y', respectively.
+ [grotty]: Check basic Latin ("ASCII") glyph mappings.
- * src/roff/troff/input.cpp (device_request, device_macro_request):
- New functions.
- (init_input_requests): Register them.
+ * src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
+ Do it.
+ * src/devices/grotty/grotty.am (grotty_TESTS): Run test.
- * doc/groff.texinfo (Postprocessor Access), man/groff_diff.man,
- man/groff.man, NEWS: Document them.
+2022-01-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-27 Gaius Mulley <gaius@glam.ac.uk>
+ [font,tmac]: Simplify Unicode character mapping process.
- * src/roff/troff/input.cpp (encode_char): Emit special characters
- for -Thtml as `\[...]'.
- * src/devices/grohtml/post-html.cpp (page::add_and_encode): Updated.
+ * tmac/unicode.tmac: Drop. It was originally added in 2005 to
+ suppress horizontal spacing of glyphs in the range U+0483..9.
+ Its purpose has wandered over the years; most recently to map
+ the Basic Latin ("ASCII") hyphen-minus, apostrophe, and grave
+ accent to special characters (and thus ultimately to the General
+ Punctuation block). But this is unnecessary since the font
+ descriptions for devices with the `unicode` property can provide
+ this information, and anyone who wants to alter the mappings can
+ change either font description files, output device macro files,
+ or troffrc; or add `char` requests to their macro packages or
+ documents (in decreasing magnitude of ambition).
- * doc/groff.texinfo (Postprocessor Access) <\X>: Updated.
+ * tmac/html.tmac:
+ * tmac/tty.tmac: Stop sourcing unicode.tmac.
-2006-03-27 Werner LEMBERG <wl@gnu.org>
+ * tmac/tmac.am (TMACNORMALFILES): Stop shipping it.
- * tmac/Makefile.sub (NORMALFILES, SPECIALFILES): Add various missing
- files.
+ * font/devutf8/NOTES: Drop remarks about mapping of \[a~],
+ \[a^], and Basic Latin circumflex accent and tilde. Not only do
+ I disagree with the reasoning (whether these glyphs are "too
+ small" depends on the font used by the terminal emulator, over
+ which we have no control), but this mapping happens in a
+ completely different part of the source tree,
+ src/libs/libgroff/glyphuni.cpp.
-2006-03-26 Werner LEMBERG <wl@gnu.org>
+ * font/devhtml/R.proto:
+ * font/devutf8/R.proto: Add mappings for the five Basic Latin
+ characters that map surprisingly (see groff_char(7)) and are not
+ syntactically significant to troff. Three of these are ported
+ from unicode.tmac.
+ (html): Don't migrate the hyphen-minus--yet.
- * doc/groff.texinfo (Writing Macros): More documentation on
- end-of-macro symbol of `.de'.
- (Diversions): Minor addition to `.di' description.
+2022-01-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/grops.man: Some clarifications regarding
- insertion of PostScript snippets.
+ * tmac/tty-char.tmac: Drop redundant logic. We don't need to
+ source the `cp1047` or `latin1` files here; `troffrc` will
+ already have loaded `tty` for us, which loads whichever applies.
-2006-03-25 Michail Vidiassov <master@iaas.msu.ru>
+2022-01-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add rules to generate `symbolsl.afm'.
+ * doc/doc.am: Separate concerns better; stop re-generating plain
+ text and HTML documents when the 'doc' target is updated; these
+ are already handled by the 'build_infodoc' target.
+ (build_infodoc): Use existing phony targets for plain text and
+ HTML output files instead of repeating filename literals.
+ (doc_all): Remove those same two phony targets from this one's
+ dependencies.
- * font/devps/generate/zapfdr.sed,
- font/devps/generate/symbolsl.awk: New files.
+2022-01-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/generate/Makefile (symbolfont, PRINTAFM): New
- variables.
- (SS, clean): Updated.
- (freeeuro.afm): Use $(srcdir).
- (symbolsl.afm): New rule.
- (zapfdr.afm): Use zapfdr.sed.
+ * src/roff/troff/input.cpp: Rename `eoi_macro_name` to
+ `end_of_input_macro_name`. It's long, yes, but better parallels
+ `blank_line_macro_name` and `leading_spaces_macro_name`. It is
+ not used in lengthy expressions and furthermore clarifies the
+ meaning of the nearby function name `eoi_macro` in one use.
-2006-03-22 Dwight Aplevich <aplevich@uwaterloo.ca>
+2022-01-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/pic.y (expr <INT>): Fix code.
+ * src/preproc/preconv/preconv.1.man (Limitations): Add
+ subsection.
-2006-03-22 Jörgen Grahn <jgrahn@algonet.se>
+ Fixes <https://savannah.gnu.org/bugs/?55035>.
- * tmac/sv.tmac: Add missing translations and activate support for
- other macro packages.
+2022-01-11 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-21 Francis GUDIN <fgudin@nerim.net>
+ [docs]: Be more careful with control characters when they are
+ word-initial in filled text lines. The idea is to prevent
+ baffling surprises if a sentence is recast in a text editor, and
+ a word beginning with a dot or neutral apostrophe is reflowed
+ onto the beginning of the next input line--suddenly it is parsed
+ as a control character. Based on a patch by Bjarni Ingi
+ Gislason.
- * tmac/doc-syms (Dx): New macro to identify DragonFly.
- (doc-str-St--ieee1275-94, doc-str-St--isoC-amd1,
- doc-str-St--isoC-tcor1, doc-str-St--isoC-tcor2): New standard
- strings.
- (doc-operating-system-FreeBSD-5.5, doc-operating-system-FreeBSD-7.0,
- doc-operating-system-NetBSD-1.6.3, doc-operating-system-NetBSD-4.0
- doc-operating-system-DragonFly-*): New operating system strings.
+ * contrib/hdtbl/groff_hdtbl.7.man:
+ * doc/automake.mom:
+ * doc/meintro.me.in:
+ * doc/meintro_fr.me.in:
+ * doc/pic.ms:
+ * doc/webpage.ms:
+ * src/devices/gropdf/gropdf.1.man: Do it.
- * tmac/groff_mdoc.man, NEWS: Document `Dx'.
+ Fixes <https://savannah.gnu.org/bugs/?51312>.
-2006-03-21 Werner LEMBERG <wl@gnu.org>
+2022-01-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/pic.y (object_spec THEN): For compatibility with
- both DWB pic and dpic, make
+ * doc/groff.texi (Font Description File Format):
+ * man/groff_font.5.man (Font description file format): Document
+ restriction of kerning adjustment to glyph pairs from within a
+ single font (since that is the scope of the font description).
- right;
- line then down;
+ Fixes <https://savannah.gnu.org/bugs/?44715>.
- equal to
+2022-01-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- right;
- line right then down;
+ * contrib/groff_filenames/groff_filenames.5.man: Remove
+ superfluous paragraphing macro.
- instead of
+ Fixes <https://savannah.gnu.org/bugs/?55084>. Thanks to Bjarni
+ Ingi Gislason for the report and a suggested patch.
- right;
- line 0 then down;
+2022-01-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/pic.ms: Document this.
+ * doc/groff.texi (Operators in Conditionals): Update explanation
+ of output-comparison conditional operator.
-2006-03-20 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?60836>.
- * doc/pic.ms: With permission of Eric Raymond, put it under the
- GPL.
+2022-01-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Updated.
+ [build]: Use pnmtops(1)'s -quiet option if possible, to quieten
+ build.
-2006-03-19 Werner LEMBERG <wl@gnu.org>
+ * m4/groff.m4 (GROFF_PNMTOOLS_CAN_BE_QUIET): Add new macro to
+ test pnmtops for support for (undocumented) '-quiet' option.
- * src/preproc/pic/pic.y (expr <INT>): Really return integer part.
+ * configure.ac: Perform the check.
- * src/preproc/pic/objects.cpp (object_spec::make_line): Handle `at'
- attribute in combination with `with'. Bug reported by Jennifer
- Sayers <jenjen@mail.usyd.edu.au>.
+ * doc/doc.am: Alter check of shell variable `pnmtops_nosetpage`
+ {processed by AC_SUBST} to correctly match even if pnmtops
+ accepts the '-quiet' option.
-2006-03-19 Miklos Somogyi <msom@netspace.net.au>
+2022-01-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo (Manipulating Spacing): Improve documentation of
- `.sp'.
+ [tmac]: Manage hyphenation mode more carefully in localization
+ packages.
-2006-03-18 Werner LEMBERG <wl@gnu.org>
+ * tmac/{cs,de,it,sv}.tmac: Localize the man(7) package's HY
+ register.
- * LICENSE: Renamed to...
- * LICENSES: This. Collect all licensing information in this file.
- * tmac/README, src/libs/snprintf/README: Removed.
+ * tmac/{cs,de,fr,it,sv}.tmac: When localizing the ms(7) package,
+ use mode "2" instead of "3": the 'hy' request complains of
+ contradictory hyphenation modes if "3" is used (the semantics of
+ the hyphenation mode are complex and non-orthogonal; see
+ groff(7) or our Texinfo manual).
+
+ * tmac/{cs,de,en,fr,it,sv}.tmac: If the one language-independent
+ hyphenation bit (don't hyphenate just prior to a page location
+ trap) is set, preserve it; this way a system's troffrc or a
+ macro package can set it and it will not get turned off by the
+ localization package, which for best results should be loaded
+ after any full-service package (and any auxiliary package
+ requiring localized strings, though none are yet distributed
+ with groff).
+
+2022-01-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/grops.man: Add section how to install fonts.
+ [tmac]: Add unit test for localization macro files. Right now
+ this just covers the hyphenation mode.
- * src/utils/xtotroff/xtotroff.c: Add GPL.
+ * tmac/tests/localization-works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-01-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [indxbib]: Document --version in usage message.
+
+ * src/utils/indxbib/indxbib.cpp (usage): Document --version
+ option. Use more informative metasyntactic variable names.
+ Organize usage message consistently with our others, and stop
+ wrapping the output lines: we know neither the width of the
+ terminal nor the length of the `program_name` string we're
+ interpolating. See commit b4de44f0, 19 July 2021.
+
+2022-01-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libbib]: Refactor index header checking.
-2006-03-17 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libbib/index.cpp: Move more header validity checks...
+ (index_search_item::load): ...from here...
- * Makefile.comm (.y.cpp): Fix #line arguments in output.
+ (index_search_item::check_header): ...to here. Test all size
+ values in header for negative values (never valid) before
+ proceeding. (These data could be changed to unsigned integer
+ types in the file format, but that would require bumping the
+ file version. That in turn would make indexes generated with
+ groff 1.23 unusable on systems running older groffs and, perhaps
+ worse, would make groff 1.23 reject index files produced by
+ older groffs. On the other hand, the regeneration of index
+ files should be, for those who use them, a common activity, and
+ as long as the original database files are kept intact, it seems
+ likely that most people, given modern machines, won't even
+ notice a slowdown in document generation when refer(1) and
+ friends fail to open the indices and fall back to full-text
+ searches of the originals. So we could still consider revising
+ the file format before the groff 1.23 release.)
+
+ * src/libs/libbib/index.cpp (index_search_item::load):
+ Explicitly perform widening conversion from signed `off_t` value
+ {from a stat(2) buffer} to an unsigned integer; quietens
+ compiler warning about comparison between integers differing in
+ signedness.
+
+2022-01-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * configure.ac (AC_CHECK_HEADERS): Expect stdbool.h, since we
+ now use it in src/include/lib.h.
+
+2022-01-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-13 Werner LEMBERG <wl@gnu.org>
+ [libbib, libgroff, indxbib]: Slightly refactor.
- * src/preproc/tbl/tbl.man: Mention default length of text blocks.
+ Also, it's silly to test even numbers > 2 for primality. Stop.
- * tmac/doc-common (Os): Add more Darwin versions.
- * tmac/groff_mdoc.man: Document them.
+ * src/include/lib.h: Include `stdbool.h` since this header file
+ is used for both C and C++ code.
- * doc/groff.texinfo (Operators in Conditionals): Mention that `c'
- works with \N'...' also.
- * man/groff_diff.man: Ditto. Remove use of future tense where
- possible.
+ * src/include/lib.h (is_prime):
+ * src/libs/libgroff/prime.cpp (is_prime): Boolify. Return
+ Boolean instead of integer literals and demote return type to
+ `bool`. Include `assert.h` and add assertion to reject
+ mathematically offensive input.
+
+ * src/libs/libbib/index.cpp
+ (index_search_item::read_common_words_file): Test only odd
+ numbers for primality.
+ * src/utils/indxbib/indxbib.cpp (main): Same. Since the number
+ comes from user input, make it (a potential hash table size) odd
+ first.
+
+2022-01-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Internationalize and localize.
+
+ * tmac/an.tmac (TH): Indirect predefined manual section titles
+ through new strings `an*section[1-9]` so that they can be
+ localized.
+ (initialization): Give these strings English defaults.
+ (TH): Move `ss` request from here...
+
+ * tmac/en.tmac: ...to here. It's not the man(7) package's
+ business what the inter-word and inter-sentence spacing values
+ are. Also, having the correct[disputed] inter-sentence spacing
+ value for English in its localization file restores it for the
+ benefit of multi-lingual documents (mainly roff applications
+ other than man(7)).
+
+ * tmac/{cs,de,fr,it,sv}.tmac: Supply translations for the manual
+ section titles; these were done by a monoglot American employing
+ Google Translate, so those scandalized or running into howlingly
+ wrong locutions are warmly invited to submit corrections.
+
+ * tmac/trans.tmac: Load localized strings.
-2006-03-12 Michail Vidiassov <master@iaas.msu.ru>
+ Fixes <https://savannah.gnu.org/bugs/?61734>.
- * font/devps/generate/make-zapfdr, font/devps/symbolsl.ps,
- font/devps/zapfdr.ps: Add `%%EndComments' line.
+2022-01-04 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-10 Larry Kollar <kollar@alltel.net>
+ * src/utils/grog/grog.pl: Handle auxiliary macro package
+ arguments correctly.
+ (process_arguments): Don't append the argument to the '-m'
+ option to the command line; requested macro packages have
+ dedicated logic.
+ (construct_command): When iterating through requested package
+ list, assume each element is an auxiliary package unless it
+ matches an element in the list of main packages. If the
+ assumption holds, append the package name to a new list,
+ `auxiliary_package_argument` (prefixed with '-m'). Push this
+ list onto the command line after any main package.
- * doc/groff.texinfo (Headers and footers): Document PT, HD, and BT.
+ Also rename `$selected_main_package` to `$main_package` for
+ brevity, and drop unused global lists `m` and
+ `supplemental_package`.
-2006-03-10 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61758>.
- * src/devices/grops/ps.cpp (ps_printer::do_exec, ps_printer::do_def,
- ps_printer::do_mdef): Overlong lines now cause a warning message,
- not an error.
+2022-01-04 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-09 Werner LEMBERG <wl@gnu.org>
+ * src/utils/grog/tests/smoke-test.sh: Add test cases for user
+ specification of auxiliary macro packages.
- * font/devps/generate/make-zapfdr: New script for generating
- `zapfdr.ps'.
+2022-01-03 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-08 Werner LEMBERG <wl@gnu.org>
+ [me]: Drop unnecessary code. Apart from being superfluous, it
+ prevented a user-defined value of the `sx` register from being
+ applied to the first footnote marker interpolated, a subtlety
+ that escaped my notice because the first footnotes in our
+ "meref" and "meintro" documents are not numeric, but symbolic,
+ and their markers occurred on lines with vertical space above
+ and below. (The bug was further masked by an otherwise
+ redundant redefinition of the `*` string inside the `)f` macro.)
- * doc/groff.css (pre): Fix `background-color' value.
+ * tmac/e.tmac ()f, +c): Stop redefining footnote marker string
+ `*` after updating the automatic footnote number; its
+ interpolation is already backslash-protected.
+ ()d, pd): Stop redefining delayed text marker string `#` for an
+ analogous reason.
+ (initialization): Drop unneeded `_*` and `_#` strings.
-2006-03-04 Larry Kollar <kollar@alltel.net>
+ Thanks to Robert Goulding for his feedback and patience. See
+ <https://savannah.gnu.org/bugs/?61025>.
- * tmac/groff_ms.man: Document PT, HD, and BT.
+2022-01-03 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-04 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/e_footnote-marks-work.sh: Enhance test. Confirm
+ that the automatic footnote number is reset to 1 by starting a
+ new chapter with the `+c` macro.
- * src/roff/troff/node.cpp (make_glyph_node): Improve warning message
- for single-letter glyph names.
+2022-01-02 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-03-02 Werner LEMBERG <wl@gnu.org>
+ [me]: Revise `n1` and `n2` interface and behavior.
- * tmac/sv.tmac: New file; currently holding only the Swedish strings
- for -mm.
- * tmac/hyphen.sv: New hyphenation pattern file for Swedish, taken
- from CTAN.
- * tmac/README: Updated.
+ There were several bugs in the previous implementation.
-2006-02-27 Werner LEMBERG <wl@gnu.org>
+ * tmac/e.tmac (po): Issue diagnostic if an attempt is made to
+ set the page offset to a negative value.
- * tmac/trans.tmac (Liec, Letdate, Letns!14): Add it (for -mm).
- * tmac/fr.tmac: Add French translations.
+ (n1): Accept new optional "C" argument to behave more (but not
+ exactly) like roff(1), as the formerly-recognized "c" argument
+ to `n2` did. If present, the line length is reduced by the same
+ amount (in new interface register `no`) as the line number field
+ to preserve the overall line length. Save the previous line
+ length in internal register `_l` and set a flag, stored in `?N`,
+ indicating this reduction. Otherwise, the macro expects to be
+ able to reduce the page offset to accommodate the line number.
+ If it cannot (for example, with the zero page offset default
+ used by nroff output devices), see above re: the `po` macro.
- * tmac/composite.tmac: Add entry for `:'.
+ (n2): Cache the last line number that may have been output,
+ instead of the current one, so that we can operate on it
+ consistently with user expectations. Do this earlier, and
+ rename this macro-local variable from `_ln` to `_n` so that we
+ don't need groff's `do` request to operate on it. Drop
+ recognition of "c" as an optional second argument. If turning
+ off line numbering: if the line length was shortened (`?N`)
+ restore the saved value and delete `_l` register; otherwise,
+ reverse the change to the page offset. Delete `_n` register.
-2006-02-26 Werner LEMBERG <wl@gnu.org>
+ (initialization): Assign `\w'0000'u` to `no` register; this was
+ previously hard-coded in `n1` and `n2`. Initialize `?N` with 0.
- * doc/Makefile.sub (HTMLEXAMPLEFILESALL): New variable.
- (CLEANADD): Use it.
- (install_html, uninstall_sub): Updated.
+ * doc/meref.me.in (roff Support): Update to reflect interface
+ changes and describe behavior more accurately.
-2006-02-26 Bruno Haible <bruno@clisp.org>
+ * doc/meref.me.in (Summary):
+ * tmac/groff_me.7.in (Registers): Document new `no` register and
+ mark it as a groff extension.
- Introduce Unicode fonts.
+ * NEWS: Add item documenting interface changes.
- * font/devhtml/DESC.proto: Mark as unicode.
- * font/devhtml/R.proto: Remove all charset entries that are already
- in glyphuni.cpp.
- * font/devutf8/DESC.proto: Mark as unicode.
- * font/devutf8/R.proto: Remove all charset entries.
- * src/include/font.h (font): New static field `is_unicode'.
- Change order of fields.
- * src/libs/libgroff/font.cpp: Include unicode.h.
- (font::font): Update for changed order of fields.
- (font::contains, font::get_width, font::get_height, font::get_depth,
- font::get_italic_correction, font::get_left_italic_correction,
- font::get_subscript_correction, font::get_character_type,
- font::get_code, font::get_special_device_encoding): Handle both the
- explicitly enumerated glyphs and use general code for Unicode fonts.
- (font::load): Make the charset section optional when the font is
- declared unicode.
- (font::load_desc): Recognize the `unicode' attribute.
- * src/libs/libgroff/fontfile.cpp (font::is_unicode): New variable.
+ Fixes <https://savannah.gnu.org/bugs/?61646>. See the comments
+ in the report for a lengthy enumeration of rendering problems
+ exhibited by the previous implementation.
-2006-02-26 Claudio Fontana <claudio@gnu.org>
+2022-01-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in: Add comment about DESTDIR.
+ [me]: Add unit test for line numbering feature.
- * Makefile.sub: Add DESTDIR to install and uninstall targets
- to support staged installations.
- * Makefile.comm: Likewise.
- * doc/Makefile.sub: Likewise.
- * contrib/eqn2graph/Makefile.sub: Likewise.
- * contrib/grap2graph/Makefile.sub: Likewise.
- * contrib/pic2graph/Makefile.sub: Likewise.
- * src/devices/xditview/Makefile.sub: Likewise.
- * src/preproc/eqn/Makefile.sub: Likewise.
- * src/roff/grog/Makefile.sub: Likewise.
- * src/roff/nroff/Makefile.sub: Likewise.
- * src/utils/afmtodit/Makefile.sub: Likewise.
- * src/utils/indxbib/Makefile.sub: Likewise.
- * tmac/Makefile.sub: Likewise.
+ * tmac/tests/e_line-numbering-works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2006-02-24 Werner LEMBERG <wl@gnu.org>
+2021-12-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list): Use entry
- for \-.
- Remove commented out entries for \' and \` (there are no such glyph
- names).
+ * src/devices/grohtml/post-html.cpp (style::style): Add
+ initializer to argumentless constructor to avoid later read from
+ uninitialized memory in `html_printer::do_font`.
- * src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Remove
- commented out entries for \' and \`.
+ Fixes <https://savannah.gnu.org/bugs/?61748>.
+2021-12-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * */*: s/legal/valid/ where appropriate.
+ [groff]: Add regression test for Savannah #61748.
-2006-06-23 Werner LEMBERG <wl@gnu.org>
+ * src/roff/groff/tests/html_works_with_grn_and_eqn.sh: Do it.
+ * src/roff/groff/groff.am (groff_TESTS): Run it.
- * font/devhtml/R.proto, font/devutf8/R.proto: Remove incorrect \'
- and \` entries.
+2021-12-31 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-02-22 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grohtml/post-html.cpp
+ (html_printer::do_file_components): Emit fatal diagnostic if
+ we're unable to `freopen()` standard output. Quietens
+ `-Wunused-result` warning from GCC 8.3.
- Remove all remaining traces from the `shc' glyph.
+2021-12-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list),
- src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Remove
- entry for `shc'.
+ * src/devices/grohtml/html.h (INT_HEXDIGITS): Add new constant
+ to store the maximum possible quantity of digits in the
+ hexadecimal representation of an `int`.
- * font/devlatin1/R.proto, font/devcp1046/R.proto: Replace `shc'
- entry with unnamed glyph.
+ * src/devices/grohtml/html-text.cpp (html_text::issue_tag):
+ * src/devices/grohtml/post-html.cpp (html_printer::do_body):
+ Guard against format string overflow by large integers in RGB
+ color channel specifications; in a *printf format string, the
+ precision (like the field width) is a _minimum_. Quietens
+ `-Wformat-overflow` warnings from GCC 8.3.
- * tmac/html/tmac: Remove `shc' entry from call to `.cflags'.
+2021-12-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/preconv/preconv.cpp (unicode_entity): Handle U+00AD
- specially.
+ * src/preproc/html/pre-html.cpp (get_image_generator): Clarify
+ complex conditional expression. Quietens `-Wparentheses`
+ warning from GCC 8.3.
-2006-02-22 Bruno Haible <bruno@clisp.org>
+2021-12-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- Concretize the `glyph' datatype.
+ [me]: Rename new `$x` register to `sx`. Since we expect the
+ user to set this register directly, it should not be named with
+ a leading '$' per the "me Reference Manual".
- * src/include/font.h (glyph): Remove class.
- (glyph): Renamed from struct `glyphinfo'.
- (glyph_to_index): New inline function.
- (glyph_to_name): Make extern, not inline.
- (glyph_to_number): Update.
- (font): Use `glyph *' instead of `glyph'.
+ * tmac/e.tmac (initialization, {, }): Do it.
- * src/libs/libgroff/nametoindex.cpp (charinfo): Inherit from class
- `glyph'. Make `name' field public.
- (character_indexer, number_to_glyph, name_to_glyph): Use `glyph *'
- instead of `glyph'.
- (glyph_to_name): Renamed from `glyph::glyph_name'.
+ * tmac/groff_me.7.man:
+ * doc/meref.me.in:
+ * NEWS: Update documentation.
- * src/roff/troff/charinfo.h (charinfo): Inherit from class `glyph'.
- Use `glyph *' instead of `glyph'.
+ * doc/meintro.me.in:
+ * doc/meintro_fr.me.in:
+ * doc/meref.me.in: Sync with new register name.
- * src/roff/troff/input.cpp (name_to_glyph, number_to_glyph): Use
- `glyph *' instead of `glyph'.
- (glyph_to_name): Renamed from `glyph::glyph_name'.
+ See <https://savannah.gnu.org/bugs/?61025>. Thanks to Dave
+ Kemper for the discussion in
+ <https://savannah.gnu.org/bugs/?61710>.
- * src/libs/libgroff/font.cpp: Use `glyph *' instead of `glyph',
- and `glyph_to_index' instead of `glyph::glyph_index'.
+2021-12-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/printer.h (printer): Use `glyph *' instead of `glyph'.
- * src/libs/libdriver/printer.cpp: Likewise.
- * src/devices/grodvi/dvi.cpp: Likewise.
- * src/devices/grohtml/post-html.cpp: Likewise.
- * src/devices/grolbp/lbp.cpp: Likewise.
- * src/devices/grolj4/lj4.cpp: Likewise.
- * src/devices/grops/ps.cpp: Likewise.
- * src/devices/grotty/tty.cpp: Likewise.
+ [troff]: Slightly refactor.
-2006-02-22 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/div.cpp:
+ * src/roff/troff/div.h:
+ * src/roff/troff/input.cpp: Rename variables to reduce confusion
+ between "end macros" and "end-of-input macros". Call the latter
+ "eoi" macros for brevity.
- * font/devdvi/generate/tc.map: Add `sr' glyph.
- * font/devdvi/*TC: Regenerated.
+2021-12-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list): Use entry
- for `sqrt'.
+ * tmac/e.tmac: Fix code style nits.
+ - Use new terminology in diagnostic. See commit 66ac1a8db9,
+ 11 December.
+ - Drop unused '&&&' annotation for macro definitions. This
+ was a BSD me(7) implementation detail wherein parts of the
+ package were broken out into module files, loaded if/when
+ their macros were called. groff me(7) is monolithic, except
+ for devtag and refer(1) support.
+ - Remove '&&' end macro when we're done using it.
-2006-02-21 Werner LEMBERG <wl@gnu.org>
+2021-12-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_char.man: Explain `***' marker.
+ [me]: (Re-)localize strings.
-2006-02-17 Bruno Haible <bruno@clisp.org>
+ * tmac/{cs,de,fr,it,sv}.tmac: Update package localizations to
+ use new resources. As a happy side effect (and with the new
+ appendix string), the `+c` macro is now localized for Czech,
+ German, and Swedish.
- * src/libs/libgroff/nametoindex.cpp (character_indexer): Rename
- methods and fields from *_index to *_glyph.
- (character_indexer::named_char_glyph): Test for `charNNN' name
- here...
- (name_to_glyph): ... not here.
-
-2006-02-17 Bruno Haible <bruno@clisp.org>
-
- * src/include/font.h (name_to_glyph): Renamed from
- font::name_to_index.
- (number_to_glyph): Renamed from font::number_to_index.
- (glyph_to_name): Renamed from font::index_to_name.
- (glyph_to_number): Renamed from font::index_to_number.
- * src/libs/libgroff/nametoindex.cpp: Likewise.
- * src/roff/troff/charinfo.h (charinfo::as_glyph): Renamed from
- charinfo::get_index.
-
- * src/roff/troff/input.cpp: All callers changed.
- * src/roff/troff/node.cpp: Likewise.
- * src/libs/libgroff/font.cpp: Likewise.
- * src/devices/grops/ps.cpp: Likewise.
- * src/devices/grohtml/post-html.cpp: Likewise.
- * src/libs/libdriver/printer.cpp: Likewise.
-
-2006-02-17 Werner LEMBERG <wl@gnu.org>
-
- * src/include/ptable.h, src/include/itable.h
- (NEXT_PTABLE_SIZE_DEFINED): Use it to avoid multiple declaration
- of external symbol `next_ptable_size' (used by both header files).
-
-2006-02-15 Bruno Haible <bruno@clisp.org>
-
- * src/include/font.h (glyphinfo): New class.
- (glyph): Change internal representation.
- Change constructor signature.
- New method glyph::glyph_number().
- (glyph::glyph, glyph glyph::undefined_glyph, glyph::glyph_index,
- glyph::operator==, glyph::operator!=): Update.
- (font::index_to_name, font::index_to_number): New functions.
-
- * src/include/itable.h: New file, based on src/include/ptable.h.
-
- * src/libs/libgroff/nametoindex.cpp: Include itable.h.
- (class charinfo): New class.
- (class character_indexer): Change table result type from `int' to
- `class charinfo'.
- Add table with integer key.
- (character_indexer::character_indexer): Update.
- (character_indexer::ascii_char_index): Update.
- (character_indexer::numbered_char_index): Use NULL as name, not a
- string starting with a space.
- (character_indexer::named_char_index): Update.
- (font::number_to_index, font::name_to_index): Remove no-op cast.
- (glyph::glyph_name): New method.
- * src/roff/troff/charinfo.h (class charinfo): Inherit from class
- glyphinfo.
- (NUMBERED): Remove flag bit.
- (charinfo::numbered, charinfo::get_index): Update.
-
- * src/roff/troff/input.cpp (charinfo::charinfo): Update.
- (charinfo::set_number, charinfo::get_number): Update.
- (glyph::glyph_name): New method.
-
-2006-02-15 Werner LEMBERG <wl@gnu.org>
-
- * src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list): Fix
- entries for `>>', `<<', `*f', and `+f'. Reported by Bruno.
-
-2006-02-13 Werner LEMBERG <wl@gnu.org>
-
- * font/devps/prologue.ps (RE): Check `UniqueID' also, similar to
- dvips.
-
-2006-02-11 Werner LEMBERG <wl@gnu.org>
-
- * src/include/font.h: s/glyph_t/glyph/.
- Update all callers.
-
- * src/devices/grotty/tty.cpp: s/glyph/tty_glyph/.
- s/output_character_t/output_character/.
-
-2006-02-11 Bruno Haible <bruno@clisp.org>
-
- New accessor method glyph_t::glyph_name().
-
- * src/include/ptable.h (declare_ptable): Add a return value to the
- `define' method, and declare a `lookupassoc' method.
- (implement_ptable): Return the stored key in `define'. Implement
- lookupassoc.
- * src/include/font.h (glyph_t): Add `name' field. Add an argument
- to the constructor.
- (glyph_t::glyph_name): New method.
-
- * src/libs/libgroff/nametoindex.cpp (character_indexer): Change
- return type of methods and field member type to glyph_t.
- (character_indexer::character_indexer): Update.
- (character_indexer::ascii_char_index): Allocate a name for the
- glyph.
- Return a glyph_t with name.
- (character_indexer::numbered_char_index): Return a glyph_t without a
- name.
- (character_indexer::named_char_index): Return a glyph_t with a name.
- (font::number_to_index, font::name_to_index): Update.
+ * doc/meintro_fr.me.in (Les Parties du Document): Update example
+ to reflect mixed-case default string used in chapter headings.
- * src/roff/troff/input.cpp (charinfo::charinfo): Use the symbol as
- the glyph's name.
+ * tmac/tests/e_ld-works.sh: Add tests for localization.
-2006-02-11 Bruno Haible <bruno@clisp.org>
+2021-12-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grotty/tty.cpp (output_character_t): New type.
- (tty_printer::make_bold, tty_printer::add_char,
- tty_printer::put_char): Change argument type to output_character_t.
- (crossings): Change element type to output_character_t.
+ [me]: Internationalize strings.
-2006-02-11 Bruno Haible <bruno@clisp.org>
+ * tmac/e.tmac (initialization): Introduce internal
+ `_mo1`..`_mo12`, `_dw1`..`_dw7`, and `_td_format` strings (with
+ English defaults). Define them outside of the new `ld` macro so
+ that they can be overridden by localization packages.
+ (ld) <dw, mo, td>: Populate via the above new strings.
+ * tmac/trans.tmac: Stop defining `mo` and `dw`. Instead, make
+ them aliases of the new strings above. Handle `wa` and `wc`
+ similarly.
- Make the glyph data type abstract.
+2021-12-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/font.h (glyph_t): New class.
- (name_to_index, number_to_index): Change return type to glyph_t.
- (font::contains, font::get_width, font::get_height, font::get_depth,
- font::get_character_type, font::get_kern, font::get_skew,
- font::get_italic_correction, font::get_left_italic_correction,
- font::get_subscript_correction, font::get_code,
- font::get_special_device_encoding, font::add_entry,
- font::copy_entry, font::add_kern, font::hash_kern): Change argument
- type to glyph_t.
+ [me]: Add `ld` macro to re-init date/l10n stuff.
- * src/libs/libgroff/font.cpp (font_kern_list): Change members
- type and constructor argument types to glyph_t.
- (font::contains, font::get_width, font::get_height, font::get_depth,
- font::get_character_type, font::get_kern, font::get_skew,
- font::get_italic_correction, font::get_left_italic_correction,
- font::get_subscript_correction, font::get_code,
- font::get_special_device_encoding, font::add_entry,
- font::copy_entry, font::add_kern, font::hash_kern): Change argument
- type to glyph_t.
- (font::load): Use glyph_t variables.
+ * tmac/e.tmac (ld): New macro updates `y2` and `y4` registers
+ and `wa`, `wc`, `mo`, `dw`, and `td` strings.
- * src/libs/libgroff/nametoindex.cpp (name_to_index,
- number_to_index): Change return type to glyph_t.
+ * doc/meref.me.in (Miscellaneous, Predefined Strings):
+ * tmac/groff_me.7.man (Macros): Document it.
- * src/roff/troff/charinfo.h (charinfo::index): Change type to
- glyph_t.
- (charinfo::get_index): Change return type to glyph_t.
+ * tmac/tests/e_ld-works.sh: Add unit test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * src/roff/troff/env.cpp: Include font.h.
+ Fixes <https://savannah.gnu.org/bugs/?61670>.
- * src/roff/troff/node.cpp: Include font.h before charinfo.h.
+2021-12-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp: Include font.h before charinfo.h.
- (charinfo::charinfo): Update.
- (name_to_index, number_to_index): Change return type to glyph_t.
+ * tmac/tests/e_chapter-titles-work.sh: Add unit test for chapter
+ heading feature.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * src/include/printer.h (printer::set_char_and_width): Change return
- type to glyph_t.
+2021-12-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/printer.cpp (printer::set_char_and_width):
- Change return type to glyph_t.
+ * tmac/e.tmac: Ease localization and customization by exposing
+ strings for "Chapter" and "Appendix" instead of hard-coding
+ these words into the `$c` macro.
+ (initialization): Define new `wa` and `wc` strings. Separate
+ these and existing localization strings from `y2` and `y4`
+ initialization since the latter don't involve natural languages.
+ ($c): Interpolate these strings in chapter and appendix headings
+ and in calls to `$C` hook macro. Set "Chapter" and "Appendix"
+ in mixed case instead of full capitals, and set one
+ adjustable nonbreaking word space `\~` between them and the
+ chapter number instead of two unadjustable nonbreaking spaces.
+ {These changes do slightly alter the default output of the
+ package when the `+c` macro is used.}
- * src/devices/grodvi/dvi.cpp (dvi_printer::set_char): Change
- argument type to glyph_t.
+ * doc/meref.me.in (Predefined Strings):
+ * tmac/groff_me.7.man (Strings): Document new strings.
- * src/devices/grohtml/post-html.cpp (page::add_and_encode): Update.
- (html_printer::space_glyph): Renamed from space_char_index.
- (html_printer::add_to_sbuf, html_printer::sbuf_continuation,
- html_printer::overstrike, html_printer::set_char): Change argument
- type to glyph_t.
- (html_printer::set_char_and_width): Change return type to glyph_t.
+ * doc/meintro.me.in (Parts of the Basic Paper): Update example
+ to reflect mixed-case default string.
- * src/devices/grolbp/lbp.cpp (lbp_printer::set_char): Change
- argument type to glyph_t.
+ Fixes <https://savannah.gnu.org/bugs/?61661>.
- * src/devices/grolj4/lj4.cpp (lj4_printer::set_char): Change
- argument type to glyph_t.
+2021-12-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/ps.cpp (ps_printer::space_glyph): Renamed from
- space_char_index.
- (ps_printer::set_subencoding, ps_printer::set_char): Change argument
- type to glyph_t.
+ * tmac/e.tmac (@p): Deactivate right alignment (the effect of
+ groff's `rj` request) when starting a new paragraph.
+ * doc/meref.me.in (Paragraphing) <lp>: Document this.
- * src/devices/grotty/tty.cpp (tty_printer::set_char): Change
- argument type to glyph_t.
+2021-12-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-02-11 Bruno Haible <bruno@clisp.org>
+ * tmac/e.tmac ()c): Add bounds check to avoid attempting to set
+ a negative indentation, provoking a troff warning. Problem
+ exposed by formatting "meintro_fr.me" document with default
+ nroff mode line length.
- * src/roff/troff/input.cpp (font::name_to_index): Never return a
- negative value.
+2021-12-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/font.cpp (font::load): Remove failure tests for
- font::name_to_index.
+ [troff]: Slightly refactor (boolify).
-2006-02-10 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/div.cpp:
+ * src/roff/troff/div.h:
+ * src/roff/troff/env.cpp:
+ * src/roff/troff/input.cpp: Rename variables and demote from
+ `int` to `bool`. Initialize and assign them using Boolean
+ literals. The new names try harder to express a logical
+ predicate, and start with verbs to resist interpretation as
+ noun phrases.
+ - exit_started -> is_exit_underway
+ - done_end_macro -> is_end_macro_finished
+ - seen_last_page_ejector (demoted but not renamed)
+ - began_page_in_end_macro (demoted but not renamed)
- * doc/groff.texinfo (Assigning Formats): Number registers are always
- interpolated.
- Apply some rephrasing, contributed by Michael Burt.
+2021-12-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-02-07 Werner LEMBERG <wl@gnu.org>
+ * tmac/e.tmac: Explain presence of undocumented `$r` and `$R`
+ registers.
- * tmac/fr.tmac <ms>: Set `HY' register.
+ Fixes <https://savannah.gnu.org/bugs/?61683>.
-2006-02-07 Werner LEMBERG <wl@gnu.org>
+2021-12-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add framework for simple adaptation of the main macro packages (mm,
- me, ms, mom) to different locales. In particular, add support for
- French. For activation, simply use `-mfr' as the last macro
- package. This feature has been contributed by Fabrice MĂ©nard
- <menard.fabrice@wanadoo.fr>.
+ * tmac/e.tmac (bc): To get to the next column, space by the page
+ length `.p`, not by the distance to the next trap (or 24 inches,
+ as hard-coded in me(7) traditionally). It is up to any sprung
+ traps to issue further space requests or otherwise ensure a
+ transition to the next column.
- * tmac/fr.tmac, tmac/trans.tmac, tmac/hyphen.fr, tmac/LOCALIZATION:
- New files.
- * tmac/README: Mention hyphen.fr.
- * man/groff_tmac.man: Mention fr.tmac.
- * NEWS: Updated.
+ See <https://savannah.gnu.org/bugs/?55081> for discussion.
-2006-01-27 Werner LEMBERG <wl@gnu.org>
+2021-12-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_font.man: Updated documentation of `entity_name' field.
- Avoid future tense.
+ * tmac/e.tmac ({): Fix missing scaling unit in arithmetic
+ expression: broke footnotes in troff mode. Problem introduced
+ by me in commit 6eafd208, 16 December. Thanks to Robert
+ Goulding for the (informal) report.
-2006-01-27 Bruno Haible <bruno@clisp.org>
+2021-12-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devhtml/R.proto: Remove the entity names from the font's
- special_encoding_encoding column.
- * src/devices/grohtml/post-html.cpp (get_html_entity): New function,
- handling the entity names here.
- (get_html_translation): Use it. Change return type to `const
- char *'.
- (page::add_and_encode): Update, removing a useless cast.
+ * doc/doc.am (doc/{pic,webpage}.html): Quieten build. Stop
+ passing `-p` (progress) option to postprocessor, which produces
+ TeX-like bracketed page numbers when images occur.
-2006-01-26 Werner LEMBERG <wl@gnu.org>
+2021-12-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- This change is based on a patch by Bruno Haible <bruno@clisp.org>.
+ * doc/doc.am (.ms.html): Drop unused suffix rule.
- * src/include/device.h: Add comments.
- * src/include/font.h: Add comments.
- * src/include/unicode.h: Likewise.
- * src/include/ptable.h, src/libs/libgroff/ptable.cpp: Likewise.
+2021-12-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-01-26 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * tmac/tmac.am (tmac_XFAIL_TESTS): Mark test
+ "e_footnotes-work-with-columns.sh" as expected to fail (as it
+ does now, consequent to a reverted commit).
- Suppress `.st' request emission by `grn'.
+2021-12-16 Dave Kemper <saint.snit@gmail.com>
- * src/preproc/grn/main.cpp (USE_ST_REQUEST): New macro.
- (conv): Use it.
+ * man/groff_tmac.5.man: Fix minor errors.
-2006-01-22 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61633>.
- * install-sh: New version; taken from texinfo CVS.
+2021-12-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-01-21 Werner LEMBERG <wl@gnu.org>
+ Parameterize line height adjustment when super/subscripting.
- * src/preproc/preconv/preconv.cpp (main): Set program_name. Bug
- reported by Alexander E. Patrakov <patrakov@ums.usu.ru>.
+ * tmac/e.tmac (initialization): Assign 0.2m to register `$x`.2m.
+ ({, <}: Apply adjustment, multiplied by -1 for superscripts.
-2006-01-19 Bruno Haible <bruno@clisp.org>
+ * doc/meref.me.in:
+ * tmac/groff_me.7.man: Document it.
- Let `make -k install' install more files.
+ * NEWS: Add item.
- * Makefile.in (MAKE_K_FLAG): New variable. Use it everywhere where
- $(MAKE) and $(MDEFINES) are used.
- (CPROGDIRS): Remove $(XPROGDIRS). Treat $(XPROGDIRS) like
- $(CPROGDIRS) everywhere.
- ($(DEVDIRS) $(XDEVDIRS) $(OTHERDEVDIRS) $(TTYDEVDIRS)): Don't depend
- on $(XPROGDIRS).
- ($(OTHERDIRS)): Likewise.
+ * doc/meintro.me.in:
+ * doc/meintro_fr.me.in:
+ * doc/meref.me.in: Forego extra line height for more attractive
+ typesetting.
+ Fixes <https://savannah.gnu.org/bugs/?61025>. Thanks to Robert
+ Goulding for the suggestion.
- * src/devices/grohtml/post-html.cpp (get_html_translation): Remove
- failure test for font::name_to_index -- it can never fail.
+2021-12-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-01-19 Werner LEMBERG <wl@gnu.org>
+ * tmac/e.tmac ($c): Draw the footnote separator no wider than
+ the column width.
- * src/devices/grops/grops.man: Fix section on creating EPS files.
- Don't use future time in manual.
- Other minor fixes.
+ Fixes <https://savannah.gnu.org/bugs/?61675>.
-2006-01-15 Gaius Mulley <gaius@glam.ac.uk>
+2021-12-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac: New macro LINKSTYLE which allows users to set
- various typographical URL attributes for non-HTML devices.
+ * tmac/e.tmac (2c): Accept an empty first argument, permitting
+ the number of columns to be specified but preserving the default
+ column separation.
- * tmac/groff_www.man: Document LINKSTYLE.
+ Fixes <https://savannah.gnu.org/bugs/?61671>.
-2006-01-11 Werner LEMBERG <wl@gnu.org>
+2021-12-12 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure.ac: Test for getc_unlocked (needed for localcharset).
- * configure, src/include/config.hin: Regenerated.
+ * tmac/e.tmac (initialization): Initialize `$C` hook, preventing
+ `mac` warnings from troff(1) if chapter title feature is used.
- * src/libs/libgroff/Makefile.sub (EXTRA_CFLAGS): Define
- ENABLE_RELOCATABLE.
+2021-12-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/relocatable.h: New dummy header file for
- localcharset.c.
+ * tmac/e.tmac (i, bi): Add italic corrections.
- * src/libs/libgroff/localcharset.c: Updated to (unchanged) CVS
- gnulib version.
+2021-12-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-01-10 Bruno Haible <bruno@clisp.org>
+ * tmac/e.tmac: Fix groff warnings and correctness issue.
+ (n2): Prefix `ie` request with `do` because it uses the groff
+ `\B` escape sequence. Use braces to group multiple requests
+ after an `el` request: `ie` and `el` count as two requests, not
+ one. Add comment regarding the unfortunate choice of brace
+ style given *roff's syntactical constraints.
+ (n2, (c): Conceal bare tab in request argument list (exposed by
+ no longer stripping the macro file).
- Work around unportability of nl_langinfo(CODESET).
+2021-12-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * m4/glibc21.m4: New file, from gnulib.
- * Makefile.sub (M4MACROS): Add m4/glibc21.m4.
- * configure.ac: Also test for stddef.h, and invoke jm_GLIBC21.
- * Makefile.in (HOST, GLIBC21): New variables.
- (MDEFINES): Pass them to subdirectories.
- * src/include/relocate.h (relocatep): Define with C linkage.
- * src/include/localcharset.h: New file, from gnulib.
- * src/libs/libgroff/localcharset.c: New file, from gnulib with a
- modification for relocate().
- * src/libs/libgroff/config.charset: New file, from gnulib.
- * src/libs/libgroff/ref-add.sin: New file, from gnulib.
- * src/libs/libgroff/ref-del.sin: New file, from gnulib.
- * src/libs/libgroff/Makefile.sub (EXTRA_CFLAGS): Also define LIBDIR.
- (OBJS): Add localcharset.o.
- (CSRCS): Add localcharset.c.
- (all): Add dependencies to charset.alias, ref-add.sed, ref-del.sed.
- (charset.alias): New rule.
- (PACKAGE): New variable.
- (ref-add.sed, ref-del.sed): New rules.
- (MKINSTALLDIRS): New variable.
- (install_data): Depend on install_charset_data.
- (install_charset_data): New rule for creating or updating
- charset.alias.
- (uninstall_sub): Depend on uninstall_charset_data.
- (uninstall_charset_data): New rule for uninstalling or updating
- charset.alias.
- * src/preproc/preconv/preconv.cpp: Include localcharset.h instead
- of <langinfo.h>.
- (main): Initialize default_encoding from locale_charset() instead of
- nl_langinfo(CODESET).
+ [me]: Revise diagnostic messages to follow GNU Coding Standards,
+ identifying what is emitting them.
- * aclocal.m4, configure, src/include/config.hin: Regenerated.
+ * tmac/e.tmac (_e): New string holds "e.tmac".
+ (@err): New macro constructs and issues diagnostics. Add file
+ name to messages when available. Suppress line number when
+ unavailable.
+ (check_page_length, @z, @h, n2, sk, @p, @(, @), (c, )c, EQ, (f,
+ ++, @U): Call `@err` instead of invoking `tm` request. Revise
+ wording of messages in an attempt at clarity.
-2006-01-10 Werner LEMBERG <wl@gnu.org>
+ Continues the long process of fixing Savannah #52463.
- * src/preproc/preconv/preconv.cpp (conversion_iconv): Use
- ICONV_CONST in call to iconv. Reported by Robert Goulding.
+2021-12-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-01-07 Werner LEMBERG <wl@gnu.org>
+ * tmac/e.tmac: Slightly refactor footnote numbering.
+ ()f): Tighten code style and end string definition with comment.
+ (+c, initialization): Drop unused auto-incrementation of
+ footnote number register `$f`. Add new string `_*` to use when
+ {re-}initializing `*` outside of a footnote diversion, and
+ interpolate the footnote number register instead of a literal.
- * font/devps/generate/freeeuro.sfd: Run auto-hinter with recent
- fontforge version.
- Bump font version to 001.001.
+2021-12-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devps/generate/Makefile (freeeuro.afm, freeeuro.pfa):
- Call fontforge, not pfaedit.
+ * tmac/tests/e_footnote-marks-work.sh: Add unit test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * font/devps/freeeuro.afm, font/devps/freeeuro.pfa: Regenerated.
+2021-12-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2006-01-05 Ruslan Ermilov <ru@FreeBSD.org>
+ * tmac/e.tmac: Fix automatic numbering of delayed text.
+ (initialization): Add `_#` string for use in multiple
+ assignments of `#` string.
+ (initialization, pd): Remove unused auto-incrementation from
+ `$d` delayed text number register.
+ ()d): Increment `$d` register unconditionally, no longer
+ conditionally on whether the delayed text marker string `#` has
+ been interpolated.
+ ()d, pd): Update `#` string using new `_#` string. Stop
+ initializing the string with `\k` mark-setting escape sequence.
- * tmac/doc-common: Add new FreeBSD and NetBSD versions.
- * tmac/groff_mdoc.man: Updated.
+ * doc/meref.me (Annotations) <)d>: Document now-unconditional
+ incrementation of `$d` register.
-2006-01-05 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61632>.
- * src/preproc/preconv/preconv.cpp: s/debug/debug_flag/.
- (raw_flag): New global variable.
- (do_file): Use .lf to set file name (if `raw_flag' isn't set).
- Don't pass BOM to `conversion_utf8'.
- (usage): Updated.
- (main): Handle `-r' command line switch to set `raw_flag'.
- (get_BOM): Fix encodings in `BOM_table'.
+2021-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/preconv/preconv.man: New file. Not complete yet.
- * src/preproc/proconv/Makefile.sub (MAN1): New variable.
+ * tmac/tests/e_delayed-text-marks-work.sh: Add test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2006-01-04 Werner LEMBERG <wl@gnu.org>
+2021-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/preconv/preconv.cpp (emacs_to_mime): As suggested by
- Bruno, comment out most encodings to support only a small set of
- coding tags, thus reducing potential problems with legacy encodings
- and character sets in the future.
- Add many XEmacs coding tags (now commented out).
- Add `cp1047'.
- (check_encoding_tag): Renamed to...
- (check_coding_tag): This.
- (get_BOM): Return encoding as specified by BOM.
- Test for UTF32-LE too.
- (do_file): Don't check for coding tag if a BOM has been found.
+ * tmac/e.tmac: Rename internal register out of user name space.
+ (@f): Rename `VL` to `__`; remove it immediately after using it.
-2006-01-03 Bruno Haible <bruno@clisp.org>
+2021-12-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * m4/groff.m4: Renamed from aclocal.m4.
- * m4/codeset.m4: New file, from gnulib.
- * m4/iconv.m4: New file, from gnulib.
- * m4/lib-ld.m4, m4/lib-link.m4, m4/lib-prefix.m4: New files, from
- gnulib.
- * config.rpath: New file, from gnulib.
- * config.guess, config.sub: New files, from gnulib.
- * Makefile.sub (M4MACROS): New variable.
- (configure): Fix typo.
- (aclocal.m4): New rule.
- (stamp-h.in): Depend on aclocal.m4.
- * configure.ac: Invoke AM_ICONV and AM_LANGINFO_CODESET.
- * Makefile.in (LIBICONV): New variable.
- (MDEFINES): Pass it to recursive makes.
- * src/preproc/preconv/preconv.cpp: Use HAVE_LANGINFO_CODESET and
- HAVE_ICONV instead of I18N macro.
- * src/preproc/preconv/Makefile.sub (EXTRA_LDFLAGS): New variable.
+ * doc/meref.me: Fix documentation error; the `$s` macro draws a
+ horizontal line of 2 inches' length, not 1.5 inches.
- * aclocal.m4, configure, src/include/config.hin: (Re)generated.
+ Fixes <https://savannah.gnu.org/bugs/?58682>. Thanks to Dave
+ Kemper for the report.
-2006-01-03 Werner LEMBERG <wl@gnu.org>
+2021-12-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/Makefile.in (webpage.html): Simplify.
- * doc/Makefile.sub (webpage.html): Synchronize with doc/Makefile.in.
- * doc/webpage.ms, tmac/groff_www.man, tmac/www.tmac: Minor updates.
+ Generate me(7) manual sources as part of the build. We had been
+ shipping 'me' sources with the string '@VERSION@' in them and
+ only sed-replacing that to produce generated PostScript, but
+ this replacement was not occurring for users who processed the
+ documents themselves.
-2006-01-01 Werner LEMBERG <wl@gnu.org>
+ * doc/meintro.me:
+ * doc/meintro_fr.me:
+ * doc/meref.me: Rename these to...
+ * doc/meintro.me.in:
+ * doc/meintro_fr.me.in:
+ * doc/meref.me.in: ...these.
- * tmac/doc-common (Os): Add some Darwin versions.
- * tmac/groff_mdoc.man: Document them.
+ * doc/doc.am (DOCFILES): Add the new *.in files. Move the *.me
+ files from here...
+ (GENERATEDDOCFILES): ...to this new variable.
+ (dist_otherdoc_DATA, EXTRA_DIST): Add `$(GENERATEDDOCFILES)`.
+ (doc/me{intro{,_fr},ref}.me): Add new target rules.
-2006-01-01 Bruno Haible <bruno@clisp.org>
+ * src/utils/grog/tests/smoke-test.sh: Update test to look for
+ the above source tree documents under their new names.
- * src/preproc/preconv/preconv.cpp (emacs_to_mime): Various
- corrections:
- . Don't map ascii to latin-1.
- . Don't use IBMxxx encodings but cpxxx for portability.
- . Map cp932, cp936, cp949, cp950 to itself.
- (emacs2mime): Protect calls to strcasecmp.
- (conversion_iconv): Add missing call to iconv_close.
- (do_file): Emit error message in case of unsupported encoding.
+2021-12-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-12-31 Werner LEMBERG <wl@gnu.org>
+ * doc/doc.am (.me.txt, .ms.txt): Drop unused suffix rules.
- Integrate preconv into the groff binary. Changes based on a patch
- from Michail Vidiassov.
+2021-12-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/pipeline.h (MAX_COMMANDS): Increase by 1.
+ * doc/doc.am (DOC_SED): Add substitution of command prefix
+ {"@g@"} so we can make accurate reference to groff commands with
+ Unix counterparts in our documentation.
- * src/roff/groff/groff.cpp (PRECONV_INDEX): New macro.
- (SOELIM_INDEX): Updated.
- (help, synopsis): Updated.
- (main): Add command line options `-k' and `-K enc' to select
- encoding.
- Add support for GROFF_ENCODING environment variable.
+2021-12-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/groff.man: Updated and revised.
+ * tmac/e.tmac: Add nroff mode string definitions for 4.4BSD
+ compatibility.
+ - Define '{' and '}' (superscripting) strings as '[' and ']'.
+ - Define '<' and '>' (subscripting) strings as '\(la and
+ '\(ra' if available on the device, otherwise '<' and '>'.
+ * tmac/tests/e_footnote-marks-work.sh: Update expected output.
- Start with autoconf support for preconv.
+ * doc/meref.me: Document it.
- * configure.ac: Call AC_C_BIGENDIAN.
- * configure, src/include/config.hin: Regenerated.
+ Fixes <https://savannah.gnu.org/bugs/?61619>.
-2005-12-30 Werner LEMBERG <wl@gnu.org>
+2021-12-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- New preprocessor `preconv' to convert input encodings to something
- groff can understand. Not yet integrated within groff. Proper
- autoconf stuff is missing too.
+ * doc/doc.am (doc/meintro_fr.ps): Add target rule (overriding
+ suffix rule) to generate this file using `-mfr` (load the French
+ localization macro file).
- Tomohiro Kubota has written a first draft of this program, and some
- ideas have been reused (while almost no code has been taken
- actually).
+2021-11-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/preconv/preconv.cpp. src/preproc/preconv/Makefile.sub:
- New files.
+ [troff]: Drop redundant `do_divert()` declaration.
- * MANIFEST, Makefile.in (CCPROGDIRS), test-groff.in
- (GROFF_BIN_PATH): Add preconv.
+ * src/roff/troff/env.h: Do it.
-2005-12-12 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61433>. Thanks to Bjarni
+ Ingi Gislason for the report.
- * aclocal.m4 (GROFF_MAKEINFO): Fix regexps to be POSIX conformant.
- In particular, don't use `\+' since it is a GNU sed extension.
+2021-11-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure: Regenerated.
+ [troff]: Remove `DEBUGGING` preprocessor cruft.
-2005-12-09 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/input.cpp:
+ * src/roff/troff/mtsm.cpp: Stop defining `DEBUGGING`
+ preprocessor macro (as empty).
- * src/libs/libgroff/make-uniuni: New script to generate uniuni.cpp.
+ * src/roff/troff/input.cpp: Give `DEBUG_OPTION` an empty string
+ value if the former is undefined, so the `getopt_long()` call
+ will compile.
- * src/libs/libgroff/uniuni.cpp: Regenerated, using data from Unicode
- 4.1.0.
+ Fixes <https://savannah.gnu.org/bugs/?61436>. Thanks to Bjarni
+ Ingi Gislason for the report.
+2021-11-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit/make-afmtodit-tables: New script to generate
- afmtodit.tables.
+ [tbl]: Slightly refactor table format column modifier `p` and
+ `v` validation.
- * src/utils/afmtodit/afmtodit.tables: New file, representing Unicode
- 4.1.0 data.
+ * src/preproc/tbl/main.cpp (process_format): Make code terser by
+ introducing references to `list->point_size` and
+ `list->vertical_spacing`. Doing this requires a new scope
+ {because a switch case isn't one} so add it, without updating
+ indentation for this commit. When complaining of out-of-range
+ type size or vertical spacing, report the limit.
- * src/utils/afmtodit/afmtodit.pl (%unicode_decomposed,
- %AGL_to_unicode): Removed. Replace it with a tag.
+2021-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit/Makefile.sub (afmtodit): Adjust sed expression
- to replace tag with actual file contents.
+ [tbl]: Improve diagnostic messages.
-2005-12-08 Werner LEMBERG <wl@gnu.org>
+ Revise diagnostic messages generally to use terminology
+ consistent with the recent rewrite of tbl(1), identify a
+ contextual token when possible, and communicate more helpfully.
- The change 2005-06-20 can indeed cause problems, so we follow the
- advice by using marks.
+ * src/preproc/tbl/main.cpp (process_options): Tell the user
+ which region option is missing a closing parenthesis or cannot
+ accept an empty argument. Refer to region options as such, not
+ simply "options" (so they can't be confused with command-line
+ options). Say that input is "invalid" instead of "bad".
+ (process_format): Say "table format specification" instead of
+ just "format". Say "column classifier" instead of "format".
+ When a column modifier is missing an argument or a closing
+ parenthesis, identify it and refer to it as a "column modifier"
+ instead of omitting context. Inform user that arguments to `p`
+ and `v` column modifiers must be "(optionally signed) integer"s,
+ not "numbers", lower these diagnostics' levels from error to
+ warning, and indicate that the modifier is ignored. Clarify
+ diagnostic when extra characters trail `.` at the end of a table
+ format line.
+ (process_data): Say "table entry" instead of "data entry" when
+ discarding an excess one.
+ (process_table): Say we're giving up on "this table region", not
+ this "table", particularly since any table continuations (.T&)
+ are ignored.
- * font/devps/prologue.ps (PBEGIN): Use `mark'.
- (PEND): Use `cleartomark'.
+2021-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-12-07 Michail Vidiassov <master@iaas.msu.ru>
+ [tbl]: Fix call to `getopt_long()`.
- * src/utils/afmtodit.pl: Fix kerning output to avoid warnings for
- glyphs which have kern values but aren't handled (glyph variants,
- for example).
+ * src/preproc/tbl/main.cpp (main): Stop telling `getopt_long()`
+ to look for a `T` option. Continues b4bbf32e, 16 October 2020.
-2005-12-02 Werner LEMBERG <wl@gnu.org>
+2021-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/ps.cpp (ps_printer::get_subfont): Use correct
- subfont index. Reported by Michail Vidiassov <master@iaas.msu.ru>.
+ [tbl]: Tweak usage message.
-2005-11-28 Gaius Mulley <gaius@glam.ac.uk>
+ * src/preproc/tbl/main.cpp (usage): Document `--version`. Give
+ version retrieval mode separate synopsis. Use more normative
+ synopsis syntax.
- * doc/Makefile.in: Separate rule for webpage.html so that extra
- command line options can be passed to grohtml.
- * doc/groff.css: Change all margins to 0%.
- * doc/webpage.ms: Now use new macros ALN, LNS, and LNE so that left
- navigation is exploited. Also update webpage to contain new
- sections on licenses, mailing lists, cvs/ftp access, groff
- dependencies, and bug reports.
- * tmac/groff_www.man: Document the new macros ALN, LNS, and LNE.
- * tmac/www.tmac: Implement the new macros ALN, LNS, and LNE.
-
-2005-11-25 Gaius Mulley <gaius@glam.ac.uk>
+2021-11-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp
- (html_printer::do_file_components): Add fputs calls to emit the
- head contents and shut down the head tag whenever a new file
- component is generated.
+ [tbl]: Fix code style nits.
-2005-11-22 Gaius Mulley <gaius@glam.ac.uk>
+ * src/preproc/tbl/main.cpp (process_input_file)
+ (entry_format::debug_print, process_data, main): Replace
+ `assert(0)` calls with communicative predicates.
+ (struct input_entry_format, input_entry_format::debug_print,
+ process_format): Boolify. Demote and rename `int`s
+ `last_column` and `equal` to `bool`s named `is_last_column` and
+ `is_equal_width`. Assign them Boolean literals.
+ (process_format): Boolify. Demote `have_expand`, `got_format`,
+ and `got_period` from `int` to `bool`. Use Boolean literals in
+ assignments thereto.
+ (process_options): Swap order of null pointer comparison when a
+ typo or thinko could lead to lvalue assignment.
+ (process_data): Boolify. Demote `give_up` from `int` to `bool`.
+ Demote and rename `int` `row_comment` to `bool`
+ `seen_row_comment`. Use Boolean literals in assignments
+ thereto.
+ (main): Use standard C library symbols `EXIT_SUCCESS` and
+ `EXIT_FAILURE` with `exit()` calls instead of `0` and `1`.
- * src/devices/grohtml/post-html.cpp (html_printer::flush_page): Add
- call to flush_text to flush any outstanding html tags on the
- paragraph stack.
+2021-11-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Fix Savannah #61520.
+
+ * src/utils/grog/grog.pl: Move hash `preprocessor_for_macro` to
+ global scope since it is now mutable across `do_line` subroutine
+ calls.
+ (do_line): Adjust regex matching an end macro to work better.
+ Check names of macros being defined by the document; if they
+ start with '[' or ']', stop attempting to detect refer(1) usage,
+ by deleting its key from the `preprocessor_for_macro` hash.
-2005-11-18 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61520>.
- * aclocal.m4 (GROFF_MAKEINFO): Use `groff.info' in tests.
- Announce makeinfo version.
- * configure: Regenerated.
+2021-11-24 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-11-18 Mike Frysinger <vapier@gentoo.org>
+ [grog]: Add regression test for Savannah #61520.
- * Makefile.in: Declare proper dependencies between make targets.
+ * src/utils/grog/tests/avoid-refer-fakeout.sh: Do it.
+ * src/utils/grog/grog.am (grog_TESTS): Run test.
- * doc/Makefile.in: Rename groff info page to `groff.info'.
- * doc/Makefile.sub: Likewise.
- * doc/groff.texinfo: Likewise.
+2021-11-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-11-17 Peter O'Gorman <mlists@thewrittenword.com>
+ * doc/groff.texi (Page Motions):
+ * man/groff.7.man (Escape short reference): Fix error: the `\r`,
+ `\u`, and `\d` escape sequences move in ems, not vees, despite
+ being vertical motions. Add discussion and example. Thanks to
+ Bjarni Ingi Gislason for pointing out the problem in groff(7)
+ and Tadziu Hoffman for his lucid explanation.
- * src/utils/pfbtops/pfbtops.c, src/utils/xtotroff/xtotroff.c: Move
- definition of __GETOPT_PREFIX to the beginning of file to ensure
- that it is defined even on platforms where getopt.h is already
- included by other header files.
+ Fixes <https://savannah.gnu.org/bugs/?61437>. Thanks to Bjarni
+ Ingi Gislason for the report and a suggested patch.
-2005-11-10 Gaius Mulley <gaius@glam.ac.uk>
+2021-11-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp (html_printer::do_heading):
- Reset font to NULL to ensure that a font block is recreated during
- the next paragraph.
+ * src/include/error.h: Drop `extern` storage class from
+ diagnostic function prototypes. Drop parameter names from
+ prototypes, in keeping with the Stroustrup-style C++ used in
+ most of groff.
-2005-11-04 Werner LEMBERG <wl@gnu.org>
+2021-11-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * aclocal.m4 (GROFF_MAKEINFO): Fix sed expression.
- * configure: Regenerated.
+ * src/libs/libgroff/font.cpp (font::load): Update diagnostic
+ messages to say "kerning pair" instead of "kern pair".
-2005-10-27 Werner LEMBERG <wl@gnu.org>
+2021-11-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * aclocal.m4 (GROFF_MAKEINFO): New function for checking whether
- makeinfo 4.8 or newer is available.
- * configure.ac: Call GROFF_MAKEINFO.
- * configure: Regenerated.
+ * src/roff/troff/input.cpp (read_size): Update diagnostic
+ messages to use more normative language: say "type size" instead
+ of "point-size", and "escape sequence" instead of "escape".
+ * src/roff/groff/tests/\
+ use_point_size_escape_with_single_digit_arg.sh: Update expected
+ diagnostic wording in text.
- * Makefile.in (MAKEINFO): Use autoconf variable.
- (MDEFINES): Add MAKEINFO.
+2021-11-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/Makefile.in (MAKEINFO): Use autoconf variable.
- * doc/Makefile.sub (MAKEINFO): Remove.
+ * src/roff/troff/input.cpp (read_size): Boolify. Update
+ prototype. Demote return type from `int` to `bool`. Use
+ Boolean literals for return values. Similarly demote local
+ variable, rename it from `bad_digit` to
+ `contains_invalid_digit`, and use Boolean literals with it.
-2005-10-26 Werner LEMBERG <wl@gnu.org>
+2021-11-16 Deri James <deri@chuzzlewit.myzen.co.uk>
- * REVISION: Set to 3.
+ * src/devices/gropdf/gropdf.pl: Fixes to importing pdf versions
+ > 1.4.
+
+2021-11-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-10-17 Werner LEMBERG <wl@gnu.org>
+ [tbl]: If "nowarn", suppress table row warning.
- Mention $MANPAGER variable used with some `man' systems.
+ * src/preproc/tbl/table.cpp (table::init_output): Bracket the
+ generated groff code that emits a warning if a table row
+ overruns a page location trap (usually, is too long to
+ vertically fit on the page) in a test for whether the "nowarn"
+ region option was given, so that this warning is suppressed as
+ well when that option is used.
+ * src/preproc/tbl/tbl.1.man (Region options): Document new
+ "nowarn" behavior.
+
+ {"nokeep" also suppresses this warning, for a different reason;
+ no diversion is created to hold the table row, so its vertical
+ size does not exist to be compared to the distance to the next
+ page trap.}
+
+ Fixes <https://savannah.gnu.org/bugs/?61477>.
+
+2021-11-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/tbl/table.cpp (table::do_vspan): Fix code style
+ nits. Swap order of null pointer and zero equality comparisons
+ when a typo or thinko could lead to lvalue assignment. Break a
+ series of 6 and-ed assertion predicates into separate `assert()`
+ calls--sure to be less maddening for anyone who has to debug
+ such a contingency. Clarify comment since C++98 didn't yet have
+ `nullptr`.
+
+2021-11-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [m4]: Clean up shell variable quoting and bracing.
+
+ * m4/groff.m4 (GROFF_PROG_YACC, GROFF_MAKEINFO)
+ (GROFF_BROKEN_SPOOLER_FLAGS, GROFF_TARGET_PATH_SEPARATOR): Stop
+ bracing shell variable expansions that don't require it; the
+ shell is not make(1).
+ (GROFF_PROG_YACC, GROFF_MAKEINFO): Double-quote shell variable
+ expansions that might produce whitespace.
+ (GROFF_MAKEINFO): Drop unnecessary leading zeroes from version
+ number component construction. Drop unnecessary escaping of
+ plus sign in expr(1) input.
+
+2021-11-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [m4]: Clean up test(1) usage.
+
+ Get rid of string (non-)nullity tests and comparisons involving
+ concatenation with garbage (usually "x"). Even the GNU Autoconf
+ manual's shell portability material doesn't recommend this. It
+ must be either a bodge cooked up by shell programmers who
+ couldn't remember to quote variable expansions, or a workaround
+ for shells of such poor quality that they defied the odds and
+ decayed out of usage or got fixed.
+
+ Instead, use double quotes (only where necessary). Test for
+ non-empty strings with "test -n" and empty strings with "test
+ -z". Stop quoting literal comparands that obviously have no
+ shell metacharacters in them.
+
+ * m4/groff.m4 (GROFF_PRINT, GROFF_PROG_YACC, GROFF_PERL)
+ (GROFF_DOC_CHECK, GROFF_MAKEINFO, GROFF_TEXI2DVI)
+ (GROFF_HTML_PROGRAMS, GROFF_PDFDOC_PROGRAMS, GROFF_PAGE)
+ (GROFF_TMAC, GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_X11)
+ (GROFF_APPRESDIR_DEFAULT, GROFF_APPRESDIR_CHECK)
+ (GROFF_HAVE_TEST_EF_OPTION, GROFF_BASH, GROFF_UCHARDET)
+ (GROFF_UCHARDET_CHECK, GROFF_PDFTOOLS)
+ (GROFF_USE_GROFF_ALLOCATOR): Do it.
+
+2021-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_TEXI2DVI): Add dependency on
+ `GROFF_MAKEINFO` macro. Rewrite to also test `MAKEINFO`
+ variable, which is empty if the `makeinfo` command is not
+ installed or too old. Consequently ignore `texi2dvi` if is too
+ old without having to do a version check (since it and
+ `makeinfo` are distributed together, both being part of GNU
+ Texinfo).
+
+ * doc/doc.am (.texi.dvi, .texi.pdf): Update error message to
+ indicate that `texi2dvi` is _either_ missing or too old.
+
+2021-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_MAKEINFO): Stop throwing a warning if the
+ installed `makeinfo` is old but the distributed Info manual is
+ up to date. This is not a configure-time problem; the user will
+ be notified when they run 'make' if they modify doc/groff.texi,
+ or if they run 'make doc' (which has required a TeX installation
+ for years). Empty the `MAKEINFO` variable immediately if a
+ too-old version is detected. Drop needless `AC_SUBST`itution of
+ the detected `makeinfo` version.
+
+2021-11-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_HTML_PROGRAMS): Clarify message; it is only
+ groff-generated HTML that is disabled by the absence of the
+ programs checked for. (`makeinfo` can still generate our
+ Texinfo manual in HTML format.)
+
+2021-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [build]: Drop `BUILD_INFODOC` symbol. Ship manual in GNU Info,
+ text, and HTML forms in distribution archive.
+
+ * Makefile.am (MAINTAINERCLEANFILES): Initialize.
+ (MOSTLYCLEANADD): Drop unused variable.
+ * configure.ac: Drop `AM_CONDITIONAL([BUILD_INFODOC]...`.
+ * doc/doc.am (EXTRA_DIST): Rearrange shipment of our Texinfo
+ manual source files to precede all of the generated forms, for
+ clarity. Drop all `BUILD_INFODOC` conditionals. Make
+ `build_infodoc` phony target depend on plain text, GNU Info, and
+ HTML forms of Texinfo manual unconditionally. Also drop unused
+ variables `groffinfodir`, `groffpdfdir`, and `texi2dvi_missing`.
+ (EXTRA_DIST, MAINTAINERCLEANFILES): Add Info form of manual.
+ Drop glob pattern attempting to match the segments that
+ `makeinfo` breaks it into. It isn't necessary for
+ MAINTAINERCLEANFILES.
+ (EXTRA_DIST, MAINTAINERCLEANFILES): Add text form of manual.
+ (EXTRA_DIST, MAINTAINERCLEANFILES): Add HTML form of manual.
+ (dist-hook): Depend on new (phony) target `dist-info-bits`.
+ (dist-info-bits): Look for the info document in the build
+ directory, then the source directory. (It could be in either
+ place depending on whether the build from a Git working tree is
+ being done in or out of a separate build directory.) When
+ found, copy the segments to the assembly area for the
+ distribution archive.
+ (install_infodoc): Refactor. Remove any groff info files from
+ the destination info directory using a shell glob directly
+ instead of a partly redundant ls(1) command substitution.
+ Similarly, use a shell glob to cp(1) the info files (including
+ any matched segments) to the destination info directory before
+ running `install-info`. (In this process I learned that
+ `install-info` doesn't "install" anything; instead, it
+ {de-}registers info files with their top-level catalog.)
+
+2021-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am (.texi.txt, .texi.html): Reorder pattern rules to
+ make it clearer which formats require only `makeinfo` and which
+ require `texi2dvi`. The latter imposes more build dependencies,
+ including a full TeX installation.
+
+2021-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [mom]: Build more quietly.
+
+ * contrib/mom/mom.am (penguin.{ps,.pdf}): Make targets quiet by
+ default; they are simple file copies.
+
+2021-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Revise a test's setup.
- * doc/webpage.ms, src/devices/grotty/grotty.man, NEWS: Updated.
+ * src/roff/groff/tests/fp_should_not_traverse_directories.sh:
+ Revise search for device/font description directory to work in
+ within-source-tree builds and (for now) with the approach used
+ by Automake's "distcheck" target.
-2005-09-13 Werner LEMBERG <wl@gnu.org>
+2021-11-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/hyphenex.us: New version (`ushyphex.tex' from ftp.dante.de).
+ [tbl]: Accept `\&` as an empty table entry.
-2005-09-04 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/tbl/table.cpp (table::add_entry): Suppress
+ diagnostic about non-empty table entries classified as `_` or
+ `=` if the entry consists of exactly `\&`.
-Version 1.19.2 released
-=======================
+ * src/preproc/tbl/tbl.1.man (Table data): Document this idiom.
- * tmac/groff_ms.man, doc/groff.texinfo: Synchronize.
+2021-11-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/webpage.ms: Updated.
+ [tbl]: Update diagnostic messages.
- * install-sh, mkinstalldirs: New versions; taken from texinfo CVS.
+ * src/preproc/tbl/main.cpp (process_options, process_format):
+ * src/preproc/tbl/table.cpp (table::add_entry): Align diagnostic
+ text with terminology now used in tbl(1) man page.
+ - "global option" -> "region option"
+ - "specifier" -> "column modifier"
+ - "format" -> "column classifier"
-2005-09-04 Jörgen Grahn <jgrahn@algonet.se>
+2021-11-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_ms.man: Document `PO' better.
+ [libgroff]: Fix missing colon in diagnostic messages.
-2005-09-03 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+ Restore missing colon to diagnostic text. Problem introduced by
+ me in commit 9a038161, 8 November.
- * NEWS: Document grotty changes.
+2021-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-09-01 Keith Marshall <keith.d.marshall@ntlworld.com>
+ [libgroff,grops]: Slightly refactor.
- Backward compatibility support for `man' program.
+ * src/devices/grops/ps.cpp: Explicitly preprocessor-include
+ "lib.h" since we use the `PI` symbol it defines.
- * tmac/an-old.tmac (LL): Initialize it to respect prior LL register
- assignment, prior `.ll' request and then package defaults, in this
- specified order of decreasing priority.
+ * src/include/lib.h: Add inclusion guard. Wrap only `extern "C"
+ and its braces in preprocessor conditionals, so that prototypes
+ are present in the header even for C language code that
+ #includes this header. Add `static` storage class to `PI`
+ symbol to avoid redefinition errors from the linker.
- * tmac/groff_man.man, doc/groff.texinfo (Man options): Document
- altered `LL' register initialization priorities.
+ * src/libs/libgroff/iftoa.c (if_to_a):
+ * src/libs/libgroff/itoa.c (i_to_a, ui_to_a): Add `const` type
+ qualifier to function definitions for agreement with prototypes
+ in "lib.h". Drop local copies of prototypes.
-2005-08-29 Gary W. Swearingen <garys@opusnet.com>
+2021-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_mdoc.man: Go into more details how the `AUTHORS'
- section should look like.
+ [libgroff]: Centralize definitions of {U,}INT_DIGITS.
-2005-08-29 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/iftoa.c:
+ * src/libs/libgroff/itoa.c: Move definitions of `INT_DIGITS` and
+ `UINT_DIGITS` from here...
+ * src/include/lib.h: ...to here.
- * tmac/groff_mdoc.man: The month's name in a call to .Dd shouldn't
- be abbreviated.
+ * src/libs/libgroff/iftoa.c:
+ * src/libs/libgroff/itoa.c: Preprocessor-include "lib.h". This
+ revealed missing guards around `extern "C"` declarations, so...
-2005-08-27 Bernd Warken
+ * src/include/lib.h: Add them where necessary.
- * tmac/groff_man.man: Add man(7) too SEE ALSO and more minor
- fixes.
+2021-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-08-11 Bernd Warken
+ * tmac/an.tmac (OP): Fix code style nits. Don't quote macro
+ arguments unnecessarily. Use consistent backslashing. Use
+ groff font escape sequence syntax. Use adjustable non-breaking
+ space escape sequence instead of a non-adjustable one.
+ Parenthesize numeric expression for better readability.
- * tmac/www.tmac (URL, MTO): Handle empty \\$1 better.
+2021-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-08-09 Bernd Warken
+ [libgroff]: Make allocator replacement optional. Switch it
+ off by default, relying on C++ runtime new/delete support.
- * tmac/www.tmac (URL, MTO): Use bold series if color support is
- deactivated.
+ * configure.ac: Call new `GROFF_USE_GROFF_ALLOCATOR` m4 macro.
+ Use `AM_CONDITIONAL` to set Automake variable
+ `USE_GROFF_ALLOCATOR` if appropriate. Report whether the
+ allocator is used in configure script output summary.
+ * m4/groff.m4 (GROFF_USE_GROFF_ALLOCATOR): Define new macro to
+ collect user preference. The default is off.
+ * src/libs/libgroff/libgroff.am (libgroff_a_SOURCES): Build and
+ link new.cpp only if we are to `USE_GROFF_ALLOCATOR`.
-2005-08-02 Bernd Warken
+ * NEWS: Add item.
- * doc/Makefile.sub (uninstall_sub): Use --remove, not --delete
- as argument to $(INSTALL_INFO). The latter isn't portable.
- Remove $(HTMLEXAMPLEFILES) too.
+2021-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in (uninstall_dirs): Remove $(datadir)/doc/groff and
- $(datadir)/doc too.
- Suppress warning messages and return always true.
+ * m4/groff.m4 (GROFF_TMAC): Report a human-readable message if
+ no system tmac prefix is found, instead of leaving the ellipsis
+ hanging.
- * tmac/Makefile.sub (uninstall_sub): Remove www.tmac too.
+2021-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-07-02 Bernd Warken
+ * m4/groff.m4 (GROFF_TMAC): Use separate shell variable for
+ `AC_MSG_RESULT()` content since the human-readable string we
+ populate it with in the empty case is not appropriate for later
+ `AC_SUBST()`-itution. Problem introduced by me in commit
+ 19670348, 31 October.
- * src/devices/xditview/gxditview.man: Change many `.I' to `.B'.
- * man/groff_out.man: More markup and minor improvements.
- * src/roff/groff/groff.man: Minor improvements.
+2021-11-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-06-28 Werner LEMBERG <wl@gnu.org>
+ * tmac/tmac.am (MOSTLYCLEANFILES): Remove `$(TMACMDOCFILES)`.
+ This variable, formerly named `TMACMDOCSTRIPFILES`, should not
+ be used in a clean target because its contents are (no longer)
+ generated files. Problem introduced by me in commit 24602f42, 4
+ July (only noticeable in within-source-tree builds).
- * ChangeLog: Split off older entries into...
- * ChangeLog.115 ChangeLog.116, ChangeLog.117, ChangeLog.118: New
- files.
+2021-11-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-06-26 Bernd Warken
+ [libgroff,pic]: Check `strdup()` return value.
- * src/devices/xditview/gxditview.man: More minor fixes.
+ * src/libs/libgroff/font.cpp (struct text_file): Add `fatal()`
+ member function.
+ (text_file::fatal): Implement it.
-2005-06-24 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/font.cpp (font::load_desc):
+ * src/preproc/pic/troff.cpp (troff_output::set_location): Die if
+ `strdup()` returned a null pointer.
- * src/preproc/pic/troff.cpp (troff_output::set_fill,
- troff_output::set_color, troff_output::reset_color): Use .bcolor and
- .fcolor instead of \m and \M, respectively.
+2021-11-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-06-23 Bernd Warken
+ * src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+ Revise to eliminate `fprintf()` calls, which might perform
+ dynamic memory allocation, rendering this function unsafe to
+ call after memory allocation failures. Since this function is
+ near the top of our diagnostic output call stack, that would be
+ unfortunate. `errprint()` does not use dynamic allocation, nor
+ do the `i_to_a()` and `ui_to_a()` functions it calls to format
+ integers.
- * src/devices/xditview/gxditview.man: More minor fixes.
- * README: Formatting issues.
- Mention some problems with Debian.
+2021-11-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-06-23 Bernd Warken
+ * configure.ac: Add `strdup` to AC_CHECK_FUNCS since we are
+ using it and the whole point of libgroff's `strsave()` was to
+ get along without it. But `strdup` has been standardized in
+ POSIX for 20 years (SUSv3, POSIX:2001) and is on its way into
+ ISO standard C (N2353) and C++ (P2391R0) as well.
- * src/devices/xditview/gxditview.man: Revised and improved.
+2021-11-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-06-22 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/strsave.cpp (strsave): Call `strcpy()` only
+ if `malloc()` did not return a null pointer. Problem noted by
+ Ingo Schwarze.
- Another round in fixing getopt problems. Hopefully the last one!
- This time we use the getopt stuff from gnulib and define a prefix
- unconditionally so that there are no collisions with any other
- getopt implementations. This is a slight waste of space in case
- we already use a GNU getopt implementation, but on
- the other hand it really simplifies life.
+2021-11-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/getopt.h: Use gnulib version.
+ * src/libs/libgroff/fontfile.cpp (font::open_file): Don't open
+ user-specified font file names with slashes in them; i.e., don't
+ traverse directories outside the configured font path. Also
+ refuse to open the file if the `sprintf()` used to construct its
+ file name doesn't write the expected quantity of bytes to the
+ destination buffer.
- * src/include/getopt_int.h: Use gnulib version.
+ Fixes <https://savannah.gnu.org/bugs/?61424>. Thanks to Ingo
+ Schwarze for feedback.
- * src/include/groff-getopt.h: Removed. Obsolete now.
+2021-11-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/lib.h: Regarding getopt, don't handle any platform
- specially; just include getopt.h.
- (__GETOPT_PREFIX): Define (before getopt.h).
+ [libgroff]: Regression-test Savannah #61424.
- * src/include/Makefile.sub (HDRS): Updated.
+ * src/roff/groff/tests/fp_should_not_traverse_directories.sh: Do
+ it.
+ * src/roff/groff/tests/artifacts/HONEYPOT: Add test artifact.
+ * src/roff/groff/tests/artifacts/devascii/README: ...and this;
+ we need a directory to make the test work but empty ones tend to
+ look unintentional.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+ (EXTRA_DIST): Ship artifacts.
- * src/libs/libgroff/getopt1.c, src/libs/libgroff/getopt.c: Use
- gnulib version.
+2021-11-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/Makefile.sub (EXTRA_CFLAGS): Set
- __GETOPT_PREFIX.
+ [libgroff]: Fix diagnostic error wording.
- * src/utils/pfbtops/pfbtops.c, src/utils/xtotroff/xtotroff.c
- (__GETOPT_PREFIX): Define (before getopt.h).
+ * src/libs/libgroff/font.cpp (font::load): Fix diagnostic
+ message; this is issued when an unrecognized directive is
+ encountered, so it necessarily occurs _before_ any `charset` or
+ `kernpairs` directive. Give the user a hint accordingly.
-2005-06-21 Werner LEMBERG <wl@gnu.org>
+2021-11-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/lib.h: Provide a fix for Mac OS X to not include
- groff-getopt.h.
+ [man]: Fix paragraph tag regressions.
-2005-06-20 Denis M. Wilson <dmw@oxytropis.plus.com>
+ * tmac/an-ext.mac (UR, MR): Only create an environment and
+ diversion if we're not already in one of the latter. If we are
+ {in groff man, this occurs only when collecting a `TP` paragraph
+ tag}, then typeset the URI as part of the indented paragraph.
+ (UE, ME): Pop the diversion and environment stacks only if we
+ pushed them in the first place. Eliminate spurious space in
+ post-URI arguments by only typesetting excess macro parameters
+ if there were any.
- * font/devps/prologue.ps (EP): Dont' use `bind'. Reason: Using
- `bind' to define a procedure which contains `showpage' means that an
- invocation of `showpage' may execute wrongly (the exact effect
- depending on the interpreter). Not usually a problem except under
- transformations, such as combining pages.
- (PEND): Don't call `clear'. Reason: Using `clear' in the definition
- of /PEND means that stack underflow will occur if the stack is
- deliberately non-empty before document inclusion. If included
- files are found to be generally badly behaved, we could replace the
- `clear' with `mark' in /PBEGIN and `cleartomark' in /PEND (I've
- never found this necessary).
+2021-11-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-06-20 Jörgen Grahn <jgrahn@algonet.se>
+ [man]: Regression-test Savannah #61425.
- * src/preproc/soelim/soelim.cpp (do_file): Append trailing zero
- earlier to get correct error message.
+ * tmac/tests/an-ext_link-macros-work-in-paragraph-tags.sh: Do
+ it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2005-06-16 Bernd Warken
- * src/roff/nroff/nroff.sh: Add support for iso-8859-15.
+2021-11-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-06-15 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (DS): Drop a redundant unconditional break; every
+ display macro we call in the event of a valid call already
+ breaks the line, and it's polite to not break if we're given an
+ invalid argument. Emit a diagnostic error if the argument we're
+ given is invalid, and immediately end the diversion we just
+ opened.
+
+2021-11-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/env.cpp (environment::set_font): Clarify
+ diagnostic warning.
- Another try to update getopt files. This time we add a dummy
- gettext.h file to satisfy the dependency.
+2021-11-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/getopt.h, src/libs/libgroff/getopt.c,
- src/libs/libgroff/getopt1.c: Updated from GNU libc CVS.
+ * src/preproc/tbl/table.cpp (table::add_entry): If we see a '\^'
+ entry on the first row of a table, it's invalid, but we need to
+ create an empty entry in its place. Otherwise, someone can put
+ another '\^' right below the one on the first row, creating a
+ reference to a nonexistent table entry and provoking a SEGV.
+ Issue an error diagnostic (distinct from the one in
+ `do_vspan()`), create the entry, and skip `do_vspan()` (given a
+ '^' in a first-row definition, it issues an error diagnostic and
+ returns early, which suffices). Problem appears to date back to
+ groff 1.02 (June 1991) at the latest.
- * src/include/getopt_int.h: New file (from GNU libc CVS).
+ Fixes <https://savannah.gnu.org/bugs/?61417>.
- * src/include/gettext.h: Dummy file which just defines a gettext()
- macro.
+2021-11-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/groff-getopt.h: Updated.
+ [tbl]: Regression-test Savannah #61417.
- * src/include/Makefile.sub (HDRS): Add getopt_int.h and gettext.h.
+ * src/preproc/tbl/tests/\
+ do-not-segv-on-invalid-vertical-span-entry.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+2021-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/input.cpp (IntArray): Remove superfluous
- `const' keywords in return value.
+ [man]: Fix Savannah #61408.
- * src/preproc/html/pushback.cpp (pushBackBuffer::~pushBackBuffer):
- Remove redundant variable `old'.
- (pushBackBuffer::skipToNewline): Remove redundant variable `ch'.
+ * tmac/an.tmac (an-prepare-inner-footer): Don't try to get a
+ substring of an empty string; the man page author might not have
+ specified a third argument to `TH` (or supplied an empty one).
- * src/preproc/tbl/main.cpp (process_table): Remove redundant
- variable `c'.
+ Fixes <https://savannah.gnu.org/bugs/?61408>. Thanks to Bjarni
+ Ingi Gislason for the report.
+2021-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- Fix more friend name injection problems since modern C++ compilers
- fail otherwise. We simply provide (global) declarations for all
- functions declared as friends. This is not really necessary but
- doesn't harm.
+ [man]: Add regression test for Savannah #61408.
- * src/preproc/eqn/lex.cpp: Provide declarations for get_char,
- peek_char, and get_location.
+ * tmac/tests/an_inner-footer-abbreviation-works.sh: Do it.
- * src/preproc/refer/ref.h: Provide declarations for
- compare_reference, same_reference, same_year, same_date,
- same_author_last_name, and same_author_name.
+2021-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/div.h: Provide declarations for do_divert and
- page_offset.
+ [man]: Tweak computation in URI breaking.
- * src/roff/troff/env.h: Provide declarations for title_length,
- space_size, fill, no_fill, adjust, no_adjust, center, right_justify,
- vertical_spacing, post_vertical_spacing, line_spacing, line_length,
- indent, temporary_indent, do_underline, do_input_trap, set_tabs,
- margin_character, no_number, number_lines, leader_character,
- tab_character, hyphenate_request, no_hyphenate,
- hyphen_line_max_request, hyphenation_space_request,
- hyphenation_margin_request, line_width, tabs_save, tabs_restore,
- line_tabs_request, widow_control_request, and do_divert.
+ * tmac/an-ext.tmac (UE, ME): Stop adding the page offset `.o`
+ when performing the available horizontal space computation for
+ the typeset URI string. This made no difference on nroff
+ devices (grotty; even with `.po 15n`), but it caused the
+ breaking decision to be too conservative on troff devices
+ {grops}, forcing some URIs that would fit on the current line to
+ the next one.
- * src/roff/troff/input.cpp: Provide declaration for chop_macro.
+ * tmac/tests/an-ext_UE-breaks-before-long-URIs.sh: Add test of
+ URI with no link text, which also has break points after every
+ character, so that we detect even slight alterations.
- * src/roff/troff/node.cpp: Provide declarations for class
- tfont_spec.
- Provide declaration for make_tfont.
+2021-11-02 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-05-29 Werner LEMBERG <wl@gnu.org>
+ [libgroff]: Do more device and font description file validation,
+ resolve an assertion failure arising from a negative declared
+ device resolution, and correct a documentation error.
- * doc/fdl.texi: Updated to version 1.2. Reported by Bernd Warken.
+ * src/libs/libgroff/font.cpp (font::load): Include more
+ information about invalid input in diagnostic messages.
+ - When a kern pair's amount is missing or invalid, report the
+ name of the kern pair.
+ - When someone tries to declare the first entry in the charset
+ section as an alias, report the glyph name.
+ - Identify the token for the unnamed character if an attempt
+ is made to alias it.
+ - When an out-of-range character type is applied to a glyph,
+ name the glyph.
+ (font::load_desc): Same.
+ - Drop redundant zero initialization of `res`.
+ - Check all directives that take basic units for positive
+ values, adding `res`, `unitwidth`, `paperwidth`, and
+ `paperlength`. Update this diagnostic to demand positive,
+ not nonnegative, values.
+ - When the font count is long in a `fonts` directive, report
+ how many font names were declared (and thus expected). (If
+ the count is short, the next line is read for a font name,
+ like 'tcommand' in our devutf8/DESC.)
+ - When interpreting a `papersize` directive, throw an error
+ and return false if `res` has not yet been encountered,
+ since it is used in subsequent computations.
+ - When a paper format cannot be determined, report the
+ original declared value from the DESC file. Use `strdup()`
+ to save it since it gets clobbered by the resolving process.
+ `free()` the saved string when we're done, regardless of
+ error condition.
+
+ * doc/groff.texi (Device and Font Files):
+ * man/groff_font.5.man (DESC file format): Document additional
+ exception to order-indifference of directives: (at least one)
+ `res` must precede `papersize`.
+
+ Fixes <https://savannah.gnu.org/bugs/?61414>.
+
+2021-11-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-05-28 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grohtml/post-html.cpp
+ (html_printer::do_file_components): Add assertion.
- * src/devices/grolbp/lbp.cpp, src/devices/grolbp/lbp.h: Remove
- redundant semicolons.
+2021-11-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/Makefile.sub, src/preproc/html/Makefile.sub,
- src/preproc/soelim/Makefile.sub, src/preproc/tbl/Makefile.sub:
- Define `MLIB'. Some compilers need this for linking with libgroff.
+ * src/devices/grops/ps.cpp (usage): Document -p and --version
+ options.
-2005-05-27 Werner LEMBERG <wl@gnu.org>
+2021-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * MANIFEST, README, doc/webpage.ms: Updated.
+ * tmac/mdoc/doc-nroff (doc-setup-page-layout): Set the title
+ length to the device line length (register `.l`) if register
+ `LT` is not defined. This keeps the title length from being set
+ to 78n when the line length is not, preventing the output from
+ looking silly.
-2005-05-26 Werner LEMBERG <wl@gnu.org>
+2021-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * All affected files: Update postal address of FSF.
+ * src/preproc/tbl/main.cpp (main): Emit groff code to define
+ macro `T&` as empty if it is not already defined. (All of our
+ full-service macro packages [except mdoc(7)] already do this, so
+ there's no change in semantics; mom(7) even defines it as an
+ empty _string_.)
-2005-05-25 Keith Marshall <keith.d.marshall@ntlworld.com>
- Bernd Warken
+2021-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * README: More fixes.
+ * src/roff/groff/tests/string_case_xform_requests.sh: Migrate
+ test to POSIX shell, dropping use of process substitution (a
+ Bashism). Also rewrite to stop using a here document within a
+ command substitution, mainly for paranoia.
- * README.CVS: Removed. Its contents is now part of the README file.
+ * src/roff/groff/tests/string_case_xform_requests.sh:
+ * src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh: Update
+ shebang lines to use /bin/sh as the interpreter.
-2005-05-21 Werner LEMBERG <wl@gnu.org>
+2021-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * README: Updated. Based on a patch from Bernd Warken.
+ * src/devices/grops/ps.cpp (encode_subfont): Update assertion to
+ check for `sub` parameter being a null pointer rather than
+ `sub->glyphs`; the latter is a member array of a `subencoding`
+ struct so it can't be a null pointer. (`glyphs` is an array of
+ pointers to `const char`; the _elements_ of the array can [and
+ are initialized to] be null pointers, but the address of the
+ array itself will never be in a C/C++ implementation.) Detected
+ by Clang 13's "-Wtautological-pointer-compare".
-2005-05-16 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- Miscellaneous script portability enhancements.
+ * src/libs/libgroff/new.cpp (delete): Declare `throw()` (no
+ exceptions thrown); quiets "-Wimplicit-exception-spec-mismatch"
+ from Clang 13.
- * aclocal.m4: (GROFF_CSH_HACK): Add space in shebang prototype for
- generated conftest.sh script, conforming to portability
- recommendation in autoconf docs.
- * configure: Likewise, for code generated by GROFF_CSH_HACK.
- * contrib/eqn2graph/eqn2graph.sh: Add space in shebang, conforming
- to portability recommendation in autoconf docs.
- * contrib/grap2graph/grap2graph.sh: Likewise.
- * contrib/pic2graph/pic2graph.sh: Likewise.
- * font/devps/generate/afmname: Likewise.
- * src/devices/xditview/ad2c: Likewise.
- * src/preproc/eqn/neqn.sh: Likewise.
- * src/roff/grog/grog.pl: Likewise.
- * src/roff/grog/grog.sh: Likewise.
- * src/roff/nroff/nroff.sh: Likewise.
- * PROBLEMS: Likewise, in embedded script examples.
+2021-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-05-16 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * m4/groff.m4: Fix messaging nits.
+ (GROFF_MAKEINFO): Set `missing` to "missing 'makeinfo'" for
+ consistency with other assignments to `missing`.
+ (GROFF_TMAC): Utter an intelligible result in the configure
+ check when no system macro files requiring groff wrapping are
+ located.
- Improve portability of `pdfroff' shell script.
+2021-10-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * arch/misc/shdeps.sh: Add space in shebang, conforming to
- portability guidelines in `autoconf' docs.
- (PATH_SEARCH_SETUP): New substitution; emits PATH_SEPARATOR
- initialization code. Used by contrib/pdfmark/pdfroff.sh's
- `searchpath' function.
+ [troff]: Handle special character escape sequences that map to
+ basic Latin glyphs in device control escape sequences
+ consistently among output devices.
-2005-05-14 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/input.cpp (encode_char): Rearrange
+ conditionals. This is the logic that puts the "whatever" within
+ a \X'whatever' escape sequence into GNU troff's intermediate
+ output. Handle adjustable and nonadjustable space escape
+ sequences ("\~" and \ ") first. Then, if the token is a special
+ character escape sequence, retrieve its "contents" (glyph name).
+ Move the basic Latin mapping for the seven glyph names '-',
+ 'aq', 'dq', 'ga', 'ha', 'rs', and 'ti' here, before checking
+ whether the device description issued the
+ 'use_charnames_in_special' directive. This way, the 'html' and
+ 'xhtml' output devices can straightforwardly embed these basic
+ Latin characters in device control escapes (notably, "html:",
+ for which the present convention is to follow the this tag
+ immediately with a literal HTML URI, complete with `<a href>`
+ element syntax). If the special character is none of these and
+ we should 'use_charnames_in_special', proceed as groff 1.22.4
+ and earlier did. This is a behavior change, as was my addition
+ of this translation mechanism in the first place, so...
- * contrib/pic2graph/pic2graph.sh, contrib/graph2graph.sh,
- contrib/eqn2graph.sh: Add option `-trim' to `convert' which is
- needed for newer ImageMagick versions.
+ * doc/groff.texi (Postprocessor Access): Document it.
-2005-05-07 Werner LEMBERG <wl@gnu.org>
+ * src/roff/groff/tests/\
+ device_control_escapes_express_basic_latin.sh: Test it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * src/preproc/refer/refer.man: Many small typographic fixes.
+ Fixes <https://savannah.gnu.org/bugs/?61401>.
-2005-05-06 Jeff Conrad <jeff_conrad@msn.com>
+2021-10-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp (assert_state::~assert_state):
- Use `char *' cast for a_delete.
+ [troff]: Map \[ti] correctly in device control escape sequences.
-2005-05-03 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/input.cpp (encode_char): Fix copy-and-paste
+ error. \[ti] should put '~', not '^', into a device control
+ command.
- * src/libs/libgroff/maxpathname.cpp: Include stdlib.h.
- src/libs/libgroff/relocate.cpp: Use path_name_max everywhere.
+ Fixes <https://savannah.gnu.org/bugs/?61403>; problem introduced
+ by me in commit 9d61b3d1, 1 October.
+
+2021-10-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Handle degenerate input quietly.
+
+ * tmac/an.tmac (TH): Define new register `an-TH-was-called`.
+ (an-end): Return immediately if that register is not defined;
+ to format the default page footer we must have the information
+ declared in a valid `TH` call. (`TH` also initializes the type
+ size and baseline spacing registers we use to prepare the page
+ footer environment.) If the register _is_ defined, remove it
+ just prior to the end of this macro definition, in preparation
+ for next page to be rendered.
+
+ * tmac/tests/an_handle-degenerate-input-quietly.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+ Fixes <https://savannah.gnu.org/bugs/61402>, a regression from
+ groff 1.22.4 (problem introduced by me in the course of many
+ changes to trap management and header/footer handling to work
+ nicely in batch rendering with -mandoc and mdoc(7) documents).
+
+2021-10-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Warn if `TE` table macro called but `TW` register (set by
+ tbl(1)) undefined. Arrange it so that we warn only once per
+ man(7) document, not per table region.
+
+ * tmac/an.tmac (TH): Remove `TW` register when processing new
+ document and clear `an-was-tbl-failure-reported` register.
+ (TE): Check `TW` and `an-was-tbl-failure-reported` registers; if
+ the former is undefined and the latter false, emit the message
+ and set `an-was-tbl-failure-reported`.
+
+ Addresses part of <https://savannah.gnu.org/bugs/?61379>.
+ Thanks to Bjarni Ingi Gislason for the suggestion.
+
+2021-10-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Improve portability.
+
+ * src/devices/grotty/tests/osc8_works.sh: Fix typo in test.
+ Multiple regex quantifiers after an atom were not flagged with a
+ diagnostic by GNU grep 3.3, but were by BSD grep 2.5.1-FreeBSD.
+
+ * src/roff/groff/tests/smoke-test_html_device.sh: Stop trying to
+ set $LC_CTYPE to "C.UTF-8"; some systems don't support this
+ expediency. Skip the test if the tester hasn't configured the
+ environment adequately.
+
+ * tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Fix
+ portability problems exposed by FreeBSD sed (which version is
+ unclear). {1} Use POSIX BREs, dropping use of '+' quantifier.
+ {2} Add semicolons to terminate commands before braces on the
+ same line. Simplify surrounding test structure.
+ * tmac/tests/e_footnotes-work-with-columns.sh: Fix same two sed
+ problems.
+ * tmac/tests/andoc_flush-between-packages.sh:
+ * tmac/tests/doc_accept-mixed-case-section-headings.sh:
+ * tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Fix same
+ sed semicolon problem.
+
+ * src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh: Rewrite
+ test to stop using a here document (containing an unpaired
+ single quote) inside a command substitution, which is broken in
+ GNU Bash 3.2 and some other versions. Instead construct the
+ input with printf(1). Also gets rid of a Bashism (process
+ substitution) that Ingo pointed out years ago.
+ * src/utils/grog/tests/recognize-perl-pod.sh: Same problem,
+ different solution. The Perl POD output is far too large to
+ construct programmatically, so move it into an external file...
+ * src/utils/grog/tests/foo.man: ...here.
+ * src/utils/grog/grog.am (EXTRA_DIST): Ship new test artifact.
-2005-05-03 Jeff Conrad <jeff_conrad@msn.com>
+2021-10-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp: Use casts to `char *' if using
- `a_delete' for `const char *'.
+ * doc/doc.am: Make sed-based insertion of `lf` requests more
+ portable: a dance is required to embed a literal newline inside
+ a sed expression inside a shell command executed as part of a
+ Make target rule. We assume that neither the POSIX shell $''
+ operator nor a working printf(1) is available.
+ (DOC_GROFF): Define a shell variable containing a literal
+ newline, evading make(1) and echo(1)'s valiant attempts to
+ consume it.
+ (doc/pic.html, doc/webpage.html): Repeat trick, slightly
+ modified since the dependency needs to be manually identified.
-2005-05-03 Werner LEMBERG <wl@gnu.org>
+ Solution adapted from the GNU Autoconf manual, "Newlines in Make
+ Rules".
- * src/devices/grohtml/post-html.cpp,
- src/devices/grohtml/html-table.cpp,
- src/devices/grohtml/html-text.cpp, src/devices/grohtml/output.cpp:
- Replace malloc/free with new/delete/a_delete.
+ Fixes <https://savannah.gnu.org/bugs/?61265>. Thanks to John
+ Gardner for the report.
- * src/devices/grolbp/lbp.h: Remove superfluous semicolons which
- are prohibited with ANSI C++.
- (lbpprintf, vdmprintf): Remove useless `inline' keyword (since the
- function has a variable number of arguments).
+2021-10-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/grn/main.cpp (doinput): Change return type to `int'.
- Simplify function and update all callers.
+ * tmac/an.tmac (TH): Stop populating `an-extra3` (the default
+ center header) if the section argument is "3p". "3p" does not
+ always mean a Perl-related man page; Debian- and Arch
+ Linux-based systems[1][2] (at least) have long used a "3perl"
+ suffix, while OpenBSD appears to still use "3p" for Perl[3],
+ which is also used by the POSIX man page distribution[4].
+ Fortunately, Perl and POSIX are reliable at providing a fifth
+ argument to `TH` anyway, so our fallback is as unnecessary as it
+ is non-impartial.
+ * tmac/groff_man.7.man.in (Document structure macros) <TH>:
+ De-document the above behavior.
-2005-05-02 Werner LEMBERG <wl@gnu.org>
+ [1] https://manpages.debian.org/bullseye/perl-doc/\
+ Pod::Man.3perl.en.html
+ [2] https://man.archlinux.org/man/Pod::Man.3perl
+ [3] https://man.openbsd.org/man3p/Pod::Man.3p
+ [4] https://man7.org/linux/man-pages/man3/system.3p.html
- Undo getopt changes from 2005-04-30. We don't want a dependency
- on gettext.
+2021-10-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/getopt_int.h: Removed.
+ [man]: Abbreviate the inside footer if necessary.
- * src/include/getopt.h, src/include/groff-getopt.h,
- src/include/Makefile.sub, src/libs/libgroff/getopt.c,
- src/libs/libgroff/getopt1.c: Revert to previous version.
+ * tmac/an.tmac (an-prepare-inner-footer): Prevent the inside
+ footer from overrunning the center footer.
+ (BT): Use new string `an-ifoot` instead of `an-extra2` in page
+ footers.
+ Fixes <https://savannah.gnu.org/bugs/?61386>.
- * src/include/nonposix.h (access) [_MSC_VER]: New macro.
+2021-10-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/posix.h (F_OK): Define conditionally.
+ Add regression test for Savannah #61386.
- * src/devices/grotty/tty.cpp (tty_printer::make_underline): Use
- different variable name in second `for' loop to avoid MSVC compiler
- problem.
+ * tmac/tests/an_inner-footer-abbreviation-works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2005-04-30 Werner LEMBERG <wl@gnu.org>
+2021-10-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- AC_TYPE_SIGNAL from current autoconf can fail if CC=g++.
+ * man/groff_char.7.man (Description, Special character escape
+ forms): Document the `\C` escape sequence. Fix error: \[a] is
+ _not_ "translated to \a, the uninterpreted leader escape
+ sequence," but requests a glyph _named_ '\a' internally--it
+ appears thus in diagnostic messages and, importantly, in the
+ font description files defining special character glyph names.
- * aclocal.m4 (GROFF_TYPE_SIGNAL): New function.
- * configure.ac: Use GROFF_TYPE_SIGNAL, not AC_TYPE_SIGNAL.
- * configure, src/include/config.hin: Regenerated.
+2021-10-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac: Refactor to reduce repetition.
+ (an-break-paragraph): New macro handles paragraph-breaking tasks
+ previously duplicated.
+ (SH, SS, P, TP, IP, HP): Call it rather than issuing its
+ constituent requests.
- * PROBLEMS: Updated.
+2021-10-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+ * tmac/an.tmac (TP): Reset type size, vertical spacing, and font
+ to defaults before setting the new paragraph.
- Update getopt files.
+ Fixes <https://savannah.gnu.org/bugs/?61380>.
- * src/include/getopt.h, src/libs/libgroff/getopt.c,
- src/libs/libgroff/getopt1.c: Updated from GNU libc CVS.
+2021-10-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/getopt_int.h: New file (from GNU libc CVS).
+ * doc/groff.texi (Auto-increment): Fix error; the `\R` escape
+ sequence does _not_ support an auto-incrementation amount.
+ * man/groff_out.5.man (Command reference/Simple commands): Fix
+ erroneous claim: 'N' is not a GNU roff extension; it appears on
+ page 27 of CSTR#54 (1992).
- * src/include/groff-getopt.h: Updated.
+2021-10-24 Keith Marshall <keith.d.marshall@ntlworld.com>
- * src/include/Makefile.sub (HDRS): Add getopt_int.h.
+ [ms]: Provide global default XH and XN implementations.
+ cf. <https://savannah.gnu.org/bugs/?58946#comment13>
- * font/devutf8/NOTES: Updated.
+ * tmac/s.tmac (XH-INIT, XN-INIT, XH-UPDATE-TOC)
+ (XH, XN, XH-REPLACEMENT, XN-REPLACEMENT): Implement them, and...
+ * tmac/groff_ms.7.man: ...document them.
-2005-04-28 Werner LEMBERG <wl@gnu.org>
+2021-10-24 Keith Marshall <keith.d.marshall@ntlworld.com>
- Bug fix for Win32 relocatable code. Based on a patch from Keith
- Marshall.
+ [ms]: Fix misleading NH macro indentation.
- * src/libs/libgroff/maxpathname.cpp (PATH_MAX): Test for `_MAX_PATH'
- also.
+ * tmac/s.tmac (@NH) [.T is html]: .if statement should exhibit
+ same indentation as preceding .DEVTAG-NH statement, but is
+ overindented; fix it.
- * src/libs/libgroff/relocate.c (DEBUG): Define it conditionally.
- (searchpath) [_WIN32]: Use `_fullpath', not `realpath'.
+2021-10-23 Keith Marshall <keith.d.marshall@ntlworld.com>
-2005-04-28 Keith Marshall <keith.d.marshall@ntlworld.com>
+ [ms]: Defend against uncontrolled page trap recursion.
- Correct `gnu.eps' handling for build from distribution tarball, with
- separate source and build directories.
+ * tmac/s.tmac (pg@top) [HM+FM+.V>.p]: Diagnose insufficient page
+ length, and abort; cf. <https://savannah.gnu.org/bugs/?61294>
- * doc/Makefile.sub: (examples.stamp): New target; forces copy of
- grnexmpl.g, groff.css and gnu.eps from source to build directory;
- generate gnu.eps from gnu.xpm if required; touch examples.stamp.
- (prepare_examples): Make it depend on examples.stamp.
- (CLEANADD): Add examples.stamp.
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-04-27 Werner LEMBERG <wl@gnu.org>
+ [groff]: Fix code style nits.
- Implement the rule
+ * src/roff/groff/groff.cpp (main, help): Use standard C library
+ preprocessor symbols `EXIT_SUCCESS` and `EXIT_FAILURE` instead
+ of 0 and 1 literals, respectively. See commit fa4c27e9, 7
+ September.
+ (main): Replace `assert(0)` with a communicative predicate.
- position: `(' position `)'
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- in pic.
+ * src/devices/grotty/tty.cpp (tty_printer::special_link):
+ Eliminate casts by retyping `uri` and `pair` to pointers to
+ `const char`s.
- * src/preproc/pic/pic.y (position, position_not_place): Handle
- additional parentheses.
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/pic.ms: Updated.
+ * tmac/tmac.am: Build more quietly.
+ (tmac/stamp-wrap): Prefix all rule commands with `$(AM_V_at)`;
+ since this target is a stamp file instead of a useful artifact
+ to be distributed, make its creation completely silent by
+ default.
-2005-04-23 Larry Jones <lawrence.jones@ugs.com>
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/xtotroff/xtotroff.c (MapFont): Fix variable declaration.
+ * src/roff/troff/troff.am: Build more robustly.
+ (src/roff/troff/majorminor.cpp): Drop progress-reporting `echo`
+ in favor of prefixing final rule command with `$(AM_V_GEN)`.
+ Prefix earlier rule commands with `$(AM_V_at)`. Use `printf`
+ instead of `echo` to build the file, and create a temporary file
+ at first so that we don't race with the compiler on parallelized
+ builds.
-2005-04-18 Werner LEMBERG <wl@gnu.org>
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/pipeline.c: Don't include ctype.h.
+ * src/preproc/eqn/eqn.am (neqn): Simplify: drop removal of
+ target prior to overwriting it; any system we can build groff on
+ should have a shell that implements the clobbering semantics of
+ the POSIX shell '>' operator. (If this isn't true, we have
+ _many_ other target rules in our build to which we must add
+ prefatory `$(RM)`s, or I miss my guess.)
-2005-04-13 Werner LEMBERG <wl@gnu.org>
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/nroff/nroff.man: Document option `-M'.
+ * src/libs/libgroff/libgroff.am: Build more quietly and
+ robustly.
+ (src/libs/libgroff/version.cpp): Drop progress-reporting `echo`
+ in favor of prefixing final rule command with `$(AM_V_GEN)`.
+ Prefix earlier rule commands with `$(AM_V_at)`. Use `printf`
+ instead of `echo` to build the file, and create a temporary file
+ at first so that we don't race with the compiler on parallelized
+ builds. Drop nilpotent sed transformation; this looks like a
+ relic of past times when we'd drop a trailing ".0" from the
+ version number stored in the C symbol `Version_string`.
+ (charset.alias, ref-del.sed, ref-add.sed): Prefix rule command
+ with `$(AM_V_GEN)`.
-2005-04-13 Bruce Lilly <blilly@erols.com>
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/nroff/nroff.sh: Make the script accept option `-M'.
+ * src/devices/xditview/xditview.am: Build more quietly.
+ (src/devices/xditview/GXditview-ad.h): Drop progress-reporting
+ `echo` in favor of prefixing rule command with `$(AM_V_GEN)`.
-2005-04-01 Kees Zeelenberg <kzlg@users.sourceforge.net>
- Werner LEMBERG <wl@gnu.org>
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add binary relocation support for Windows platforms.
+ * font/devpdf/devpdf.am: Build more quietly.
+ (font/devpdf/enc/text.enc, font/devpdf/map/symbolmap,
+ $(DEVPDFFONTMAP_1)): Prefix all rule commands with
+ `$(AM_V_at)`; since these are all `mkdir`s and `cp`s, I reason
+ that little can go wrong with them that won't be disclosed by
+ these tools' own diagnostic messages, so they are insignificant
+ from a perspective of build progress.
- * src/include/Makefile.sub (defs.h): Add `INSTALLPATH'.
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/doc.am: Build more quietly.
+ (doc/examples.stamp): Prefix all rule commands with
+ `$(AM_V_at)`; since this target is a stamp file instead of
+ a useful artifact to be distributed, make its creation
+ completely silent by default.
+ (doc/groff.info, .texi.txt): Prefix directory creation with
+ `$(AM_V_at)` and `makeinfo` command with `$(AM_V_GEN)`.
+ (.texi.dvi, .texi.pdf): Prefix directory creation with
+ `$(AM_V_at)` and `makeinfo` command with `$(AM_V_GEN)`. Send
+ diagnostic message to standard error if `texi2dvi` is
+ unavailable.
+ (.texi.html): Prefix directory creation with
+ `$(AM_V_at)`. Two HTML versions are produced, in split and
+ unsplit versions; prefix one `makeinfo` command with
+ `$(AM_V_GEN)` and the other with `$(AM_V_at)` so that only one
+ message is produced.
+ (gnu.eps): Drop useless/noisy `echo` command. Prefix copy
+ operation with `$(AM_V_at)`. Send diagnostic messages to
+ standard error if there are problems with the Netpbm tools.
+
+ (MOSTLYCLEANFILES): The `mostlyclean` target was leaving a file,
+ `groff.info-3`, behind in the build tree. At some point our
+ Texinfo manual grew beyond earlier expectations. Use a glob
+ `[0-9]` instead (giving a hostage to fortune that `makeinfo`
+ will never split our manual into more than nine chunks).
+
+2021-10-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * arch/misc/misc.am:
+ (arch_shdeps_sh): Pull file name into a new variable.
+ (EXTRA_DIST, shdeps.sed): Use it.
+ (shdeps.sed): Build more quietly; prefix with `$(AM_GEN_V)`.
+
+2021-10-20 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [nroff]: Support groff's -R flag to run refer(1).
+
+ There's no reason not to support calling `refer` with nroff-mode
+ documents; typographically, it's less demanding than tbl(1).
+ GNU troff(1) supports an incompatible `-R` flag to suppress the
+ reading of troffrc{,-end} files, but this is likely not the `-R`
+ that users will want--it is most useful for troubleshooting
+ troff, and nroff already unconditionally loads a macro file
+ {tty-char.tmac}.
+
+ * src/roff/nroff/nroff.sh: Do it.
+
+ * src/roff/nroff/nroff.1.man:
+ * NEWS: Document it.
- * src/include/relocate.h, src/libs/libgroff/relocate.cpp: New files.
+2021-10-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/searchpath.cpp: Handle `relocate'.
- (search_path::search_path, search_path::open_file_cautious): Use
- `relocate'.
+ * tmac/tmac.am (tmac/groff_man.7.man)
+ (tmac/groff_man_style.7.man): Be quieter by default; use
+ $(AM_V_GEN) more consistently with the rest of the build.
- * src/libs/libgroff/Makefile.sub (OBJS, CCSRCS),
- src/include/Makefile.sub (HDRS): Updated.
+2021-10-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-04-01 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/input.cpp (do_error): Format diagnostic
+ messages in closer alignment with GNU Coding Standards: don't
+ introduce a space between the program name and the input file
+ name.
- * src/devices/grohtml/post-html.cpp: Don't use strdup/free but
- strsave/a_delete.
+ * src/roff/groff/tests/string_case_xform_errors.sh: Update
+ expected output.
+
+2021-10-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/env.cpp (distribute_space): Revert an
+ `assert()` I added in commit b93eacd8d7 (5 September); we can
+ indeed reach this code with a negative amount of desired space,
+ and in fact the "show hyphenation points" trick
+ <https://froude.eu/groff/examples/hyphenation-points.html>
+ relies upon it. Add explanatory comment.
+
+ Fixes <https://savannah.gnu.org/bugs/?61348>.
+
+2021-10-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * test-groff.in: Add support for sboxes.tmac.
+
+2021-10-11 Paul Eggert <eggert@cs.ucla.edu>
+
+ Include <config.h> before any standard headers.
- * src/libs/libgroff/font.cpp: Replace strdup with strsave.
+ Gnulib requires that files that might use Gnulib features (which
+ pretty much means every C or C++ source file) must include
+ <config.h> first. Arrange for that. This will be needed once
+ Groff updates to the latest Gnulib; see Bjarni Ingi Gislason's
+ problem report in:
+ <https://lists.gnu.org/r/bug-gnulib/2021-10/msg00008.html>
- * src/libs/libgroff/maxfilename.cpp: Don't include limits.h since
- lib.h already does it.
+ The only exception I can see is src/utils/addftinfo/guess.cpp,
+ which does not include any standard include file either directly
+ or indirectly, and so need not include <config.h>.
- * src/libs/libgroff/maxpathname.cpp: New file, defining
- path_name_max.
+ * src/devices/xditview/Dvi.c:
+ * src/devices/xditview/font.c:
+ * src/devices/xditview/lex.c:
+ * src/devices/xditview/page.c:
+ * src/devices/xditview/parse.c:
+ * src/libs/libbib/map.c:
+ * src/libs/libgroff/change_lf.cpp:
+ * src/libs/libgroff/cmap.cpp:
+ * src/libs/libgroff/cset.cpp:
+ * src/libs/libgroff/fmod.c:
+ * src/libs/libgroff/getcwd.c:
+ * src/libs/libgroff/lf.cpp:
+ * src/libs/libgroff/ptable.cpp:
+ * src/libs/libgroff/quotearg.c:
+ * src/libs/libxutil/DviChar.c:
+ * src/libs/libxutil/XFontName.c:
+ * src/libs/libxutil/xmalloc.c:
+ * src/utils/indxbib/signal.c: Do it.
- * src/include/lib.h: Add prototype for path_name_max.
+ [Fixes <https://savannah.gnu.org/bugs/?61315>. --GBR]
- * src/libs/libgroff/Makefile.sub (OBJS, CCSRCS): Updated.
+2021-10-10 Deri James <deri@chuzzlewit.myzen.co.uk>
- * src/include/nonposix.h (PATH_EXT): New macro.
+ Handle pdfs > v1.4 loaded by \X'pdf: pdfpic'.
-2005-03-28 Werner LEMBERG <wl@gnu.org>
+ * src/devices/gropdf/gropdf.pl: Improve loading of pdfs above
+ version 1.4, i.e. handle compressed nodes in /ObjStm. Also
+ improve code in \X'pdf: import'.
- Add support for double- and zero-width characters in grotty.
+2021-10-10 Deri James <deri@chuzzlewit.myzen.co.uk>
+
+ Add new background boxes to gropdf.
+
+ * src/devices/gropdf/gropdf.pl: New \X'pdf: background' command.
+ * tmac/pdf.tmac: Covenience command .pdfbackground added.
+ * contrib/sboxes/: Files which demonstrate use of background
+ boxes using -ms macros.
+
+2021-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tests]: Fix portability problems in 2 tests.
+
+ * src/roff/groff/tests/break_zero-length_output_line_sanely.sh:
+ * tmac/tests/s_PN-works.sh: Migrate from `echo` to `printf` for
+ test inputs containing backslashes to be interpreted literally.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?61302>. Thanks to
+ Deri James for identifying the problem.
+
+2021-10-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grotty]: Slightly refactor.
- * src/devices/grotty/tty.cpp (glyph): Add width.
- (tty_printer::make_underline, tty_printer::make_bold,
- tty_printer::add_character): Add parameter to pass character width.
- Update all callers.
- (tty_printer::end_page): Increase hpos by actual character width.
+ * src/devices/grotty/tty.cpp: Boolify. Demote numerous
+ variables (and one return type) from `int` to `bool`, use
+ Boolean instead of integer literals with them, and give the
+ variables names resembling logical predicates.
+ - horizontal_tab_flag -> want_horizontal_tabs
+ - form_feed_flag -> want_form_feeds
+ - bold_flag_option -> want_emboldening_by_overstriking
+ - bold_flag -> do_bold
+ - underline_flag_option -> want_italics_by_underlining
+ - underline_flag -> do_underline
+ - overstrike_flag -> want_glyph_composition_by_overstriking
+ - draw_flag -> allow_drawing_commands
+ - italic_flag_option -> want_sgr_italics
+ - italic_flag -> do_sgr_italics
+ - reverse_flag_option -> want_reverse_video_for_italics
+ - reverse_flag -> do_reverse_video
+ - old_drawing_scheme -> use_overstriking_drawing_scheme
+ (class tty_printer:printer): Similarly.
+ - is_underline -> is_underlining
+ - is_bold -> is_boldfacing
+ - cu_flag -> is_continuously_underlining
+ (tty_printer::tty_color): Demote return type as above. Invert
+ its sense; rename `unknown_color` to `is_known_color`.
+ (tty_printer::color_to_idx): Invert sense of test at
+ `tty_color()` call site.
- * font/devutf8/R.proto: Specify zero width for non-spacing
- characters.
+2021-10-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/unicode.tmac: Remove definitions for non-spacing entities.
+ [ms]: Finish documenting new `TC-MARGIN` register and
+ `TC-LEADER` special character.
- * Makefile.comm (extraclean): Remove more junk files.
+ Fixes <https://savannah.gnu.org/bugs/?61157>.
-2005-03-25 Werner LEMBERG <wl@gnu.org>
+2021-10-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure.ac: Undo change from 2005-03-24.
- * configure: Regenerated.
+ [grotty]: Slightly refactor.
+
+ * src/devices/grotty/tty.cpp (tty_printer::special_link): Use
+ consistent loop styles and drop unnecessary arithmetic.
-2005-03-24 Werner LEMBERG <wl@gnu.org>
+2021-10-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in (NOMAKEDIRS): Add contrib/gdiffmk/tests.
- (dist): Search Makefile while descending into $(EXTRADIRS).
+ [man]: Fix oversight and improve `MR` test.
+
+ * tmac/an-ext.tmac (initialization): Enable `mY` register to
+ indicate use of grotty(1) (and therefore OSC 8 support) if the
+ "ascii", "cp1047", or "latin1" output devices are used, not just
+ "utf8".
+
+ * tmac/tests/an_MR-works.sh: Drop copy-and-paste cruft from a
+ different test. Update expected output and check for the
+ presence of "link" device control subcommands, not just correct
+ font selections.
+
+2021-10-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Add `MR` macro for man page cross references.
+
+ * tmac/an.tmac (an-prepare-page-title): After a possibly
+ abbreviated man page title is determined, redefine `an-pageref`
+ to set the title portion in the font stored in the `MF` string
+ and bracket it with italic corrections if that font is thought
+ to be oblique.
+ (MR): Add macro to format the text of a man page cross
+ reference, and hyperlink it on HTML and terminal output devices
+ if permitted by the `U` register.
+ (initialization): Define `MF` string as `I` if not already set.
+ Define `an-lic` and `an-ic` strings as either empty or as
+ containing italic corrections.
- * doc/Makefile.in (.PHONY): Add.
- (clean): Don't remove *.png and *.eps.
- Don't handle *.gif.
- (realclean): Remove *.png and *.eps.
- (extraclean): Depend on distclean.
+ * tmac/an-ext.tmac (MR): If the formatter is not GNU troff,
+ define macro to format the text of a man page cross reference.
- * configure.ac: Add copyright.
- Handle contrib/pdfmark/Makefile.
+ * tmac/groff_man.7.man.in: Document it.
+ (Description): Add macro to summary table.
+ (Description/Hyperlink macros): Document new feature. Note
+ origin in Plan 9 troff. [style] Add examples of use.
+ (Description/Font style macros): Drop man page cross references
+ from list of items whose typeface conventions are disputed,
+ since we have a semantic macro now and a configurable means of
+ resolving the problem.
+ (History): Add `MR` item.
+ (Options) <MF>: Document new string.
+ (Files) <an-ext.tmac>: Revise discussion to accommodate `MR`.
+ (Authors): Add myself an author of extension macros.
- * configure: Regenerated.
+ * tmac/tests/an_MR-works.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+ * NEWS: Add item.
+
+2021-10-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-03-18 Larry Kollar <kollar@alltel.net>
+ * tmac/an.tmac (SH, SS): Invoke `ne` request _before_ performing
+ font remapping: any page-breaking decision will be taken before
+ the remapping happens, and so won't be in effect across a page
+ boundary, undesirably impacting header and footer text.
+
+ Fixes <https://savannah.gnu.org/bugs/?61279>.
+
+2021-10-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Regression-test Savannah #61279.
+
+ * tmac/tests/an_font-remapping-does-not-affect-titles.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-10-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an.tmac (an-abbreviate-title): Rename to...
+ (an-prepare-page-title): ...this.
+
+2021-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [docs]: Correct erroneous claim: the ".NH S" extension to ms(7)
+ comes from 4.2BSD, not GNU.
+
+2021-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add numbered and definition lists to www.tmac.
+ * doc/ms.ms (Creating a table of contents): Sync with recent
+ additions to groff_ms(7), expand, and heavily revise.
- * tmac/www.tmac (www-ul-level1, www-ul-level2, www-ul-level3,
- www-ol-level1, www-ol-level2, www-ol-level3, www-ol-tmp): New
- auxiliary string registers.
- (www-ul-level, www-ol-level, www-dl-level, www-ol-ctr1, www-ol-ctr2,
- www-ol-ctr3, www-dl-shift): New auxiliary number registers.
- (www-level): Removed.
- (www-level1, www-level2, www-level3): Initialize to empty.
- (www-level0, www-level4, www-level5, www-level6, www-level7,
- www-level8, www-level9): New string registers.
- (www-push-li, www-pop-li): New macros.
- (www-push-level, www-pop-level): Renamed to...
- (www-push-ul-level, www-pop-ul-level): This.
- Updated.
- (www-push-ol-level, www-pop-ol-level): New macros.
- (ULS, ULE): Updated.
- (OLS, OLE, DLS, DLE): New user macros.
- (LI): Removed. It is aliased to one of...
- (www-li-ul, www-li-ol, www-li-dl): New macros.
+2021-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_www.man: Document new macros.
+ [andoc,man,mdoc]: Fix Savannah #61266. Resolve problems in
+ batch rendering of man pages to PDF arising from entanglement
+ of end-of-input traps, page location traps, continuous rendering
+ mode, and andoc's reloading of the (m)an and (m)doc packages.
- * NEWS: Updated.
+ * tmac/andoc.tmac (reload-doc, reload-man): Remove end-of-input
+ traps alongside others.
-2005-03-18 Werner LEMBERG <wl@gnu.org>
+ * tmac/an.tmac (an-end): Only perform flush and "manual" page
+ footer placement if in continuous rendering mode, since this
+ macro is not only called by a trap placed only in continuous
+ rendering mode, but also by andoc when changing macro packages.
+ Unconditionally remove the `an-header` trap since the next
+ document might be using a different macro package.
+
+ * tmac/mdoc/doc-common: In initialization, set flag indicating
+ that manual header placement will be required.
+ (Dt): Call `doc-setup-header` (which sets up several types of
+ trap) unconditionally, and break the page if the vertical
+ drawing position is anywhere but at the top.
+ (Os): If the package has just been initialized, call
+ `doc-header` to force the page header to be written.
+ (doc-end-macro): Remove `doc-header` trap since the next
+ document might be using a different macro package. Break the
+ page. Set flag indicating that manual header placement will be
+ required for the next document.
+
+ * tmac/mdoc/doc-ditroff (doc-setup-header): Only set page
+ location traps for the header and footer if not continuously
+ rendering.
+ * tmac/mdoc/doc-nroff (doc-setup-header): Stop calling
+ `doc-header` here if continuously rendering. Emit an
+ unconditional break. Except for the location of the footer
+ trap, the `doc-setup-header` implementations are now identical.
+
+ Refactoring is needed: some macros and registers have misleading
+ names, there is some code duplication in mdoc, and some of the
+ trap management problems are solved in slightly different ways
+ in man(7) and mdoc(7), perhaps unnecessarily. We also need some
+ test scripts to protect us from regressions. But this fixes the
+ rendering problems.
+
+ Fixes <https://savannah.gnu.org/bugs/?61266>.
+
+2021-10-02 Keith Marshall <keith.d.marshall@ntlworld.com>
+
+ Correct manpage typo/inconsistency.
+
+ * tmac/groff_ms.7.man (TC_LEADER, TC_MARGIN): Correct; should
+ be...
+ (TC\-LEADER, TC\-MARGIN): ...respectively, for consistency
+ with...
+ * tmac/s.tmac (TC-LEADER, TC-MARGIN): ...these.
+
+2021-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc-common (doc-operating-system-NetBSD-2.0.1,
- doc-operating-system-NetBSD-2.0.2): New strings.
+ * src/roff/troff/input.cpp (encode_char): Update diagnostic
+ messages to not presume the identity of the escape character;
+ continues 9be3f8e3 (4 June).
- * tmac/groff_mdoc.man: Updated.
+2021-10-03 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-03-17 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grotty/tty.cpp (tty_printer:special_link): Tighten
+ code slightly by taking advantage of preprocessor string literal
+ concatenation.
- * doc/Makefile.sub (CLEANADD): Add `groff.html'.
+2021-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-03-17 Werner LEMBERG <wl@gnu.org>
+ [man]: Fix `U` enablement override so it actually works the way
+ I had in mind.
+ - The package proper enables it by default, but
+ - the sample site configuration file switches it off, on the
+ assumption that distributors and users will know better than
+ we do when they get a capable pager in place, and
+ - a register setting at the command line (or otherwise prior to
+ the loading of the macro package) is dispositive.
+
+ * tmac/an-ext.tmac: Rename URI output device capability register
+ from `U` to `mU`.
+ (UR, UE, MT, ME): Test both `U` and `mU` before handling
+ hyperlinks specially.
+ * tmac/an.tmac: If `man.local` did not initialize `U`, switch it
+ on. The hope is that we can drop the stuff in `man.local`
+ completely at some point.
+ * tman/man.local: Only initialize `U` if it is not already
+ defined.
- * src/libs/libgroff/hypot.c: Renamed to...
- * src/libs/libgroff/hypot.cpp: This. Updated to C++.
+2021-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/Makefile.sub (CCSRCS, CSRCS): Updated.
+ [man]: Use OSC 8 hyperlinks.
- * src/include/lib.h: Updated.
+ * tmac/an-ext.tmac: Add registers `mY` (output driver is
+ "grotty") and `U` (generate hyperlinks). `U` is intended to
+ apply to hyperlinking support in general, not just grotty's OSC
+ 8 feature. If the output driver is either grohtml or grotty,
+ make `U` true (`man.local` is read subsequently and can override
+ it).
+ (UR, MT): Conditionalize diversion production on hyperlink
+ support, not grohtml use per se.
+ (UE, ME): Generate device control commands for `tty` device to
+ emit hyperlinks.
-2005-03-16 Werner LEMBERG <wl@gnu.org>
+ * tmac/groff_man.7.man.in (Options): Document -rU.
+ (Files) [style]: Add example of `U` register enablement.
- Add workaround for broken hypot() on Interix.
+ * tmac/man.local: Disable `U` register by default, except on the
+ `html` device.
- * src/libs/libgroff/hypot.c: New wrapper file for `hypot'.
+ * NEWS: Add item.
- * src/libs/libgroff/Makefile.sub (OBJS): Add `hypot.o'.
- (CSRCS): Add `hypot.c'.
+2021-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/lib.h: Declare `groff_hypot'.
+ [grotty]: Add OSC 8 hyperlink support.
+
+ * src/devices/grotty/tty.cpp: Do it. Define `OSC` (Operating
+ System Command) and `ST` (String Terminator) preprocessor
+ symbols for these ECMA-48 (ISO 6429) character sequences.
+ (tty_printer::simple_add_char): Add stripped-down alternative to
+ `add_char()` member function for cases where we want to use many
+ defaults because we're writing a terminal escape sequence, not
+ rendering a glyph. (A function like `add_char()` that takes 8
+ arguments of varying types is a code smell--phew!)
+ (tty_printer::special): Call `special_link()` member function if
+ the device control command is `link`.
+ (tty_printer::special_link): Add new member function to generate
+ OSC 8 hyperlinks.
- * src/preproc/grn/hgraph.cpp: Don't declare `hypot'.
- Use `groff_hypot'.
+ * src/devices/grotty/grotty.1.man: Document it. Observe in
+ multiple places that disablement of SGR escape sequences
+ disables OSC 8 too.
- * src/preproc/pic/pic.h: Don't declare `hypot'.
+ * src/devices/grotty/tests/osc8_works.sh: Test it.
+ * src/devices/grotty/grotty.am (TESTS, grotty_TESTS): Run test.
+ (EXTRA_DIST): Ship test.
+
+ * NEWS: Add item.
+
+ Fixes <https://savannah.gnu.org/bugs/?60666>. Thanks to Steffen
+ Nurpmeso for supplying a proof-of-concept. (I went with my own
+ implementation, though, so blame me if it breaks.)
- * src/preproc/pic/object.cpp (hypot): Use `groff_hypot'.
+2021-10-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Convert special character glyphs corresponding to
+ Unicode Basic Latin ("ASCII") code points to those code points
+ when they occur in device escapes. (They should be correct for
+ IBM code page 1047 as well, but this is untested.) This is
+ necessary for encoding URLs in device control commands. Special
+ character identifiers are presumed to be the defaults documented
+ in groff_char(7); this is a design gap that we should consider
+ addressing. (We don't have a way to ask "is this the special
+ character corresponding to Unicode basic Latin code point X?")
-2005-03-15 Gaius Mulley <gaius@glam.ac.uk>
+ * src/roff/troff/input.cpp (encode_char): Do it.
- * src/devices/grohtml/post-html.cpp
- (html_printer::lookahead_for_tables): End .ce properly to avoid a
- segfault.
+2021-09-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man, mdoc]: Draw line after each page more consistently in
+ continuous rendering mode.
+
+ * tmac/an.tmac (an-bp): Move responsibility for line-drawing
+ after each document from here...
+ (an-end): ...to here. Refactor; drop
+ `an-do-draw-line-after-document` register in favor of testing
+ `\n[.F]` for nullity; if it is not null, then another document
+ is due to be processed (in fact, `.F` already contains its file
+ name), and we need to draw a separating line. If it is null, we
+ have reached the end of input and none is necessary.
+
+ * tmac/mdoc/doc-ditroff.tmac (doc-setup-page-layout):
+ * tmac/mdoc/doc-nroff.tmac (doc-setup-page-layout): Save
+ configured line length in new register `doc-line-length`.
+ * tmac/mdoc/doc-common.tmac (doc-end-macro): Port the above
+ man(7) feature to mdoc(7); draw a line of this length after each
+ document if continuously rendering.
+
+2021-10-01 Keith Marshall <keith.d.marshall@ntlworld.com>
+
+ [ms]: Update footnote handling documentation.
+
+ * tmac/groff_ms.7.man: Make some linguistic style adjustments.
+ (FP): Document it; see <https://savannah.gnu.org/bugs/?61022>.
+ (FS-MARK): Likewise, document this recently added feature.
+
+2021-10-01 Keith Marshall <keith.d.marshall@ntlworld.com>
+
+ [ms]: Support user-defined TOC leader style.
+
+ * tmac/s.tmac (toc*leader-char): Rename it as...
+ (TC-LEADER): ...this; within PX, leave it unchanged, if
+ predefined.
+ (TC-MARGIN): New numeric register; if predefined, leave it
+ unchanged, otherwise define as \w'000'; use it instead of
+ hard-wired definition, within PX; see
+ <https://savannah.gnu.org/bugs/?61157>.
+
+ * tmac/groff_ms.7.man (TC-LEADER, TC-MARGIN): Document them.
+
+2021-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-03-15 Werner LEMBERG <wl@gnu.org>
+ [pic]: Update input file name correctly.
- makeinfo 4.8 doesn't produce good HTML output from groff.texinfo.
+ * src/preproc/pic/troff.cpp (troff_output::set_location): Copy
+ the inbound file name argument with `strdup()` and store pointer
+ to this copy in `last_filename` instead of aliasing argument.
+ (troff_output::~troff_output): `free()` the memory allocated by
+ `strdup()` in destructor.
- * doc/fixinfo.sh: New script to postprocess makeinfo's HTML output.
+ Fixes <https://savannah.gnu.org/bugs/?61206>. Pointer
+ assignment instead of a string copy was being performed, which
+ means that after its initial assignment, `last_filename` always
+ shared its value ultimately with the `current_filename` pointer
+ {a libgroff symbol}, so `strcmp()` was always being performed on
+ identical pointers. Problem appears to date back 30+ years, to
+ the dawn of our repo history.
+
+2021-09-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devlj4/S: Make font name consistent with file name.
+
+2021-09-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libgroff/font.cpp (font::load): Throw error if a font
+ description file is missing a `spacewidth` directive, since it
+ is now re-documented as mandatory. Atypically, we don't return
+ false in this scenario; instead we proceed with the existing
+ logic to compute a space width for the font based on typical
+ practices for Western alphabetic fonts (see, e.g.,
+ <https://type.today/en/journal/spaces>.
- * doc/Makefile.in (.texinfo.html): Call fixinfo.sh.
+ * font/devdvi/EX:
+ * font/devdvi/MI:
+ * font/devdvi/S:
+ * font/devdvi/SA:
+ * font/devps/EURO: Add `spacewidth` directive to font
+ description files we ship that were missing it. We use the same
+ values that libgroff would have computed, so there should be no
+ visible difference.
+
+2021-09-24 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-03-14 Werner LEMBERG <wl@gnu.org>
+ * Makefile.am: Mark `$(TEST_SUITE_LOG)` as `.PRECIOUS`. This
+ prevents the test suite log from being deleted if there are any
+ failures.
+
+ Fixes <https://savannah.gnu.org/bugs/?61213>. Thanks to Bjarni
+ Ingi Gislason for the report.
- Add Cyrillic support to devutf8 and devhtml.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devutf8/R.proto, font/devhtml/R.proto: Add Cyrillic blocks.
+ * src/utils/grog/grog.pl (do_line): Move first-macro-call test
+ for `TH` to a more appropriate location.
- * tmac/unicode.tmac: New file.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/tty.tmac: Include unicode.tmac if device is utf8.
+ [grog]: Refactor to make it easier to generalize a per-package
+ scoring mechanism.
+
+ * src/utils/grog/grog.pl: Convert `inferred_main_package` from
+ scalar to list. Add scalar `selected_main_package` to store a
+ "winner" from the list of main packages inferred.
+ (push_main_package): Add subroutine to populate
+ `inferred_main_package`.
+ (do_line, infer_man_or_ms_package): Update to use
+ `push_main_package`.
+ (construct_command): Rewrite to select a main package from the
+ list `inferred_main_package`, taking user-supplied arguments
+ into account as an overriding factor. Drop now-unused `msupp`
+ list.
- * tmac/Makefile.sub (NORMALFILES): Add unicode.tmac.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Updated.
+ * src/roff/groff/groff.cpp (main): If the `-I` option is given,
+ run the grn preprocessor and pass it an `-M` option with `-I`'s
+ argument.
-2005-03-02 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * NEWS:
+ * src/roff/groff/groff.1.man (Options): Document it. Also
+ document that `-I` options are passed to the output driver.
- * src/libs/libdriver/printer.cpp (check_for_output_error): New
- function. It has been introduced to catch peculiar error contexts
- on MS-Windows platforms.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-02-28 Werner LEMBERG <wl@gnu.org>
+ * src/utils/grog/grog.pl (do_line): Don't strip groff-style
+ comments \# if AT&T compatibility mode is enabled.
- * src/roff/troff/input.cpp (string_iterator::fill): Protect against
- null pointer.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/papersize.tmac: Convert `paper' string contents to lowercase.
+ [libgroff]: Perform more font description file validation. Our
+ documentation said that the `name` directive was mandatory but
+ we didn't actually enforce this. Also be more specific in our
+ complaints of ill-formedness.
- * configure: Regenerated.
+ * src/libs/libgroff/font.cpp (font::load): Add local Boolean
+ variable `saw_name_directive`. Rename `had_charset` to
+ `saw_charset_directive` for symmetry. Emit distinct diagnostics
+ for `spacewidth` and `slant` directives having a missing,
+ non-numeric, or out-of-range argument. Emit diagnostic if the
+ file lacks a `name` directive.
- * NEWS: Updated.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-02-28 Keith Marshall <keith.d.marshall@ntlworld.com>
+ [libgroff]: Slightly refactor.
- Integrate `pdfmark' into normal groff build system;
- install macro `pdfmark' packages, build and install `pdfroff',
- and PDF format documentation.
+ * src/libs/libgroff/font.cpp (struct text_file): Rename member
+ variable `size` to `linebufsize` for clarity (it's certainly not
+ the size of the text file).
+ (text_file::text_file): Initialize `linebufsize` in constructor.
+ (text_file::next_line): Allocate new `buf` using `linebufsize`
+ instead of magic number (which was also stored to `size`, making
+ it only semi-magic, I guess). Rename local variable `i` to
+ `length` since it is in fact the length (in `char`s) of the
+ string stored in `buf`.
- * Makefile.comm: Add PDFDOCDIR.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in: (MDEFINES) ALT_AWK_PROGS, ALT_GHOSTSCRIPT_PROGS,
- pdfdocdir, make_pdfdoc, make_install_pdfdoc: New variables.
- (unstall_dirs): Add pdfdocdir.
+ [libgroff]: Revisit fix for Savannah #61173.
- * aclocal.m4: (GROFF_GHOSTSCRIPT_PREFS): New function; support
- `--with-alt-gs' option, set ALT_GHOSTSCRIPT_PROGS.
- (GROFF_GHOSTSCRIPT_PATH): Support `--with-gs' option, force use of
- GROFF_GHOSTSCRIPT_PREFS, set GHOSTSCRIPT.
- (GROFF_HTML_PROGRAMS): Force use of GROFF_GHOSTSCRIPT_PATH; tidy up.
- (GROFF_AWK_PREFS): New function; support `--with-alt-awk' option,
- set ALT_AWK_PROGS.
- (GROFF_AWK_PATH): New function; support `--with-awk' option, force
- use of GROFF_AWK_PREFS.
- (GROFF_PDFDOC_PROGRAMS): New function; force use of GROFF_AWK_PATH
- and GROFF_GHOSTSCRIPT_PATH, set make_pdfdoc and make_install_pdfdoc.
+ * src/libs/libgroff/font.cpp (text_file::text_file): Restore
+ setting of `lineno` member variable to `0` in constructor
+ initializer list, but...
+ (text_file::next_line): ...unconditionally increment it every
+ time through this member function's outer loop.
- * configure.ac: Add AC_PREREQ(2.59), GROFF_PDFDOC_PROGRAMS.
- Remove GROFF_GHOSTSCRIPT_PATH, (forced by GROFF_PDFDOC_PROGRAMS, and
- also by modified GROFF_HTML_PROGRAMS).
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-02-27 Gaius Mulley <gaius@glam.ac.uk>
+ [troff]: Align diagnostic message format with libgroff.
- * src/devices/grohtml/html-text.cpp (html_text::do_pre): Preserve
- paragraph spacing.
- (html_text::done_para): Unset `start_space'.
- (html_text::remove_para_align): Call `retrieve_para_space' for the
- spacing.
+ * src/roff/troff/input.cpp (fatal_with_file_and_line): Report
+ the program name if one is defined.
+ (fatal_with_file_and_line, error_with_file_and_line,
+ debug_with_file_and_line): Report the line number of the input
+ file only if it is positive, so that other values can be used
+ for "whole file" complaints. See commit cd0457b6, 17 September.
- * src/devices/grohtml/post-html.cpp (html_printer::emit_raw): Unset
- `seen_space'.
- (html_printer::do_check_center): Emit vertical space if necessary.
+2021-09-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/env.cpp (environment_switch): Preserve
- `seen_space', `seen_eol', and `suppress_next_eol' while switching
- environments.
+ [libgroff]: Drop redundant diagnostic.
- * src/roff/troff/node.cpp (suppress_node::suppress_node): Set
- `is_special'.
+ * src/libs/libgroff/font.cpp (font::load): Drop redundant
+ diagnostic; a missing `charset` directive is already checked for
+ later, circa line 998.
-2005-02-20 Werner LEMBERG <wl@gnu.org>
+2021-09-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/eqn.man, NEWS: Document various extensions of
- eqn.
+ [libgroff]: Fix code style nits.
-2005-02-17 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/font.cpp (font::font): Use initializer list
+ as much as possible in constructor.
+ (font::unit_scale, font::get_width, font::get_height,
+ font::get_depth, font::get_italic_correction,
+ font::get_left_italic_correction,
+ font::get_subscript_correction, font::get_character_type,
+ font::get_code, font::get_special_device_encoding): These member
+ functions rely on the font being either indexed or associated
+ with an output device that uses the `unicode` directive in its
+ `DESC` file. The compiler doesn't know this, so annotate the
+ `abort()` calls that conclude them. Add an `assert()` before
+ each one to more usefully describe the violated invariant in the
+ event this unreachable code is somehow reached.
+ (font::get_width): Annotate special meaning of zero zoom factor.
- * doc/pic.ms, man/groff.man: Fix typos.
+2021-09-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo: Fix typos.
- (\LEmacro): Get proper mathematical spacing.
+ * src/include/font.h (UNDEFINED_GLYPH): Use idiomatic C++98 null
+ pointer constant.
-2005-02-16 Werner LEMBERG <wl@gnu.org>
+2021-09-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * aclocal.m4 (GROFF_APPRESDIR_CHECK): Improve warning message.
- * configure: Regenerated with autoconf 2.59b.
+ [grohtml]: Fix compiler warning and dead store.
-2005-02-16 Gaius Mulley <gaius@glam.ac.uk>
+ * src/devices/grohtml/post-html.cpp (html_printer::special):
+ Update call of `font::load_font()` to stop passing obsolete
+ parameter (deleted by me in 2dff87d3, 17 September). The value
+ stored to the parameter by that function was never read anyway,
+ so also get rid of the variable that contained it.
- * src/devices/grohtml/post-html.cpp (html_printer::is_line_start,
- html_printer::start_font): Fix handling of preformatted text.
+ Fixes <https://savannah.gnu.org/bugs/?61187>. Thanks to Bjarni
+ Ingi Gislason for the report.
-2005-02-15 Gaius Mulley <gaius@glam.ac.uk>
+2021-09-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- These patches modify the indentation implementation to use `<p
- style=margin-left: n%>'. Many thanks to Peter and Larry for
- suggesting this solution. Grohtml only uses tables for `.IP' and
- related tags when the first operand has a short width.
+ [libgroff]: Slightly refactor.
- Similarly, they modify all vertical space code. By default, grohtml
- sets up a style sheet which uses no vertical space between `table',
- `pre', and `p' tags. It forces spaces when it needs them using
- `style="margin-top: 1em"'.
+ * src/include/font.h (font::scan_papersize): Demote return type
+ from `int` to `bool`.
+ * src/libs/libgroff/font.cpp (font::scan_papersize): As above.
+ Use Boolean instead of integer literals. Also rename `FILE`
+ stream pointer from `f` to `fp` and perform an explicit
+ comparison against the idiomatic C++98 null pointer constant.
- * src/devices/grohtml/html-table.cpp: Include `html-text.h'.
- (html_table::emit_table_header, html_table::emit_new_row):
- Rewritten.
- (html_table::set_space): New function.
- (html_indent::html_indent): Don't set `is_used'.
- (html_indent::begin): Rewritten.
- (html_indent::end): Remove code in function.
-
- * src/devices/grohtml/html-table.h: Updated.
- (html_table): Make `out' public.
-
- * src/devices/grohtml/html-text.cpp (html_text::html_text):
- Initialize `start_space' with FALSE.
- (html_text::end_tag) <P_TAG, PRE_TAG>: Updated.
- (html_text::issue_tag): Add argument to handle space style.
- (html_text::start_tag) <P_TAG, PRE_TAG>: Updated.
- (html_text::flush_text): Don't set `start_space'.
- (html_text::push_para): Don't set `p->really_issued'.
- (html_text::do_emittext): Updated.
- (html_text::do_para): Add paremeter to handle space.
- Update all callers.
- (html_text::retrieve_para_space): New function.
-
- * src/devices/grohtml/html-text.h (STYLE_VERTICAL_SPACE): New macro.
- (tag_definition): Remove `really_issued'.
- (html_text): Updated.
-
- * src/devices/grohtml/post-html.cpp (html_printer): Add variables
- `current_column' and `row_space'.
- Update constructor.
- (html_printer::emit_raw, html_printer::write_header,
- html_printer::do_indent, html_printer::do_check_center,
- html_printer::do_tab_ts): Handle vertical space.
- (html_printer:do_tab_te, html_printer::do_end_para): Call
- `remove_para_space'.
- (html_printer::do_col): Rewritten.
- (html_printer::flush_globs): Remove debugging code.
- (html_printer::is_line_start): New function.
- (html_printer::start_font): Use `is_line_start'.
- (html_printer::writeHeadMetaStyle): New function.
- (html_printer::do_file_components, html_printer::~html_printer):
- Call `writeHeadMetaStyle'.
-
- * tmac/www.tmac (www-handle-percent): New macro.
- (MPIMG): Handle percent values for width and height parameters.
- (DC): Updated.
-
- * tmac/groff_www.man: Updated.
-
-2005-02-14 Werner LEMBERG <wl@gnu.org>
-
- * src/utils/afmtodit/afmtodit.pl: Remove an incorrect `my' from
- $psname and $italic_angle.
- Immediately restart file input loops if `split' returns an empty
- array.
-
-2005-02-13 Michail Vidiassov <master@iaas.msu.ru>
- Werner LEMBERG <wl@gnu.org>
-
- Update afmtodit to better support Unicode (Michail).
- Update afmtodit to use Perl 5 syntax (Werner).
-
- * src/utils/afmtodit/afmtodit.pl: Don't use `getopts.pl' but
- `Getopts::Std'.
- Decorate variables with `my' where necessary.
- Use `defined' where necessary to avoid warnings.
- Don't use `do' for subroutine calls.
- Other minor syntax updates.
- Check for both `uXXXX[X[X]]' and `uniXXXX'.
- Handle glyph variants properly.
- (%unicode_decomposed, %AGL_to_unicode): Don't use `u' prefix in
- strings.
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit/afmtodit.man: Updated.
+ [libgroff, troff]: Slightly refactor device and font description
+ file loading. Remove dead code.
-2005-02-13 Werner LEMBERG <wl@gnu.org>
+ * src/include/font.h (font::load_font): Drop second parameter.
+ It was never used for its intended purpose.
+ (load): Drop first parameter; likewise.
+ * src/libs/libgroff/font.cpp (font::load, load): As above.
- Make groff.texinfo work with texinfo 4.8.
+ * src/libs/libgroff/font.cpp (struct text_file): Rename
+ `skip_comments` to `recognize_comments`. Demote that and
+ `silent` from `int` to `bool`.
+ (text_file::text_file): Use Boolean rather than integer literals
+ in constructor.
+ (text_file::next_line, font::load): Apply above renaming.
- * doc/groff.texinfo (@Var): Use @r and @slanted.
- (@defdummy, @Def*): Use @c to avoid empty lines.
- (\angles): Replaced with...
- (\Langlemacro, \Ranglemacro): New TeX macros.
- (@Langlemacro, @Ranglemacro): New variables defined with @set.
- (@angles): Use @Langlemacro and @Ranglemacro.
- (\LE): Replaced with...
- (\LEmacro): New TeX macro.
- (@LEmacro): New variable defined with @set.
- (@LE): Use @LEmacro.
- (@Lparenmacro, @Rparenmacro, @Lbrackmacro, @Rbrackmacro): New
- variables defined with @set.
- (@lparen, @rparen, @lbrack, @rbrack): Replaced with...
- (@Lparen, @Rparen, @Lbrack, @Rbrack): New macros.
- Update all callers.
+ * src/libs/libgroff/font.cpp (font::load): Rename parameter from
+ `head_only` to `load_header_only` to be more communicative.
+ Drop test of font description file name being `DESC`; this code
+ was not being reached. Stop throwing errors from this function
+ on failure to open the file; the caller will handle this when it
+ sees our false return value. Rename local variable `command` to
+ `directive` for alignment with our documentation. Replace "I
+ dont think this should happen" test and comment with `assert()`.
+ (struct table): Rename member from `command` to
+ `numeric_directive` to indicate its specificity, tracking only a
+ subset of valid `DESC` file directives.
- Other minor updates.
+ * src/libs/libgroff/font.cpp (font::load, font::load_desc):
+ Remove redundant assignments to the member variable formerly
+ known as `skip_comments`.
- * doc/texinfo.tex: Update to texinfo version 4.8.
+ * src/libs/libgroff/font.cpp (font::load_desc): Rename local
+ variable `directive_found` to `numeric_directive_found` to
+ clarify logic.
- * README.CVS: Updated.
+ * src/roff/troff/node.cpp (mount_font_no_translate): Simplify
+ call of `font::load_font`. The `not_found` in-out parameter
+ which was so agonizingly passed up through layers of library
+ calls was never actually read. Drop code that has been `#if
+ 0`-ed out since 1993.
-2005-02-09 Alejandro LĂłpez-Valencia <palopez@etb.net.co> (tiny change)
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo (ms Document Control Registers): Document `HY'
- and `FAM' registers.
+ * src/libs/libgroff/font.cpp (font::load_desc): Clear line
+ number before emitting whole-file validity diagnostics.
-2005-02-05 Werner LEMBERG <wl@gnu.org>
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_mdoc.man, tmac/doc-common, tmac/doc-ditroff,
- tmac/doc-nroff, tmac/doc-old.tmac, tmac/doc-syms, tmac/doc.tmac:
- Update BSD license.
+ * src/libs/libgroff/font.cpp (font::load_desc): Emit correct
+ line numbers when complaining of invalid `sizescale`, `hor`, or
+ `vert` values in device description files.
-2005-02-01 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61174>.
- * src/roff/groff/groff.man: Add information about paper size.
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-01-25 Werner LEMBERG <wl@gnu.org>
+ [libgroff]: Increase validation of device and font description
+ files.
- * src/roff/nroff/nroff.sh: Handle `*.ISO8859-1' in locale. From
- NetBSD bin/29114.
+ * src/libs/libgroff/font.cpp (font::load): Validate the syntax
+ and value of the `name` directive.
+ (font::load_desc): Issue distinct diagnostics for a `fonts`
+ directive that is missing arguments and for a first argument
+ that can't be interpreted as a valid number.
-2005-01-22 Ruslan Ermilov <ru@FreeBSD.org>
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc.tmac (Sm): Improved. It didn't work properly in many
- cases.
- (Re): Emit a warning if called without `.Rs'.
- (doc-finish-reference): Use parameter for decreasing
- `doc-reference-count'.
- (doc-print-reference): Pass specific count parameters to
- `doc-finish-reference'.
+ [libgroff]: Make error reporting more flexible.
-2005-01-21 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+ Interpret a nonpositive line number specially: treat the
+ diagnostic as applying to the entire file, and omit the line
+ number.
- * src/libs/libdriver/input.cpp (delete_current_env, do_file):
- Reset pointers to zero after deallocation. This fixes a crash
- if a driver is called with multiple input files. Reported by
- Ken Chilton <ken@chiltonfamily.org>.
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/grops.man: Add more info on DSC.
+ [libgroff]: Add information to diagnostics.
-2005-01-17 Ruslan Ermilov <ru@FreeBSD.org>
+ * src/libs/libgroff/font.cpp (font::load): Drop unused argument
+ from `error()` call.
+ (font::load_desc): In another, add name of numeric directive
+ that is given an unparsable number.
- * tmac/doc-common (Dd), tmac/doc-ditroff (gX, doc-setup-header):
- Remove dead code.
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2005-01-17 Werner LEMBERG <wl@gnu.org>
+ [libgroff]: Tweak code style.
- * src/roff/troff/div.cpp (top_level_diversion::space): Protect
- against division by zero.
+ * src/libs/libgroff/font.cpp (trim_args, font::load)
+ (font::load_desc): Compare pointer explicitly to null pointer
+ literal `0` instead of using logical complementation.
+ (font::load, font::load_desc): Swap order of null pointer
+ equality comparisons when a typo or thinko could lead to lvalue
+ assignment.
-2005-01-13 Ruslan Ermilov <ru@FreeBSD.org>
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc.tmac (Ef): Restore doc-curr-font and doc-curr-size.
+ [libgroff]: Use idiomatic C++98 null pointer constant.
-2004-12-19 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/font.cpp (text_file::error)
+ (glyph_to_unicode, font::get_special_device_encoding)
+ (font::load):
+ * src/libs/libgroff/fontfile.cpp (font::image_generator):
+ * src/libs/libgroff/nametoindex.cpp (class charinfo)
+ (character_indexer::named_char_glyph)
+ (character_indexer::numbered_char_glyph):
+ * src/libs/libgroff/string.cpp (string::clear):
+ * src/libs/libgroff/tmpfile.cpp (temp_init::temp_init):
+ * src/libs/libgroff/tmpname.cpp (gen_tempname): Use `0` literal
+ instead of `NULL` to represent a null pointer; this was
+ idiomatic in C++98 and is mostly the practice elsewhere in
+ groff. Also swap order of null pointer equality comparisons
+ when a typo or thinko could lead to lvalue assignment.
+
+ * src/roff/troff/input.cpp (input_stack::diversion_state)
+ (input_stack::get_diversion_state, charinfo::contains)
+ (glyph_to_name): Similar.
+
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Slightly refactor.
+
+ * src/libs/libgroff/font.cpp (font::load): Use same loop style
+ as `font::load_desc()`.
+
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Fix off-by-one error in font and device description
+ file reader diagnostics.
+
+ * src/libs/libgroff/font.cpp (text_file::text_file): All text
+ files begin with line 1, not line 0.
+
+ Fixes <https://savannah.gnu.org/bugs/?61173>.
+
+2021-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Boolify more interfaces.
+
+ * src/include/font.h (font::unit_scale):
+ * src/libs/libgroff/font.cpp (font::unit_scale): Demote return
+ type from `int` to `bool`. Use Boolean literals instead of
+ integers.
+
+ * src/libs/libgroff/font.cpp (struct text_file): Rename `next`
+ member function to `next_line`. Demote its return type from
+ `int` to `bool`. Use Boolean literals instead of integers.
+
+2021-09-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Boolify local variables.
+
+ * src/libs/libgroff/font.cpp (font::load, font::load_desc):
+ Demote local variables used as Booleans from `int` to `bool` and
+ update literals used with them from integer to Boolean.
+
+2021-09-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grn, groff, troff]: Communicate better when device DESC file
+ can't be loaded.
+
+ * src/libs/libgroff/font.cpp (font::load_desc): Stop writing
+ diagnostic to standard error.
+ * src/preproc/grn/main.cpp (getres):
+ * src/roff/troff/troff.cpp (main): Replace "sorry, I can't
+ continue" fatal diagnostic with a more informative message.
+ Instead say which device's DESC file the program was trying to
+ open, which might reveal a user's logic error or typo.
+ * src/roff/groff/groff.cpp (main): Replace "invalid device" text
+ of fatal diagnostic similarly. I think it is more helpful to
+ indicate the operation that failed rather than saying the device
+ was invalid, particularly since there are other ways for a
+ device description to be invalid even if a DESC file is found
+ and loaded.
+
+2021-09-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Throw warning diagnostic if device DESC file attempts
+ to load unavailable fonts.
+
+ * src/roff/troff/input.cpp (main): Take advantage of new Boolean
+ return values of `mount_style()` and `mount_font()` to produce
+ warning diagnostics if mounting a style or font as directed by
+ the DESC file fails. Explain in a comment why, at present, this
+ style mount warning will never actually trip.
+
+2021-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Lift font mounting diagnostic messages to be closer to
+ their user-controlled contexts to provide more information. In
+ many cases no diagnostic was being thrown at all when an
+ unavailable font was requested by name, which is the method most
+ users prefer, and which meant that failures resulting from typos
+ in font names for many requests (`uf`, `fschar`, `rfschar`,
+ `special`, `fspecial`, `fzoom`, `bd`, `tkf`, `cs`) were going
+ unreported. Further, promote these font warnings to errors
+ because the request will utterly fail to do what was requested
+ with no reasonable fallback. Possibly, they were formerly
+ warnings because at the low level they were being emitted, they
+ could also have originated from unavailable fonts encountered in
+ device description files, and while that's bad news, it results
+ in no formatting problems if it doesn't affect fonts that an
+ input document actually uses.
+
+ * src/roff/troff/node.cpp (struct font_lookup_info): New struct
+ keeps the font name or position requested, and the position of
+ successful font lookup.
+ (font_lookup_info::font_lookup_info): Add constructor.
+ (font_lookup_error): New function builds error message using a
+ `font_lookup_info` struct and a message argument.
+ (get_fontno): Rename to...
+ (has_font): ...this. Add argument to take a pointer to a
+ `font_lookup_info` struct. Return a `bool` indicating whether
+ the lookup succeeded. Place former `int` return value into the
+ struct instead. Populate the other struct members with the
+ requested font name or position, as appropriate.
+ (mount_font_no_translate): Stop throwing warning diagnostic here
+ if a font cannot be loaded. Instead, throw them...
+ (font_position): ...here, and...
+ (underline_font, define_font_special_character,
+ remove_font_special_character, read_special_fonts,
+ font_special_request, font_zoom_request, bold_font, track_kern,
+ constant_space): ...here, using `font_lookup_info` structs and
+ `has_font()`.
+ (remove_font_special_character): Stop returning early if font
+ lookup fails; it's gratuitously inconsistent with other similar
+ functions (save one, which has a reason to be different).
+ (define_font_special_character): Return early if font lookup
+ fails and say why in a comment (we can't `skip_line()`).
+
+ Fixes <https://savannah.gnu.org/bugs/?59522>.
+
+2021-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * [libgroff, troff]: Further boolify.
+
+ * src/include/font.h (load_font, font): Demote parameters from
+ {pointer to} `int` to `bool` and update default literal from
+ integer to Boolean (except for the pointer). Update comment.
+ * src/libs/libgroff/font.cpp (load_font, load): Similarly.
+
+ * src/roff/troff/node.h (mount_font):
+ * src/roff/troff/node.cpp (mount_font): Demote return type from
+ `int` to `bool`.
+
+ * src/roff/troff/node.h (mount_style):
+ * src/roff/troff/node.cpp (mount_style): Promote return type
+ from `void` to `bool`.
+
+ * src/roff/troff/node.cpp (mount_font_no_translate): Demote
+ return type and `check_only` parameter from `int` to `bool` and
+ use Boolean rather than integer literals with them.
+ (check_font): Update call site of `mount_font_no_translate` to
+ use Boolean literal.
+ (font_position): Indicate that "error" is ignored by casting
+ return value of `mount_font` to void instead of using a comment.
+ (style): Cast return value of `mount_style` to `void`.
+
+2021-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * Makefile.am: Add `.DELETE_ON_ERROR` special target; both GNU
+ and FreeBSD make(1)s support it so maybe it will be portable
+ enough. This avoids, among other problems, a target appearing
+ falsely up-to-date (often as an empty file) when the troff
+ process generating it experiences an assertion failure.
+
+2021-09-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Since June 1991 if not earlier, groff (technically, the refer,
+ lookbib, and lkbib programs) has trusted the header contents of
+ binary bibliographic index files (canonically generated with
+ indxbib(1)) regarding the sizes of the data structures that
+ follow in the file, a notorious class of security problem. In
+ July 2013, the Mayhem Team at Carnegie Mellon University
+ reported to the Debian Bug Tracking System a problem with
+ groff's refer(1) implementation dumping core when reading an
+ index file prepared by a fuzzer.
+
+ * src/libs/libbib/index.cpp (index_search_item::check_header):
+ Add new member function to validate the header of an indexed
+ bibliography file, returning a string describing in detail the
+ first validity problem encountered.
+ (index_search_item::load): Perform the foregoing check before
+ using any of the size values taken from the header; they are
+ relied upon for pointer arithmetic. If in verification mode
+ {using the undocumented `-V` flag to refer(1), lkbib(1), or
+ lookbib(1)}, report the details of the problem encountered.
+ Regardless of that mode, if there is a validity problem, report
+ corruption of the index file and abandon it, forcing fallback to
+ the text version of the corresponding bibliography file.
+
+ Fixes <https://bugs.debian.org/716109>.
+
+2021-09-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libbib/index.cpp
+ (index_search_item::get_invalidity_reason): Don't complain about
+ a last list element being nonnegative if the list size was zero
+ in the first place, as can happen with an empty index. More
+ seriously from a language standpoint, avoid reading through a
+ negative array index (this can escape a compiler's attention
+ because we're reading from the midst of a heap-allocated or
+ `mmap()`ed region, but it's still a code smell).
+
+ Fixes <https://savannah.gnu.org/bugs/?61144>.
+
+2021-09-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libbib/index.cpp (index_search_item::load)
+ (index_search_item::get_invalidity_reason)
+ (index_search_item::add_out_of_date_file): Clarify diagnostic
+ messages. Make it more obvious when we're complaining of a
+ problem in an indexed bibliographic database file (rather than a
+ plain text one). Dial down the amount of Unix jargon a little.
+
+2021-09-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libbib]: Partially boolify.
+
+ * src/include/search.h:
+ * src/libs/libbib/index.cpp:
+ * src/preproc/refer/refer.cpp:
+ * src/utils/lkbib/lkbib.cpp:
+ * src/utils/lookbib/lookbib.cpp: Demote `verify_flag` from an
+ `int` to a `bool`, rename it to `do_verify`, use Boolean
+ instead of integer literals with it, and update call sites.
+
+ * src/libs/libbib/index.cpp: Rename `do_verify()` member
+ function to `get_invalidity_reason()` (it returns a string).
+ Demote `load()` from `int` to `bool`; do the same for `verify()`
+ and rename it to `is_valid()` as well. Use Boolean instead of
+ integer literals with them.
+ (index_search_item::is_valid, make_index_search_item): Update
+ call sites of renamed member functions.
+
+2021-09-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libbib/map.c (mapread): Compare return value of
+ `mmap()` to `MAP_FAILED` instead of `(char *)-1`. `MAP_FAILED`
+ is documented in POSIX Issue 5 a.k.a. SUSv2
+ <https://pubs.opengroup.org/onlinepubs/007908799/xsh/mmap.html>
+ {1997} and should be portable enough by now.
+
+2021-09-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Clamp negative tab stop positions to zero instead of
+ throwing an assertion failure.
+
+ * src/roff/troff/env.cpp (tab_stops::distance_to_next_tab):
+ Replace `assert` with clamping logic, ensuring that `lastpos`
+ can never be negative. While negative tab stop positions don't
+ make much sense (they result in zero horizontal motion), user
+ input like `.ta T -5` should never provoke an assertion failure.
+
+ (set_tabs): Throw range warning in additional scenario, viz., if
+ a repeating tab offset is negative.
+
+ Fixes <https://bugs.debian.org/990406>. Thanks to ĐœĐ°Đ± for the
+ report.
+
+2021-09-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Boolify `set_tabs` function.
+
+ * src/roff/troff/env.cpp (set_tabs): Demote local variables from
+ `int` to `bool` and give them predicate-like names.
+ - `first` -> `is_first_stop`
+ - `repeated` -> `is_repeating_stop`
+ Use Boolean instead of integer literals in assignments to them.
+
+2021-09-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Deprecate `OP` macro.
+
+ * tmac/an-ext.tmac (OP): Move implementation from here...
+ * tmac/an.tmac (OP): ...to here. Throw deprecation warning.
+ Throw style warning if wrong number of arguments given.
+
+ * tmac/groff_man.7.man.in (Description): Drop from introductory
+ macro summary.
+ (Description/Command synopsis macros): Move discussion from
+ here...
+ (Description/Deprecated features): ...to here. Explain why it's
+ deprecated.
- * install-sh: New version; taken from texinfo CVS.
+2021-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Make `ab` request quiet if given no arguments. The
+ `tm`, `tm1`, and `tmc` requests provide ample flexibility for
+ constructing diagnostic messages prior to an error exit, and
+ it's convenient to make `ab` itself quiet instead of saying
+ "User Abort." as Unix Version 7 troff did. Further, there is no
+ standardization across troffs regarding what `ab` should emit if
+ arguments are absent.
+
+ * src/roff/troff/input.cpp (abort_request): Do it.
+
+ * src/roff/groff/tests/ab_works.sh:
+ * src/roff/groff/groff.am (groff_TESTS): Test it.
+
+ * doc/groff.texi (Debugging, Implementation Differences):
+ * man/groff.7.man (Requests/Request short reference):
+ * man/groff_diff.7.man (Implementation differences): Document
+ it.
+
+ Fixes <https://savannah.gnu.org/bugs/?61070>. Thanks to Dave
+ Kemper for the discussion.
+
+2021-09-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Update exit status literals.
+
+ * src/roff/troff/div.cpp (top_level_diversion::begin_page):
+ * src/roff/troff/input.cpp (exit_troff, abort_request, do_error)
+ (fatal_with_file_and_line): Use standard C library preprocessor
+ symbols `EXIT_SUCCESS` and `EXIT_FAILURE` instead of 0 and 1
+ literals, respectively.
+
+2021-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Drop unused member function.
+
+ * src/roff/troff/token.h (class token): Drop unused `title`
+ member function. Its implementation was apparently removed in
+ the prehistory of our Git repository: see James Clark's
+ ChangeLog entry of 1990-09-06.
+
+2021-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Remove workaround for Cfront 1.2 bug.
+
+ * src/roff/troff/input.cpp (do_define_macro): Move `dot_symbol`
+ from to file to function local scope as originally intended.
+
+2021-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Rename parameter.
+
+ * src/roff/troff/input.cpp (token::usable_as_delimiter): Rename
+ parameter from `err` to `report_error` to be more communicative.
+
+2021-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Boolify members of `token` class.
+
+ * src/roff/troff/token.h (class token): Demote return type of
+ several member functions from `int` to `bool` and rename them.
+ - `backspace` -> `is_backspace`
+ - `delimiter` -> `usable_as_delimiter`
+ - `dummy` -> `is_dummy`
+ - `eof` -> `is_eof`
+ - `horizontal_space` -> `is_horizontal_space`
+ - `hyphen_indicator` -> `is_hyphen_indicator`
+ - `leader` -> `is_leader`
+ - `left_brace` -> `is_left_brace`
+ - `newline` -> `is_newline`
+ - `page_ejector` -> `is_page_ejector`
+ - `right_brace` -> `is_right_brace`
+ - `space` -> `is_space`
+ - `special` -> `is_special`
+ - `stretchable_space` -> `is_stretchable_space`
+ - `tab` -> `is_tab`
+ - `transparent_dummy` -> `is_transparent_dummy`
+ - `transparent` -> `is_transparent`
+ - `unstretchable_space` -> `is_unstretchable_space`
+ - `white_space` -> `is_white_space`
+ - `zero_width_break` -> `is_zero_width_break`
+ (class token): Drop 1991 comment anticipating that member
+ function `nspaces` could return "2" for a "double space"; this
+ was apparently never implemented.
+ (class token): Drop parameter names from declarations; the
+ prevailing style (familiar from Stroustrup) is not to use them.
+ (token::is_special): Simplify implementation.
+
+ * src/roff/troff/input.cpp (has_arg)
+ (token::usable_as_delimiter): Update definitions of above member
+ functions not defined in token.h.
+
+ * src/roff/troff/div.cpp (begin_page, space_request, need_space)
+ (output_saved_vertical_space, flush_output):
+ * src/roff/troff/env.cpp (fill, no_fill, center)
+ (right_justify, indent, temporary_indent, margin_character)
+ (number_lines, do_break_request, hyphen_word):
+ * src/roff/troff/input.cpp (next_file, do_overstrike)
+ (do_bracket, do_name_test, do_expr_test, do_zero_width)
+ (token::skip, has_arg, skip_line, empty_name_warning)
+ (non_empty_name_warning, do_get_long_name, process_input_stack)
+ (flush_pending_lines, decode_args, read_request)
+ (do_define_string, do_define_character, remove_character)
+ (do_define_macro, length_request, get_delim_number)
+ (get_line_arg, read_size, get_delim_name, do_register, do_width)
+ (read_title_parts, encode_char, do_special, device_request)
+ (output_request, skip_alternative, begin_alternative)
+ (nop_request, do_if_request, do_source, pipe_source)
+ (ps_bbox_request, tag, taga, do_terminal, do_translate)
+ (hyphenation_code, hyphenation_patterns_file_code, define_class)
+ (get_optional_char, check_missing_character, abort_request)
+ (copy_file, transparent_file, do_macro_source)
+ (charinfo_to_node_list, read_draw_node, read_color_draw_node):
+ * src/roff/troff/node.cpp (get_fontno)
+ (remove_font_special_character, bold_font):
+ * src/roff/troff/number.cpp (start_number, parse_term):
+ * src/roff/troff/reg.cpp (define_number_reg, alter_format):
+ Update call sites to use new names.
+
+ * src/roff/troff/input.cpp (token::usable_as_delimiter)
+ (read_draw_node): Return Boolean, not integer, literals.
+
+2021-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Clamp line and title lengths to device horizontal
+ resolution.
+
+ * src/roff/troff/env.cpp (line_length, title_length): Do it.
+
+ Fixes <https://savannah.gnu.org/bugs/?61116>.
+
+2021-09-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/env.cpp (do_hyphenation_patterns_file):
+ Refactor slightly. Demote `append` from `int` to `bool`.
+ (hyphenation_patterns_file, hyphenation_patterns_file_append):
+ Update call sites to use Boolean, not integer, literals.
+
+2021-09-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/hvunits.h:
+ * src/roff/groff/number.cpp: Mark `H0`, `V0` objects as `const`.
+
+2021-09-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/env.cpp (do_underline_special): Refactor
+ slightly.
+ - Rename `underline_spaces` -> `do_underline_spaces`.
+ - Demote it from an `int` to a `bool`.
+ - Use ternary operator and explicit character literals when
+ writing device control command instead of doing arithmetic
+ on a character literal.
+ - Update call sites to use Boolean literals.
+ - Relocate function to avoid forward reference.
+ - Mark function as static to eliminate external linkage.
+ Remove now-unnecessary prototype.
+
+2021-09-04 Keith Marshall <keith.d.marshall@ntlworld.com>
+
+ Add "ms" footnote marker placement hook.
+
+ * tmac/s.tmac (FS-MARK): New macro; define as no-op, by default.
+ (@FS): Invoke FS-MARK as first action, allowing caller to "hook" it.
+
+2021-09-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/env.cpp (distribute_space): Refactor slightly.
+ - Rename `force_reverse` to `force_reverse_node_list`.
+ - Rename `reverse` to `do_reverse`.
+ - Demote both of the above from `int` to `bool`.
+ - Use Boolean literals with them.
+ - Add assertions to enforce positive values of `nspaces` and
+ `desired_space`.
+ - Remove now-redundant test for `nspaces` being positive.
+ - Add explanatory comments.
+ (environment::wrap_up_field): Update call sites of
+ `distribute_space` when non-default value of
+ `force_reverse_node_list` is supplied.
-2004-12-17 Werner LEMBERG <wl@gnu.org>
+2021-09-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/devtag.tmac: Protect against loading twice.
- Protect agains compatibility mode.
- * tmac/www.tmac: Protect against loading twice.
- Load `devtag.tmac' before switching off compatibility mode.
- * tmac/an-old.tmac, tmac/s.tmac: Load `devtag.tmac'.
+ [troff]: Don't adjust nonadjustable lines. This means that the
+ direction from which an output line in adjustment mode "b" (or
+ its "n" synonym) is filled with supplemental space is not
+ changed if that output line does not require adjustment. This
+ will result in whitespace changes to documents using that
+ adjustment mode, and these changes will be plainly visible on
+ low-resolution output devices like terminals.
-2004-12-16 Mike Bianchi <mbianchi@Foveal.com>
+ To illustrate, in the following "A" means an output line
+ requiring adjustment; "F" a line that is "full" and does not;
+ and "L" and "R" indicate distribution of adjustment spaces from
+ the left and right, respectively.
- * configure.ac: Produce `contrib/gdiffmk/tests/runtests'.
- * configure: Updated.
+ groff 1.22.4 groff 1.23.0
+ ------------ ------------
+ A L A L
+ A R A R
+ F L F R
+ A R A L
-2004-12-15 Thomas Klausner <wiz@netbsd.org>
+ * src/roff/troff/env.cpp (distribute_space): Return early if
+ either the amount of desired space to be distributed or the
+ count of space nodes in the output line to distribute it among
+ is zero.
- * tmac/doc-syms, tmac/groff_mdoc.man: Add `libpam' library.
+ * tmac/tests/an_TH-repairs-ad-damage.sh: Update test to expect
+ space to be distributed differently.
-2004-12-15 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?61089> and
+ <https://savannah.gnu.org/bugs/?60673>.
- Make `test-groff' work again -- previously, wrong paths have been
- used. Additionally, it can now be called from anywhere.
+2021-09-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * test-groff.in: Don't test for groff binary. This is no longer
- necessary since the proper paths are determined by `configure'.
- (EXEEXT): Removed. No longer used.
- (srcdir, builddir): Use values provided by the configure script.
- (XENVIRONMENT): Updated.
+ Skip core-dump-checking test if a core file already exists.
- * INSTALL: Updated.
+ * src/roff/groff/tests/regression_savannah_59202.sh: Skip test
+ if a core dump is already present.
-2004-12-14 Gaius Mulley <gaius@glam.ac.uk>
+2021-09-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- Make .tag and .taga work for all devices (but only grohtml actually
- handles them).
+ Add regression test for Savannah #60189.
- * src/devices/grohtml/post-html.cpp: s/html-tag/devtag/.
- (text_glob::is_br, page::add_tag, html_printer::troff_tag,
- html_printer::handle_assertion): Don't use hard-coded string
- lengths.
- (html_printer::lookahead_for_table): Reset `tbl' properly if
- necessary.
- (html_printer::devtag): New function, handling `devtag'.
- (html_printer::special): Don't handle `html-tag'.
+ * src/roff/groff/tests/break_zero-length_output_line_sanely.sh:
+ Do it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * src/include/printer.h, src/libs/libdriver/printer.cpp
- (printer::devtag): New virtual function.
+2021-08-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/input.cpp (parse_x_command) <'X'>: Handle
- `devtag'.
+ [troff]: Tweak diagnostic message.
+
+ * src/roff/troff/env.cpp (environment::environment): Use
+ terminology more rigorously in diagnostic.
+
+2021-08-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Fix code style nit.
+
+ * src/libs/libgroff/errarg.cpp (errprint): Replace `assert(0)`
+ with a meaningful predicate.
+
+2021-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Demote `need_space` to Boolean.
+
+ * src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+ Demote local integer `need_space` and its assignments to `bool`.
+
+2021-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Boolify `font::load()` and `font::load_desc()`
+ return values.
+
+ * src/include/font.h (font::load, font::load_desc):
+ * src/libs/libgroff/font.cpp (font::load, font::load_desc): Do
+ it.
+
+2021-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (TRADITIONAL_CPP): Update `AC_MSG_CHECKING`
+ argument to refer to "pre-ISO C90 syntax" instead of a
+ "traditional" preprocessor. Call `AC_MSG_ERROR` (aborting
+ configuration) if the check (for pre-C90 transformation)
+ succeeds. We thus withdraw support for such superannuated
+ {"Reiser"} C preprocessors.
+
+2021-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Un-indirect token concatenation through macro.
+
+ * src/include/itable.h:
+ * src/include/ptable.h: Do it.
+
+2021-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Drop support for `TRADITIONAL_CPP`. This means a C
+ preprocessor that does not support the ANSI C89/ISO C90
+ token concatenation operator "##".
+
+ * src/include/itable.h:
+ * src/include/ptable.h: Do it.
+
+ * Makefile.am: Undocument preprocessor symbol.
+
+2021-08-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Drop `a_delete` preprocessor wrapper for the
+ `delete` operator. It has been rendered unnecessary by the
+ removal of support for ancient C++ compilers.
+
+ * src/include/lib.h (a_delete): Drop symbol definition.
+
+ * src/devices/grohtml/output.cpp (word::~word):
+ * src/devices/grohtml/post-html.cpp (char_block::char_block)
+ (assert_state::~assert_state, assert_state::add)
+ (assert_state::close, replace_negate_str):
+ * src/devices/grops/ps.cpp (ps_font::ps_font)
+ (subencoding::subencoding, ps_printer::define_encoding)
+ (ps_printer::encode_fonts):
+ * src/devices/grops/psrm.cpp (resource_manager::document_setup)
+ (resource_manager::supply_resource):
+ * src/devices/grotty/tty.cpp (tty_printer::tty_color)
+ (tty_printer::tty_printer, tty_printer::color_to_idx)
+ (tty_printer::add_char):
+ * src/include/itable.h (ITABLE(T)::~ITABLE(T))
+ (ITABLE(T)::define):
+ * src/include/ptable.h (PTABLE(T)::~PTABLE(T))
+ (PTABLE(T)::define):
+ * src/libs/libbib/index.cpp
+ (index_search_item::~index_search_item, make_index_search_item,
+ index_search_item_iterator::index_search_item_iterator,
+ index_search_item::get_tag, index_search_item::munge_filename,
+ index_search_item::search):
+ * src/libs/libbib/linear.cpp (bmpattern::~bmpattern)
+ (file_buffer::file_buffer, file_buffer::load)
+ (linear_searcher::linear_searcher)
+ (linear_searcher::~linear_searcher):
+ * src/libs/libbib/search.cpp
+ (search_list_iterator::search_list_iterator)
+ (search_item::search_item):
+ * src/libs/libdriver/input.cpp (IntArray::~IntArray)
+ (IntArray::append, StringBuf::~StringBuf, StringBuf::append)
+ (get_integer_arg, parse_x_command, do_file):
+ * src/libs/libdriver/printer.cpp (printer::printer)
+ (printer::load_font, text_file::~text_file, text_file::next)
+ (font::~font, font_widths_cache::~font_widths_cache)
+ (font:alloc_ch_index, font::extend_ch, font::compact)
+ (font::load_desc):
+ * src/libs/libgroff/fontfile.cpp (font::open_file):
+ * src/libs/libgroff/relocate.cpp (searchpath, searchpathext)
+ (set_current_prefix):
+ * src/libs/libgroff/searchpath.cpp (search_path::search_path)
+ (search_path::command_line_dir, search_path::open_file)
+ (search_path::open_file_cautious):
+ * src/libs/libgroff/string.cpp (sfree, srealloc)
+ (string::remove_spaces):
+ * src/libs/libgroff/symbol.cpp (symbol::symbol, concat):
+ * src/libs/libgroff/tmpfile.cpp (temp_init::temp_init)
+ (xtmpfile_list_init::~xtmpfile_list_init, xtmpfile):
+ * src/preproc/eqn/box.cpp (set_gfont, set_grfont, set_gbfont)
+ (box_list::append, box_list::~box_list):
+ * src/preproc/eqn/delim.cpp (make_delim_box)
+ (delim_box::~delim_box):
+ * src/preproc/eqn/eqn.ypp (number):
+ * src/preproc/eqn/lex.ypp (file_input::~file_input)
+ (argument_macro_input::~argument_macro_input):
+ * src/preproc/eqn/pile.ypp (matrix_box::~matrix_box)
+ (matrix_box::append):
+ * src/preproc/eqn/special.cpp (special_box::~special_box):
+ * src/preproc/eqn/text.ypp (set_char_type):
+ * src/preproc/html/pre-html.cpp (get_line, scanArguments):
+ * src/preproc/pic/object.cpp (output::~output)
+ (output::set_args, text_item::~text_item)
+ (object_spec::~object_spec, command_object::~command_object)
+ (line_object::~line_object):
+ * src/preproc/pic/pic.ypp (placeless_element, reset_variables)
+ (print_args, text_expr, object_spec, text, sprintf_args, path):
+ * src/preproc/refer/command.cpp (input_item::~input_item)
+ (input_item::peek_char):
+ * src/preproc/refer/label.ypp (lookup_label):
+ * src/preproc/refer/refer.cpp (store_citation, store_reference):
+ * src/preproc/tbl/main.cpp (format::add_rows, format::~format):
+ * src/preproc/tbl/table.cpp (block_entry::~block_entry)
+ (table::~table, table::allocate):
+ * src/roff/groff/groff.cpp (possible_command::~possible_command)
+ (possible_command::clear_name):
+ * src/roff/troff/column.cpp
+ ((justification_spec::~justification_spec)
+ (justification_spec::append):
+ * src/roff/troff/dictionary.cpp (dictionary::lookup):
+ * src/roff/troff/env.cpp (override_sizes, tab_stops::to_string)
+ (hyphen_word, hyphen_trie::insert_hyphenation):
+ * src/roff/troff/input.cpp (read_long_escape_name, token::next)
+ (do_get_long_name, temp_iterator::~temp_iterator)
+ (get_delim_name, pipe_source, read_string, pipe_output)
+ (system_request, open_mac_file, do_macro_source)
+ (do_register_assignment, do_string_assignment, read_draw_node)
+ (copy_mode_error):
+ * src/roff/troff/node.cpp (troff_output_file::set_font)
+ (troff_output_file::~troff_output_file, draw_node::is_tag)
+ (grow_font_table, font_family::~font_family)
+ (font_family::make_definite):
+ * src/utils/hpftodit/hpftodit.cpp (name_list::~name_list)
+ (read_map):
+ * src/utils/indxbib/indxbib.cpp (main, get_cwd):
+ * src/utils/tfmtodit/tfmtodit.cpp (tfm::~tfm, tfm::load): Port
+ uses of `a_delete` to `delete[]`.
+
+2021-08-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Drop `ad_delete` preprocessor wrapper for the
+ `delete` operator. It has been rendered unnecessary by the
+ removal of support for ancient C++ compilers.
+
+ * src/include/lib.h (ad_delete): Drop symbol definition.
+
+ * src/preproc/pic/object.cpp (graphic_object::print_text):
+ * src/preproc/refer/ref.cpp (reference::reference)
+ (reference::merge, reference::insert_field)
+ (reference::delete_field):
+ * src/preproc/tbl/main.cpp (format::add_rows): Port uses of
+ `ad_delete` to `delete[]`.
+
+2021-08-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_ARRAY_DELETE): Update `AC_MSG_CHECKING`
+ argument to refer to "ISO C++98" instead of "ANSI". Call
+ `AC_MSG_ERROR` (aborting configuration) if the check fails.
+
+2021-08-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Drop support for `ARRAY_DELETE_NEEDS_SIZE`.
+
+ * src/include/lib.h [ARRAY_DELETE_NEEDS_SIZE]: Drop preprocessor
+ conditional branch. This abandons support for certain pre-ISO
+ C++98 compilers. (According to a now-removed comment, unsized
+ array deletion was documented in "ARM", meaning _The C++
+ Annotated Reference Manual_, published in 1989.)
+
+ * Makefile.am: Undocument preprocessor symbol.
+
+2021-08-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Drop redefinition of `INT_MIN`.
+
+ * src/include/lib.h: Drop redefinition of `INT_MIN`. It was
+ motivated by a bug in the AT&T C++ compiler (cfront), version
+ 2.0, released in June 1989. Implementations have had 30 years
+ to get this right; assume that they have.
+
+ * PROBLEMS: Drop corresponding item.
+
+2021-08-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Drop long-dead `COOKIE_BUG` logic.
+
+ * src/libs/libgroff/new.cpp (operator new, operator delete):
+ Drop preprocessor conditional branches on the `COOKIE_BUG`
+ symbol. This was de-documented, and an autoconf check for its
+ necessity removed, way back in groff 1.10 (November 1995). It
+ was relevant only to GCC from versions 2.0 to 2.2.2 (all 1992).
+
+2021-08-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff]: Refactor `font::scan_papersize()`.
+
+ * src/libs/libgroff/font.cpp (font::scan_papersize): Ensure
+ successful return value of `fgets()` before attempting to parse
+ string for paper format. Convert `test_file` to Boolean and
+ rename to `attempt_file_open`. Quiets GCC `-Wunused-result`
+ warning.
- * src/roff/troff/env.cpp, src/roff/troff/mtsm.cpp,
- src/roff/troff/node.cpp: s/html-tag/devtag/.
+2021-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (tag, taga): Always call
- curenv->add_node.
+ [tests]: Apply naming convention.
- * tmac/an-old.tmac, tmac/s.tmac, tmac/troffrc-end: Use DEVTAG*
- macros instead of HTML-TAG*.
+ * tmac/tests/e_footnotes_work_with_columns.sh: Rename from...
+ * tmac/tests/e_footnotes-work-with-columns.sh: ...to this.
+ * tmac/tmac.am (tmac_TESTS): Update.
- * tmac/devtag.tmac: New file, defining the DEVTAG-* macros.
+2021-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac: Load devtag.tmac.
- Replace HTML-TAG* macros with DEVTAG* macros.
- (HTML, HTML-NS): Changed definitions.
- (URL): Use HTML-NS.
- (HTML-TAG, HTML-TAG-NS, HTML-TAG-NEXT): Removed.
+ * tmac/an.tmac (IP): Make code more accessible by using a
+ Boolean operator rather than an arithmetic one (assembly
+ language programmers are comfortable with the interchangeability
+ of subtraction and comparison, but not everyone is).
- * tmac/Makefile.sub (NORMALFILES): Add devtag.tmac.
+2021-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-12-10 Werner LEMBERG <wl@gnu.org>
+ groff(7): Document more escapes.
- Import Mike's `gdiffmk' package.
+ * man/groff.7.man (Escape short reference): Document
+ `\[charNNN]`, `\[uNNNN]`, `\[uNNNN_NNNN...]` escape sequences.
+ Revise descriptions of `\O0` and `\O1` escape sequences.
+ Document `\O2`, `\O3`, `\O4`, and `\O5` escape sequences.
- * contrib/gdiffmk/*: New files.
- * Makefile.in (OTHERDIRS): Add contrib/gdiffmk.
- * NEWS: Updated.
+2021-08-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-12-08 Werner LEMBERG <wl@gnu.org>
+ groff(7): Fix bug in `\?` escape rendering.
- Import Keith's `pdfmark' package. Integration is very preliminary.
+ * man/groff.7.man (ESC?): Fix bug in page-private macro: the
+ question mark that ends this uniquely-syntaxed escape sequence
+ was not shown with the mandatory escape character before it.
+ Problem dates back at least to commit 41b0e794, 19 February
+ 2007, but possiby to f790bc7a9, 6 January 2002.
- * contrib/pdfmark/*: New files.
- * Makefile.in (OTHERDIRS): Add contrib/pdfmark.
- * NEWS: Updated.
+2021-08-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-12-07 Gaius Mulley <gaius@glam.ac.uk>
+ [docs]: Elaborate macro definition discussion.
- Fix a bug with title handling in HTML.
+ Fixes <https://savannah.gnu.org/bugs/?57944>. Thanks to Dave
+ Kemper for the report.
- * src/devices/grohtml/post-html.cpp (text_glob::is_nf,
- text_glob::is_fi, text_glob::is_ce): Use strlen to compute string
- length.
- (html_printer::handle_tag_within_title): New function.
- (html_printer::do_title): Use it.
+2021-08-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/s.tmac (TL): Don't set `need_eo_tl'.
- (cov*tl-au-print): Emit `.eo.tl' tag.
+ [tests]: Make robust against $GROFF_TYPESETTER settings.
-2004-12-05 Alejandro LĂłpez-Valencia <dradul@etb.net.co>
+ * src/roff/groff/tests/\
+ use_point_size_escape_with_single_digit_arg.sh:
+ * src/roff/nroff/tests/verbose_option_works.sh:
+ * tmac/tests/s_IP-indents-using-paragraph-type-size.sh: Export
+ an empty $GROFF_TYPESETTER to the environment.
- * man/groff_char.man: Minor imrovements.
+ Fixes <https://savannah.gnu.org/bugs/?60140>. Thanks to Bjarni
+ Ingi Gislason for the report.
-2004-12-04 Werner LEMBERG <wl@gnu.org>
+2021-08-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/eqn.man: Revised.
+ [libgroff]: Treat an empty $GROFF_TYPESETTER as unset.
-2004-11-25 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/device.cpp (device_init::device_init): Test
+ both returned pointer from `getenv()` and, if that's not null,
+ the first character of the string for nullity before assigning
+ it to `device`.
- * src/utils/xtotroff/xtotroff.c: Reformat to be similar to other
- groff source files.
- Include config.h.
- Include limits.h.
- Remove X_NOT_STDC_ENV conditional.
- (Version_string, program_name): New global variables.
- (groff_flag): Removed.
- (MapFont): Updated.
- (usage): Take a stream as argument.
- Use `program_name'.
- Update all callers.
- (main): Add `long_options' array for `--help' and `--version'.
- Make `-g' a dummy option.
- Handle `-v' and unknown options.
- Remove unused `position' variable.
+ Fixes <https://savannah.gnu.org/bugs/?61068>.
- * src/utils/xtotroff/Makefile.sub (MAN1): Define.
- (XLIBS): Add LIBGROFF.
+2021-08-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/xtotroff/xtotroff.man, src/utils/xtotroff/Makefile.in:
- New files.
+ [libgroff]: Rename font class member variable.
- * src/devices/xditview/Dvi.c (default_font_map): Split into three
- parts to avoid compiler warning.
- (resources): Don't initialize with `default_font_map'.
- (ClassInitialize): Initialize first element of `resources'.
+ * src/include/font.h (font class): Rename `unscaled_charwidths`
+ member variable to `use_unscaled_charwidths`: since it is a
+ Boolean, make it read more like a logical predicate.
- * src/devices/xditview/Makefile.sub (devdir, xtotroff, DPIS, fonts):
- Removed.
+ * src/libs/libgroff/font.cpp (font::get_width, font::load_desc):
+ * src/libs/libgroff/fontfile.cpp (font class): Update
+ initialization and assignments.
- * src/utils/lkbib/lkbib.man, src/utils/lookbib/lookbib.man,
- src/utils/pfbtops/pfbtops.man: Revised, updated.
+2021-08-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure.ac: Generate src/utils/xtotroff/Makefile.
- * configure: Regenerated.
+ * src/roff/troff/input.cpp (get_copy): Demote integer arguments
+ to Booleans and use Boolean literals for default values. Rename
+ `defining` to `is_defining`.
+ (get_char_for_escape_name, do_define_macro): Update call sites
+ that use non-default arguments to use Boolean literals and
+ comments to document what's being requested.
-2004-11-24 Werner LEMBERG <wl@gnu.org>
+2021-08-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- First fixes to get produce HTML.
+ * doc/doc.am (DOC_GROFF_ONLY): Stop running groff in unsafe
+ mode; no documents (in _this_ directory) appear to require it.
- * src/devices/grohtml/post-html.cpp (generate_img_src): Add `alt'
- attribute.
+2021-08-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (IMG, PIMG, MPIMG): Add `alt' attribute.
- (HR, LI): Use `HTML</p>', not `HTML'.
+ [grn]: Fix code style issues.
- * doc/webpage.ms: Minor updates.
+ * src/preproc/grn/hgraph.cpp:
+ * src/preproc/grn/hpoint.cpp:
+ * src/preproc/grn/main.cpp:
+ * src/preproc/grn/hdb.cpp: Drop use of `register` storage class.
-2004-11-23 Larry Kollar <kollar@alltel.net>
+ Fixes <https://savannah.gnu.org/bugs/?57733>. Thanks to Bjarni
+ Ingi Gislason for the report and a suggested patch.
- Add option -S grohtml to determine the file split level.
+ * src/preproc/grn/hgraph.cpp (len, HGPrintElt, picurve):
+ * src/preproc/grn/hdb.cpp (DBRead): Wrap long lines.
- * src/devices/grohtml/post-html.cpp (split_level): New global
- variable.
- (html_header::determine_header_level): Use split_level.
- (main): Handle `-S' command line option.
- Sort options.
+ * src/preproc/grn/hgraph.cpp: Rename function from
+ `Paramaterize` to `Parameterize`.
+ (HGCurve): Update call site.
- * src/preproc/html/pre-html.cpp (scanArguments): Updated.
+ * src/preproc/grn/main.cpp (add_file): Drop redundant cast in
+ `realloc()` call.
+ (conv, interpret): Use standard English in diagnostic messages.
- * src/devices/grohtml/grohtml.man: Document it.
- Sort options.
+2021-08-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Document it.
+ * src/preproc/grn/hdb.cpp: Perform more input validation.
+ Improve diagnostics by taking advantage of libgroff
+ infrastructure and tracking the line number of the input file.
+ Add global `lineno`.
+ (DBRead): Increment `lineno` after reading newlines from input.
+ Call `error_with_file_and_line()` instead of `error()`. If
+ input reports a negative length for the text (string) to follow
+ in the file, exit with a fatal diagnostic. Check for EOF while
+ reading text string.
+ (DBGetType): Convert `fprintf()` call for warning diagnostic to
+ `warning_with_file_and_line()`.
+ (DBRead, DBGetType): Add contextual information to diagnostic
+ messages.
-2004-11-23 Y T <doarhop@hotmail.com>
+ Fixes <https://savannah.gnu.org/bugs/?61043>. Thanks to
+ Savannah user eqkws for the report.
+
+2021-08-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/grn/main.cpp (usage): Update usage message.
+
+2021-08-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grn]: Add and use `malloc()` wrapper.
+
+ * /src/preproc/grn/main.cpp (grnmalloc): New function takes
+ argument of `size_t` type and constant string argument to
+ describe what is being allocated. Return non-null pointer from
+ `malloc()`, otherwise call `fatal()`, describing what was being
+ allocated and the problem reported by the system.
+
+ * src/preproc/grn/hdb.cpp (DBCreateElt):
+ * src/preproc/grn/hpoint.cpp (PTMakePoint):
+ * /src/preproc/grn/main.cpp (main, interpret): Migrate
+ `malloc()` callers to `grnmalloc()`.
+
+2021-08-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/grn/hdb.cpp (DBRead): Check return value of
+ `sscanf()` and call `fatal()` if no conversions succeeded. The
+ blithe discard of a useful return value is bad enough, but this
+ one took place inside a do-while such that it could loop
+ forever trying fruitlessly to parse two doubles out of strings
+ that didn't contain them (the loop never checked the EOF status
+ of the file stream from which it was reading, and relied on
+ `fgets()` to keep advancing the stream pointer). Discovered
+ while root-causing Savannah #61043.
+
+2021-08-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Resolve compiler warnings relating to format string security and
+ ISO C++98 conformance.
+
+ * src/preproc/eqn/delim.cpp (define_extensible_string):
+ * src/preproc/pic/pic.ypp (do_sprintf): Use #pragma to silence
+ GCC "format-nonliteral" warning and explain why our usage is
+ safe in a comment.
+
+ * src/preproc/preconv/preconv.cpp (detect_file_encoding): Use
+ `l` modifier to `%u` `fprintf()` conversion instead of `z`, and
+ cast return values of `size_t` to unsigned long; "ISO C++98
+ does not support the âzâ gnu_printf length modifier" (it doesn't
+ support `ll` either). N.B. this is debugging output only.
+
+ * src/roff/groff/groff.cpp (synopsis):
+ * src/roff/troff/input.cpp (usage): Repeat variadic argument for
+ `%s` conversion in `fprintf()` call because "ISO C++98 does not
+ support %n$ operand number formats".
- * tmac/s.tmac (ref*add-V, ref*add-N): New macros for handling
- the volume and number refer entries.
+ * src/roff/troff/env.cpp: Initialize adjustment and hyphenation
+ mode enums without commas at the end of the enumeration lists.
-2004-11-22 Werner LEMBERG <wl@gnu.org>
+2021-08-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/html-table.cpp
- (html_table::emit_table_header): Don't emit `cols' attribute which
- doesn't exist in HTML 4.0 and is thus invalid.
+ [man]: Clean up the interface between `an-footer` and `BT`, and
+ HTML header and footer suppression generally. Move
+ responsibility for checking the `ps4html` register from the
+ latter to the former. This is not something a `BT` redefiner
+ {see groff_man(7)} should have to worry about.
- * NEWS: More minor fixes and updates.
+ * tmac/an.tmac (BT): Drop test of `ps4html` register and early
+ return.
+ (an-header, an-footer): Return immediately if
+ `an-suppress-header-and-footer` is true. Remove conditional on
+ `an-is-output-html`.
+ (initialization): Define `an-suppress-header-and-footer`
+ register; true if `an-is-output-html` is true, or if `ps4html`
+ is defined.
-2004-11-18 Werner LEMBERG <wl@gnu.org>
+2021-08-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (HTML-NS, HTML-TAG-NS, HTML-TAG-NEXT): Simplified.
- (HTML</p>): Minor clean-up.
+ * src/preproc/html/pre-html.cpp (get_resolution): Unbrace a
+ single-statement `while` loop per prevailing coding style. Add
+ comments noting how we aren't parsing DESC files _precisely_ as
+ our documentation specifies.
- * tmac/groff_www.man: Updated.
+2021-08-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/grohtml.man: Revised and updated.
+ Convert font class `int` members to `bool` where appropriate.
- * NEWS: Updated.
+ * src/include/font.h (font class): Demote integers to Booleans
+ and use Boolean literals where possible. Rename some member
+ variables to look like logical predicates.
+ - contains()
+ - is_special()
+ - has_ligature()
+ - tcommand -> has_tcommand
+ - unscaled_charwidths
+ - pass_filenames
+ - use_charnames_in_special
+ - is_unicode
+ - special (private)
+ * src/libs/libgroff/font.cpp (font::font): Construct object
+ using Boolean literal.
+ (font::contains):
+ (font::is_special):
+ (font::has_ligature): Convert return type to `bool`.
+ (font::load):
+ (font::load_desc): Assign to member variables using Boolean
+ literals.
+ * src/libs/libgroff/fontfile.cpp: Initialize appropriate globals
+ using `bool` type and Boolean literals.
+ * src/roff/troff/troff.h:
+ * src/roff/troff/input.cpp (main):
+ * src/roff/troff/node.cpp (troff_output_file::put_char_width):
+ Rename `tcommand_flag` to `device_has_tcommand` to suggest a
+ logical predicate, and to emphasize the formatter's concern with
+ what the output device can accept in the intermediate output
+ language.
+ * src/roff/troff/input.cpp: Initialize `device_has_tcommand`
+ global using `bool` type and Boolean literal.
+
+2021-08-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [me]: Clarify breadth of application of `ll` macro.
-2004-11-18 Gaius Mulley <gaius@glam.ac.uk>
+ * doc/meref.me: Document application of .ll macro only to the 3
+ environments that me(7) uses, not any the user might create.
+ * tmac/e.tmac (@C, xl, ll): Update comments.
- * src/devices/grohtml/post-html.cpp (html_printer::do_heading):
- Fix space insertion.
- (html_printer::do_links): Fix rules generation around automatic
- heading links.
+ Fixes <https://savannah.gnu.org/bugs/?55060>.
- * tmac/www.tmac (LK): Use HTML-TAG-NS.
- (HR): Simplify.
- No longer emit empty line for non-HTML devices.
+2021-08-13 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-11-17 Werner LEMBERG <wl@gnu.org>
+ Add regression test for Savannah #58736.
- * doc/Makefile.in (prepare_examples, webpage.html): Handle
- `groff.css'.
+ * tmac/tests/e_footnotes_work_with_columns.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * doc/Makefile.sub (EXAMPLEFILES, CLEANNOTSRCDIRADD,
- prepare_examples, webpage.html): Handle `groff.css'.
+2021-08-13 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-11-15 Werner LEMBERG <wl@gnu.org>
+ * tmac/e.tmac (bc): Fix problem with multiple columns on long
+ pages. Space to the next page location trap, not 24 inches.
+ Thanks to Dave Kemper and Bjarni Ingi Gislason for help tracking
+ this bug down.
- * NEWS, README, doc/webpage.ms: Updated.
+ Fixes <https://savannah.gnu.org/bugs/?55081>.
- * tmac/www.tmac (HTML, HTML-TAG): Minor clean-ups.
+2021-08-13 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-10-30 Gaius Mulley <gaius@glam.ac.uk>
+ Add regression test for Savannah #55081.
- * src/include/printer.h (printer): Remove virtual function
- `round_width'.
- Update all source files.
+ * tmac/tests/e_columns-work-on-long-pages.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * src/devices/grohtml/post-html.cpp (html_printer): New member
- function `round_width'.
+2021-08-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-10-20 Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
+ * man/groff.7.man (Localization): Add section.
- * src/preproc/tbl/table.cpp (table::do_row): Fix handling of the `d'
- column key letter suffix.
+2021-08-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-10-14 Werner LEMBERG <wl@gnu.org>
+ * tmac/cs.tmac:
+ * tmac/de.tmac:
+ * tmac/fr.tmac:
+ * tmac/it.tmac:
+ * tmac/sv.tmac: Update ms package localization to use an
+ appropriate hyphenation mode for the `HY` register (the
+ mode for the pattern files, plus 2 as is traditional in ms).
- * Makefile.in (check): Depend on `site.exp' and `docheck'.
- (docheck): Run dejagnu's `runtest' if it exists.
- (site.exp): Create dejagnu configuration file.
+2021-08-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.sub (DISTCLEANFILES): Add files related to dejagnu.
+ * tmac/e.tmac (1c): Place comment escape sequence immediately
+ after macro argument. (When redefining a request, one needs to
+ remember that request arguments are not parsed exactly as macro
+ arguments are.) Quiets "-w tab" warning.
-2004-10-13 Werner LEMBERG <wl@gnu.org>
+2021-08-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/html-text.cpp (html_text_get_alignment),
- src/devices/grohtml/post-html.cpp (make_val,
- html_printer::handle_state_assertion): Fix compiler warnings.
+ [me]: Fix misleading documentation claim; gremlin(1) pictures
+ cannot be included directly; they must be preprocessed with
+ grn(1).
- * src/roff/troff/div.cpp: Include `stringclass.h' and `mtsm.h'.
- (diversion::diversion): Fix order of initializers.
+ * doc/meref.me:
+ * tmac/groff_me.7.man: Replace "gremlin" with "grn".
- * src/roff/troff/div.h: Don't include `mtsm.h'.
+2021-08-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/env.cpp: Include `stringclass.h' and `mtsm.h'.
- (environment::environment): Fix order of initializers.
- (environment::make_tag, environment::construct_format_state): Fix
- compiler warnings.
+ * tmac/groff_me.7.man: Document `n1` and `n2` macros.
- * src/roff/troff/input.cpp: Include `stringclass.h' and `mtsm.h'.
- (input_iterator::input_iterator, macro::macro): Fix order of
- initializers.
+2021-08-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/mtsm.cpp: Include only necessary header files.
- (state_set::add, state_set::val): Fix compiler warnings.
+ [me]: Fix PS/n1 combination diagnostic spew and apparent logic
+ error.
- * src/roff/troff/mtsm.h: Don't include `stringclass.h'.
- (bool_value_state, int_value_state, units_value_state,
- string_value_state): Remove comma after last element which causes
- an error with g++ 3.3.3.
+ * tmac/e.tmac (@h): Place comment escape sequence immediately
+ after macro argument. (When redefining a request, one needs to
+ remember that request arguments are not parsed exactly as macro
+ arguments are.)
+ (n2): Prefix with `do` requests using long register names.
+ (n2): Add macro-local register `|l` to store length of first
+ argument. Don't attempt to extract a substring beyond the
+ bounds of its source, which produces a warning diagnostic.
+ (&&): Define no-op macro for use as end macro in nested macro
+ definition.
+ (PS): Fix unbalanced-else diagnostic by changing `if` to `ie`.
+ (PS): Initialize `PS_nm_cnt` register to 0 instead of relying on
+ implicit definition.
+ (PS): Prefix with `do` definition of long macro name.
+ (PS): Indent call of end macro.
+ (PS): Add comment after escaped space.
+ (PS, PF): Prefix with `do` call of long macro name.
- * src/roff/troff/node.cpp: Include `stringclass.h'.
- (hline_node::hline_node, vline_node::vline_node,
- space_char_hmotion_node, left_italic_corrected_node): Fix compiler
- warnings.
- (zero_width_node::zero_width_node): Fix order of initializers.
-
- * src/roff/troff/node.h: Don't include `mtsm.h'.
- (hmotion_node): Fix compiler warnings.
-
- * src/roff/troff/number.cpp: Include `stringclass.h' and `mtsm.h'.
-
-2004-10-12 Gaius Mulley <gaius@glam.ac.uk>
-
- * doc/groff.css: New file.
-
- * doc/webpage.ms: Use `groff.css'.
- Other small fixes.
-
- * tmac/an-old.tmac (need_eo_h): New number register.
- (TH): Emit `.eo.tl' tag after title.
- (SH): Set `need_eo_h'.
- (an-trap): Handle `need_eo_h'.
- (an-do-tag): s/HTML-TAG-NS/HTML-TAG-NEXT/.
-
- * tmac/s.tmac (need_eo_h, need_eo_tl): New number registers.
- (TL): Always start diversion.
- Updated.
- (@AI): Always call `par@reset'.
- (@AB): Update code for -Thtml.
- (cov*tl-au-print): Handle -Thtml.
- (par@reset): Handle `need_eo_tl', `need_eo_h'.
- (@IP): Simplified.
- (@IT-html): Removed.
- (@SH): Set `need_eo_h' for -Thtml.
- (par@TL): s/HTML-TAG/HTMl-TAG-NS/.
- Set `need_eo_tl'.
- (@NH): s/HTML-TAG/HTMl-TAG-NS/.
- Set `need_eo_h' for -Thtml.
- (@EQ, @EN): Don't handle -Thtml specially.
- (par@load-init): Don't handle -Thtml specially.
-
- * tmac/www.tmac (www:paraspace): New macro.
- (HTML-NS, HTML-TAG-NS): Use new `tag' request.
- (HTML</p>, HTML-TAG-NEXT): New macros.
- (HnE): Emit tag `.eo.h' instead of break.
- (HR): s/HTML-NS/HTML/.
- (www-end-nowhere): End diversion only if `www-html' not set.
- Emit `.eo.tl' tag.
- (ULS, ULE): s|HTML|HTML</p>|.
- (LI): Call `www:paraspace'.
- (HEAD): New macro.
-
-2004-10-11 Gaius Mulley <gaius@glam.ac.uk>
-
- * src/roff/troff/request.h (macro): Make `p' public.
- New variable `is_a_diversion'.
- New member function `is_diversion'.
-
-
- * src/devices/grohtml/html.h (simple_output): New member function
- `force_nl'.
-
- * src/devices/grohtml/html-table.cpp (tabs::compatible): Fix
- computation of `total'.
- (tabs::check_init): New function.
- (html_table::emit_table_header): Emit style data.
- (html_table::insert_column): Improved.
-
- * src/devices/grohtml/html-table.h: Updated.
-
- * src/devices/grohtml/html-text.cpp (html_text::html_text):
- Initialize `start_space' with TRUE.
- (html_text::end_tag, html_start_tag): Fix `P_TAG' and `PRE_TAG'
- cases.
- (html_text::flush_text): Set `start_space' flag.
- (html_text::uses_indent, html_text::remove_para_space,
- html_text::get_alignment): New functions.
- (html_text::push_para): Updated.
- (html_text::do_para): Check for empty argument.
- Don't set `space_emitted'.
- (html_text::do_space, html_text::emit_space): Updated.
-
- * src/devices/grohtml/html-text.h (tag_definition): New variable
- `really_issued'.
- (html_text): New member function `uses_indent', `remove_para_space',
- `get_alignment'.
-
- * src/devices/grohtml/output.cpp (simple_output::force_nl): New
- function.
- (simple_output:nl): Always emit `\n'.
-
- * src/devices/grohtml/post-html.cpp: Include `string.h'.
- (BASE_POINT_SIZE): Removed.
- (base_point_size, head_info): New global variables.
- (text_glob): New member functions `is_ll', `is_tl', `is_eo_tl',
- `is_eo_h'.
- (text_glob::is_nf, text_glob::is_fi): Handle `.fi 0' and `.fi 1'
- tags, respectively.
- (page::add_and_encode): Pass additional parameter for tag flag.
- (assert_pos): New structure.
- (assert_state): New class.
- (html_printer): Remove `indentation', `prev_indent'.
- Add variables `troff_indent', `device_indent', `temp_indent'.
- Add variables `seen_indent', `next_indent', `seen_pageoffset',
- `next_pageoffset', `seen_linelenght', `next_linelength',
- `seen_center', `next_center', `seen_space', `seen_break', `as'.
- Add member functions `do_check_center', `do_space', `do_head',
- `get_troff_indent', `restore_troff_indent', `handle_assertion',
- `handle_state_assertion', `do_end_para', `set_char_and_width'.
- Change argument to `do_fill' to `char *'.
- Update constructor.
- (html_printer::emit_raw): Call `shutdown_table'.
- Use new functions.
- (html_printer::do_center): Simplified.
- (html_printer::do_title): Improved.
- (html_printer::write_header): Emit one more newline.
- Use new functions.
- (html_printer::do_heading, html_printer::do_indent,
- html_printer::do_eol, html_printer::do_tab_ts,
- html_printer::do_tab, html_printer::do_tab0,
- html_printer::calc_po_in, html_printer::next_horiz_pos,
- html_printer::remove_courier_tabs,
- html_printer::insert_tab0_foreach_tab, html_printer::begin_page):
- Updated.
- (html_printer::do_linelength, html_printer::do_pageoffset,
- html_printer::do_indentation, html_printer::do_tempindent,
- html_printer::do_tab_te): Simplified.
- (html_printer::do_pointsize): Check whether point size is really
- associated a `.tl' tag.
- (html_printer::do_break): Rewritten.
- (html_printer::troff_tag): Improved.
- (html_printer::flush_globs): Updated.
- (html_printer::lookahead_for_tables): Handle `is_br'.
- Use new functions.
- (html_printer::set_char): Check `sbuf_style.f'.
- (html_printer::write_navigation): Use string comparison.
- (html_printer::~html_printer): Emit `head_info'.
- (html_printer::special): Rewritten.
- (get_str, make_val): New functions.
- (main): New option `s' to set the base point size.
-
- * src/preproc/html/pre-html.cpp (scanArguments): Handle option `s'.
-
-2004-10-10 Gaius Mulley <gaius@glam.ac.uk>
-
- * src/roff/troff/node.cpp: New extern `debug_state'.
- Include `stringclass.h' and `mtsm.h'.
- Implement new classes and class members from `node.h'.
- (real_output_file): Make `fp' public.
- (troff_output_file): New variables `cur_div_level' and `tag_list'.
- Update constructors.
- (troff_output_file::really_print_line): Check whether we should push
- the current troff state and use the state at the start of the
- invocation of this diversion.
- (troff_output_file::add_to_tag_list): New member function.
- (node::add_char): Handle `glyph_comp_np'.
-
- * src/roff/troff/node.h: Include `mtsm.h'.
- (node): New variables `state', `push_state', `div_nest_level',
- `is_special'. Update constructors, all descendants.
- Pass additional argument to `add_char' member function.
- New virtual member functions `is_tag', `debug_node',
- `debug_node_list'. Update all descendants.
- (tag_node): New class for handling tags.
- (output_file): Add variable `state'.
-
-2004-10-09 Gaius Mulley <gaius@glam.ac.uk>
-
- * src/roff/troff/mtsm.cpp, src/roff/troff/mtsm.h: New files,
- providing a minimal troff state machine to emit meta tags for the
- post-grohtml device driver.
-
- * src/roff/troff/Makefile.sub (OBJS, CCSRCS, HDRS): Handle new
+ Fixes <https://savannah.gnu.org/bugs/?61019>.
+
+2021-08-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl (do_line): Recognize `n1` and `n2` as
+ characteristic me(7) macros.
+
+2021-08-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/groff_me.7.man: Document GF, IE, IF, IS, and PF macros.
+
+2021-08-08 Dave Kemper <saint.snit@gmail.com>
+
+ * tmac/e.tmac: Rename `PE` to `PF` but remove vertical spacing.
+ (PE): New `PE` calls `PF` and then spaces as old `PE` did.
+
+ Fixes <https://savannah.gnu.org/bugs/?60479>.
+
+2021-08-06 Dave Kemper <saint.snit@gmail.com>
+
+ * doc/meref.me: Improve documentation of image-inclusion macros.
+
+ Fixes <https://savannah.gnu.org/bugs/?60478>.
+
+2021-08-06 Dave Kemper <saint.snit@gmail.com>
+
+ GNU pic recognizes two possible endings of a pic block: .PE or
+ .PF. This fact was documented in doc/pic.ms but not in the pic
+ man page. The minimal pic implementation provided by pic.tmac
+ also did not include a .PF definition.
+
+ * src/preproc/pic/main.cpp (main): Add dummy definition of `PF`
+ macro.
+ * tmac/pic.tmac (PF): Add macro that performs indentation only.
+ (PE): Call PF for indentation.
+
+ * doc/pic.ms (Interface to [gt]roff/How Scaling is Handled):
+ * src/preproc/pic/pic.1.man (Description, Options): Mention `PF`
+ in addition to `PS` and `PE`.
+
+ Fixes <https://savannah.gnu.org/bugs/?60504>.
+
+2021-08-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/refer-ms.tmac:
+ * tmac/s.tmac (fn@init, @PP): Rename strings
+ `fn@sup-{start,end}` to `fn@mark-{start,end}`. This makes it
+ more clear that the strings are brackets for the footnote
+ marker, and not so much to do with the note text. Further, in
+ nroff mode, they aren't superscripts at all, but bracket glyphs.
+
+2021-08-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/refer/refer.1.man (Examples): Add section.
+
+ Addresses part of <https://savannah.gnu.org/bugs/?57667>.
+
+2021-08-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/refer-ms.tmac: Use `fn@sup-{start,end}` instead of
+ `par@sup-{start,end}` when setting refer(1) citation labels.
+ This improves the appearance of the default labels on nroff
+ devices. Continues commit caeede07, 1 May.
+
+2021-08-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tman/an-ext.tmac (EX, EE): Stop manipulating hyphenation.
+ It's redundant since disabling fill mode already prevents
+ automatic breaking, and therefore automatic hyphenation.
+ * tmac/groff_man.7.man.in (Description/Document structure
+ macros) <EX, EE>: Update documentation.
+
+2021-08-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Update authorship credits. I appear
+ to have removed or refactored all of the "device" (recte: macro
+ package) inference logic adapted from Ralph Corderoy's grog.sh;
+ see commit 3617f42048f54cc3f0adc282ee3b9e481c75ebd5, 13 June
+ 2014.
+
+2021-07-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Refactor through relocation and
+ renaming. Move several global objects into subroutines.
+ - `@request` -> `&do_line`
+ - `@macro_ms`, `@macro_man`, `@macro_man_or_ms` ->
+ `&infer_man_or_ms_package`
+ - `@main_package` -> `&construct_command`
+ Rename some objects for clarity.
+ - `%Groff` -> `%score`
+ - `@filespec` -> `$input_file`
+ Delete unused object.
+ - `@standard_macro`
+ Add comments.
+
+2021-07-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl (do_line): When matching macro/request
+ names, accept any non-whitespace character (Perl: \S) instead of
+ just a word-constituent character (Perl: \w), since roff
+ identifiers can contain unusual characters (refer(1) and
+ groff_me(7) illustrate some real-world cases).
+
+2021-07-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Refactor macro package inference.
+ - Stop manually populating `Groff` hash. (It's itching for a
+ rename.)
+ - Stop calling now-dead subroutine `infer_macro_packages`.
+ (do_line): Always store the names of all macros called to the
+ `Groff` hash, incrementing it. Now it's a proper scoreboard.
+ Populate `inferred_main_package` from here upon encountering
+ characteristic (i.e., uniquely named) macros of each package.
+ Bug fix: drop "SP" from list of characteristic mom(7) macros;
+ it's shared with mm(7).
+ (infer_man_or_ms_package): Update comment. Return 0 (false) if
+ document appears to be "raw", using no full-service macro
+ package.
+ (infer_macro_packages): Delete; do_line() does this work.
+
+2021-07-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Refactor preprocessor inference.
+ - Add new list, `inferred_preprocessor`.
+ - Drop preprocessor-related keys from `Groff` hash.
+ - Drop scalar `inside_tbl_table`.
+ (do_line): Set up hash `preprocessor_for_macro`. Detect
+ preprocessor macros the way the preprocessors do, explained in a
+ comment. Respect AT&T compatibility mode when doing so. Build
+ list of inferred preprocessors. This replaces the extensive and
+ gaseous series of `if` statements that manipulated the `Groff`
+ hash.
+ (infer_preprocessors): Completely replace. Set up a hash
+ `option_for_preprocessor` mapping preprocessor names to groff
+ options (where applicable). Append to `command` and
+ `preprocessor` lists as appropriate. Sort the preprocessor
+ options so they don't move around in the argument list depending
+ on the order of their macros' appearance in the input.
+
+ * src/utils/grog/tests/smoke-test.sh: Update test cases to
+ expect preprocessor options to show up in sorted order.
+
+2021-07-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Drop dead code. Delete global
+ hash `preprocs_tmacs`, unused since commit b0de53c9, 30 June.
+
+2021-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Fix code nit.
+
+ * src/preproc/html/pre-html.cpp (get_image_generator):
+ Type-qualify `keyword_len` as `const` to encourage the compiler
+ to compute this value (the length of a string literal) at build
+ time.
+
+2021-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Slightly refactor.
+
+ * src/roff/troff/node.cpp: Add static `image_filename_len` to
+ store length of cached image file name, so we don't wastefully
+ recompute its length every time one is re-used.
+ (suppress_node::tprint): Compute image file name length only
+ when saving a new image file name. Use saved length in later
+ expressions.
+ (min): Drop unused inline function.
+
+2021-07-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Fix regression (breaking important pdfmark/pdfroff
+ features) caused by my commit
+ e876d4bfd193abb9a7d1fb6e76519349bded482a, 27 July. An empty
+ image file name is in fact semantically valid when writing a
+ bounding box; pdfmark uses such boxes to frame hyperlinks.
+ Avoid null pointer dereference by initializing `image_filename`
+ to an empty string literal. Thanks to Tadziu Hoffman and Keith
+ Marshall for their patient explanations.
+
+2021-07-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Refactor some internal functions.
+
+ * src/roff/troff/node.cpp: Rename two functions that have only
+ one caller.
+ - get_reg_int -> get_register
+ - get_reg_str -> get_string
+ We now have:
+ (get_register, get_string): Use `assert()` aggressively because
+ these are deeply internal and validation is imperative. Get rid
+ of diagnostic messages (one of which perpetuated the dubious
+ "number register" nomenclature) accordingly.
+ (fetch_register): Also rename `prev_value`, misleadingly
+ specific and seemingly copy-and-pasted out of a context where an
+ auto-increment or -decrement might have been applied. It's just
+ the `value`.
+ (suppress_node::tprint): Update call site.
+
+2021-07-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Refactor `get_value` member functions. Given their
+ names and popular "getter/setter" paradigms from many OO
+ languages, the return type is misleading. Change it from `int`
+ to `bool` since it returns only a success/failure status and
+ modifies an argument (passed by reference) to deliver the
+ requested data.
+
+ * src/roff/troff/reg.h (reg, variable_reg):
+ * src/roff/troff/div.cpp (page_offset_reg, page_length_reg)
+ (vertical_position_reg, high_water_mark_reg)
+ (distance_to_next_trap_reg, page_number_reg, no_space_mode_reg):
+ * src/roff/troff/env.cpp (int_env_reg, vunits_env_reg)
+ (hunits_env_reg, horizontal_place_reg):
+ * src/roff/troff/input.cpp (writable_lineno_reg):
+ * src/roff/troff/reg.cpp (reg, number_reg, variable_reg): Update
+ class and member function definitions to reflect the new type.
+ Update member function definitions to return appropriate Boolean
+ literals instead of 0 and 1.
+
+2021-07-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Fix Savannah #60981. Refactor device description
+ file handling and make it more robust. Make pre-grohtml's
+ -F option work as documented and honor device description file
+ semantics documented in groff_font(5).
+
+ * src/preproc/html/pre-html.cpp: Store partial filespecs of HTML
+ and PostScript device files in constant strings.
+ (get_resolution): Initialize `res` to zero. Only `free()` the
+ pointer `pathp` if `open_file()` succeeded (populating it).
+ Stop checking for valid `sscanf()` conversions of an integer to
+ store in `res`, and don't return early. Instead process the
+ whole DESC file; per our Texinfo manual and groff_font(5),
+ "Later entries in the file ... override previous values."
+ (get_image_generator): Add new function, paralleling
+ `get_resolution()`, replacing open-coded logic in `main()`.
+ Only the body of the `while` loop significantly differs.
+ Instead of using `sscanf`, process the input character by
+ character matching the keyword and {1,} spaces or tabs
+ after it. Whatever follows in `linebuf` must be the program
+ name.
+ (imageList::createPage): Add `assert()` to cause failure if an
+ empty image generator program gets this far, because it creates
+ repeated messes if it does. (Something isn't checking exit
+ statuses.)
+ (main): Condense `image_gen` collection to a function call, a
+ null pointer check, and a fatal diagnostic. Add a sanity check
+ and a fatal diagnostic if the PostScript resolution is garbage.
+ {It's initialized to -1 and `get_resolution()` will return 0 if
+ it doesn't find one.}
+
+ Fixes <https://savannah.gnu.org/bugs/?60981>.
+
+2021-07-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Delete or rename `debug` symbols to avoid clash with
+ new `debug` function in libgroff.
+
+ * src/preproc/html/pre-html.cpp: Update a comment to refer to
+ "debugging" mode. Rename static global from `debug` to
+ `debugging`.
+ (html_system, imageList::createPage, imageList::createImage,
+ print_args, char_buffer::do_html, char_buffer::do_image,
+ scanArguments): Update uses of static global.
+
+ * src/preproc/html/pushback.cpp:
+ * src/preproc/html/pushback.h: Delete unused `debug` member
+ variable.
+
+2021-07-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/nroff/nroff.sh: Fix straggling use of `$1`, which
+ might not have a clear meaning in some shells after being
+ shifted (what if we just shifted the last argument?). Also
+ `continue` after processing a (groff) option argument, as we
+ should make no attempt to parse it.
+
+2021-07-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (do_suppress): Recast diagnostic
+ messages for clarity, to communicate in terms of what the
+ escape sequence _is_, and to quote literals expected as input.
+ * src/roff/troff/node.cpp (suppress_node::tprint): Recast
+ diagnostic to prevent misinterpretation of image "description"
+ as being HTML IMG tag alt text or something like that.
+ Unfortunately, the new language speaks in terms of internal
+ implementation details ("grohtml-info"), but at least that way
+ it's easier for a user to decide if they care about it.
+
+2021-07-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Avoid using sprintf() with user-controlled format
+ string.
+
+ * src/preproc/html/pre-html.cpp (makeFileName): Add comment
+ noting need for implementation synchrony between this function,
+ which generates \O5 escape sequences, and troff's
+ suppress_node::tprint member function, which interprets them.
+ * src/roff/troff/node.cpp: Rename 2 static globals for clarity.
+ - `last_image_filename` -> `image_filename`
+ - `last_image_id` -> `subimage_counter`
+ (suppress_node::tprint): Set up the buffer for image file name
+ to be written using a constant rather than an embedded literal.
+ Unconditionally initialize the buffer with a string terminator,
+ so there is no chance of a read from uninitialized storage.
+ Drop unused code involving `tem`. Drop stale comments. Clarify
+ comment: an `image_filename` doesn't _always_ contain a format
+ string, only sometimes. Replace use of `sprintf` with manual
+ construction of a new image filename string. There are two
+ cases, one where a format string {presently "%d"} is present,
+ and one where it is not. If it is present, locate it
+ {`percent`}. This means a limited/bounded image ("subimage") is
+ being processed; increment the subimage counter. Write a new
+ image file name preserving the parts before and after "%d" (the
+ "prefix" and "suffix", and replacing only the middle, using
+ `sprintf` with the subimage counter and the (string literal)
+ format. Be mindful of string bounds and memory allocation,
+ issuing diagnostics or aborting as necessary. If the image file
+ name does _not_ contain a format string, but needs only to be
+ copied, do that (`strcpy`), again instead of using `sprintf`.
+
+ Fixes <https://savannah.gnu.org/bugs/?60977>.
+
+2021-07-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Fix Savannah #60971.
+
+ * src/preproc/html/pre-html.cpp (makeFileName): Consistently put
+ a dash at the end of `macroset_template` whether the image file
+ name stem is user-supplied or the default. Stop adding the dash
+ before the image number in `image_template` instead. This makes
+ the image file name format reliable whether the image needs to
+ be subdivided (eqn) or not (tbl).
+
+ Fixes <https://savannah.gnu.org/bugs/?60971>.
+
+2021-07-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Reduce noise to standard error stream.
+
+ * src/preproc/html/pre-html.cpp (imageList::createImage): Fix
+ apparent oversight: `EXE_EXT` was not being applied to the
+ second of three commands being run in a pipeline (did Windows
+ users notice?). Also issue (undocumented!) `-quiet` option to
+ `pnmtopng` to shut up its commentary about counting colors.
+
+2021-07-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Stop discarding standard error output.
+
+ * src/preproc/html/pre-html.cpp (html_system): Stop sending the
+ standard error stream to /dev/null; this just makes debugging
+ harder, and doesn't produce much more output for well-formed
+ input documents. Rename `save_stdout` to `saved_stdout`.
+
+2021-07-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grohtml]: Fix misspelled variable.
+
+ * src/preproc/html/pre-html.cpp: Rename `IMAGE_BOARDER_PIXELS`
+ to `IMAGE_BORDER_PIXELS`.
+
+2021-07-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [libgroff, troff]: Add debug diagnostic level.
+
+ * src/include/error.h: Declare functions
+ `debug_with_file_and_line` and `debug`.
+ * src/libs/libgroff/error.cpp: Add `DEBUG` to enum `error_type`.
+ (do_error_with_file_and_line): Add case for `DEBUG` in switch.
+ (debug, debug_with_file_and_line): Add new functions.
+
+ Do the same for troff since it has a private implementation of
+ the diagnostic functions (thanks to `output_warning()`).
+
+ * src/roff/troff/input.cpp: Add `DEBUG` to enum `error_type`.
+ (do_error_with_file_and_line): Add case for `DEBUG` in switch.
+ (debug, debug_with_file_and_line): Add new functions.
+
+2021-07-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/hpftodit/hpftodit.cpp (hp_msl_to_ucode_name)
+ (unicode_to_ucode_name): Hush "format nonliteral" compiler
+ warnings by using a preprocessor-defined string literal as an
+ sprintf() format string instead of a C++ variable that just
+ compared identically to the same thing.
+
+2021-07-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/hpftodit/hpftodit.cpp (show_symset): Prevent
+ sprintf() from overunning a static buffer. Thanks to Bjarni
+ Ingi Gislason for the report. Resize buffer to be large enough
+ to accommodate a 64-bit unsigned int type formatted as decimal.
+ Also add assert() before the sprintf() to abort if the int type
+ is even larger than that. Use "%u" conversion instead of "%d"
+ since the quantity is unsigned.
+ (hp_msl_to_ucode_name): Similar, but for a signed int.
+ (unicode_to_ucode_name): Similar, but for a signed int formatted
+ as (unsigned) hexadecimal.
+
+ Fixes <https://savannah.gnu.org/bugs/?60964>.
+
+2021-07-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/nroff/nroff.sh: Refactor, mostly by relocation. Move
+ locale character set inference logic so that we only run it if
+ we have to (`-T` option was invalid or not given and
+ `GROFF_TYPESETTER` was not set in the environment or invalid).
+ Initialize `T` variable as empty.
+
+2021-07-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/nroff/nroff.sh: Use Version 7 Unix sh-compatible form
+ of parameter expansion; per the GNU Autoconf manual[1], "[o]ld
+ BSD shells, including the Ultrix sh, don't accept the colon for
+ any shell substitution, and complain and die." This is also the
+ form of such substitutions used elsewhere in the script, so they
+ should be mutually consistent.
+
+ [1] https://www.gnu.org/software/autoconf/manual/autoconf-2.60/\
+ html_node/Shell-Substitutions.html
+
+2021-07-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/nroff/nroff.sh: Slightly refactor. Rename formerly
+ unused loop index variable from `i` to `arg` to leverage it in a
+ later diagnostic message without a separate definition. Inside
+ the loop, expand `arg` instead of positional parameter 1, the
+ meaning of which is less obvious after the parameter list is
+ shifted by the new `is_option_argument_pending` logic (commit
+ 2b955c57, 20 July).
+
+2021-07-23 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/groff.1.man (Options) <-S>: Fix error: `-S`
+ sets safer mode (redundantly) but is not passed to pic and troff
+ as was claimed.
+
+2021-07-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/number.cpp (parse_term): Tweak diagnostic
+ messages. When a left operand to a binary operator is empty,
+ report the operator in question (helpful for string
+ interpolations in complex expressions). When handling input
+ scaling indicators, drop word "this" from "this context", since
+ the parser's context might not be clear from a file name and
+ line number. Say "scaling indicator" instead of "scale
+ indicator".
+ (parse_expr, parse_term): Rename function parameter from
+ `scale_indicator` to `scaling_indicator`.
+
+2021-07-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (define_color): Tweak warning
+ diagnostics for clarity. Only one value is expected when
+ defining a color in the `gray` color space. Quote recognized
+ color space names when complaining of an unknown one.
+
+2021-07-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [nroff]: Pass a supplied `-c` option to groff. While at present
+ this does little more than `-P-c` already achieves, that might
+ not be true forever. Further, there is a distinction between
+ ignoring color-related requests in groff input documents and
+ ignoring color-related commands in device-independent output.
+ This distinction would make it unwise to adapt `-c` to any other
+ purpose in nroff in the future.
+
+ * NEWS: Update item from commit dd725dce, 10 February 2020.
+ * src/roff/nroff/nroff.sh: Pass `-c` option to groff in addition
+ to synthesizing a `-P-c` option (for grotty) when it is seen.
+ * src/roff/nroff/nroff.1.man (Options): Document `-c` as an
+ option recognized by troff(1).
+
+2021-07-20 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [nroff]: Support space between option flags and their arguments.
+
+ * src/roff/nroff/nroff.sh: Add new `is_option_argument_pending`
+ flag to add an additional state to the option parser. Set it if
+ an argument-requiring option is encountered with no abutting
+ argument. If it is set when a new argument is encountered,
+ absorb the argument into the groff option list and clear the
+ flag. Modernize script in a couple of other ways.
+ - Exit with status 2 upon usage errors so that this condition
+ is easily distinguished from a groff abort (which exits with
+ status 1).
+ - Test shell variables for non-nullity with test(1) -n
+ operator instead of a string comparison.
+ * src/roff/nroff/tests/verbose_option_works.sh: Test correct
+ construction of groff command using this input form.
+ * src/roff/nroff/nroff.1.man (Options): Add spaces between
+ option flags and option arguments. Sync metasyntactic variable
+ names with groff(1) while we're at it.
+ (Description): Drop sentence warning of whitespace prohibition.
+ (Exit status): Add new section.
+
+ Fixes <https://savannah.gnu.org/bugs/?60943>.
+
+2021-07-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (main): Emit error diagnostic if `-d`
+ or `-r` option is given a malformed argument. This prevents a
+ string or register with an empty name from being created.
+
+ Fixes <https://savannah.gnu.org/bugs/?60935>.
+
+2021-07-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/nroff/nroff.sh:
+ * src/roff/troff/input.cpp (usage): Use "dev" as metasyntactic
+ variable name for -T option argument to achieve consistency with
+ our other documentation.
+
+2021-07-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [groff]: Comment out vestiges of gideal support. It would be
+ lovely to have, but no free (and GPL-compatible) implementation
+ has showed up after decades of waiting. Production of the
+ original was a Ph.D. thesis. Excited by de Moivre's theorem?
+ Take a stab at it.
+
+ * src/roff/groff/groff.cpp (main): Comment out effect of `-J`
+ option. It remains recognized, but silently ignored (instead of
+ attempting to execute a nonexistent preprocessor).
+ (synopsis): Add comment reminding us to document the option if
+ we ever get the support.
+ (help): Comment out documentation of option.
+
+2021-07-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [[gnt]roff]: Make usage messages more accurate.
+
+ * src/roff/groff/groff.cpp (synopsis): Drop `-h` and `-v` from
+ normal operation synopsis. Sort options in en_US lexicographic
+ order. Tighten presentation of alternate usage forms.
+ (help): Document longer forms of `-d` and `-r`.
+ * src/roff/nroff/nroff.sh: Report `$prog` instead of "nroff"
+ literal. Refer to `-P` option argument as "arg" instead of
+ "opt", for consistency with groff usage message. Use opposite
+ case from option letter for option argument.
+ * src/roff/troff/input.cpp (usage): Put brackets around options.
+ Sort options in en_US lexicographic order. Drop `-v` from
+ normal operation synopsis. Use opposite case from option letter
+ for option argument. Put operand name in capitals. Set valid
+ usage forms on one physical line each (see 89648fb4, 5 June).
+ Add synopsis line for alternate usage forms.
+
+2021-07-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Refactor environment initialization, switching, and
+ copying.
+
+ * src/roff/troff/env.cpp: Rename struct `env_list` to
+ `env_list_node` since it describes a node of a singly-linked
+ list. Remove constant `NENVIRONMENTS` and array `env_table`.
+ Add static symbol `default_environment_name` to replace string
+ literal.
+ (init_environments): Stop initializing `curenv` through
+ `env_table`. Use `default_environment_name` for that
+ initialization and add the default environment to
+ `env_dictionary`.
+ (environment_switch): Simplify. Shorten "dummy environment"
+ diagnostic message. Stop creating an integer-named
+ environment inside the `env_table` array, only falling through
+ to use the `env_dictionary` if the named environment is not a
+ valid integer or if the array is full. Instead use
+ `env_dictionary` always. Drop no longer needed `pop`
+ quasi-Boolean integer with extra state to suppress environment
+ stack underflow errors. Instead report the error if underflow
+ occurs, regardless of any other circumstance.
+ (environment_copy): Simplify. Stop searching the `env_table`
+ array for an environment to copy from, only falling through to
+ use the `env_dictionary` if the named environment is not a valid
+ integer or if the array is full. Instead search
+ `env_dictionary` always. Emit "no environment specified to copy
+ from" diagnostic only if the `evc` request is given no argument.
+ If the source environment to copy from is given but not found,
+ emit a new diagnostic naming the nonexistent environment. Fix
+ bug: stop returning early if no copying could be done; instead
+ fall through to the end of the function, which calls
+ `skip_line()` and prevents anything on the remainder of the
+ {invalid} control line from being interpreted. Problem dates
+ back to commit da3b7137, 6 March 2000 (groff 1.16).
+
+ Fixes <https://savannah.gnu.org/bugs/?60913>.
+
+2021-07-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/evc_produces_no_output_if_invalid.sh:
+ Regression-test Savannah #60913.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2021-07-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Update English hyphenation patterns.
+
+ * NEWS: Add item.
+ * tmac/hyphen.en: Update file using `hyph-en-us.tex` patterns
+ file from the TeX hyph-utf8 project.
+ * tmac/hyphenex.en: Remove explicit hyphenations for words that
+ no longer require them when using the new patterns. Add one
+ item scraped from an erratum comment in hyphen.en
+ {"dem-o-crat"}.
+
+ The new patterns likely _will_ change the automatic hyphenation
+ break points of your English documents. Here is a sample of
+ affected words found within groff's own documentary corpus.
+
+ OLD NEW
+ === ===
+ arârangeâment arrangeâment
+ colâumns columns
+ conâstrucâted conâstructed
+ cusâtomâized cusâtomized
+ defâiâniâtions deâfâiânâiâtions
+ derâiâvaâtions deârivaâtions
+ hyâphenâaâtion hyâphenâation
+ maâteârial maâteârâial
+ Miâcroâsoft Miâcrosoft
+ pipeâlines pipelines
+ postâproâcesâsors postâprocesâsors
+ proâcessed processed
+ proâcesses processes
+ spaâces spaces
+ Werâner Werner
+
+2021-07-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Add unit test for `substring` request.
+
+ * src/roff/groff/tests/substring_works.sh: Do it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2021-07-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Remove compatibility mode save registers after using
+ them.
+
+ * tmac/an.tmac:
+ * tmac/andoc.tmac:
+ * tmac/cp1047.tmac:
+ * tmac/devtag.tmac:
+ * tmac/ec.tmac:
+ * tmac/fallbacks.tmac:
+ * tmac/latin1.tmac:
+ * tmac/latin2.tmac:
+ * tmac/latin5.tmac:
+ * tmac/latin9.tmac:
+ * tmac/papersize.tmac:
+ * tmac/pdfpic.tmac:
+ * tmac/psold.tmac:
+ * tmac/pspic.tmac:
+ * tmac/trace.tmac:
+ * tmac/unicode.tmac: Do it.
+
+ * doc/groff.texi (Implementation Differences):
+ * man/groff_diff.7.man (Implementation Differences): Illustrate
+ doing so in relevant examples.
+
+2021-07-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/troffrc: Load the English localization file `en.tmac` by
+ default, instead of dealing with hyphenation language and
+ patterns directly in this file. (This also replaces a
+ localization-determination mechanism that was never part of a
+ groff release.)
+
+ * src/roff/groff/tests/initialization_is_quiet.sh:
+ * src/roff/groff/tests/localization_works.sh: Rewrite to use
+ explicit macro file loading localization mechanism.
+
+2021-07-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Move core man(7) implementation to an.tmac.
+
+ * tmac/an.tmac: Delete andoc-sourcing wrapper.
+
+ * tmac/an-old.tmac: Rename...
+ * tmac/an.tmac: ...to this.
+
+ * tmac/tests/an-old_AT-and-UC-footer-saved-and-restored.sh:
+ * tmac/tests/an-old_CS-register-off.sh:
+ * tmac/tests/an-old_CS-register-on.sh:
+ * tmac/tests/an-old_CS-register-unspecified.sh:
+ * tmac/tests/an-old_CT-register-off.sh:
+ * tmac/tests/an-old_CT-register-on.sh:
+ * tmac/tests/an-old_CT-register-unspecified.sh:
+ * tmac/tests/an-old_FT-bad-value-should-not-trash-titles.sh:
+ * tmac/tests/an-old_LL-init-sanely.sh:
+ * tmac/tests/an-old_TH-repairs-ad-damage.sh:
+ * tmac/tests/an-old_TH-repairs-hy-damage.sh:
+ * tmac/tests/an-old_TS-do-not-keep-tables-when-cR-set.sh:
+ * tmac/tests/an-old_X-register-works.sh:
+ * tmac/tests/an-old_avoid-two-font-denial-of-service.sh:
+ * tmac/tests/an-old_no-break-after-short-paragraph-tags.sh:
+ * tmac/tests/an-old_page-footers-present.sh:
+ * tmac/tests/an-old_page-header-has-current-data.sh:
+ * tmac/tests/an-old_title-abbreviation-works.sh: Rename...
+
+ * tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh:
+ * tmac/tests/an_CS-register-off.sh:
+ * tmac/tests/an_CS-register-on.sh:
+ * tmac/tests/an_CS-register-unspecified.sh:
+ * tmac/tests/an_CT-register-off.sh:
+ * tmac/tests/an_CT-register-on.sh:
+ * tmac/tests/an_CT-register-unspecified.sh:
+ * tmac/tests/an_FT-bad-value-should-not-trash-titles.sh:
+ * tmac/tests/an_LL-init-sanely.sh:
+ * tmac/tests/an_TH-repairs-ad-damage.sh:
+ * tmac/tests/an_TH-repairs-hy-damage.sh:
+ * tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh:
+ * tmac/tests/an_X-register-works.sh:
+ * tmac/tests/an_avoid-two-font-denial-of-service.sh:
+ * tmac/tests/an_no-break-after-short-paragraph-tags.sh:
+ * tmac/tests/an_page-footers-present.sh:
+ * tmac/tests/an_page-header-has-current-data.sh:
+ * tmac/tests/an_title-abbreviation-works.sh: ...to these.
+
+ * tmac/tmac.am (TMACNORMALFILES): Remove an-old.tmac.
+ (tmac_TESTS): Reflect renames of test files above.
+ (tmac/stamp-wrap): Macro-source `an.tmac` in the man wrapper.
+
+ * tmac/andoc.tmac: Refer to (and macro-source) an.tmac.
+ * tmac/man.tmac: Macro-source `an.tmac`, not `andoc.tmac`.
+ * tmac/tests/andoc_flush-between-packages.sh: Call groff with
+ `-mandoc` option instead of `-man`. Henceforth, if you want the
+ andoc wrapper, you have to ask for it.
+
+ * tmac/an.tmac: Drop "-old" nomenclature.
+
+ * PROBLEMS:
+ * doc/groff.texi (man):
+ * tmac/man.local: Update documentation appropriately.
+
+ * NEWS: Add item.
+
+ * man/groff_tmac.5.man (Macro packages/man pages):
+ * src/roff/groff/groff.1.man (Usage/Macro packages): Update
+ discussion of an, doc, and andoc.
+ * tmac/groff_man.7.man.in (Files): Update descriptions of
+ an.tmac, andoc.tmac, man.tmac, and mandoc.tmac.
+
+ Fixes <https://savannah.gnu.org/bugs/?60789>.
+
+2021-07-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [troff]: Slightly refactor. Make the source code slightly more
+ accessible by using a `bool` type for a function's default
+ parameter used as a Boolean, and comment it at call sites where
+ the default is overridden.
+
+ * src/roff/troff/token.h (get_name, get_long_name): Change type
+ of parameter from `int` to `bool` and default from 0 to `false`.
+ * src/roff/troff/input.cpp (do_get_long_name)
+ (empty_name_warning, get_name, get_long_name): Change type of
+ parameter from `int` to `bool` in declarations and definitions.
+ * src/roff/troff/column.cpp (column_justify):
+ * src/roff/troff/div.cpp (diversion_trap):
+ * src/roff/troff/env.cpp (environment_switch, environment_copy)
+ (do_input_trap, set_hyphenation_language)
+ (do_hyphenation_patterns_file):
+ * src/roff/troff/input.cpp (define_color, composite_request)
+ (do_define_string, do_define_macro, rename_macro, alias_macro)
+ (chop_macro, do_string_case_transform, substring_request)
+ (length_request, asciify_macro, unformat_macro, do_register)
+ (device_macro_request, do_if_request, do_source)
+ (ps_bbox_request, do_open, close_request, do_write_request)
+ (write_macro_request, define_class, copy_file, vjustify)
+ (transparent_file, do_macro_source):
+ * src/roff/troff/node.cpp (font_translate, font_position, style)
+ (get_fontno):
+ * src/roff/troff/reg.cpp (define_number_reg, inline_define_reg)
+ (alter_format, alias_reg, rename_reg): Update call sites. Add
+ (comment indicating meaning of parameter.
+
+ Do similarly for token::delimiter() member function.
+
+ * src/roff/troff/token.h (token::delimiter): Change type of
+ parameter from `int` to `bool`, name from `warn` to `err` (to
+ match definition and behavior in input.cpp) and default from 0
+ to `false`.
+ * src/roff/troff/input.cpp (token::delimiter): Change type of
+ parameter from `int` to `bool` in definition.
+ * src/roff/troff/input.cpp (do_expr_test, get_delim_number)
+ (get_line_arg, read_size, do_register, read_draw_node):
+ * src/roff/troff/reg.cpp (inline_define_reg): Update call sites.
+ Add comment indicating meaning of parameter.
+
+2021-07-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (an-footer): Remove string
+ `an-outer-footer-text` after we're done with it.
+
+2021-07-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Remove the stripper script and its vestiges.
+
+ * contrib/hdtbl/hdmisc.tmac:
+ * contrib/hdtbl/hdtbl.tmac:
+ * contrib/mom/om.tmac:
+ * tmac/doc.tmac:
+ * tmac/e.tmac:
+ * tmac/mdoc/doc-common:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff:
+ * tmac/mdoc/doc-syms: Remove `%beginstrip` comment.
+
+ * tmac/strip.sed: Delete.
+
+ * tmac/tmac.am (EXTRA_DIST): Stop shipping `strip.sed`.
+
+ Fixes <https://savannah.gnu.org/bugs/?55091>.
+
+2021-07-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Skip the stripper, part 3/3 (mdoc).
+
+ * tmac/doc-old.tmac-u:
+ * tmac/doc.tmac-u:
+ * tmac/mdoc/doc-common-u:
+ * tmac/mdoc/doc-ditroff-u:
+ * tmac/mdoc/doc-nroff-u:
+ * tmac/mdoc/doc-syms-u: Rename these...
+
+ * tmac/doc-old.tmac:
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-common:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff:
+ * tmac/mdoc/doc-syms: ...to these.
+
+ * tmac/tmac.am (TMACNORMALFILES): Add `doc-old.tmac` and
+ `doc.tmac`.
+ (TMACUNSTRIPFILES, TMACSTRIPFILES): Delete variables.
+ (dist_tmac_DATA): Drop `$(TMACUNSTRIPFILES)`.
+ (nodist_tmac_DATA): Drop `$(TMACSTRIPFILES)`.
+ (TMACMDOCSTRIPFILES): Rename...
+ (TMACMDOCFILES): ...to this.
+ (nodist_mdoc_DATA, MOSTLYCLEANFILES): Reflect above rename.
+ (nodist_mdoc_DATA): Rename...
+ (dist_mdoc_DATA): ...to this.
+ (TMACMDOCUNSTRIPFILES): Delete variable.
+ (EXTRA_DIST): Drop `$(TMACMDOCUNSTRIPFILES)`.
+ ($(TMACSTRIPFILES), $(TMACMDOCSTRIPFILES)): Drop targets.
+
+ The portions above are based on a patch by Ingo Schwarze.
+
+ * tmac/doc.tmac:
+ * tmac/mdoc/doc-common:
+ * tmac/mdoc/doc-ditroff:
+ * tmac/mdoc/doc-nroff:
+ * tmac/mdoc/doc-syms: Bracket macro definitions tightly with
+ `eo` and `ec` requests since they were written under this
+ assumption. The files in general were also drafted under the
+ assumption that they'd be stripped, so `eo` was in effect for
+ broad swaths of the file including portions outside of any macro
+ definition where comments were used. But comments are expressed
+ using the escape character! So we got warnings about an
+ undefined '\"' macro, and that was just the beginning of a
+ wrecking ball of trouble that smashed through the
+ implementation. Some--but not all--string definitions (and
+ appendments) needed to be bracketed with `eo` and `ec` as well,
+ to delay interpolation of embedded string names that are not
+ defined until macros interpolate them later. I did what
+ appeared necessary to pass our tests and keep -Tutf8 and -Tps
+ renderings of tmac/groff_mdoc.7 from changing from their
+ strip-influenced output. Subtle bugs might linger, but some
+ won't be the fault of the unstripping process. (For instance,
+ try provoking a usage message on the `Hf` macro.)
+
+2021-07-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man pages]: Remove compatibility save register.
+
+ * **/*.man*: Remove page-local compatibility save register after
+ using it.
+
+2021-07-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Simplify `mso` requests.
+
+ * tmac/X.tmac:
+ * tmac/Xps.tmac:
+ * tmac/dvi.tmac:
+ * tmac/html.tmac:
+ * tmac/lbp.tmac:
+ * tmac/lj4.tmac:
+ * tmac/ps.tmac:
+ * tmac/tty-char.tmac:
+ * tmac/tty.tmac:
+ * tmac/www.tmac.in: Move `mso` requests to be inside regions
+ where compatibility mode is turned off. I believe they were
+ placed where they were because things didn't work when the
+ compatibility mode register being saved was .C, rather than the
+ .cp register introduced in commit 6a37bb5f, 17 April 2020. Now
+ the logic is less mysterious. Also, remove the register used to
+ save compatibility mode after we're done with it, to reduce name
+ space clutter.
+
+2021-07-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/it.tmac: Drop sourcing of `latin1.tmac` and set up of
+ hyphenation codes; since the `hyphen.it` file is pure ASCII, we
+ don't need to expect Latin-1-encoded code points in it.
+
+2021-07-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Make localization files work in compatibility mode.
+
+ * tmac/cs.tmac:
+ * tmac/de.tmac:
+ * tmac/en.tmac:
+ * tmac/fr.tmac:
+ * tmac/it.tmac:
+ * tmac/ja.tmac:
+ * tmac/sv.tmac:
+ * tmac/zh.tmac: Save and restore compatibility mode.
+
+ * tmac/den.tmac: Invoke requests with `do`.
+
+ Fixes <https://savannah.gnu.org/bugs/?60874>. Thanks to Bjarni
+ Ingi Gislason for the report.
+
+2021-07-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Add regression test for Savannah #60874.
+
+ * src/roff/groff/tests/initialization_is_quiet.sh: Test it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2021-07-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Integrate Italian localization.
+
+ * NEWS: Add item. Update an existing list of localization macro
files.
+ * doc/groff.texi (Manipulating Hyphenation): Update table of
+ hyphenation pattern left and right minimums and list of
+ available localization files to include Italian.
+ * man/groff_tmac.5.man: Update list of available localization
+ files to include Italian.
+ * src/roff/groff/tests/localization_works.sh: Test it.
+ * tmac/tmac.am (TMACNORMALFILES): Add `it.tmac` and `hyphen.it`.
+
+ Fixes <https://savannah.gnu.org/bugs/?60828>.
+
+2021-07-02 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [tmac]: Flesh out Italian localization.
+
+ * tmac/hyphen.it: Add hyphenation patterns from TeX hyph-utf8
+ project.
+ * tmac/it.tmac:
+ - Revise copyright date to just this year (it had been copied
+ from fr.tmac).
+ - Use grave accents instead of acute ones to indicate stress
+ on word-final vowels. Per the University of Wikipedia and a
+ sampling of apparently well-typeset Italian language
+ documents online, this appears to be correct. Yell at me if
+ I'm wrong.
+ - Source latin1.tmac instead of latin9.tmac; Italian doesn't
+ require any letter code points from Latin-9, unlike the
+ French file upon which this one was based, and Latin-1 is
+ less of a pain to work with.
+ - Set the hyphenation mode to 1 instead of 4 for congruence
+ with the requirements of the hyphenation patterns.
+ - Set up hyphenation codes. This (and sourcing latin1.tmac)
+ might not be necessary as the hyphenation pattern file, of a
+ more recent vintage than the others we're using, is pure
+ ASCII. However I don't understand these issues perfectly so
+ I am making the conservative choice. Again per the
+ University of Wikipedia, Italian requires only acute and
+ grave accents, in contrast to the rich French diacritical
+ bouillabaisse.
+ - Set the hyphenation language and load the pattern file.
+ - Add comments in parallel with other localization files and
+ to supply text editors with hints.
+
+2021-07-02 Edmond Orignac <edmond.orignac@wanadoo.fr>
+
+ * tmac/it.tmac: Add Italian localization.
+
+2021-07-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Skip the stripper, part 1/3 ("me").
+
+ * tmac/e.tmac-u: Rename to...
+ * tmac/e.tmac: ...this.
+
+ * tmac/tmac.am (TMACNORMALFILES): Add tmac/e.tmac.
+ (TMACUNSTRIPFILES): Remove tmac/e.tmac-u.
+ (TMACSTRIPFILES): Remove tmac/e.tmac.
+
+ Fixes one third of <https://savannah.gnu.org/bugs/?55091>.
+
+2021-07-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl: Simplify parsing. Dave Kemper pointed
+ out that preprocessors like pic(1) use pretty unsophisticated
+ *roff parsing to determine where to perform their textual
+ replacements. My enhancements to support input line
+ continuation and cope with brace escapes were thus
+ overengineered. Remove them.
+ - Drop scalars `is_continued_line` and `logical_line`.
+ (do_line): Stop performing logical line concatenation and
+ detecting input line continuation. Perform operations on
+ `line` instead of `logical_line`. Stop removing brace
+ escapes.
+ * src/utils/grog/grog.1.man (Limitations): Update discussion.
+
+ Fixes <https://savannah.gnu.org/bugs/?60862>. Thanks, Dave!
+
+2021-06-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/reg.cpp (lookup_number_reg, alias_reg): In
+ diagnostic messages, say simply "register" instead of "number
+ register" (there is no other kind).
+
+2021-06-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Refactor input parsing.
+
+ * src/utils/grog/grog.pl:
+ - Add scalar `use_compatibility_mode` (see below).
+ - Add list `request` to store the names of all requests
+ recognized by groff so that they aren't confused with macro
+ names.
+ - Add scalars `have_seen_first_macro_call` (replaces
+ `before_first_command`, but at global scope),
+ `is_continued_line` and `logical_line`. The latter two
+ enable us to handle *roff input line continuation correctly.
+ (process_arguments): Set `use_compatibility_mode` if `-C`
+ option specified.
+ (process_input): Refactor to greatly simplify, to not attempt
+ to read the first line of an input file as a special case, and
+ to avoid sending `do_line` an undefined argument (when EOF is
+ reached).
+ (do_first_line): Delete.
+ (do_line): Rewrite the early stages of input parsing.
+ - Concatenate continued input lines, setting
+ `is_continued_line` and returning early as each one is seen,
+ storing the accumulating input in `logical_line`.
+ - Check the input line for the form of comment deposited by
+ Perl's Pod::Man, which uses a highly accented dialect of
+ man(7); if it's present, inflate `man_score` to compensate
+ for the page-private `IX` macro it defines but which
+ duplicates the name and function of a 4.2BSD-era ms(7)
+ extension that would otherwise deceive our scoring
+ mechanism, because Pod::Man produces `IX` calls to
+ metastatic excess. (An alternative to this kludge is
+ documented in comments: if a "standard" macro is redefined,
+ we could delete it from the relevant lists and hashes.)
+ - Strip *roff comments from input.
+ - Normalize control lines; convert the no-break control
+ character to the regular one and remove unnecessary
+ white space.
+ - Remove brace escapes.
+ - Recognize two-character macro calls when not followed by
+ white space in compatibility mode.
+ - Drop logic that erroneously attempted to infer soelim(1) use
+ from macro calls and request invocations. The grog(1) and
+ soelim(1) man pages now both explain why such an effort was
+ misguided.
+ - Recognize macro definitions created by .am and .am1 requests
+ {not just .de and .de1}.
+ - Ignore all other *roff requests.
+ - What remains must be a ("standard") macro call, so set
+ `have_seen_first_macro_call`.
+
+ * src/utils/grog/grog.1.man (Limitations): Document a further
+ restriction: don't change the escape character, either.
+
+ * src/utils/grog/tests/smoke-test.sh: Comment out pic-detection
+ test on soelim(1). The pic macro calls are guarded by roff
+ control structures and only worked previously by accident
+ because grog did not recognize *roff input line continuation,
+ now it does and the illusion is dispelled. (A reliable way to
+ fool grog before and after my refactoring is now documented in
+ its man page.)
+
+ Fixes <https://savannah.gnu.org/bugs/?59622>.
+
+2021-06-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Add regression test for Savannah #59622.
+
+ * src/utils/grog/tests/recognize-perl-pod.sh: Test it.
+ * src/utils/grog/grog.am (grog_TESTS): Run test.
+
+2021-06-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.1.man (Limitations): Document further
+ restrictions (no changing of control characters, control
+ structures not interpreted).
+
+2021-06-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Refactor command-line argument handling.
+
+ * src/utils/grog/grog.pl:
+ - Drop scalars `groff_opts`, `device`, and `with_warnings`.
+ - Move scalar `pdf_with_ligatures`...
+ (process_arguments): ...here. Recognize all groff options
+ that take an optionally whitespace-separated option argument
+ and apply the existing "delayed option" handling to them.
+ Push any groff option except `-m` as-is onto the constructed
+ groff command's argument list (`-m` handling is unchanged).
+ Match long option names exactly, not sloppily. Stop
+ recognizing `--warnings` option. Emit error diagnostic if
+ unrecognized long option encountered.
+ (infer_device): Delete subroutine and its top-level call site.
+ (help): Undocument `--warnings`.
+
+ * src/utils/grog/grog.1.man:
+ (Synopsis): Use font style macros instead of .OP. Undocument
+ `--warnings`.
+ (Options): Note that the groff arguments produced by the grog
+ `--ligatures` option are supported only by the `pdf` device.
+ Undocument `--warnings`. Undocument groff-incompatible
+ restriction on whitespace before option arguments; grog is
+ compatible now. Simplify discussion in light of simplified
+ grog logic.
+ (Details): Undocument scenario where grog infers multiple
+ main/major/full-service macro packages; this no longer
+ happens.
+ (Examples): Update to no longer illustrate inclusion of `-T
+ ps` option; this no longer happens by default.
+
+ * NEWS: Document removal of grog's `--warnings` option.
+
+ Fixes <https://savannah.gnu.org/bugs/?57873>; groff options are
+ no longer "mangled".
+
+2021-06-29 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Add regression test for Savannah #57873.
+
+ * src/utils/grog/tests/preserve-groff-options.sh: Test it.
+ * src/utils/grog/grog.am (grog_TESTS): Run test.
+
+2021-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Refactor device (`-T` option) handling.
+
+ * src/utils/grog/grog.pl: Redeclare `device` as a scalar instead
+ of a list.
+ (process_arguments): Generalize handling of `-T` and `-m`
+ options to permit optional whitespace. Rename scalar `was_T` to
+ `delayed_option`.
+ (infer_device): Stop unconditionally adding a `-T ps` argument
+ to the generated groff command. Remove logic that validates any
+ given `-T` option argument; instead, let groff fail if a bad one
+ is supplied (its own diagnostics in this scenario were improved
+ in commit 5a721a30, 27 May). This makes grog agnostic about any
+ differently configured default device in groff itself, and about
+ the GROFF_TYPESETTER environment variable.
+
+ Fixes <https://savannah.gnu.org/bugs/?55301> by getting out of
+ the way.
+
+ * src/utils/grog/tests/PF-does-not-start-pic-region.sh:
+ * src/utils/grog/tests/smoke-test.sh: Update expected output.
+
+2021-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.am (grog): Drop sed replacement of unused
+ configuration variables @g@, @BINDIR@, @libdir@, and @EGREP@.
+ * src/utils/grog/grog.pl (process_arguments, construct_command):
+ Tweak warning diagnostics to use a style where an empty argument
+ will be easy to spot.
+ (do_first_line): Stop emitting pseudo-diagnostic (to standard
+ output!) if we see a "groff options line" [it's not] of
+ incorrect form. The preprocessor encoding hint convention of
+ concern here is particular to man pages, disregarded by at least
+ one major implementation thereof (man-db man), and not used by
+ other types of roff documents; at this point, we don't yet know
+ if the document we're processing is a man page.
+ (construct_command): Correct comment and related logic error.
+ Clear the inferred main macro package if _any_ `-m` argument
+ matching any main macro package is given. Warn only if what is
+ specified doesn't match the inference.
+
+2021-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Heavily refactor.
+
+ * src/utils/grog/grog.pl:
+ - Drop import of unused module `Data::Dumper`.
+ - Drop unused scalars `Sp` and `correct_tmac`.
+ - Simplify determination of version number. Drop hash `at_at`
+ which only stored one key, `GROFF_VERSION`. Initialize
+ scalar `groff_version` to "DEVELOPMENT". Rename scalar
+ `before_make` to `in_source_tree` and initialize to zero.
+ Update `groff_version` with Automake-determined version
+ variable if it is defined (i.e., grog is not running outside
+ of, or in an unbuilt, groff source or binary distribution).
+ - Drop unused `Mparams` list. Replace it with new list
+ `requested_package`, which stores the arguments to any grog
+ `-m` options specified by the user.
+ - Rename many objects so that I, and others, can better
+ comprehend their purpose, and for consistent letter casing.
+ . @Command -> @command
+ . @devices -> @device
+ . $Prog -> $program_name
+ . %macros -> %user_macro
+ . $have_any_valid_args -> $have_any_valid_arguments
+ . &handle_args -> &process_arguments
+ . &handle_whole_files -> &process_input
+ . @preprograms -> @preprocessor
+ . &make_groff_device -> &infer_device
+ . &make_groff_preproc -> &infer_preprocessors
+ . &make_groff_tmac_others -> &infer_macro_packages
+ . &make_groff_tmac_man_ms -> &infer_man_or_ms_package
+ . &make_groff_line_rest -> &construct_command
+ - Drop many unused keys in `Groff` hash.
+ - Add new lists, `macro_ms`, `macro_man`, and
+ `macro_man_or_ms` to support new scoring technique to
+ disambiguate input documents between these two packages.
+ - Append the foregoing 3 lists to new list `standard_macro`,
+ and add these as keys to the `Groff` hash.
+ - Add new list `main_package` to keep track of full-service
+ package names.
+ - Add new scalars `man_score`, `ms_score`, and
+ `inside_tbl_table` to aid disambiguation of .TH macro calls
+ and the many macro names shared between man(7) and ms(7).
+ (process_arguments): Strip '-m' off of argument before storing
+ the remainder in `@requested_package`.
+ (do_line): Detect .TH macro call even if white space occurs
+ between the control character and the macro name.
+ (do_line): Inflate `$man_score` by 100 if .TH is the first
+ macro call seen in a document.
+ (do_line): Fix bug; clear `$before_first_command` in correct
+ scope--after any macro call, not just if we saw a .TH as the
+ first macro call.
+ (do_line): Set `$inside_tbl_table` when we see a .TS call.
+ (do_line): Clear `$inside_tbl_table` when we see a .TE call.
+ Also increment `$Groff{'tbl')' again, increasing the "score"
+ of tbl(1) usage evidence.
+ (do_line): Drop a lot of code that manually increments %Groff
+ keys corresponding to man and ms macros. This is now done
+ differently and elsewhere.
+ (do_line): Drop "P" from list of characteristic mm(7) macros.
+ (do_line): Simplify matching of mom(7) macros (match $command,
+ not $line). Extend list of characteristic mom(7) macros.
+ (do_line): Increment $Groff{$key} if $key is in
+ @standard_macro.
+ (infer_man_or_ms_package): Rewrite. Compute a score for each
+ package by counting occurrences of their characteristic
+ macros. If both have a score of zero, assume that the input
+ is a raw roff document. If the scores are equal
+ {doc/webpage.ms, startlingly, comes within 1 point of a tied
+ score}, infer ms(7) if 'TH' was never called, and if it was,
+ issue a diagnostic advising user to supply a disambiguating
+ `-m` option. Otherwise, the scores are unequal: infer the
+ package of the winner. Set scalar `inferred_main_package`
+ instead of pushing `-m` options onto `@m`.
+ (infer_macro_packages): Set scalar `inferred_main_package`
+ instead of pushing `-m` options onto `@m`. Explicitly return
+ 0 if we fall off the end of the function.
+ (construct_command): Rewrite handling of -m options. Add new
+ list `msupp` to store supplementary (non-main) macro package
+ arguments. If a full-service package was explicitly
+ requested, it had better not clash with what we inferred. If
+ it does, explicitly unset `inferred_main_package` so that the
+ -m arguments are placed in the same order that the user gave
+ them; caveat dictator. If `--run` option was given, just
+ print the command; don't preface it with __FILE__ and __LINE__
+ noise.
+ - Remove comments documenting shared variables used by
+ subroutines. These are far from useless but too tedious to
+ keep up to date while the code is in flux.
+ - Note several places for further code review or refactoring
+ with "XXX" comments.
+ - Add Vim modeline.
+
+ grog now passes all its tests and correctly infers arguments for
+ all in-tree groff documents (except for a known, and already
+ documented in grog(1), false positive detection of soelim in
+ soelim(1)). This refactor also obviates or resolves several
+ outstanding Savannah tickets.
+
+ Fixes <https://savannah.gnu.org/bugs/?44707> by obviating it;
+ grog no longer cares about file name extensions on man pages (or
+ any other input).
+
+ Fixes <https://savannah.gnu.org/bugs/?55302>; same. The quality
+ of diagnostic messages has been improved as well.
+
+ Fixes <https://savannah.gnu.org/bugs/?59753>; same.
+
+ Fixes <https://savannah.gnu.org/bugs/?59664>. The attached
+ patch was a less aggressive refactor of &do_line and %Groff.
+ Its author made the following claim for it: "With this patch,
+ all 'man', 'me', 'mom, and 'ms' files in the repository are
+ correctly identified. The only example of a 'mm'-file is
+ "letter.mm", which is not recognized correctly." As noted
+ above, the present refactor achieves correct recognition of all
+ of the files, including letter.mm.
+
+2021-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/tests/smoke-test.sh: Perform whole-line
+ matches. Apply DRY principle to expected output. In
+ anticipation of pending changes to grog.pl, uncomment and add
+ tests for several in-tree documents.
+ doc/meref.me
+ contrib/mom/examples/copyright-chapter.mom
+ contrib/mom/examples/copyright-default.mom
+ contrib/mom/examples/letter.mom
+ contrib/mom/examples/mom-pdf.mom
+ contrib/mom/examples/mon_premier_doc.mom
+ contrib/mom/examples/sample_docs.mom
+ contrib/mom/examples/slide-demo.mom
+ contrib/mom/examples/typesetting.mom
+ doc/webpage.ms
+
+2021-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Refactor. Discard filename extension-based inference.
+
+ * src/utils/grog/grog.pl (do_line): Stop saving the control
+ character in the matched scalar `command` (the request or macro
+ name). We don't need it, and it simplifies much later matching.
+ (handle_file_ext): Delete.
+ (top level): Drop call site.
+
+ * src/utils/grog/grog.pl: Rename `tmac_ext` scalar to
+ `inferred_main_package`.
+
+2021-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/grog/grog.pl (handle_args): Complain less noisily
+ and more comprehensibly when given unrecognized groff options.
+
+2021-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Handle "--" argument as documented.
+
+ * src/utils/grog/grog.pl (handle_args): Rename scalar
+ `double_minus` to `no_more_options` so it actually communicates
+ something. Drop openability check of operand encountered after
+ "--"; since it's on the operand list, it will be checked later
+ {in `handle_whole_files`}. Stop pushing "--" itself onto the
+ `filespec` list.
+
+ Fixes <https://savannah.gnu.org/bugs/?60834>.
+
+2021-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [grog]: Revise operand handling, diagnostics, and exit status.
+
+ * src/utils/grog/grog.pl: Track more state so that we can
+ process the argument list more intelligently and exit with a
+ meaningful status. Add `had_inference_problem`,
+ `had_processing_problem`, and `have_any_valid_args` Boolean
+ scalars.
+ (fail): Add diagnostic subroutine for serious problems; sets
+ `had_processing_problem`.
+ (handle_args, handle_file_ext): Stop complaining here about
+ unopenable file operands.
+ (handle_whole_files): Complain only here, with `fail` if a file
+ operand cannot be opened.
+ (make_groff_line_rest): Don't exit immediately if there is a
+ macro package inference clash, because there might be more
+ operands to process. Instead, set `had_inference_problem`.
+ Stop exiting from this subroutine.
+ (top level): Only call the inference subroutines if we had a
+ valid operand to work with (including an implicit read from
+ stdin). Exit with a status corresponding to the Booleans
+ declared above.
-2004-10-09 Werner LEMBERG <wl@gnu.org>
-
- * tmac/trace.tmac: Fix handling of `am' and `am1' calls.
-
-2004-10-06 Gaius Mulley <gaius@glam.ac.uk>
-
- * src/roff/troff/column.cpp (vjustify_node::copy): Updated.
-
- * src/roff/troff/div.h: Include `mtsm.h'.
- (diversion): New variables `any_chars_added', `needs_push',
- `saved_seen_break', `saved_seen_space', `saved_seen_eol',
- `saved_suppress_next_eol', `modified_tag'.
- New virtual member function `is_diversion'. Update all descendants.
-
- * src/roff/troff/div.cpp (diversion::diversion,
- macro_diversion::macro_diversion): Updated.
- (do_divert): Handle `seen_break', `seen_space', `seen_eol',
- `suppress_next_eol'.
- (top_level_diversion::space): Handle `curenv->seen_space'.
- (page_offset): Update tag handling.
- (space_request, blank_line, flush_output): Don't call `add_html_tag'.
-
- * src/roff/troff/env.h (environment): Make `tabs' public.
- Remove `ignore_next_eol', `emitted_node'.
- Update `output_line', `output'.
- New variables `seen_space', `seen_eol', `suppress_next_eol',
- `seen_break'.
- New member functions `construct_state', `make_tag',
- `construct_format_state, `construct_new_line_state,
- `dump_troff_state'.
- Remove `add_html_tag', `make_html_tag'.
-
- * src/roff/troff/env.cpp: New externs `suppress_push',
- `get_diversion_state', `global_diverted_space'.
- (pending_output_line): New variable `was_centered'.
- Update constructor and all callers.
- (pending_output_line::output): Call `curenv->construct_format_state'.
- (environment::environment, environment::copy): Updated.
- (environment::output): Handle `was_centered'.
- (environment::add_char): Handle construct and diversion state.
- (environment::add_node): Handle construct state.
- (environment::newline): Handle `was_centered'.
- (environment::output_line): Updated.
- (environment::possibly_break_line): Updated.
- Update tag handling.
- (environment::add_html_tag): Replaced with...
- (environment::make_tag): New function.
- (environment::add_html_tag_tabs, environment::make_html_tag): Removed.
- (environment::dump_troff_state): New debugging function.
- (environment::construct_state, environment::construct_format_state,
- environment::construct_new_line_state): New functions.
- (environment::do_break): Updated.
- Handle `global_diverted_space'.
- (environment::handle_tag): Update tag handling.
- (point_size, fill, do_break_request): Don't call `add_html_tag'.
- (no_fill): Don't call `add_html_tag'.
- Set `suppress_next_eol'.
- (center, right_justify, line_length, indent, temporary_indent,
- set_tabs):
- Update tag handling.
-
- * src/roff/troff/input.cpp: Don't include `stringclass.h'.
- (input_iterator): New variables `is_diversion', `diversion_state'.
- Update constructors.
- (input_stack): New member functions `get_div_level',
- `get_diversion_state', `check_end_diversion'.
- New variables `div_level', `diversion_state'. Initialize them.
- (suppress_push, global_diverted_space): New global variables.
- (input_stack::finish_get, input_stack::finish_peek,
- input_stack::remove_boundary, input_stack::end_file,
- input_stack::clear, input_stack::pop_macro): Call
- `check_end_diversion'.
- (input_stack::push): Handle `div_level' and `diversion_state'.
- (get_diversion_state): New function.
- (diverted_space_node::reread): Handle `global_diverted_space'.
- (macro::macro): Update constructors.
- (macro::is_diversion): New function.
- (macro::operator=): Set `is_a_diversion'.
- (string_iterator): New member function `is_diversion'.
- (string_iterator::string_iterator): Update constructors.
- (string_iterator::fill): Set `div_nest_level'.
- (macro_iterator): New member function `is_diversion'.
- (do_if_request): Handle `suppress_push'.
- (tag, taga): New functions.
- (init_input_requests): Add `tag' and `taga' requests.
-
-2004-10-05 Gaius Mulley <gaius@glam.ac.uk>
-
- * src/include/font.h (font): New member function
- `get_image_generator'.
- New variables `unscaled_charwidths' and `image_generator'.
-
- * src/libs/libgroff/font.cpp (font::get_width): Always return the
- character's unscaled width if `font::unscaled_charwidths' is set.
- (font::get_image_generator): New function.
- (font::load_desc): Check the `unscaled_charwidths' and
- `image_generator' keywords.
-
- * src/libs/libgroff/fontfile.cpp: Initialize
- `font::unscaled_charwidths' and `font::image_generator'.
-
- * font/devhtml/DESC.proto: s/html/unscaled_charwidths/.
-
- * font/devhtml/Makefile.sub (DESC): Set `image_generator' keyword.
-
- * man/groff_font.man: Document `unscaled_charwidths' and
- `image_generator'.
-
- * src/preproc/html/pre-html.cpp: Include `device.h'.
- (image_gen): New global variable.
- (imageList::createPage): Use `image_gen'.
- (main): Use `image_generator' keyword.
-
-2004-10-04 Gaius Mulley <gaius@glam.ac.uk>
-
- * tmac/html.tmac: Handle \[sqrtex].
-
-2004-10-04 Gaius Mulley <gaius@glam.ac.uk>
-
- * src/include/printer.h (printer): New virtual method `round_width'.
-
- * src/devices/grodvi/dvi.cpp, src/devices/grolbp/lbp.cpp,
- src/devices/grolj4/lj4.cpp, src/devices/grops/ps.cpp,
- src/devices/grotty/tty.cpp (printer::round_width): New function
- member.
-
- * src/devices/grohtml/post-html.cpp (printer::round_width): New
- function member.
- (html_printer::set_numbered_char): Use it.
-
-2004-10-03 Gaius Mulley <gaius@glam.ac.uk>
-
- * aclocal.m4 (GROFF_GHOSTSCRIPT_PATH): New macro.
-
- * configure.ac: Call GROFF_GHOSTSCRIPT_PATH.
-
- * configure: Regenerated.
-
- * Makefile.in (GHOSTSCRIPT): New variable.
- (MDEFINES): Add GHOSTSCRIPT.
+ * src/utils/grog/grog.1.man (Exit status): Add section; describe
+ semantics of exit status values.
-2004-10-03 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?60833>.
- * INSTALL.gen: Updated (taken from texinfo CVS).
+2021-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-09-28 Werner LEMBERG <wl@gnu.org>
+ [grog]: Revise diagnostic messages.
- * NEWS: Updated.
+ * src/utils/grog/grog.1.man (err): Rename from this...
+ (warn): ...to this. Prefix diagnostic with command name and
+ diagnostic severity level. The subroutine didn't change the
+ exit status and was not used to report serious trouble, so
+ "warning" seems appropriate.
+ (make_groff_tmac_man_ms): Update call sites. Modify diagnostic
+ wording to stop calling macros "requests".
-2004-09-28 Heinz-JĂŒrgen Oertel <hj.oertel@surfeu.de>
+2021-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_www.man: Revised and updated.
+ * src/utils/grog/grog.1.man (Limitations): Add subsection
+ covering the problem grog has with soelim inference. Undocument
+ groff's -s option as one that can be inferred, because at
+ present it cannot be.
-2004-09-26 Werner LEMBERG <wl@gnu.org>
+ Prompted by Savannah #60421.
- Fix \$@ and \$* to handle any number of arguments.
+2021-06-26 Dave Kemper <saint.snit@gmail.com>
- * src/roff/troff/input.h (BEGIN_QUOTE, END_QUOTE): New special
- characters.
+ [grog]: Fix erroneous detection of pic(1) usage.
- * src/roff/troff/input.cpp (input_iterator::internal_level):
- Removed.
- (input_stack): New member functions `increase_level' and
- `decrease_level'.
- (input_stack::get_level): Don't use `internal_level'.
- (get_copy, token::next): Handle BEGIN_QUOTE and END_QUOTE.
- (end_quote_iterator): Completely removed.
- (interpolate_arg): Build string for \$@ and \$* which is then
- pushed onto the input stack.
+ Fixes <https://savannah.gnu.org/bugs/?60772>.
-2004-09-23 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-06-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_ms.man, doc/groff.texinfo (ms Document Control
- Registers): Document changes from 2004-09-19.
+ * src/utils/grog/tests/PF-does-not-start-pic-region.sh:
+ Regression-test Savannah #60772.
+ * src/utils/grog/grog.am (grog_TESTS): Run test.
-2004-09-23 Werner LEMBERG <wl@gnu.org>
+2021-06-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/an-old.tmac (ne): Using default scaling operator.
+ [grog]: Add smoke test.
-2004-09-19 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * src/utils/grog/tests/smoke-test.sh: Add test.
+ * src/utils/grog/grog.am (grog_TESTS): Run it.
+ (TESTS): Add `grog_TESTS`.
+ (EXTRA_DIST): Ship test.
- This change implements the following features:
+2021-06-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- PORPHANS
- New numeric register: Defines number of lines following LP, PP,
- QP, IP or XP, which must be kept together, before any automatic
- page break. If insufficient space remains on the current page, a
- page break is forced before the new paragraph begins.
+ [grog]: Relocate in source tree.
- HORPHANS
- New numeric register: Sets number of lines of following paragraph
- which must be kept with a heading, defined by NH or SH, before any
- automatic page break. If insufficient space remains on the
- current page, a page break is forced before the heading.
+ * src/roff/grog: Move from here...
+ * src/utils/grog: ...to here.
- GROWPS
- (Thanks to Joerg van den Hoff, for this idea).
+ * MANIFEST:
+ * Makefile.am:
+ * src/utils/grog/grog.am: Reflect move.
- New numeric register: Sets the first level of heading (set with
- NH), which will keep the same point size as body text; e.g. if
- GROWPS is set to 3, .NH 3, .NH 4, ... will produce headings at the
- point size specified by \n[PS], but .NH 2 and .NH 1 will have
- progressively larger point sizes, determined by \n[PSINCR] (see
- below).
+ Fixes <https://savannah.gnu.org/bugs/?60788>.
- PSINCR
- New numeric register: Sets the point size increment for each level
- of heading, (set with NH), below the threshold level set by
- GROWPS; e.g. if \n[PS] = 10, \n[GROWPS] = 3 and \n[PSINCR] = 2.0p,
- then .NH 1 will produce 14pt headings, .NH 2 will produce 12pt,
- and all other levels will remain at 10pt, (because \n[PS] = 10).
+2021-06-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- SH
- Existing macro now accepts a numeric argument, to make heading
- size match that of NH with same argument value, when the
- GROWPS/PSINCR feature is enabled.
+ * doc/groff.texi (Assigning Formats): Revise discussion.
+ Clarify that a format never causes truncation of an interpolated
+ magnitude. Note that non-Arabic number formats cannot be used
+ as operands to arithmetic expressions. Add example of how to
+ work around this.
- SN-DOT
- New string, set by NH macro, replaces the existing (undocumented)
- use of SN, to represent the assigned section number.
+2021-06-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- SN-NO-DOT
- New string, set by NH macro, represents the assigned section
- number, but omits the terminal period (periods at intermediate
- levels are retained).
+ [troff]: Clarify diagnostics.
- SN
- String set by NH macro, originally undocumented, now implemented
- as an alias for SN-DOT (which reproduces original behaviour).
+ * src/roff/troff/reg.cpp (reg::set_increment): Update diagnostic
+ to unabbreviate "auto".
+ (reg::alter_format): Update diagnostic to say "assign" instead
+ of "alter", since the documentation consistently uses the former
+ term.
- * tmac/s.tmac (PORPHANS): New register.
- (par*start): Use it.
- (HORPHANS, GROWPS, PSINCR): New registers.
- (SH-NO-TAG, @SH): Use them.
- (@NH): Improved.
+2021-06-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-09-19 Keith Marshall <keith.d.marshall@ntlworld.com>
+ [troff]: Slightly refactor. Make the source code slightly more
+ accessible by using a `bool` type for a member function's
+ default parameter used as a Boolean, and comment it at call
+ sites where the default is overridden.
- * NEWS, doc/groff.texinfo (ms Display and Keeps), tmac/groff_ms.man:
- Document the deletion of `Ds' and `De' macros.
+ * src/roff/troff/token.h (token::get_char): Change type of
+ parameter from `int` to `bool` and default from 0 to `false`.
+ * src/roff/troff/input.cpp (token::get_char): Update definition.
+ * src/roff/troff/env.cpp (hyphen_word):
+ * src/roff/troff/node.cpp (remove_font_special_character):
+ * src/roff/troff/input.cpp (do_overstrike, do_bracket, next)
+ (do_define_character, remove_character, get_line_arg)
+ (encode_char, do_if_request, do_translate, char_flags)
+ (hyphenation_code, define_class): Update call sites. Add
+ comment indicating meaning of parameter.
-2004-09-10 Werner LEMBERG <wl@gnu.org>
+2021-06-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- In tbl, handle \a as an interpreted leader character if in
- compatibility mode.
+ * tmac/an-old.tmac (TH): When outputting HTML, write the
+ possibly case-transformed (but not yet abbreviated) page title
+ as the `title` element instead of the unaltered first argument
+ to `TH`.
- * src/preproc/tbl/table.h (PREFIX, PREFIX_CHAR, LEADER,
- LEADER_CHAR): New macros.
- (compatible_flag): New declaration.
+2021-06-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/main.cpp (table_input): Add LEADER_1, LEADER_2,
- LEADER_3, and LEADER_4 to `state'.
- (table_input::get): Handle `\a'.
+ * tmac/an-old.tmac (an-abbreviate-title): Define with `de`, not
+ `de1`, since it is not intended for call by traps or users.
- * src/preproc/tbl/table.cpp (PREFIX): Removed.
- (LEADER_REG): New macro.
- (table::init_output): Define LEADER_REG string register if in
- compatibility mode.
+2021-06-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/tbl.man: Document it.
+ * doc/groff.texi (Tab Stops): Fix erroneous claim; tab stops are
+ not set "every half inch across the page". This is only true in
+ "line tabs mode", which is not enabled by default. The default
+ behavior, to keep compatibility with AT&T troff, measures tab
+ stops relative to the current position on the input line.
-2004-08-18 Werner LEMBERG <wl@gnu.org>
+2021-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc.tmac (An): Fix error message.
+ * tmac/mdoc/doc-nroff-u: Set the usekeeps register used by tbl
+ to the logical complement of the cR (continuous rendering)
+ register. This prevents blank lines from creeping into tables
+ in that mode.
-2004-08-06 Werner LEMBERG <wl@gnu.org>
+2021-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/tbl/main.cpp (main): Call `fatal' not `error' if a
- file can't be opened. UNIX tbl has the same behaviour.
+ * tmac/an-old.tmac (an-blank-line-trap, an-leading-space-trap):
+ We say in a comment, "Macros ... that are called by traps of any
+ kind must be defined with `de1` because they might be called
+ from a context where compatibility mode is enabled." So do it.
-2004-08-05 Y T <doarhop@hotmail.com>
+2021-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/grn/hdb.cpp (compatibility_flag): Add declaration.
- (DBRead): If in compatibility mode, take into account the text
- when computing figure boundaries.
+ * tmac/an-old.tmac (an-header): Lightly refactor; tighten.
-2004-08-05 Werner LEMBERG <wl@gnu.org>
+2021-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/soelim/soelim.man: Improved. Based on suggestions
- from Tadziu Hoffmann.
+ * tmac/an-old.tmac (an-write-paragraph-tag): Lightly refactor
+ for clarity and to reduce code duplicated in both branches of an
+ `ie`/`el` structure.
-2004-08-03 Werner LEMBERG <wl@gnu.org>
+2021-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/meref.me: Document `_M' register.
+ * tmac/an-old.tmac: Rename `an-HF-remap-I-style` register to
+ `an-remap-I-style-in-headings` for greater clarity.
-2004-08-03 Martin Husemann <martin@duskware.de>
+2021-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- Make hpftodit work correctly on big-endian systems.
+ * tmac/mdoc/doc-common-u (doc-header, doc-end-macro): Partially
+ revert bf4b3dde (from 20 May); per Ingo Schwarze, continuous
+ rendering in mdoc(7) documents has always used only one vee
+ between headers, footers, and man page body text.
- * src/utils/hpftodit/hpftodit.cpp (File): New method
- `get_uint32(char *)'.
- (entry): New member `orig_value'.
- (read_tags): Use new method.
- (output_font_name, read_and_output_pcltypeface, dump_ascii):
- Updated.
+2021-06-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-08-01 Werner LEMBERG <wl@gnu.org>
+ * tmac/en.tmac: Stop using `do` request; it's unnecessary since
+ the file is already loaded with compatibility mode off.
- * tmac/s.tmac: Undo change 2003-06-29. The proper macro definitions
- are already in X11's `macros.t' file.
+2021-06-18 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-08-01 Jeff Conrad <jeff_conrad@msn.com>
+ [ms]: Fix doc omission; .ID can take an argument.
- * src/utils/hpftodit/hfptodit.cpp (output_font_name, dump_ascii):
- Fix casting bug.
- (read_and_output_pcltypeface): Handle strings with length <= 4.
+ * doc/groff.texi (ms Document Control Settings) <DI>:
+ Characterize register setting as a _default_.
+ (ms Displays and Keeps): Add optional variable "indent" argument
+ to syntax summary of ".DS I" and ".ID". Note that the given
+ indentation is used if present, and \n[DI] otherwise.
+ * doc/ms.ms (Displays and keeps): Add optional variable "indent"
+ argument to syntax summary of ".ID". Switch fonts more
+ carefully and apply italic corrections.
+ * tmac/groff_ms.7.man (Displays and keeps): Sync with doc/ms.ms.
-2004-07-27 Egil Kvaleberg <egil@kvaleberg.no>
+2021-06-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/s.tmac (pg@top): Don't save `PO' register.
- (pg*end-col, pg*end-page): Directly use `PO' register.
+ * tmac/s.tmac: Properly situate devtag flag-related register
+ names in the package name space. Rename `need_eo_h` to
+ `s@devtag-needs-end-of-heading'. Rename `need_eo_tl` to
+ `s@devtag-needs-end-of-title`.
+ ((initialization), par@reset, @SH, par@finish, @NH): Do it.
+ (par@reset): Test their values more idiomatically.
-2004-07-27 Werner LEMBERG <wl@gnu.org>
+ Fixes last third of <https://savannah.gnu.org/bugs/?42515>.
- * man/groff_tmac.man: Mention `trace' and `pic' macro packages.
+2021-06-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/refer/refer.cpp (output_references): Check for
- empty hash table.
- * src/preproc/refer/refer.man: Improve documentation of
- `bibliography' command.
+ * tmac/e.tmac-u (@h): Migrate SCCS revision 2.37 to be idiomatic
+ for groff (and not throw warnings of type 'mac').
-2004-07-26 Werner LEMBERG <wl@gnu.org>
+2021-06-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add requests `fcolor' and `gcolor'.
+ * doc/doc.am: Improve diagnostics during documentation
+ generation; none should occur normally, but when they do, seeing
+ troff complain about "<standard input>" is disheartening.
+ (DOC_GROFF_ONLY): Add -b option so we get backtraces (also kill
+ off trailing whitespace).
+ (DOC_GROFF):
+ (doc/pic.html):
+ (doc/webpage.html): Add sed expression to inject `lf` request
+ into the stream to identify the file being processed.
- * src/roff/troff/env.cpp (fill_color_change, glyph_color_change):
- New functions.
- (init_env_requests): Add `fcolor' and `gcolor'.
+2021-06-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.h: Export do_glyph_color and do_fill_color.
+ * doc/me-revisions: Supplement history with subsequent BSD work
+ from versions 2.29 (1988-04-22) to 8.1 (1993-06-05).
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo
- (Colors): Document new requests.
+2021-06-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-07-24 Werner LEMBERG <wl@gnu.org>
+ * doc/me-revisions: Add 'me' macro package revision log, scraped
+ from <https://svnweb.freebsd.org/csrg/share/me/revisions>.
+ * doc/doc.am (DOCFILES): Ship it.
- Add support for fractional point sizes in ms macros. A value for
- PS, VS, FPS, and FVS greater than or equal to 1000 is always divided
- by 1000. For example, `.nr PS 10250' sets the font size to 10.25p.
+2021-06-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/s.tmac (@AU, @AI, par@load-init, par@init, par@reset, NL,
- PX): Handle fractional point sizes for PS, VS, FPS, and FVS.
+ * tmac/e.tmac-u: Rename registers for clarity. Unlike other
+ macro packages supplied by groff, "me" mostly remains within the
+ AT&T 2-character name space, accessing extended names
+ selectively through `do` and `de1` requests. The package
+ therefore has no characteristic name prefix.
+ need_eo_h -> devtag-needs-end-of-heading
+ need_eo_tl -> devtag-needs-end-of-title
+ need_tl -> devtag-needs-title
+ (@html_check_need_title, sh, EQ): The foregoing registers are
+ effectively Booleans, so perform Boolean-style tests on their
+ interpolations.
- * tmac/groff_ms.man, docs/groff.texinfo (ms Document Control
- Registers), NEWS: Document it.
+ Fixes a second third of <https://savannah.gnu.org/bugs/?42515>.
-2004-07-19 Werner LEMBERG <wl@gnu.org>
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/lex.cpp (for_input): Add member `from'.
- Update constructor.
- (do_for, for_input::get, for_input::peek): Handle negative `by'.
- * src/preproc/pic/pic.man, doc/pic.ms, NEWS: Document it.
+ * tmac/e.tmac-u: Work in compatibility mode. It seems this was
+ the intention (reasonable, since "me" originates in pre-groff
+ BSD Unix), but there were several problems.
+ (@R): Prefix register existence test with `do`.
+ (@html_check_need_title): Define with `do` since the macro name
+ is long, and also with `de1` so that we can freely use groff
+ extensions within. Drop many `do` requests from macro
+ definition.
+ (@check_need_title): Define with `do`, as above. Add comment
+ explaining why `de1` is not needed for this macro definition.
+ (@S): Prefix macro/string existence test with `do`. Remove
+ spurious space so that the argument string name is truly defined
+ as empty.
+ (nm, n1, n2): Prefix handling of long register names `_#p` and
+ `_#f` with `do` request.
+ (top level): Prefix `mso` request with `do`.
+ ((x-html): Define with `do` and `de1` instead of `de`. Drop
+ now-unnecessary `do` requests from macro body.
+ ()x-html): Define with `do` and `de1` instead of `de` for
+ symmetry.
+ (xp-html): Define with `do` and `de1` instead of `de`. Drop
+ now-unnecessary `do` requests from macro body.
-2004-07-08 Thomas Klausner <wiz@netbsd.org>
+ Fixes <https://savannah.gnu.org/bugs/?60785>.
- * tmac/doc-syms (doc-str-St--p1003.1-2004): New string.
- * tmac/groff_mdoc.man: Updated.
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-07-05 Werner LEMBERG <wl@gnu.org>
+ * tmac/devtag.tmac: Work in compatibility mode; define macros
+ with the `de1` instead of the `de` request.
- * doc/groff.texinfo (Manipulating Hyphenation): Further improve
- documentation of `hcode'.
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-07-04 Sang Dae Yu <sdyu@bh.knu.ac.kr>
+ * tmac/refer-me.tmac:
+ * tmac/refer.tmac: Add include guards.
- Improve appearance of arrows in pic.
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/object.cpp (draw_arrow): Make outline of filled
- arrow head thin.
- Use two line segments for drawing non-filled arrow head.
- (line_object::print, spline_object::print): Shorten line length to
- avoid arrow sticking.
- (arc_object::print): Take arrow direction into account.
+ * tmac/refer-me.tmac: Handle being loaded in compatibility mode.
-2004-07-03 Heinz-JĂŒrgen Oertel <hj.oertel@surfeu.de>
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_www.man: Update documentation of .MPIMG.
+ * tmac/an-old.tmac: Properly situate devtag flag-related
+ register names in the package name space. Rename `need_eo_h` to
+ `an-devtag-needs-end-of-heading'. Rename `need_col2` to
+ `an-devtag-needs-second-column`.
+ (an-input-trap, SH, SS, HP, (initialization)): Do it.
+ (an-input-trap): Test their values more idiomatically.
-2004-07-03 Werner LEMBERG <wl@gnu.org>
+ Fixes one third of <https://savannah.gnu.org/bugs/?42515>.
- * tmac/an-old.tmac (RI): Always start with font `R'.
- (RI, IR): Properly end with font `R'.
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-07-02 Paul Eggert <eggert@cs.ucla.edu>
+ * src/roff/troff/input.cpp (do_if_request): Improve diagnostic
+ message; say "conditional operator", not just "conditional".
- * man/ditroff.man, man/groff_font.man, man/groff_out.man,
- src/devices/grohtml/grohtml.man, src/preproc/grn/grn.man,
- src/preproc/pic/pic.man, tmac/groff_man.man, tmac/groff_ms.man:
- Don't pass more than six arguments to .R, .I, .B, etc., for
- compatibility with traditional troff macros.
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-07-02 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-old.tmac (an-end, an-header): In continuous rendering
+ mode, use same spacing amount after header and before footer as
+ mdoc in its own continuous rendering mode. Thanks to Ingo
+ Schwarze for the suggestion.
- * src/roff/troff/input.h: s/COMPATIBLE_SAVE/PUSH_GROFF_MODE/.
- s/COMPATIBLE_RESTORE/POP_GROFFCOMP_MODE/.
- Update all users.
- (PUSH_COMP_MODE): New internal character constant.
- Update all users.
+ Fixes <https://savannah.gnu.org/bugs/?60653>.
- * src/roff/troff/input.cpp (get_copy): Handle PUSH_GROFF_MODE,
- PUSH_COMP_MODE, and POP_GROFFCOMP_MODE.
- (token::next, macro::append): Handle PUSH_COMP_MODE.
- (decode_args): Add PUSH_GROFF_MODE or PUSH_COMP_MODE before and
- POP_GROFFCOMP after each of the decoded arguments to make them
- independent from the compatibility mode status.
- (comp_mode): Add `COMP_ENABLE'.
- (do_define_string, do_define_macro): Handle COMP_ENABLE.
- (define_string, append_string, define_macro, define_indirect_macro,
- append_macro, append_indirect_macro): Handle `compatible_flag'.
- (chop_macro, substring_request, asciify): Handle PUSH_COMP_MODE.
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_diff.man, doc/groff.texinfo: Updated.
+ * tmac/an-old.tmac (P): Define this as the "canonical"
+ paragraphing macro.
+ (LP, PP): Make these aliases of P.
-2004-07-01 Werner LEMBERG <wl@gnu.org>
+2021-06-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo: Improve documentation of `hcode'.
- Use @documentencoding and convert document to latin-1; to do that
- make latin characters active and assign proper macros (within a
- @tex...@end tex environment).
- * doc/Makefile.in (.texinfo.html, groff): Use --enable-encoding.
- * doc/Makefile.sub (groff): Ditto.
+ * src/roff/troff/input.cpp (spring_trap): Tighten lexical
+ discipline; describe macro as "trap-called" rather than
+ "trap-invoked".
-2004-06-29 Werner LEMBERG <wl@gnu.org>
+2021-06-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- Implement two new conditional operators `F <name>' and `S <name>'
- which check whether <name> is a valid font or style, respectively.
+ [man]: Don't spuriously break a page after a paragraph tag when
+ the tag is short enough to fit within the paragraph's
+ indentation.
- * src/libs/libgroff/font.cpp (text_file): Add `silent' member.
- (text_file::text_file): Updated.
- (text_file::error): Don't emit message if `silent' is set.
- (font::load_font): Add optional third argument (which is directly
- passed to `load'.
- (font::load): Add optional second argument to check the header of
- a font only, without emitting warning or error messages.
- * src/include/font.h (font): Updated.
+ * tmac/an-old.tmac (an-write-paragraph-tag): Reserve ("need") 2
+ vees plus 1 basic unit of vertical space regardless of the width
+ of the tag. In the short tag case, we reverse space by one vee
+ after outputting the diversion in which the tag is stored, but
+ it will always contain a break, and by the time we reverse, we
+ might have already hit a page location trap
+ {an-break-body-text}, and by then it's too late to back up.
- * src/roff/troff/input.cpp (do_if_request): Implement `S' and `F'
- conditionals.
- * src/roff/troff/node.cpp (mount_font_no_translate): Add optional
- fourth argument to check a font without mounting.
- (check_font, check_style): New functions.
- * src/roff/troff/node.h: Updated.
+ * tmac/tests/an-old_no-break-after-short-paragraph-tags.sh: Test
+ it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * man/groff_diff.man, man/groff.man, NEWS, doc/groff.texinfo:
- Updated.
+ Fixes <https://savannah.gnu.org/bugs/?60624>.
-2004-06-27 Werner LEMBERG <wl@gnu.org>
+2021-06-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- Implement new string-valued register `.sty' to return the current
- style name.
+ * tmac/an-old.tmac: Rename environments to be more descriptive.
+ an-env -> an-env-header-or-footer
+ an-2 -> an-env-paragraph-tag
+ (an-header, an-footer, an-write-paragraph-tag): Do it.
- * env.cpp (environment::get_style_name_string): New function.
- (init_env_requests): Add `.sty' register.
- * env.h (environment): Updated.
- * node.cpp (font_info): Make `get_style_name' a friend.
- (get_style_name): New function.
- * node.h: Updated.
+2021-06-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff_diff.man, man/groff.man, NEWS, doc/groff.texinfo:
- Updated.
+ * tmac/s.tmac: Add diagnostic error if .EQ used within .TS/.TE.
+ Introduce register `tbl@within-table` to track whether we're
+ inside a table.
+ (@EQ): Check register and issue error if it is true.
+ (@TS): Set register.
+ (@TE): Clear register.
-2004-06-15 Werner LEMBERG <wl@gnu.org>
+ Prompted by Savannah #55754.
- * src/preproc/tbl/main.cpp (process_data) <GOT_RIGHT_BRACE>: Handle
- `nospaces' option.
+2021-06-14 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-06-10 Colin Percival <colin.percival@wadham.ox.ac.uk>
+ * tmac/s.tmac: Permit document to start with .PS.
+ (cov*ab-init): Alias PS to @PS.
+ (PS): Call LP, then re-execute (aliased) self as TS does.
+ (TS): Update comment to parallel the one in PS.
- * doc/meintro.me, doc/meref.me: Don't use \*[td], \n[dy], \*[mo],
- and \n[mo] to avoid dependency on current date.
+2021-06-11 Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
-2004-06-08 Werner LEMBERG <wl@gnu.org>
+ Indent an IP paragraph based on the type size of the paragraph
+ text, not a preceding heading. We have to delay evaluating IP's
+ argument until the font size has been reset, which I've
+ attempted to do by simply passing the argument unevaluated down
+ the call hierarchy, instead of saving it in a number register
+ right away, as appears customary in this ms implementation.
- * Makefile.sub (install_data): New target.
+ However, par@reset is called from a great number of places, and
+ these usually set the indent registers beforehand. I've left
+ this as it is, so now two ways of setting the indents exist: via
+ register and optionally via argument.
-2004-06-04 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (par@reset): Move font-size setting stuff before
+ indent-setting stuff; set registers from optional arguments with
+ default "n" scaling indicator before setting indents.
+ (par*start, par@finish): Don't set registers, but instead pass
+ arguments to par@reset.
+ (@IP): Pass argument unevaluated to par*start.
- * src/libs/libxutil/Makefile.sub (EXTRA_CFLAGS): Define.
-
-2004-06-03 Werner LEMBERG <wl@gnu.org>
-
- * src/devices/xditview/Makefile.sub (EXTRA_LDFLAGS): Fix typo and
- order of libraries.
- (install_data): Add $(srcdir).
-
- * src/utils/xtotroff/Makefile.sub (EXTRA_LDFLAGS): Fix order of
- libraries.
-
-2004-06-02 Werner LEMBERG <wl@gnu.org>
-
- * aclocal.m4 (GROFF_X11): s/have_no_x/groff_no_x/.
- Add X11 stuff to CFLAGS, LDFLAGS, and LIBS temporarily.
- Add test for Xmu library.
- (GROFF_APPRESDIR_OPTION, GROFF_APPRESDIR_CHECK,
- GROFF_APPRESDIR_DEFAULT): New macros.
-
- * configure.ac: Call GROFF_APPRESDIR_OPTION, GROFF_APPRESDIR_CHECK,
- and GROFF_APPRESDIR_DEFAULT.
+ Fixes <https://savannah.gnu.org/bugs/?59604>.
- * configure: Regenerated.
+2021-06-11 Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
- * Makefile.in (appresdir): New variable.
- (MDEFINES): Add appresdir.
+ * tmac/s.tmac (@QP, @XP): Be more scrupulous about using "u"
+ scaling indicator.
- * src/devices/xditview/Makefile.sub (EXTRA_LDFLAGS): Add -Xmu and
- -Xt.
- (install_data, uninstall_sub): New targets to handle GXditview.ad.
+2021-06-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/indxbib/Makefiles.ub (install_data): Depend on
- `$(srcdir)/eign', not `eign'.
+ Add regression test for Savannah #59604.
- * MANIFEST, INSTALL, NEWS, PROBLEMS: Updated.
+ * tmac/tests/s_IP-indents-using-paragraph-type-size.sh: Add it.
+ * tmac/tmac.am (tmac_TEST): Run it.
- * man/groff_out.man, man/roff.man, src/devices/grops/grops.man,
- src/devices/xditview/gxditview.man, src/roff/groff/groff.man:
- Protect (g)xditview with `\%' to avoid hyphenation.
- Other minor formatting.
+2021-06-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-06-01 Werner LEMBERG <wl@gnu.org>
+ Refactor grog even more aggressively. Make the tedious search
+ for subs.pl unnecessary by inlining it into grog.pl directly.
+ This makes the script stand alone and much more convenient to
+ work with, and doesn't contribute to bloat, in my
+ opinion--subs.pl was 10 times the size of grog.pl, and most of
+ the code in the latter was dedicated to trying to locate
+ subs.pl.
- Integrate gxditview into groff's standard directory hierarchy.
+ * Makefile.am: Delete references to $(grog_dir).
+ * configure.ac: Delete call of `GROFF_GROGDIR_DEFAULT` macro.
+ * m4/groff.m4: Delete definition of same.
+ * src/roff/grog/grog.am (GROG, dist_grog_DATA, grogdir): Drop
+ variables.
+ (grog): Remove target's dependency on `$(GROG)`. Remove sed
+ expression replacing `@grog_dir@` with `$(grog_dir)` in grog.pl.
+ * src/roff/grog/grog.pl: Inline most of subs.pl (except for
+ author/license comment banner). Delete sub-hunting logic.
+ * src/roff/grog/subs.pl: Delete.
+
+2021-06-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/pic.ms (Basic PIC Concepts, Decorating Objects/Filled
+ Objects, PIC Reference/Semi-Formal Grammar): Fix error: the
+ keyword "solid" sets a line style, not a fill for a closed
+ figure. Thanks to Dave Kemper and Wim Stockman for reporting
+ and researching this issue.
+
+ Fixes <https://savannah.gnu.org/bugs/?60470>.
+
+2021-06-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * NEWS:
+ * doc/webpage.ms:
+ * man/groff.7.man (Registers/Read-only registers) <.U>:
+ * man/groff_diff.7.man (Language/New number registers) <.U>: Fix
+ error; the sense of this Boolean variable was backwardly
+ documented {perhaps due to an implementation detail from 2004
+ that was reversed in commit 7a0e2f15, 26 February 2008}.
+
+2021-06-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/groff.cpp: Revise usage message.
+ (synopsis): Set primary synopsis on a single output line, for
+ convenience of parsing and also because we have no control over
+ the width of the program name in character cells; it comes from
+ argv[0] and is under user control. There is thus no point in
+ trying to get pretty formatting. Also include separate synopsis
+ lines for short and long help options. Use opposite case from
+ option flags for option arguments.
+ (help): Collate option flags in English lexicographic order.
+ Include space after flag letters for options that take
+ arguments. Consistently use capitals for option arguments
+ because they are space-separated here. Illustrate longer forms
+ of -d and -r options. Update language (some, like "tmac.name",
+ was very old). Add reference to groff(1) man page at end.
+ (usage): Drop appendnment of notice regarding -h option; this is
+ now covered in `synopsis()` unconditionally.
+
+2021-06-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Eliminate "groff_opts_no_arg.txt" and "groff_opts_with_arg.txt"
+ files from distribution. They are not needed by any live code
+ in the tree; possibly only groffer ever used them.
+
+ * src/roff/groff/groff.am (GROFF_OPTS_OUTPUT, groffoptsdir)
+ (groffopts_DATA): Delete variables.
+ (MOSTLYCLEANFILES): Stop adding to target.
+ (groff_opts.tmp, groff_opts_no_arg.txt,
+ groff_opts_with_arg.txt): Delete targets.
+
+2021-06-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/grog/subs.pl (version): Report version information in
+ a format consistent with our other programs.
+
+2021-06-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/grog/grog.pl: Refactor initialization so that the
+ program can be run from a build tree--and tested. Drop much
+ cruft from before Bertrand Garrigues's 2018 work to adopt
+ `git-version-gen`.
+
+2021-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/an-old_title-abbreviation-works.sh: Log more
+ accurate messages in test failures.
+
+2021-06-03 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (an-abbreviate-title): Add new internal macro
+ to reduce the length of a man page title (i.e., the "ls" in
+ "ls(1)", if it is too wide to fit in the page header (and would
+ overwrite the center header material, usually the title of the
+ manual section). Since the beginning and end of the title might
+ be important for disambiguation, truncation at either end would
+ be unwise; replace the middle of the title with an ellipsis.
+ Define new an-pageref and an-title-abbv strings for use by other
+ macros and user-defined PT and BT traps.
+ (PT, an-footer): Use new an-pageref string for economy.
+ (an-header): Call an-abbreviate-title after setting the title
+ length.
- * src/xditview/*: Moved to ...
- * src/devices/xditview/*: Here.
- Moved DviChar.h and XFontName.h to src/include.
- Moved DviChar.c and XFontName.c to new directory src/libs/libxutil.
- Split off `xmalloc' into new file src/libs/libxutil/xmalloc.c.
- Moved xtotroff.c to new directory src/utils/xtotroff.
- Provide proper Makefile.sub files (reusing the stuff from
- Imakefile.in).
- DESC renamed to DESC.in.
- Removed GXDitview-ad.h, INSTALL, Imakefile.in.
- Converted everything from K&R to ANSI C.
- Decorated with const where appropriate.
- Cast string constants with `String' and `char *' where appropriate.
- Made it compile with C++ (used as a C compiler).
- Removed other minor compiler warnings.
+ * tmac/tests/an-old_title-abbreviation-works.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * src/devices/xditview/device.c: Include config.h, string.h, and
- defs.h.
- Don't declare `exit', `strtok', `strchr', and `getenv'.
- (FONTPATH): Remove.
+ Fixes <https://savannah.gnu.org/bugs/?43532>.
- * src/devices/xditview/font.c: Don't declare `XParseFontName' and
- `XFormatFontName'.
+2021-06-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/xditview/xditview.c: Include config.h.
- Include stdio.h earlier.
- Protect declaration of `popen' and `pclose' with
- NEED_DECLARATION_POPEN and NEED_DECLARATION_PCLOSE.
- Replace `caddr_t' with `XtPointer'.
- (MakePromptFunc): New typedef.
- (DoPrint): Use RETSIGTYPE.
- (promptfunction): Change type to MakePromptFunc.
- (MakePrompt): Use MakePromptFunc for third argument.
- (xmalloc): Removed.
+ * man/groff.7.man (Copy mode): Add new section.
- * src/devices/xditview/ad2c: Add casts to `String'.
+2021-06-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/XFontName.h (XFontNameString): Don't use array
- notation.
- Add prototypes for `XParseFontName', `XFormatFontName',
- `XCompareFontName', and `XCopyFontName'.
+ * src/roff/troff/input.cpp (else_request, while_request)
+ (pipe_source, open_request, opena_request, pipe_output)
+ (system_request): Update diagnostic messages to not presume the
+ identities of the control or escape characters.
- * src/include/Makefile.sub (HDRS): Add `DviChar.h' and
- `XFontName.h'.
+2021-06-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/xtotroff/xtotroff.c: Include getopt.h.
- Don't declare `XParseFontName' and `XFormatFontName'.
- (xmalloc): Removed.
- (main): Remove `optind' and `optarg'.
+ * doc/groff.texi (Conventions Used in This Manual): Add node.
- * Makefile.in (XDEVDIRS, XPROGDIRS, XLIBDIRS): New variables
- (to select programs which need X).
- Make XDEVIDIRS depend on `FORCE'.
- (X_CFLAGS, X_LIBS, X_EXTRA_LIBS, X_PRE_LIBS): New variables (for
- X support).
- (MDEFINES): Updated.
- (LIBDIRS): Use XLIBDIRS.
- (CPROGDIRS): Use XPROGDIRS.
- (DEVDIRS): Remove font directories for gxditview.
- (ALLDIRS, DISTDIRS): Add XDEVDIRS.
- (EXTRADIRS): Remove src/xditview.
+2021-05-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.sub (DISCLEANFILES): Updated.
+ * src/roff/groff/groff.1.man: Expand to aid beginners.
+ (initialization): Define `TeX` string.
+ (Usage): Rewrite.
+ (Usage/Getting started): Add "Hello, world!" example using
+ multiple output devices (formats).
+ (Usage/Using groff as a REPL): Add example of likely interest to
+ programmers. Or so I hope. It illustrates the Turing
+ fundamentals; we read, store, test, and branch.
- * Makefile.comm (LIBXUTIL): New variable.
- (.cpp.o, .cpp.obj): Handle EXTRA_CCFLAGS.
- (.c.o, .c.obj, .y.o): Handle EXTRA_CFLAGS.
+2021-05-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.cpg, Makefile.ccpg ($PROG): Handle EXTRA_LDFLAGS.
+ * tmac/papersize.tmac: Improve diagnostic message; when
+ complaining about unrecognized input, report back the input we
+ actually received, not what it looks like after we transform it.
+ Also add name of macro package to diagnostic so the user knows
+ who is speaking, continuing the long process of fixing Savannah
+ #52463.
- * aclocal.m4 (GROFF_X11): New function.
+2021-05-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure.ac: Call GROFF_X11.
- Don't create src/xditview/Imakefile.
- Don't emit notice how to build gxditview.
+ * tmac/groff_ms.7.man (Usage/Paragraphs) <QP>: Fix error: .QP
+ paragraphs are indented by \n[QI], not \n[PI].
- * configure: Regenerated.
+2021-05-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * test-groff.in (GROFF_BIN_PATH, XENVIRONMENT): Updated.
+ * src/libs/libdriver/input.cpp (do_file): Make fatal diagnostic
+ from output driver when the device description file "DESC" can't
+ be found more informative by including the name of the device
+ for which the input was prepared. Also makes malformed input of
+ intermediate format more obvious.
-2004-05-28 Akihiro Sagawa <sagawa@sohgoh.net>
+2021-05-27 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in (CPPFLAGS): Define.
- (MDEFINES): Add CPPFLAGS.
+ * src/preproc/tbl/tbl.1.man (Miscellaneous): Add paragraph
+ cautioning users against making tbl(1) tables conditional
+ document content.
-2004-05-27 Werner LEMBERG <wl@gnu.org>
+2021-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * arch/misc/Makefile.sub (shdeps.sed): Use $(srcdir).
+ [man]: Add style warnings for documents with input lines that
+ are blank or have leading spaces, since they can cause
+ surprising rendering; enabled if the CHECKSTYLE register is
+ greater than 2.
-2004-05-26 Niklas Edmundsson <nikke@acc.umu.se>
+ * tmac/an-old.tmac (an-blank-line-trap, an-leading-space-trap):
+ Issue style warning if enabled (and only if fill mode enabled in
+ leading space trap); in any event, recreate the default *roff
+ behavior.
+ (TH): Install traps.
- Fix problems with `friend name injections'.
+ * doc/andoc.tmac (reload-doc): Remove man(7) traps before
+ loading doc.tmac.
- * src/preproc/eqn/box.h (make_mark_box, make_lineup_box,
- make_script_box), src/roff/troff/div.h (end_diversions),
- src/roff/troff/env.h (title), input.cpp (process_input_stack): Undo
- change 2004-04-08.
+2021-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-05-25 Bernd Warken <bwarken@mayn.de>
+ * doc/andoc.tmac (reload-doc): Fix spurious blank line.
- * src/preproc/pic/pic.man, doc/pic.ms: Add example for `command'.
+2021-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-05-25 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Operators in Conditionals):
+ * man/groff.7.man (Control structures/Conditional expressions):
+ Fix omission; the conditional operators "F", "m", and "S" also
+ accept optional spaces and/or tabs between themselves and their
+ arguments.
- * src/libs/libgroff/cset.cpp, src/libs/libgroff/lf.cpp,
- src/libs/libgroff/color.cpp: Include lib.h.
+2021-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-05-25 Paul Eggert <eggert@cs.ucla.edu>
+ * man/groff.7.man (Requests/Request short reference) <.ta>:
+ Describe the request as tersely as possible without omitting its
+ essential syntax and semantics. (The AT&T troff "+" relative
+ prefix for normally absolute positions ".ta 1i +1i +1i" and
+ alignment-specifying suffixes "L", "R", and "C" had both been
+ omitted.)
- * PROBLEMS: Update documentation for problems with Sun C++ 5.0
- through Forte 6u1, and for how to get GNU make on Solaris.
+2021-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-05-24 Werner LEMBERG <wl@gnu.org>
+ * man/groff.7.man (Registers/Writable registers): Fix error:
+ \n[nl] interpolates the current vertical position, not the
+ vertical position of the "last printed text baseline"; the
+ latter is \n[.h].
- * PROBLEMS: Document problems with gcc 3.4.0 on Sun. Reported
- by Paul Eggert.
+2021-05-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-05-15 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * doc/groff.texi (Manipulating Filling and Adjustment): Update
+ inter-sentence space example to be more illustrative. Thanks to
+ Dave Kemper and Doug McIlroy for the discussion.
- * arch/misc/Makefile.sub (shdeps.sed): Don't use `$<' in explicit
- rule.
+ Fixes <https://savannah.gnu.org/bugs/?60404>.
-2004-05-14 Werner LEMBERG <wl@gnu.org>
+2021-05-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * REVISION: Set to 2.
+ * tmac/mdoc/doc-common-u: Add comment warning source divers that
+ \n[doc-header-space] is re-used for a purpose for which it is
+ not documented.
+ * tmac/mdoc/doc-nroff-u: Initialize doc-{header,footer}-space
+ registers, which define the vertical spacing between body text
+ and the relevant titles (not between the titles and the page
+ margins) to 1v instead of 0.5i. This is what mdoc(7) has always
+ done in practice, per Ingo Schwarze.
- * aclocal.m4 (GROFF_STDINT_H): Removed.
- (GROFF_INTTYPES_H): Define HAVE_CC_INTTYPES_H.
+2021-05-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * configure.ac: Updated.
- * configure, src/include/config.hin: Regenerated.
+ * src/devices/grohtml/post-html.cpp (assert_state::add): Avoid
+ potential deallocation of statically-allocated strings. Use
+ strsave() to duplicate them so that they can be safely handed to
+ a_delete(). Also update diagnostic message to report name of
+ complaining program (continuing the long process of fixing
+ Savannah #52463).
- * src/libs/libgroff/tmpname.cpp: Don't include stdint.h but
- inttypes.h conditionally.
+ Fixes <https://savannah.gnu.org/bugs/?55693>. Thanks to
+ Petru-Florin Mihancea for the report.
-2004-05-13 Werner LEMBERG <wl@gnu.org>
+2021-05-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-Version 1.19.1 released
-=======================
+ * tmac/troffrc-end: Fix transposition error (in commit a248aa33
+ on 15 January) that broke most table image generation in HTML
+ output.
-2004-05-10 Stephen Gildea <http://www.gildea.com/stephen>
+ Fixes <https://savannah.gnu.org/bugs/?60656>.
- * src/preproc/refer/label.y (same_author_last_name,
- same_author_name): Handle empty sort keys.
+2021-05-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-05-10 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-ext.tmac (UE, ME): Replace calls to HTML-NS macro for
+ emissions of HTML 'A' tags with direct usage of \X device
+ control escapes. Replace .nop requests with text lines since
+ this file is supposed to be maximally portable to other *roffs.
- * NEWS, README, TODO, PROJECTS, PROBLEMS, MANIFEST, doc/webpage.ms,
- tmac/TODO: Updated.
+2021-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc-syms (doc-str-Lb-libposix, doc-str-Lb-libpthread,
- doc-str-Lb-librt): Reset font.
- (Lb): Rename `doc-str-Lb' to `doc-str-Lb1'.
- Provide `doc-str-Lb' to reset font.
- * tmac/groff_mdoc.man: Updated.
+ * src/preproc/html/pre-html.cpp (main): Call `scanArguments()`
+ earlier, before trying to load a font description, so that -v,
+ --version, and --help work.
-2004-05-08 Jan Schaumann <jschauma@netmeister.org>
+2021-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/html/pre-html.cpp (make_message): Make it work for
- snprintf versions which don't conform to ANSI C 99 (this is,
- counting the string's trailing null byte in the return value).
+ [grohtml]: Add -C and -G options to postprocessor, to suppress
+ output of CreationDate and Creator HTML comments, respectively.
+ These can inject unwanted noise into build artifacts.
-2004-05-07 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * src/devices/grohtml/post-html.cpp: Add static globals
+ `do_write_creator_comment` and `do_write_date_comment`.
+ (html_printer::{do_file_components,~html_printer}): Write
+ comments per corresponding global variables.
+ (main): Add to `getopt_long()` call parameter and set as needed.
+ (usage): Document them.
- * src/roff/troff/node.cpp (suppress_node::tprint): Don't expect
- that all implementations of sprintf handle null pointers correctly.
+ * src/preproc/html/pre-html.cpp (scanArguments): Add to
+ `getopt_long()` parameter, but ignore.
-2004-05-04 Werner LEMBERG <wl@gnu.org>
+ * src/devices/grohtml/grohtml.1.man (Synopsis, Options):
+ Document them.
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo:
- Document `.U' register.
+ * src/roff/groff/tests/output_driver_C_and_G_options_work.sh:
+ Test them.
+ * tmac/tmac.am (groff_TESTS): Run test.
- * src/roff/troff/env.cpp (environment::mark_last_line)
- [WIDOW_CONTROL]: Fix scope of `p' for new C++ compilers.
+ Fixes 1/3rd of <https://savannah.gnu.org/bugs/?60655>.
-2004-05-04 Larry Kollar <kollar@alltel.net>
+2021-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- New read-only register `.U'; it returns 1 in safer mode and 0
- otherwise.
+ * src/preproc/html/pre-html.cpp (usage):
+ * src/devices/grohtml/post-html.cpp (usage): Fix inaccuracies in
+ supported option summary.
- * src/roff/troff/input.cpp (init_input_requests): Implement `.U'
- register.
+2021-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-05-03 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/html/pre-html.cpp (scanArguments):
+ * src/devices/grohtml/post-html.cpp (main): Use libgroff's
+ warning() instead of printf() to emit diagnostic about
+ unrecognized parameter to `-x` option. This sends the
+ diagnostic to the standard error stream and continues the long
+ process of fixing Savannah #52463.
- * install-sh, mkinstalldirs: New versions; taken from texinfo CVS.
+2021-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-04-17 Werner LEMBERG <wl@gnu.org>
+ * tmac/groff_www.7.man: Stop using the "www" macro package. The
+ macros it exposes are not part of the quasi-standardized man(7)
+ language, and thus should not be used in man(7) documents. See
+ groff_man_style(7) for portability advice. Besides, the
+ extension macros in the permissively-licensed an-ext.tmac are
+ sufficient to support URL and email hyperlinks, and our SH and
+ SS macro implementations already support anchor placement
+ without requiring explicit effort from page authors.
+ (initialization): Stop sourcing www.tmac. Stop calling .LK and
+ .HR; the page-internal navigation links were being placed after
+ the apropos line instead of at the beginning of the page,
+ contradicting the comment that was there (possibly a bug).
+ (Requests) <URL, LK>: Stop calling .TAG.
+ <LK>: Drop paragraph advising reader to format page for groff's
+ HTML output device to observe the navigation links at that point
+ in the test.
+
+2021-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/font.h (font): Use `int' for ch_index.
- * src/libs/libgroff/font.cpp (font::alloc_ch_index,
- font::compact): Updated.
+ * doc/groff.texi (Comments): Fix error in description of parser
+ operation; '.\"' is an effective whole-line comment not because
+ it is a call of an undefined macro named '\"' (no 'mac' warning
+ is emitted when that warning type is enabled), but because the
+ comment escape is recognized normally and what remains is
+ handled as the empty request. Clarify that the optional
+ argument to the .ig request is the name of a macro (which will
+ be called normally _and_ end the ignored region; this is
+ analogous to ".de foo bar").
- * src/roff/groff/pipeline.c (run_pipeline) [_WIN32]: Fix compiler
- warnings.
+2021-05-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/div.cpp (begin_page), src/roff/troff/env.cpp
- (hyphen_word): Fix compiler warnings.
- * src/roff/troff/input.cpp (get_char_for_escape_name): Return
- `char'.
- Update all callers.
- (get_delim_number, get_line_arg): Change second argument type to
- `unsigned char'.
- (macro_header::copy, token::next, do_define_string,
- do_define_character, substring_request, asciify_macro,
- unformat_macro, read_size, non_interpreted_node::interpret,
- while_request, main: Fix compiler warnings.
- (read_color_draw_node): Initialize `col'.
+ * tmac/an-ext.tmac (UR, UE, MT, ME): Rename environment and
+ diversion for clarity; they apply to the link text, not the URL
+ {or email address}. The latter might not visibly appear,
+ depending on the output driver.
- * src/preproc/tbl/table.cpp (horizontal_span, table_entry): Make
- `start_col' and `end_col' of type `int'.
- (vertical_rule): Make `col' of type `int'.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/grn/hdb.cpp (DBRead): Protect call to getc with check
- for EOF.
+ * tmac/an-old.tmac (TH): Remove extraneous right-brace escape.
- * src/preproc/refer/label.y (uppercase_array, lowercase_array):
- New arrays.
- (format_serial): Use them to remove dependency on ASCII.
+ Fixes <https://savannah.gnu.org/bugs/?60651>. Thanks to Bjarni
+ Ingi Gislason for catching it.
- * src/devices/grops/ps.cpp (ps_printer::define_encoding): Fix
- compiler warning.
- * src/devices/grops/psrm.cpp (resource_manager::supply_resource):
- Ditto.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grotty/tty.cpp (tty_font::load_tty_font): Fix
- compiler warnings.
- (glyph): Change type of `hpos' to `int'.
+ * doc/groff.texi (Copy Mode): Fix omissions from list of escape
+ sequences interpreted even in copy mode. Add \g, \V, "\.",
+ '\"', \#, \a, \e and \E (with caveat), and \t. Parallels
+ groff(7) now. Add cross reference to "Character Translations"
+ node.
- * src/devices/lbp/lbp.cpp (strsep): Removed. Unused.
- * src/devices/lbp/lbp.h (splinerel): Fix compiler warnings.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/tfmtodit.cpp (gf::load): Fix compiler warnings.
+ * man/groff.7.man (Escape Sequences): Fix omission; the escape
+ character in an unrecognized escape sequence is not merely
+ ignored; the sequence produces a warning diagnostic, albeit of a
+ type that is disabled by default.
+ (Escape Sequences/Escape short reference): Fix omissions; \# and
+ \V are interpreted even in copy mode.
- * src/utils/pfbtops/pfbtops.c (get_text): Fix compiler warning.
-
-2004-04-16 Werner LEMBERG <wl@gnu.org>
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (an-header): Fix missing brace escape.
- * src/devices/grolbp/lbp.h, src/preproc/grn/gprint.h,
- src/preproc/grn/hgraph.cpp, src/preproc/grn/hpoint.cpp,
- src/preproc/html/pushback.cpp, src/preproc/html/pushback.h: Use
- `double' instead of `float' everywhere.
- * src/preproc/grn/main.cpp: Use `double' instead of `float'
- everywhere.
- (main): Add return value.
- * src/preproc/grn/hdb.cpp: Use `double' instead of `float'
- everywhere.
- Update all user functions.
-
- * src/include/search.h, src/include/ptable.h, src/include/printer.h,
- src/preproc/eqn/box.h, src/preproc/pic/object.h,
- src/preproc/refer/refer.h, src/preproc/tbl/table.h,
- src/preproc/tbl/table.cpp, src/roff/troff/env.h,
- src/roff/troff/div.h, src/roff/troff/token.h, src/roff/troff/node.h,
- src/roff/troff/input.cpp, src/roff/troff/request.h,
- src/roff/troff/node.cpp: Don't mix `struct' and `class' in forward
- declarations.
-
- * src/utils/indxbib/signal.c: Include stdlib.h.
-
-2004-04-14 Keith Marshall <keith.d.marshall@ntlworld.com>
-
- * tmac/s.tmac (@init, RP): Allow initialization of the PO register
- before the first page.
-
-2004-04-14 Thomas Klausner <wiz@netbsd.org>
-
- * tmac/doc-common (doc-volume-as-*): Use lowercase names.
- (doc-operating-system-*): Updated.
- * tmac/doc-syms (doc-str-St-*): Various small fixes.
- (doc-str-Lb-*): Add more library names.
-
-2004-04-10 Art Haas <ahaas@airmail.net>
-
- * src/utils/hpftodit/hpuni.cpp (hp_msl_to_unicode_list): Don't
- use anonymous type.
-
-2004-04-09 Art Haas <ahaas@airmail.net>
-
- * src/utils/tfmtodit.cpp (lig_chars): Don't use anonymous type.
-
-2004-04-09 Keith Marshall <keith.d.marshall@ntlworld.com>
-
- * arch/misc/shdeps.sh: Generate better comment for sed script.
-
-2004-04-08 Art Haas <ahaas@airmail.net>
-
- * src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list),
- src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list),
- src/libs/libgroff/uniuni.cpp (unicode_decompose_list),
- src/preproc/eqn/box.cpp (param_table), src/preproc/grn/hgraph.cpp
- (polyfill), src/preproc/grn/main.cpp (polyfill),
- src/preproc/refer/command.cpp (command_table),
- src/utils/tfmtodit.cpp (lig_table): Don't use anonymous types (which
- gcc 3.5 doesn't like).
-
-2004-04-08 Werner LEMBERG <wl@gnu.org>
-
- Removing many compiler warnings. groff should now compile with
- a C++ compiler used for C files also. [Simple variable renamings
- to avoid shadowing aren't logged in detail.]
-
- * src/devices/grodvi/dvi.cpp: Some local variable renamings.
- (draw_dvi_printer::draw) ['c']: Enclose in block.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp: Some local variable renamings.
- (page::add_line): Fix typos.
- * src/devices/grohtml/html-text.cpp: Some local variable renamings.
+ [man]: Slightly refactor footer spacing management when
+ continuously rendering.
- * src/devices/grolbp/lbp.cpp: Don't define _GNU_SOURCE.
- Some local variable renamings.
- * src/devices/grolbp/lbp.h: Some local variable renamings.
+ * tmac/an-old.tmac (an-end): Increase the page length _after_
+ flushing a pending output line. Do so only by the amount of
+ spacing we actually perform next. Make the scaling indicator on
+ the .sp request explicit. The amount seemed magical because it
+ was accounting for the one line to be consumed by output of the
+ footer title line. Instead, move that further increase of the
+ page length from here...
+ (an-footer): ...to here (~250 lines away), before calling BT.
- * src/devices/grolj4/lj4.cpp, src/devices/grotty/tty.cpp: Some local
- variable renamings.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libbib/index.cpp (index_search_item_iterator::get_tag):
- Remove redundant local variable declaration.
- * src/libs/libbib/map.c (mapread, unmap): Don't use K&R style.
- Don't use `caddr_t' but `void *'.
- Enclose functions with `extern "C"' for C++.
-
- * src/libs/libdriver/input.cpp (remember_filename,
- remember_source_filename): Use cast for string constant.
-
- * src/libs/libgroff/font.cpp, src/libs/libgroff/fontfile.cpp,
- src/libs/libgroff/nametoindex.cpp, src/libs/libgroff/paper.cpp,
- src/libs/libgroff/geometry.cpp: Some local variable renamings.
- * src/libs/libgroff/iftoa.c, src/libs/libgroff/itoa.c: Don't use K&R
- style.
- Enclose functions with `extern "C"' for C++.
- * src/libs/libgroff/quotearg.c (TRUE,FALSE): Define as macros.
- (needs_quoting): Return `int'.
- (quote_arg): Add proper casts to malloc and realloc.
- * src/libs/libgroff/spawnvp.c: Compile code only for MS-DOS and
- various MS Windows environments.
- (spawnvp_wrapper): Add proper cast to malloc.
-
- * src/preproc/eqn/box.h: Remove redundant declarations of
- `make_script_box', `make_mark_box' and `make_lineup_box'.
- * src/preproc/eqn/eqn.y: Remove redundant declaration of `strsave'.
- * src/preproc/eqn/script.cpp, src/preproc/eqn/pile.cpp: Some local
- variable renamings.
+ * tmac/mdoc/doc-common-u (doc-end-macro): When continuously
+ rendering and after flushing the last line of the body text of a
+ page, vertically space by 3 vees instead of 1, for consistency
+ with our man(7) implementation. Also increase page length by
+ same amount _after_ flushing a pending output line, for symmetry
+ with other spacing requests (and to prevent nasty surprises
+ analogous to those in Savannah #60611).
+ (doc-header): Put 3 vees of space after the header in continuous
+ rendering mode, not 1 (and increase page length accordingly).
- * src/preproc/grn/hpoint.cpp: Some local variable renamings.
- * src/preproc/grn/hgraph.cpp: Some local variable renamings.
- (dx, dy): Renamed functions to...
- (deltax, deltay): This.
- * src/preproc/grn/main.cpp: Some local variable renamings.
- (deffont): Add `const'.
- (initpic, conv): Use cast for string constant.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/html/pre-html.cpp: Some local variable renamings.
- (makeFileName, alterDeviceTo, addZ): Use cast for string constant.
- (char_buffer::run_output_filter): Second argument is unused.
- * src/preproc/html/pushback.cpp: Some local variable renamings.
+ [man]: Add warnings for macros deprecated in groff_man(7),
+ emitted if the CHECKSTYLE register is greater than 1.
- * src/preproc/pic/pic.y: Remove redundant declaration of `do_copy'.
- * src/preproc/pic/object.cpp: Some local variable renamings.
+ * tmac/an-old.tmac (an-deprecation-warn): New macro emits
+ diagnostic.
+ (DT, PD): Call the foregoing, re-using arguments.
- * src/preproc/refer/label.y (lookup_label): Remove redundant
- declaration of local variable.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/soelim.cpp: Remove redundant declaration of
- `interpret_lf_args'.
+ * tmac/an-old.tmac: Refactor to move bodies of DT and PD into
+ private macros.
+ (an-reset-tab-stops, an-reset-paragraph-spacing): New names for
+ the former DT and PT.
+ (TH): Call these new macro names.
+ (DT, PD): Wrap the corresponding private macros.
- * src/preproc/tbl/main.cpp: Some local variable renamings.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/groff.cpp (main): Use cast for string constant.
- * src/roff/groff/pipeline.c: Enclose declarations of `error',
- `c_fatal', and `i_to_a' with `extern "C"' for C++.
- Don't use C++-style comments.
+ * tmac/an-old.tmac (an-bp): In continuous rendering mode, draw
+ a horizontal line between a page footer of one man page document
+ and the header of the next, but only if multiple documents are
+ being rendered.
+ (initialization): Use variable to ensure we don't draw this line
+ after finishing the only document we render.
- * src/roff/troff/env.h: Remove redundant declaration of `title'.
- * src/roff/troff/node.h, src/roff/troff/env.cpp,
- src/roff/troff/div.cpp, src/roff/troff/node.cpp: Some local variable
- renamings.
- * src/roff/troff/div.h: Remove redundant declaration of
- `end_diversions'.
- * src/roff/troff/troff.h: Remove redundant declaration of
- `cleanup_and_exit'
- * src/roff/troff/input.cpp: Remove redundant declaration of
- `handle_first_page_transition' and `process_input_stack'.
+ Fixes other half of <https://savannah.gnu.org/bugs/?60611>.
- * src/utils/hpftodit.cpp: Some local variable renamings.
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/indxbib/signal.c: Enclose functions with `extern "C"'
- for C++.
- Don't define RETSIGTYPE.
- * src/utils/indxbib/indxbib.cpp: Some local variable renamings.
+ [man]: Fix stochastic vertical space loss problems in continuous
+ rendering mode by being more scrupulous about extending the page
+ length. As noted in Savannah #60611, sometimes the vertical
+ space between a header line and the first section heading
+ {"Name"} would be reduced or removed altogether, in a way that
+ was highly sensitive to circumstances. As far as I can tell,
+ the problem is that this vertical space disappeared only when we
+ were in double-secret probation no-space mode; this is the
+ special non-spacing mode {not apparent with inspection of
+ \n[.ns]} that happens when the stealth internal page location
+ trap is sprung. This trap does not appear in .ptr output but
+ can be disabled with ".vpt 0", which is an alternative fix for
+ this problem {because continuous rendering mode does not use
+ vertical position traps at all}. Another fix might have been to
+ simply call the moral equivalent of ".pl MAXINT" as soon as
+ continuous rendering mode was decided upon.
- * src/utils/pfbtops/pfbtops.cpp: Don't use K&R style.
- (error): Use `const' in argument.
- (main): Remove redundant declaration of `optind'.
- Move declaration of `Version_string' to top-level.
+ * tmac/an-old.tmac (an-header): In continuous rendering mode,
+ extend the page length by one line before calling PT to output
+ the page header, and afterwards, extend the page length by 3
+ vees and space by that amount (instead of half an inch).
- * PROBLEMS: Document difficulties compiling signal.c if a C++
- compiler is used for C.
+ Fixes half of <https://savannah.gnu.org/bugs/?60611>.
-2004-04-07 Werner LEMBERG <wl@gnu.org>
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.sub (DISTCLEANFILES): Add `test-groff'.
-
-2004-04-06 Keith Marshall <keith.d.marshall@ntlworld.com>
-
- Make scripts like nroff.sh and neqn.sh portable across various
- (Unix-like) shell implementations from Cygwin, MSYS, etc., which use
- non-POSIX path separators. The idea is to extend those scripts to
- decide at run-time (of the script) which path separator to use.
-
- * arch/misc/Makefile.sub: New file.
- * arch/misc/shdeps.sh: New file, generating OS dependency fixups.
- This script handles @GROFF_BIN_PATH_SETUP@, replacing it with
- a proper definition of the variable `GROFF_RUNTIME'.
-
- * Makefile.in (SH_DEPS_SED_SCRIPT): New variable.
- (MDEFINES): Add SH_DEPS_SED_SCRIPT.
- (PROGDEPDIRS): New variable.
- `FORCE' it.
- (PROGDIRS): Add PROGDEPDIRS.
-
- * src/preproc/eqn/Makefile.sub (neqn): Call SH_DEPS_SED_SCRIPT.
- Don't substitute @SEP@ and @BINDIR@.
- * src/preproc/eqn/neqn.sh: Use @GROFF_BIN_PATH_SETUP@.
- (PATH): Use GROFF_RUNTIME.
-
- * src/roff/nroff/Makefile.sub (nroff): Call SH_DEPS_SED_SCRIPT.
- Don't substitute @SEP@ and @BINDIR@.
- * src/roff/nroff/nroff.sh: Use @GROFF_BIN_PATH_SETUP@.
- (PATH): Use GROFF_RUNTIME.
+ * tmac/an-old.tmac (an-header, an-footer): Drop no-op .tl
+ requests.
-2004-04-05 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-05-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/nroff/nroff.sh: Implement work-around for sh.exe from
- Cygwin which doesn't handle stderr correctly.
+ * tmac/an-old.tmac (an-footer): Improve symmetry with an-header.
+ If rendering to HTML, don't bother setting the
+ an-outer-footer-text, an-extra1, and an-extra2 strings to empty
+ values; instead don't call BT, just as we don't call PT in
+ an-header.
-2004-03-08 Werner LEMBERG <wl@gnu.org>
+2021-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.comm (install_dev, uninstall_dev): Protect `for' loops
- against empty argument. Problem reported by <cgd@broadcom.com>.
+ * tmac/an-old.tmac (an-end): Drop needless .nr % assignment.
+ Call our (wrapped) bp instead of the .pl request directly.
+ (an-bp): Drop needless .br and (aliased) real .bp request.
-2004-03-05 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (an-footer): Refactor complex conditional.
+
+2021-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/an-old_X-register-works.sh: Add test for footer
+ creeping into page content.
+
+2021-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in (SEP): Replaced with...
- (RT_SEP, SH_SEP): Separators for the target platform's native path
- separator and the build environment, respectively.
- (fontpath, tmacpath): Use RT_SEP.
- (MDEFINES): Updated.
+ * tmac/an-old.tmac (initialization): Ignore P and X rendering
+ parameter registers if specified with continuous rendering
+ enabled (the default in the nroff mode used for terminals), and
+ emit diagnostic.
- * doc/Makefile.sub (GROFF_BIN_PATH): Use SH_SEP.
- * src/preproc/eqn/Makefile.sub (neqn): Use SH_SEP.
- * src/roff/nroff/Makefile.sub (nroff): Use SH_SEP.
+2021-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/an-old_X-register-works.sh: Rewrite. Increase test
+ coverage and stop assuming that -rcR=1 and -rX=anything is a
+ supported combination. (Continuous rendering is supposed to
+ suppress the printing of page numbers anyway.)
-2004-03-05 Werner LEMBERG <wl@gnu.org>
+2021-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devlj4/Makefile.sub (LJ4RES): Set to 1200. This helps to
- reduce alignment problems with newer printers which use built-in
- TrueType fonts (instead of the older Intellifonts). The ideal
- solution is to provide a second set of groff metric files, but this
- is extremely time-consuming to produce, given that HP's metric
- files are very rudimentary.
+ * tmac/an-old.tmac (initialization): Refactor handling of P and
+ X rendering parameter register validation in preparation for
+ disabling them in continuous rendering mode, where they don't
+ make any sense.
-2004-03-01 Werner LEMBERG <wl@gnu.org>
+2021-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grolj4/lj4.cpp (main): Fix argument of getopt_long.
- s/operand/argument/ in error message.
+ * tmac/tests/an-old_TH-repairs-ad-damage.sh: Tweak test
+ internals to make troubleshooting easier.
-2004-03-01 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/groff.cpp (main): Don't allow option -o if -Thtml
- is in use.
+ * tmac/an-old.tmac (TH): Relocate some initialization logic to
+ be adjacent to (most of) the rest of it.
-2004-03-01 Antti Kantee <pooka@netbsd.org>
+2021-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/s.tmac (XE): Fix error message.
+ * tmac/an-old.tmac (TH): Remove useless .if. Its condition is
+ always true now in the wake of the fix for Savannah #60609.
-2004-02-27 Jeff Conrad <jeff_conrad@msn.com>
+2021-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/nonposix.h (write, dup, dup2, close) [_MSC_VER]:
- New macros.
+ * tmac/an-old.tmac: Rename many package macros, strings, and
+ registers (and the lone named environment) to be more expressive
+ of their function. "an-footer" is now the proper complement of
+ "an-header" (setting up an environment and calling a
+ user-redefinable trap macro).
+ an-first -> an-is-first-page-of-document
+ an-html -> an-is-output-html
+ an-footer -> an-break-body-text
+ an-p-footer -> an-footer
+ an-set-margin -> an-reset-margin-and-inset-level
+ an-level -> an-inset-level
+ an-tag-sep -> an-tag-separation
+ an-no-space-flag -> an-need-no-space-mode
+ an-break-flag -> an-need-break
+ an-div? -> an-is-in-diversion
+ an-page-string -> an-outer-footer-text
+ an-trap -> an-input-trap
+ an-do-tag -> an-write-paragraph-tag
+ an-1 -> an-env
- * src/roff/groff/pipeline.c: Declare strcasecmp.
- (run_pipeline) [_WIN32]: Use function name variants which don't
- start with `_'.
- Fix stream handling.
+ * tmac/andoc.tmac (reload-doc): ...as above for the exposed
+ parts of the interface.
+ an-footer -> an-break-body-text
+ an-p-footer -> an-footer
-2004-02-27 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/nonposix.h: Fix declaration of `system_shell_name'.
- Declare `spawnvp_wrapper' and macro definitions of spawnvp only
- for platforms which use the native Win32 runtime libraries.
- (FLUSH_INPUT_PIPE) [_UWIN]: Provide non-empty version.
+ * tmac/an-old.tmac: Rearrange alternating font macros to be in
+ alphabetical order (and the order documented in groff_man(7).
- * src/libs/libgroff/quotearg.c (QUOTE_ARG_MALLOC_ERROR,
- QUOTE_ARG_REALLOC_ERROR): Fix string.
+2021-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/html/pre-html.cpp: Remove declaration of
- `spawnvp_wrapper'.
- Don't use __MINGW32__.
- s/DEBUG_FILE/DEBUG_FILE_DIR/.
- (DEBUG_TEXT, DEBUG_NAME, DEBUG_FILE) [DEBUGGING]: New macros.
- (OUTPUT_STREAM, PS_OUTPUT_STREAM, REGION_OUTPUT_STREAM): New macros.
- (char_buffer::run_output_filter) [MAY_FORK_CHILD_PROCESS]: Fix
- calls to `set_redirection' and `WAIT'.
- [MAY_SPAWN_ASYNCHRONOUS_CHILD]: Remove unused variable `i' and `j'.
- Fix calls to `set_redirection' and `save_and_redirect'.
- (char_buffer::do_html, char_buffer::do_image) [DEBUGGING]: Fix calls
- to `set_redirection' and `save_and_redirect'.
- (usage): Fix message.
- (makeTempFiles, main): Use `DEBUG_FILE'.
+ * tmac/an-old.tmac: Refactor alternating font macros. These
+ macros are hard enough to understand without adding gratuitous
+ structural differences to the reader's burden. Make their
+ implementations rigidly parallel. Update comments.
+ (RI, IR, IB, BI, RB, BR): Always define the `an-result` string
+ as empty except for a dummy character '\&' for the sake of
+ compatibility mode.
+ (RI, IR, IB, BI): Defer interpolation of the first argument to
+ the while loop if there are at least two (like the existing RB,
+ BR). This way the style name arguments to the font selection
+ escape sequences in the appendment to `an-result` match the
+ order of the letters in the macro name (useful to make sense of
+ diffs).
+ (RI, IR, IB, BI, RB, BR): Always remove the `an-result` string
+ after interpolating it.
+ (RB, BR): Only do work if there are any arguments.
-2004-02-21 Werner LEMBERG <wl@gnu.org>
+2021-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Apply italic corrections more consistently.
- * src/roff/troff/troff.h (WARN_TOTAL): Fix value.
+ * tmac/an-old.tmac (BI, IB, IR, RI): Apply italic corrections
+ more consistently. Add lengthy comment rationalizing approach.
+ (RI, BI): An italic correction is now applied after the last
+ argument if it is of even parity (i.e., the 2nd, 4th, 6th, ...).
+
+ * tmac/groff_man.7.man.in (Description/Font style macros): Note
+ that italic corrections are applied.
+
+ Fixes <https://savannah.gnu.org/bugs/?53541>.
+
+ Thanks to Bjarni Ingi Gislason for the report and a suggested
+ patch.
+
+2021-05-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Ignore FT register when appropriate.
-2004-02-21 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * tmac/an-old.tmac (initialization): Validate user-specified
+ value of \n[FT]. Continuous rendering ignores FT (page location
+ traps are not used for footers in that mode). Measuring a
+ footer distance from the page top isn't done. A footer distance
+ of over half the page length is unlikely. A footer distance of
+ less than one line height is too. Issue diagnostics in all of
+ these cases.
+
+ * tmac/tests/tmac/tests/\
+ an-old_FT-bad-value-should-not-trash-titles.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+ Fixes <https://savannah.gnu.org/bugs/?60612>.
+
+2021-05-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (TH): Plant the an-footer trap (where we
+ schedule a break in the page text prior to spacing down to the
+ footer) at twice the value of \n[FT], not a hard-coded -1i.
+ This way, the user can't make the an-p-footer trap (planted at
+ \n[FT]) spring before the an-footer trap that should precede it.
+
+ * tmac/groff_man.7.man.in (Options) <-rFT>: Document this.
+
+2021-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK): Add new
+ autoconf macro to check Ghostscript version. Versions 9.00 <= x
+ < 9.54 suffer from a rendering glitch that affects the AT&T
+ troff (and groff) special character \(lh; see
+ <https://bugs.ghostscript.com/show_bug.cgi?id=703187>. Store
+ the result of the check.
+ (GROFF_GHOSTSCRIPT_VERSION_NOTICE): Add new macro to report the
+ problem detected by GROFF_GHOSTSCRIPT_VERSION_CHECK to the user.
+
+ * configure.ac: Call the macros in appropriate places.
+
+ Fixes <https://savannah.gnu.org/bugs/?59531>.
+
+2021-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/andoc.tmac (reload-man): Remove removal of RI macro, made
+ unnecessary by commit 551f138 (15 May).
+
+2021-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_HTML_PROGRAMS, GROFF_PDFDOC_PROGRAMS):
+ Tweak autoconf warning messages when Ghostscript (gs) command
+ missing to be more mutually congruent.
+ (GROFF_URW_FONTS_CHECK): Tweak to note that gs is only run to
+ locate the URW fonts if gs is available.
+
+2021-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tests/an-old_AT-and-UC-footer-saved-and-restored.sh:
+ Tweak to be more helpful when troubleshooting exasperating
+ header/footer problems as in Savannah #60609.
+
+2021-05-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Fix missing page footers when continuously rendering
+ multiple documents. Resolving this uncovered entangled header
+ and footer management bugs with batch processing even when _not_
+ continuously rendering.
+
+ * tmac/an-old.tmac (an-start-new-document): New macro clears
+ header trap so it doesn't get called with stale information.
+ {The TH macro already replants a header trap with every man
+ page if not continuously rendering.} This macro also absorbs
+ the break-page and page number incrementation logic from TH.
+ (TH): Adapt semantics of "an-first" register to mean not "first
+ page rendered" (apparently) but "first page of new document".
+ If we are _not_ on the first page of a new document and the TH
+ macro is called, we must be batch processing: force the previous
+ man page to end (call an-end if continuously rendering, or
+ an-start-new-document if not). After all the header and footer
+ strings have been configured for the man page, call an-header if
+ we're on the first page of the document, not (just) if we're
+ continuously rendering. Zero an-first register at end of macro
+ here unconditionally instead of conditionally in .an-header.
+ (an-header): Drop conditional on continuous rendering.
+
+ When I batch-render our 62 man pages to the terminal, I do note
+ one cosmetic regression: the lj4_font(5) page, when continuously
+ rendered in batch processing, has no space between its header
+ line and first section heading ("Name"). Another cosmetic issue
+ in this scenario is that the footers for every rendered page but
+ the last, which had (wrongly) been absent entirely, are set with
+ no space after them and the header of the next.
+
+ * tmac/tests/an-old_page-footers-present.sh:
+ * tmac/tests/an-old_page-header-has-current-data.sh: Add man
+ page header/footer regression tests.
+ * tmac/tmac.am (tmac_TESTS): Run the tests.
+
+ Fixes <https://savannah.gnu.org/bugs/?60609>.
+
+2021-05-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (initialization): Key the reprocessing guard
+ {like a C language #include guard} on the existence of the TH
+ macro instead of RI. The latter seemed kind of random and TH
+ is even more guaranteed to exist; it is the macro name most
+ characteristic of the man(7) language and the andoc.tmac
+ superstructure relies on it. (TH may have been avoided because
+ of its use with tbl(1); however, neither man(7) nor mdoc(7)
+ support tbl's TH feature, and GNU tbl does not supply its own
+ empty fallback definition as it does for TS and TE. If we ever
+ want TH-like functionality in future man pages, I suggest we
+ pick a new, non-colliding name for it.)
+ (initialization): Relocate load of devtag package; we don't
+ need it before entering compatibility mode. Move assignment of
+ format of an-page-letter register from a "loose declaration"
+ amid macro definitions to within existence test of X register.
+ Stop initializing an-extra[123] strings outside of any macro;
+ they need to be reinitialized at every TH call when batch
+ rendering.
+ (TH): Call DT in a less surprising place.
+ (TH): Initialize all header/footer-related strings before
+ calling header macros, even those not needed for the default
+ header configuration.
+ (TH): Add style warnings for underspecified arguments.
+ (an-ne): Rename register from "an-need", which is pretty
+ confusing in context, to "an-amount", since (1) a (vertical)
+ amount is what it is, and (2) it's only used within this macro.
+ Also due to factor (2), remove the register after using it.
+
+2021-05-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * m4/groff.m4 (GROFF_URW_FONTS): Update configure script check
+ for URW fonts to recognize recent releases of the URW Base 35
+ fonts from Artifex Software. Look for the AR (Arial roman
+ equivalent) font under all of the names recognized by
+ fonts/devpdf/Foundry.in.
+ * m4/groff.m4 (GROFF_URW_FONTS_CHECK): Update wording of notice
+ when URW fonts are not found. Replace dead URL with working
+ one. Try to hedge against the future, but the Web is an
+ ephemeral place, as are the file names Artifex gives to its
+ fonts. Thanks to T. Kurt Bond and Thomas Dupond for reporting
+ and investigating the problem.
+
+ Fixes <https://savannah.gnu.org/bugs/?60604>.
+
+2021-05-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (ms Document Control Settings) <DI>:
+ * doc/ms.ms (Document control settings, Displays and keeps)
+ <DI>:
+ * tmac/groff_ms.7.man (Document control settings, Displays and
+ keeps) <DI>: Document this register; it had been mentioned only
+ in passing.
+
+2021-05-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (ms Document Control Settings) <DD>:
+ * doc/ms.ms (Document control settings) <DD>:
+ * tmac/groff_ms.7.man (Document control settings) <DD>: Fix
+ error; changes to \n[DD] take effect at the next display
+ boundary (including the end of the active one), not the next
+ "paragraph" (paragraph macros cannot be called inside a display
+ anyway).
+
+2021-05-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/andoc.tmac (reload-man): Delete no-op line that attempts
+ to restore compatibility mode. Individual pages have to do
+ this, and ".do cp \n(.C" is not effective for the reason
+ discussed in the 2020-04-16 ChangeLog entry.
+
+2021-05-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/s.tmac (@RT): Delete definition; make it an alias for
+ par@finish. Until commit 021ba0e7 (1 May), they had identical
+ definitions. I find it difficult to imagine what use it would
+ be to have an undocumented reset macro that resets everything
+ _except_ the deeply internal \n[.ev]:ai.
+
+2021-05-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ [man]: Handle HF strings with an embedded font family when
+ applying italic-to-bold-italic remapping; the feature now works
+ on troff devices as well.
+
+ * tmac/an-old.tmac (initialization): Do more validity checking.
+ Store heading family in new string \*[an-heading-family]. Clean
+ up after self.
+ (SH, SS): Include the heading family in the remapping target.
+
+ * tmac/groff_man.7.man.in (Description/Document structure
+ macros) <.SH, .SS>: Document it.
+
+2021-05-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * man/groff_char.7.man (Glyph tables/Mathematical symbols): Fix
+ errors in special character descriptions; \[sqrt] is a "special"
+ glyph (that is, it uses mathematical metrics on typesetter
+ devices), and \[radicalex) is not (and is thus a "text" glyph).
+ See Werner Lemberg's ChangeLog entry of 2003-01-05. Problem
+ dates to 07a6233ad, 27 May 2014.
+
+ The overloaded use of the word "special" really pinches here.
+
+2021-05-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tty.tmac: Replace fallback glyphs for radical extension
+ and square root extension; use \[rn] instead, which works fine.
+
+ Now the only glyph in the page that doesn't render on a UTF-8
+ terminal (if one's font has adequate coverage) is the Bell
+ System logo.
+
+2021-05-07 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tty.char: Add fallback characters for \[fm] and \[sd].
- * src/libs/libgroff/quotearg.c: New file, providing proper argument
- quoting for MSVC's spawn* and exec* functions.
- * src/libs/libgroff/spawnvp.c: New file, providing a wrapper around
- spawnvp with proper quoting for MSVC.
+2021-05-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/assert.cpp (program_name),
- src/libs/libgroff/new.cpp (program_name): Declare as `extern "C"'.
- * src/libs/libgroff/Makefile.sub (OBJS, CSRCS): Updated.
+ [man]: If \*[HF] is a bold style, substitute bold italics for
+ italics in section and subsection headings, keeping the font
+ weight consistent.
- * src/roff/troff/input.cpp (program_name): Declare as `extern "C"'.
+ * tmac/an-old.tmac (initialization): Set a flag for this based
+ on the interpolation of \*[HF] matching "B" as its last
+ character.
+ (SH, SS): Apply and reverse font remapping based on this flag.
- * src/include/error.h (program_name): Declare as `extern "C"'.
- * src/include/nonposix.h [__MSDOS__ ...]: Handle spawnvp.
+2021-05-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-02-21 Jeff Conrad <jeff_conrad@msn.com>
+ * tmac/an-ext.tmac (EX): Work around Savannah #59522 by changing
+ fonts differently on DVI output, avoiding a font warning.
- * src/preproc/html/pre-html.cpp [__CYGWIN__ ...]: Declare
- spawnvp_wrapper.
- [MAY_SPAWN_ASYNCHRONOUS_CHILD]: Declare i and j.
+2021-05-06 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-02-20 Jeff Conrad <jeff_conrad@msn.com>
+ * tmac/an-ext.tmac: If in nroff mode, remap font CBI to BI.
+ * tmac/dvi.tmac: Remap font CBI to CWI. (Computer Modern
+ Constant Width has no bold styles.)
- * src/roff/groff/pipeline.c (cmd) [__MSDOS__ || ...]: New global
- variable.
- (sbasename) [__MSDOS__ || ...]: New function.
- (system_shell_name) [__MSDOS__ || ...]: Use a different, more
- generic algorithm.
- (system_shell_dash_c, is_system_shell) [__MSDOS__ || ...]: Updated.
- (run_pipeline) [_WIN32]: Use _XXX variants for some macros instead
- of XXX.
- Use STDOUT_FILENO instead of hardcoded file handle.
- (signal_catcher) [__MSDOS__]: Moved to non-_WIN32 section.
+2021-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-02-19 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (NL, SM, LG): Issue warning diagnostic if macro
+ called with arguments.
+ (par*define-font-macro): Construct font macro with diagnostic to
+ warn if called with excess arguments.
+ (UL, BX): Issue warning diagnostic if macro called with excess
+ arguments.
- * src/roff/troff/div.cpp: Include nonposix.h after troff.h to
- avoid warnings w.r.t. redefinition of P_tmpdir for some compilers.
+ Fixes <https://savannah.gnu.org/bugs/?60522>.
-2004-02-18 Werner LEMBERG <wl@gnu.org>
+2021-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devlj4/Makefile.sub (DEVFILES): Updated to contain all
- new font and mapping files.
+ * doc/groff.texi: Delete redefinition of \putwordAppendix
+ Texinfo macro. This restores the word "Appendix" to the names
+ of all appendices and fixes two bad internal links to Appendix
+ E, the Register Index, in the DVI and PDF output formats. Per
+ consultation with Texinfo maintainer Gavin Smith, it's difficult
+ to get the behavior we want, so give up trying for now.
-2004-02-18 Jeff Conrad <jeff_conrad@msn.com>
- Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/nonposix.h (FLUSH_INPUT_PIPE): New macro to empty
- an input pipe. This is needed for the MSVC compiler to make troff's
- `-o' option work.
+ * tmac/s.tmac (@MC): Actually diagnose and recover when user
+ tries to .MC inside a diversion.
- * src/roff/troff/div.cpp: Include nonposix.h.
- (cleanup_and_exit): Call FLUSH_INPUT_PIPE.
+2021-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-02-17 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Differences from AT&T ms):
+ * doc/ms.ms (Differences from AT&T ms):
+ * tmac/groff_ms.7.man (Differences from AT&T ms): Document our
+ different default (empty) for the center footer in nroff mode;
+ this behavior appears to date back to June 1991 or earlier,
+ drawing few complaints.
- * font/devlj4/generate/special.awk: New script.
- * font/devlj4/generate/Makefile (S): Use special.awk.
- * font/devlj4/*: Regenerated, including the following new files:
- Arial (AR, AB, AI, ABI), Times New Roman (TNRR, TNRB, TNRI, TNRBI),
- MS Symbol (SYMBOL), Wingdings (WINGDINGS).
- * NEWS: Document new lj4 fonts and revised hpftodit.
+ Fixes <https://savannah.gnu.org/bugs/?59826>.
-2004-02-17 Paco AndrĂ©s VerdĂș <pandres@dragonet.es>
+2021-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grolbp/lbp.h (vmdvarc): Fix formatting string.
+ * tmac/tests/*: Rename files to use consistent scheme; one
+ underscore to separate the package name from the test objective,
+ dashes to otherwise separate words.
+ * tmac/tmac.am (tmac_TESTS): Use new names.
-2004-01-25 Werner LEMBERG <wl@gnu.org>
+2021-05-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/progname.cpp: Replaced with...
- * src/libs/libgroff/progname.c: New file.
- * src/libs/libgroff/Makefile.sub: Updated accordingly.
+ [ms]: Restore support for AT&T ms PN register.
-2004-01-17 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (pg): Make register PN an alias of %.
- * font/devlj4/generate/Makefile (SYMBOL): Use 9nb28703.tfm.
+ * doc/groff.texi (Differences from AT&T ms):
+ * doc/ms.ms (Differences from AT&T ms):
+ * tmac/groff_ms.7.man (Differences from troff ms): We don't need
+ PN, and it was removed in commit 08291b40 (25 October 2020), but
+ since it is documented in Lesk 1978 we're stuck with it. Advise
+ users to stick with %. Also warn them of the hoop they must
+ jump through if they redefine the page trap macro PT, which Lesk
+ 1978 also encourages.
-2004-01-16 Jeff Conrad <jeff_conrad@msn.com>
+ * tmac/tests/s_PN-works.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * font/devlj4/generate/wingdings.map,
- font/devlj4/generate/symbol.map: Include unnamed glyphs.
- Use groff glyph names where possible.
- * src/devices/grolj4/lj4_font.man: Minor updates.
+ Fixes <https://savannah.gnu.org/bugs/?59823>.
-2004-01-13 Werner LEMBERG <wl@gnu.org>
+2021-05-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (DC): Handle TTY devices.
+ [ms]: Restore default IP paragraph indentation after an SH call.
- * doc/webpage.ms: Document viewCVS from ffii.org.
- * NEWS, README: Updated.
+ * tmac/s.tmac (par@finish): Set "ai" register for the current
+ environment to the paragraph indent (PI) setting for the current
+ environment.
- * src/roff/groff/groff.man: Mention lj4_font man page.
+ * doc/groff.texi (Highlighting in ms) <IP>:
+ * doc/ms.ms (Highlighting) <IP>:
+ * tmac/groff_ms.7.man (Usage/Highlighting) <IP>: Update
+ documentation.
- * font/devlj4/generate/Makefile (SYMBOLMAP, WINGDINGSMAP): New
- variables.
- (FONTS): Add SYMBOL and WINGDINGS.
- (SYMBOL, WINGDINGS): New targets.
+ * tmac/tests/s_SH_resets_IP_indentation_amount: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2004-01-13 Jeff Conrad <jeff_conrad@msn.com>
+ Fixes <https://savannah.gnu.org/bugs/?60222>.
- * src/devices/grolj4/lj4_font.man: New man page.
- * src/devices/grolj4/Makefile.sub (MAN5): New variable.
- * src/devices/grolj4.man: Mention lj4_font man page.
+2021-05-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/hpftodit/hpftodit.cpp (read_map): Handle line comments.
- * src/utils/hpftodit/hpftodit.man: Document it.
- (CW): New macro.
- Remove details about fonts (which are now in lj4_font.man).
+ * tmac/s.tmac (DS): Issue diagnostic and attempt recovery if
+ document attempts to start a display within another display.
- * font/devlj4/generate/symbol.map,
- font/devlj4/generate/wingdings.map: New files.
+ Fixes <https://savannah.gnu.org/bugs/?55136>.
-2004-01-12 Werner LEMBERG <wl@gnu.org>
+2021-04-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * README: Mention ffii's viewcvs access.
+ * tmac/s.tmac: Implement alternative rendering for automatic
+ footnote numbers in nroff mode, inspired by Heirloom Doctools
+ ms; since superscripting is not universally available on
+ terminals, surround number with square brackets instead.
+ (fn@init): New macro finishes initializing footnote module,
+ setting up aliases to par@sup-{start,end} strings in troff mode
+ and otherwise defining fn@sup-{start,end} as brackets. Define *
+ string here, using new strings.
+ (par): Call fn@init after par@sup-{start,end} are defined, and
+ prior to other footnote integration material.
+ (par*fp!0): Migrate from par@sup-{start,end} to
+ fn@sup-{start,end}.
-2004-01-09 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (ms Document Control Settings) <FF>:
+ * doc/ms.ms (Footnotes) <FF>:
+ * tmac/groff_ms.7.man (Usage/Footnotes) <FF>: Document it.
- * font/devlj4/generate/special.map: Map MSL 228 to U+221F.
+ Fixes <https://savannah.gnu.org/bugs/?60228>.
-2004-01-09 Jeff Conrad <jeff_conrad@msn.com>
+2021-04-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- Revert most of the change from 2004-01-03 to better control used
- symbol sets.
+ * test-groff.in: Stop passing the built groff executable -b and
+ -ww options by default. This reverses a change from 2017. Dave
+ Kemper has convincingly argued that there's no way to override
+ -b and turn backtraces on warnings/errors back off, and that the
+ built groff should behave as much like a "normal" one as
+ possible. The latter factor is of added importance now that we
+ are using test-groff for generation of documents.
- * src/utils/hpftodit/hpftodit.cpp (symbol_set): New structure.
- (text_symbol_sets, special_symbol_sets): New arrays.
- (symbol_set_table): New global variable.
- (read_symbol_sets): Use search order given in the text_symbol_sets
- and special_symbol_sets arrays. If command line flag -a is not
- given, search both arrays.
- (output_charset): Require x_height_tag only for command line flag -i.
+ * src/roff/groff/tests/regression_savannah_58153.sh: Adapt.
-2004-01-06 Werner LEMBERG <wl@gnu.org>
+2021-04-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- Implement string-valued registers \n[.m] and \n[.M] to return the
- name of the current drawing and background color, respectively.
+ * tmac/s.tmac (BX): Add alternative implementation for terminal
+ {nroff} devices. Store width of boxed text, adding .4m only on
+ troff devices (to make room for the vertical box lines). Break
+ long input line in troff implementation. If not in troff mode,
+ use ISO 6429 color escapes to render boxed text in black on
+ white. Use the \Z escape to match breaking semantics of macro
+ in troff mode.
- * src/roff/troff/symbol.h: Moved to...
- * src/include/symbol.h: Here.
- Small fixes to make it work outside of the `troff' directory.
- * src/roff/troff/symbol.cpp: Moved to...
- * src/libs/libgroff/symbol.cpp: Here.
- Small fixes to make it work outside of the `troff' directory.
+ * doc/groff.texi (Highlighting in ms) <BX>:
+ * doc/ms.ms (Highlighting) <BX>:
+ * tmac/groff_ms.7.man (Usage/Highlighting) <BX>: Document it.
- * src/include/Makefile.sub (HDRS), src/libs/libgroff/Makefile.sub
- (OBJS, CCSRCS), src/roff/troff/Makefile.sub (OBJS, CCSRCS, HDRS):
- Updated.
+ Fixes <https://savannah.gnu.org/bugs/?60477>.
- * src/include/color.h: Include symbol.h.
- (color): Add new field `nm'.
- * src/libs/libgroff/color.cpp (color::color): Updated.
+2021-04-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/dictionary.cpp, src/roff/troff/div.cpp,
- src/roff/troff/node.cpp, src/roff/troff/number.cpp,
- src/roff/troff/reg.cpp: Don't include symbol.h.
+ * doc/doc.am: Make $(PROCESSEDDOCFILES) depend on all the same
+ targets as $(PROCESSEDEXAMPLEFILES); this way the me, ms, and
+ pic.ms manuals are all regenerated upon changes to their
+ underlying macro packages.
- * src/roff/troff/env.cpp: Don't include symbol.h.
- (environment::get_glyph_color_string,
- environment_get_fill_color_string): New member functions.
- (init_env_requests): Handle `.m' and `.M' registers.
- * src/roff/troff/input.cpp: Don't include symbol.h.
- (default_symbol): Moved to symbol.cpp/symbol.h.
- (do_glyph_color, do_fill_color, define_color): Pass symbol name
- to color constructor.
- * src/roff/troff/env.h: Updated.
+2021-04-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo:
- Document new registers.
+ * INSTALL.extra: Update.
+ (Evaluation): New section updates material on "test-groff"
+ script. Also tell people how to preview our Texinfo manual (in
+ info, text, DVI, PDF, and HTML formats).
+ (In Case of Trouble): New section updates bug reporting URL.
-2004-01-05 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?57863>.
- * src/roff/troff/node.cpp (space_node::get_breakpoints,
- space_node::nbreaks): Protect against zero `next' field.
+2021-04-21 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-01-03 Jeff Conrad <jeff_conrad@msn.com>
+ * tmac/s.tmac: Make the FAM string work more sensibly; it now
+ applies to headers, footers, and footnotes only if set
+ before the first call of a sectioning, paragraphing, or
+ {non-date} document description macro.
+ (PT, BT): Set the font family to that saved for titles.
+ (fn*do-FS): Set the font family to that saved for footnotes.
+ (par@init): Copy the document font family to independent strings
+ for titles and footnotes.
+ (par@reset): If in a footnote environment, set the font family
+ to that saved for footnotes; otherwise use \*[FAM].
+
+ * tmac/groff_ms.7.man (Differences from troff ms/Text settings):
+ Describe placement-dependent effect of FAM string setting.
+
+ * doc/groff.texi (Highlighting in ms):
+ * doc/ms.ms (Highlighting): As above, and suggest different
+ occasions in which ".ds FAM C" and "CW" are convenient.
- In hpftodit, use the symbol sets offered in the TFM.
+ Fixes <https://savannah.gnu.org/bugs/?60422>.
- * src/utils/hpftodit/hpftodit.cpp (NO_GLYPH): New constant.
- (symbol_set, text_symbol_sets, special_symbol_sets,
- symbol_set_table): Removed.
- (get_printcode): Removed.
- (read_symbol_sets): Initialize `symbol_set' field with
- `NO_SYMBOL_SET'.
- Simplify code to just use the `kind' value.
- (output_charset): Improve output formatting.
- (dump_symbols): Simplified.
+2021-04-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-01-02 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/input.cpp (source, source_quietly)
+ (macro_source, macro_source_quietly): Use idiomatic Boolean
+ literals.
- * font/devlj4/generate/text.map: Add more MSL numbers.
+2021-04-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2004-01-02 Jeff Conrad <jeff_conrad@msn.com>
+ * doc/groff.texi: Drop workarounds for Texinfo pre-5.0 versions;
+ our local macros produced many warnings during generation of our
+ Texinfo manual.
+ (Langlemacro):
+ (Ranglemacro):
+ (Lparenmacro):
+ (Rparenmacro):
+ (Lbrackmacro):
+ (Rbrackmacro): Delete. Replace call sites with literals.
+ (Lbracemacro):
+ (Rbracemacro): Delete. Replace call sites with @lbracechar{}
+ and @rbracechar{}.
+ (angles): Reimplement in terms of @guilsinglleft{} and
+ @guilsinglright{}. Flesh out comment.
- * src/utils/hpftodit/hpftodit.cpp (is_decomposed): New macro.
- (text_symbol_sets): Add more symbol sets.
- (debug_flag): New static variable (moved from `main').
- (get_printcode, show_symset): New functions.
- (main): Remove `debug_flag'.
- (output_charset): Use `show_symset'.
- (dump_symbols): Use `show_symset'.
- Print symsets for all glyphs.
- (read_map): Actually call `unicode_to_ucode_make' but this time
- correctly.
+ Fixes remainder of <https://savannah.gnu.org/bugs/?59524>.
-2004-01-01 Werner LEMBERG <wl@gnu.org>
+2021-04-17 Dave Kemper <saint.snit@gmail.com>
- * font/devlj4/generate/text.map, font/devlj4/generate/special.map:
- Fix placement of comments.
+ * doc/meintro.me:
+ * doc/meref.me: Correct and make consistent usage of the term
+ "point size".
-2004-01-01 Jeff Conrad <jeff_conrad@msn.com>
+ Fixes <https://savannah.gnu.org/bugs/?60403>.
- * src/utils/hpftodit/hpftodit.cpp (main): Read map file also if
- option `-d' is given.
- (output_charset): Improve warning messages to give more information.
- (dump_symbols): Make information more precise.
- (usage): Updated.
- (read_map): Don't call unicode_to_ucode_name; the glyph names must
- appear as-is and shouldn't be decomposed.
+2021-04-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-31 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-old.tmac (SS): Add devtags support. Set a subsection
+ title as a second-level heading and add it to a table of
+ contents, if any. Prompted by a query from Hans Unzner to the
+ groff mailing list. Thanks, Hans!
- * src/utils/hpftodit/hpftodit.cpp (dump_tags): Handle posture_tag.
- * font/devlj4/generate/Makefile (IFLAG): Updated to new units.
- (FONTS): Add TrueType font families Arial and Times New Roman.
- (TNRR, TNRB, TNRI, TNRBI, AR, AB, AI, ABI): New targets.
- * font/devlj4/generate/text.map: Fix Unicode values of `fi' and
- `fl'.
+2021-04-17 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-31 Jeff Conrad <jeff_conrad@msn.com>
+ * tmac/an-old.tmac (SH): Fix apparent thinko. Pass the devtags
+ macro a literal "1" argument. Passing it \n[an-level] wasn't
+ correct (it stores the relative inset level, not a sectioning
+ level), and was useless anyway: SH has already called
+ .an-set-margin by this point, which resets \n[an-level] to 1.
+ man(7) does not support nesting of SH macros. Also call
+ .DEVTAG-NH by its alias .DEVTAG-SH since section headings are
+ not numbered in man(7).
- * test-groff.in (SEP): Quote value.
- * src/roff/troff/node.cpp (suppress_node::tprint): Change type of
- `tem' to `char*' to avoid deallocation of a pointer to a constant
- object which some compilers don't like.
-
-2003-12-31 Werner LEMBERG <wl@gnu.org>
-
- * font/devlj4/generate (text.map, special.map): Rewritten to work
- with the new hpftodit version.
+2021-04-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-30 Jeff Conrad <jeff_conrad@msn.com>
+ [tmac]: Adjust editor file encoding hints.
- * src/utils/hpftodit/hpftodit.cpp (output_charset): Emit HP symbol
- set and 8bit character code for all glyphs also.
+ * tmac/cs.tmac: Tell Vim the file is "iso-8859-2" (ISO Latin-2).
+ * tmac/en.tmac: Stop telling Emacs the file is "latin-1"; it's
+ ASCII.
+ * tmac/fr.tmac: Tell Vim file is "iso-8859-15" (ISO Latin-9).
-2003-12-30 Werner LEMBERG <wl@gnu.org>
+ Vim users may need to use ":e ++enc=iso-8859-2", for instance,
+ to see correct glyphs.
- * src/libs/libgroff/strcasecmp.c: Updated from gnulib.
+2021-04-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-29 Werner LEMBERG <wl@gnu.org>
+ The first-order determinant of hyphenation points is language,
+ not territory. Use ISO 639 2-letter language codes for
+ hyphenation and exception patterns instead of ISO 3166 2-letter
+ territory codes.
- More fixes for MSVC compiler.
+ * tmac/*.us: Rename *.us files to *.en.
+ * tmac/troffrc: Change hyphenation language "us" to "en".
+ * tmac/en.tmac: Add English localization file. Set hyphenation
+ mode to 4.
+ * tmac/troffrc: Derive groff locale from system.
- * doc/Makefile.sub (GROFF_BIN_PATH): Use $(SEP).
+ * doc/groff.texi (Manipulating Hyphenation):
+ * man/groff.7.man (Hyphenation):
+ * man/groff_diff.7.man (Implementation differences): Refer to
+ "U.S. English" hyphenation patterns as simply "English"; they
+ will be mostly correct for Commonwealth English as well, and no
+ alternative English hyphenation patterns for other territories
+ are available.
- * src/include/nonposix.h (STDIN_FILENO, STDOUT_FILENO,
- STDERR_FILENO) [_MSC_VER]: Define conditionally.
- (getpid) [_MSC_VER]: Remove.
- Include direct.h and process.h conditionally.
+ * doc/groff.texi (Manipulating Hyphenation):
+ * man/groff_diff.7.man (New requests): Note that default
+ hyphenation mode depends on the language used on the system.
+ Add concept index entry for localization. Add file index
+ entries for the locale macro files (cs.tmac, etc.). Update to
+ reflect rename of English hyphenation patterns and .hla
+ identifier from "us" to "en".
- * src/roff/troff/node.cpp (suppress_node::tprint): Don't use
- parentheses for a_delete.
+ * src/roff/groff/tests/localization_works.sh: Add 10 test cases.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * src/utils/lookbib/lookbib.cpp: Include nonposix.h.
+ * tmac/LOCALIZATION: Rewrite.
- * test-groff: Replaced with...
- * test-groff.in: This new template to handle path separator
- properly.
+ Fixes <https://savannah.gnu.org/bugs/?59814>.
- * configure.ac: Check for direct.h and process.h.
- Generate test-groff script.
- * configure, src/include/config.hin: Regenerated.
+2021-04-12 Dave Kemper <saint.snit@gmail.com>
+
+ * doc/meref.me: Correct various small issues.
+
+ Fixes <https://savannah.gnu.org/bugs/?60379>.
+
+2021-04-12 Dave Kemper <saint.snit@gmail.com>
+
+ * man/groff.7.man (Registers/Writable registers) <year, yr>:
+ Drop discussion of Y2K issues.
+
+ Fixes <https://savannah.gnu.org/bugs/?60372>.
+
+2021-04-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Setting Registers) <rnn>: Fix error: the
+ request is not ignored if the second argument (the new name)
+ does not exist. Problem dates back to 52a6d12a (11 May 2000).
-2003-12-28 Werner LEMBERG <wl@gnu.org>
+2021-04-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add integral extension glyph.
- Add new option `-x' to afmtodit to suppress use of built-in AGL.
+ Implement new .soquiet and .msoquiet requests.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `u23AE'.
+ Needed for two planned developments: {1} the i18n patch in
+ Savannah #59814 can use this to quietly attempt to open a
+ localization file. groff only supports a few locales, so people
+ with LANG=es_ES, for instance, would ordinarily see warning
+ diagnostics on every groff startup; and {2} system- or
+ site-configurable support of per-user {.,}troffrc or man.local
+ files, gracefully failing if they don't exist.
- * font/devps/generate/textmap: Provide entry for `integralex' to
- override (old) PUA value of the AGL.
- * font/devps/generate/Makefile (SS): Add afmtodit option `-x'.
- * font/devps/*: Regenerated.
+ * src/roff/troff/input.cpp:
+ (do_source): Add new function, taking boolean "quietly"
+ parameter and absorbing function of source(), with added
+ conditional.
+ (source): Convert into a wrapper to call do_source() unquietly.
+ (source_quietly): Wrap do_source(), quietly.
+ (do_macro_source, macro_source, macro_source_quietly): Analogous
+ to the foregoing.
+ (init_requests): Hook "msoquiet" to macro_source_quietly() and
+ "soquiet" to "source_quietly().
+
+ * doc/groff.texi (I/O):
+ * man/groff.7.man (Requests/Request short reference):
+ * man/groff_diff.7.man (Language/New requests): Document them.
- * src/utils/afmtodit/afmtodit.pl: Add option `-x'.
- * src/utils/afmtodit/afmtodit.man, NEWS: Updated.
+ * src/roff/groff/tests/msoquiet_works.sh:
+ * src/roff/groff/tests/soquiet_works.sh: Test them.
-2003-12-27 Werner LEMBERG <wl@gnu.org>
+ * src/roff/groff/groff.am (groff_TESTS): Add tests.
- Add forgotten `coproduct' symbol (already available for DVI).
+ Fixes <https://savannah.gnu.org/bugs/?59973>.
- * font/devhtml/R.proto, font/devps/generate/textmap,
- font/devps/symbolmap, font/devutf8/R.proto, man/groff_char.man,
- src/libs/libgroff/uniglyph.cc, src/libs/libgroff/glyphuni.cpp: Add
- U+2210 (\[coproduct]).
+2021-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-26 Jeff Conrad <jeff_conrad@msn.com>
+ * doc/groff.texi (ms Document Control Settings) <FF>: Update
+ description to cover application of footnote format to footnote
+ markers in general, not just numbers. Clarify different
+ behavior of format 1 with respect to automatic numbers and other
+ markers.
+ (ms Footnotes) <*>: Describe string operation in more detail.
+ <FS>: Describe more precisely how the optional argument is
+ handled.
- hpftodit has been extended to handle TrueType metric files and
- more glyphs. See hpftodit.man for more details.
+ * doc/ms.ms (Footnotes): Synchronize with doc/groff.texi. Add
+ example using document's own text as a model.
- * src/utils/hpftodit/hpftodit.cpp: Include stdio.h, string.h,
- ctype.h, and unicode.h.
- s/msl/charcode/ everywhere since we now handle Unicode values also.
- (equal, NO, YES, MSL, SYMSET, UNICODE, UNICODE): New macros.
- Use it where appropriate.
- (MULTIPLIER): Replaced with...
- (multiplier): New global static variable.
- (scale): Updated.
- (tag_type): Add more TFM tags.
- (tag_name): New array.
- (ENUM_TYPE, FLOAT_TYPE): Removed.
- (BYTE_TYPE): New value assigned.
- (ASCII_TYPE, RATIONAL_TYPE): New enumeration values.
- (text_symbol_sets, special_symbol_sets): Extended to cover more
- sets.
- (check_type): Add return value.
- (check_units): Add parameters to get ppi and upem values.
- Handle TrueType TFM data.
- (output_font_name): New function.
- (output_charset): Add parameter to handle TFM type.
- Handle TrueType TFMs also.
- (em_fract): New macro.
- (dump_tags): Be much more verbose and handle more tags.
- (dump_ascii, dump_symbol_sets, dump_symbols): New functions.
- (hp_msl_to_ucode_name, unicode_to_ucode_name, is_uname): New
- functions.
- (read_map): Add parameter to handle TFM type.
- Handle both MSL and Unicode mappings.
- (main): Add two new command line options `-a' and `-q'.
- Updated to make use of new functions.
- (usage): Updated.
+ * tmac/groff_ms.7.man (Usage/Footnotes): Resync relevant
+ portions with doc/ms.ms.
- * src/utils/hpftodit/hpuni.cpp: New file.
+ Fixes <https://savannah.gnu.org/bugs/?60227>.
- * src/utils/hpftodit/Makefile.sub, src/utils/hpftodit/hpftodit.man:
- Updated.
+2021-04-06 Dave Kemper <saint.snit@gmail.com>
-2003-12-25 Werner LEMBERG <wl@gnu.org>
+ * src/roff/nroff/nroff.sh: Recognize -k and -K options and pass
+ them through to troff. Document them in usage message.
+ * src/roff/nroff/nroff.1.man: Document new -k and -K options.
- * src/include/nonposix.h (read) [_MSC_VER]: Define.
+ Fixes <https://savannah.gnu.org/bugs/?60349>.
-2003-12-24 Werner LEMBERG <wl@gnu.org>
+2021-04-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit/afmtodit.man: Some reformulations as suggested
- by Michail Vidiassov <master@iaas.msu.ru>.
+ * doc/groff.texi (Manipulating Hyphenation):
+ Recast introductory paragraph to better distinguish the
+ automatic breaking of words and placement of hyphens at
+ user-specified hyphenation points (done with the \% escape) and
+ automatic determination of hyphenation points within words (what
+ the pattern files and most of the hyphenation mode parameters
+ are for). Clarify that what our manual calls "automatic
+ hyphenation" pertains only to the latter.
+ <hw> Correct over-general claim; hyphenation exceptions defined
+ with the .hw request _do_ honor .hy value 2 (don't break a word
+ at the bottom of a page), but none of the others.
+ <\%> Recast description of escape to emphasize independence of
+ its two uses (e.g., "\%pseudo\%unununium" is hyphenated only
+ after "pseudo-", if at all).
+ <\:> Clarify that escape is an input word boundary.
+ <shc> Clarify that the soft hyphen glyph is applied to manual as
+ well as automatically-determined hyphenation points.
+ <hy> Recharacterize as setting the _automatic_ hyphenation mode.
+ Note that restrictions apart from value 2 are not applied to
+ words with manually-assigned hyphenation points.
+ <nh> Note that request affects only automatic hyphenation.
-2003-12-20 Werner LEMBERG <wl@gnu.org>
+ * man/groff.7.man (Requests/Request short reference) <.hy,.nh>:
+ Clarify that requests deal with _automatic_ hyphenation.
+ (Registers/Read-only registers) <.hy>:
+ Clarify that register applies to _automatic_ hyphenation.
+ (Hyphenation): Add new introductory paragraph summarizing manual
+ hyphenation support and features, including notice that breaking
+ at explicit hyphens is performed in fill mode, i.e., even if
+ _automatic_ hyphenation is disabled.
- * font/devhtml/R.proto: Add u00{47,67}_0306, u00{53,73}_0327,
- and u0049_0307.
- Add missing latin-2 glyphs.
- * font/devutf8/R.proto: Add missing latin-2 glyphs.
+ Thanks to Peter Schaffter for the report.
- * tmac/troffrc: Load `composite.tmac' earlier.
+ Fixes <https://savannah.gnu.org/bugs/?60332>.
+
+2021-03-27 Deri James <deri@chuzzlewit.myzen.co.uk>
- * tmac/dvi.tmac, tmac/ps.tmac, tmac/lbp.tmac: Add u00{47,67}_0306,
- u00{53,73}_0327, and u0049_0307.
- * tmac/X.tmac: Add u00{47,67}_0306.
- * tmac/tty-char.tmac: Use composite glyph names for readability.
+ Changes to the ghostscript fontnames (9.53.3).
+
+ * font/devpdf/Foundry.in: HI and HBI switch to using
+ Italic rather than Oblique.
+
+2021-03-24 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Manipulating Filling and Adjustment):
+ * man/groff_diff.7.man (Language/Extended requests): Fix
+ incorrect claim that additional inter-sentence space is applied
+ only in fill mode. Drop word "parameter" from description of
+ unit used in .ss request arguments; it is a needlessly specific
+ reference to the font file format. Tighten wording.
- * NEWS: Updated.
+ * man/groff.7.man (Control Characters): Fix incorrect claim that
+ end-of-sentence detection is attempted only in fill mode. Note
+ that .ss request also affects inter-word spacing.
- * src/include/unicode.h: Remove `extern' keywords.
+ * man/groff_diff.7.man (Language/Extended requests):
+ - Drop example.
+ - Move discussion of AT&T vs. GNU troff difference in .ss
+ handling from here...
+ (Implementation Differences): ...to here.
-2003-12-20 NilgĂŒn Belma BugĂŒner <nilgun@superonline.com>
+ Thanks to Dave Kemper for his continued scrutiny!
- * tmac/latin5.tmac: New file.
+2021-03-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-19 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (ms Cover Page Macros):
+ * doc/ms.ms (Cover page macros):
+ * tmac/groff_ms.7.man (Usage/Cover page macros): Revise and
+ rename (sub)sections to "Document description macros".
- Add some glyphs needed for Turkish.
+2021-03-15 Dave Kemper <saint.snit@gmail.com>
- * font/devutf8/R.proto: Add u00{47,67}_0306, u00{53,73}_0327,
- and u0049_0307.
+ * Makefile.am: Fix typos. Thanks to Bjarni Ingi Gislason for
+ the report.
- * tmac/composite.tmac: Add `,' as a synonym for `ac' accent.
- * tmac/tty-char.tmac: Add representations for u00{47,67}_0306,
- u00{53,73}_0327, and u0049_0307.
+ Fixes <https://savannah.gnu.org/bugs/?59457>.
-2003-12-18 Werner LEMBERG <wl@gnu.org>
+2021-03-14 Dave Kemper <saint.snit@gmail.com>
- * src/devices/grops/ps.cc (ps_output::put_float): Revert change
- from 2001-10-04.
- Remove trailing zeros.
+ * man/groff_tmac.5.man: Correct erroneous reference to PSPIC
+ where PDFPIC was intended. Fix numerous smaller style and
+ content problems.
-2003-12-17 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?60229>.
- Make \? transparent to end-of-sentence recognition.
+2021-03-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cc (non_interpreted_node): Add
- `ends_sentence' member function.
+ * doc/groff.texi (Optional man extensions) <CW, EX, PN, Pn>:
+ (Highlighting in ms) <CW>:
+ (Additional ms macros) <CW>: Use "monospaced" to refer to font
+ selected, retaining "constant-width" term only where it explains
+ the macro mnemonic. Thanks to Dave Kemper for pointing out the
+ issue. Also fix error: .CW in the ms package seems to have
+ originated with Research Unix, not Berkeley.
-2003-12-16 Werner LEMBERG <wl@gnu.org>
+ * doc/ms.ms (Highlighting) <CW>: Sync with our Texinfo manual.
+ * tmac/groff_ms.7.man: Sync with ms.ms, omitting FAM advice.
- * doc/groff.texinfo: Document `dt' request correctly.
- Other minor typographical improvements.
+ Fixes <https://savannah.gnu.org/bugs/?60037>.
-2003-12-10 Michail Vidiassov <master@iaas.msu.ru>
+2021-03-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit/Makefile.sub (afmtodit): Fix typo.
+ * doc/groff.texi (Identifiers, Strings, Writing Macros)
+ (Diversions): Improve cross-linkage of documentation regarding
+ shared name space of macros, strings, diversions, and boxes.
-2003-12-10 Richard Stallman <rms@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?58995>.
- * LICENSE: Better wording.
+2021-03-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-09 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac: Improve diagnostic messages.
+ (@diag): New macro wraps .tm request, always prefixing it with
+ the name of the macro package, as well as file and line
+ indicators only if these are set to non-empty or non-zero
+ values, respectively.
+ (@error, @warning): Call @diag instead of .tm directly.
+ (@fatal): Retire; it had only one call site and it would have
+ greatly complicated @diag to support calling .ab instead of .tm.
+ An ugly alternative would have been to call .ab with a redundant
+ message after calling @diag.
+ (@divert): New macro wraps .di request, remembering the name of
+ the current file (\n[.F]) when a diversion is started.
+ (@error-recover): Call .ab instead of (deleted) @fatal.
+ (pg@super-eject): Tell user what the last file name seen was
+ when recovering from an unfinished diversion when processing
+ ends.
- * aclocal.m4 (GROFF_BROKEN_SPOOLER_FLAGS): Set default value to 0.
- * configure, NEWS: Updated.
+ Fixes <https://savannah.gnu.org/bugs/?55099>.
-2003-12-08 Werner LEMBERG <wl@gnu.org>
+2021-02-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * FDL: Updated to version 1.2 (from www.gnu.org/copyleft).
+ Fix bug where having line numbering off but the output line
+ number register \n[ln] set to a positive value would cause
+ tbl(1) table rows to spontaneously become numbered. Use new
+ \n[.nm] register to determine whether line numbering is enabled.
-2003-12-07 Bernd Warken <bwarken@mayn.de>
+ * src/preproc/tbl/table.cpp (table::init_output, table::do_row)
+ (table::do_bottom): Predicate all conditions on \n[ln]
+ additionally on \n[.nm].
- * LICENSE: Updated.
+ Thanks to Olle Lögdahl for the report. Problem appears to date
+ back to commit b69062693d3360efce9d4d63fac337be21e07db7, 20 July
+ 2011.
-2003-12-07 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?59812>.
- * INSTALL: Improved.
+2021-02-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-05 Keith Marshall <keith.d.marshall@ntlworld.com>
+ Add regression test for Savannah #59812.
- Use path separator character of target platform for compiled-in
- default paths.
+ * src/preproc/tbl/tests/cooperate-with-nm-request.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TEST): Run test.
- * aclocal.m4 (GROFF_TARGET_PATH_SEPARATOR): New macro.
- * configure.ac: Use GROFF_TARGET_PATH_SEPARATOR.
- * configure: Regenerated.
- * Makefile.in (SEP): Use GROFF_PATH_SEPARATOR.
+2021-02-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-05 Werner LEMBERG <wl@gnu.org>
+ Implement new read-only register ".nm". It reports the
+ enablement status of output line numbering (caused by the .nm
+ request) irrespective of the temporary suspension of numbering
+ with the .nn request. Needed because there was no way to
+ introspect its state, tbl(1) needs to do so, and the writable
+ line number register \n[ln] is not a reliable proxy for it.
- * src/include/nonposix.h (PATH_SEP_CHAR): New definition.
- Replace `PATH_SEP[0]' with `PATH_SEP_CHAR' everywhere.
+ * src/roff/troff/env.h: Add get_numbering_nodes(), returning
+ `int`, to public interface of `environment` class.
+ * src/roff/troff/env.cpp: Implement get_numbering_nodes().
-2003-12-04 Bernd Warken <bwarken@mayn.de>
+ * src/roff/groff/tests/dot-nm_register_works.sh: Test it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * LICENSE: New file.
+ * doc/groff.texi (Miscellaneous):
+ * man/groff_diff.7.man (Language/New number registers):
+ * man/groff.7.man (Registers/Read-only registers): Document it.
-2003-12-03 Werner LEMBERG <wl@gnu.org>
+ * NEWS: Add item.
- * src/utils/afmtodit/afmtodit.pl: Comment out code which handles
- ligatures present in AFM files since groff currently only
- understands some standard ligatures and nothing else.
+2021-02-23 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-12-03 Jeff Conrad <jeff_conrad@msn.com>
+ * tmac/s.tmac: Emit warning diagnostic when using a multi-page
+ table with a repeating header (".TS H").
+ (KS): Rename diversion from "kp*div" to "kp@div" since the name
+ is now referenced outside the keep module.
+ (KF): ...similarly for kp@fdiv.
+ (generally): Update diversion dereference sites and derived
+ names.
+ (@TS): When handling "H" argument, check identity of current
+ diversion and emit appropriately worded warning.
- * src/roff/groff/groff.cpp (main): Don't run the spooler if
- option -v is given.
+2021-02-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/groff/pipeline.c (run_pipeline) [_WIN32]: Fix error
- messages.
- Close stdout copy.
- Don't use Unix wait flags.
+ * FOR-RELEASE: Add more procedures and information related to
+ incrementing groff's version number.
-2003-12-02 Werner LEMBERG <wl@gnu.org>
+2021-02-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/glyphuni.cpp, src/roff/troff/unicode.cpp,
- src/roff/troff/unicode.h, src/roff/troff/uniglyph.cpp,
- src/roff/troff/uniuni.cpp: Moved to...
- * src/libs/libgroff/glyphuni.cpp, src/libs/libgroff/unicode.cpp,
- src/libs/libgroff/unicode.h, src/libs/libgroff/uniglyph.cpp,
- src/libs/libgroff/uniuni.cpp: Here.
+ * src/libs/libgroff/searchpath.cpp (search_path::open_file)
+ (search_path::open_file_cautious): Save errno before calling
+ free() and restore it afterwards. A future version of POSIX
+ will require that free() not change errno if it succeeds[1];
+ some C library implementations, including recent versions of
+ glibc[2], lack this property. free() is called in these
+ libgroff functions to clean up after an unsuccessful fopen() of
+ a heap-allocated file name string, and because the errno from
+ fopen() may be passed to strerror() in a diagnostic message, it
+ needs to be accurate. I checked the rest of groff's codebase
+ and found no other instances of free() being used to clean up
+ after fopen() failure.
- * src/include/Makefile.sub.old (HDRS),
- src/libs/libgroff/Makefile.sub (OBJS, CCSRCS),
- src/roff/troff/Makefile.sub (HDRS, PBJS, CCSRCS): Updated.
+ [1] https://www.austingroupbugs.net/view.php?id=385
+ [2] https://sourceware.org/bugzilla/attachment.cgi?id=13073
-2003-12-01 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-02-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/htlp/pre-html.cpp (__tmpfile): Renamed to
- `DEBUG_FILE'.
- Updated all users.
+ Address build failure on macOS.
-2003-12-01 Werner LEMBERG <wl@gnu.org>
+ Follow the advice of the gnulib manual ("Changing your source
+ for use with gnulib") more scrupulously; include config.h in
+ more files.
- * groff.texinfo: Document special behaviour of `.vs 0'.
- Improve documentation of `cflags' request.
- * NEWS: Updated.
+ * src/libs/libgroff/curtime.cpp [HAVE_CONFIG_H]:
+ * src/libs/libgroff/device.cpp [HAVE_CONFIG_H]:
+ * src/libs/libgroff/fatal.cpp [HAVE_CONFIG_H]:
+ * src/libs/libgroff/string.cpp [HAVE_CONFIG_H]:
+ * src/libs/libgroff/strsave.cpp [HAVE_CONFIG_H]:
+ * src/preproc/eqn/other.cpp [HAVE_CONFIG_H]:
+ * src/preproc/eqn/text.cpp [HAVE_CONFIG_H]:
+ * src/preproc/pic/object.cpp [HAVE_CONFIG_H]: Do it.
-2003-11-29 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/assert.cpp [HAVE_CONFIG_H]:
+ * src/libs/libgroff/errarg.cpp [HAVE_CONFIG_H]:
+ * src/libs/libgroff/error.cpp [HAVE_CONFIG_H]: #include
+ config.h using angle brackets instead of quotation marks.
- * font/devlj4/generate/Makefile (CORONET): Use correct TFM.
- * font/devlj4/CORONET: Regenerated.
+ Fixes <https://savannah.gnu.org/bugs/?60035>.
-2003-11-24 Werner LEMBERG <wl@gnu.org>
+2021-02-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/env.cpp (hyphen_trie::read_patterns_file): Fix loop
- if processing hyphenation patterns in traditional mode.
- Improve error messages.
+ Add regression test for Savannah #60025.
-2003-11-20 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/doc_Mt-works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * src/roff/troff/node.cpp (troff_output_file::put_char_width,
- troff_output_file::put_char): Fix type of local variable `c'.
+2021-02-11 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-11-19 Werner LEMBERG <wl@gnu.org>
+ [ms]: Demote definition of \[yogh] special character escape from
+ unconditional availability to be defined only if the output
+ device defines it or if .AM macro is called to enable support
+ for Berkeley-style accent marks.
- * src/roff/groff/pipeline.c (P): Removed. Updated all function
- declarations.
- (i_to_a): Removed. libgroff already provides this function.
- (run_pipeline) [_WIN32]: Don't use itoa but i_to_a.
+ See
+ https://lists.gnu.org/archive/html/groff/2021-01/msg00000.html
+ and follow-ups for discussion.
-2003-11-18 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * tmac/s.tmac (initialization): Move definition of \[yogh] (only
+ if the output device doesn't already define it) from here...
+ (AM): ...to here.
- * src/roff/groff/pipeline.c (xstrsignal): Fix usage of
- HAVE_DECL_SYS_LIST.
+2021-02-08 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-11-17 Werner LEMBERG <wl@gnu.org>
+ * doc/ms.ms: Use \[ps] special character instead of local
+ character definition using numeric code point escape, which is
+ less portable.
- * COPYING: Use correct version.
+ Fixes <https://savannah.gnu.org/bugs/?59528>. Thanks to Bjarni
+ Ingi Gislason for the report and a suggested patch.
-2003-11-11 Werner LEMBERG <wl@gnu.org>
+2021-02-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- LynxOS 4.0.0 doesn't declare vfprintf.
+ * tmac/s.tmac (initialization): Call par*define-font-macro with
+ arguments "CW" and "R" in nroff mode to silence font warnings
+ from documents using .CW macro in nroff mode.
- * configure.ac: Check for vfprintf.
- * configure: Regenerated.
- * src/include/lib.h: Handle `NEED_DECLARATION_VFPRINTF'.
- * src/include/config.hin: Regenerated.
+2021-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-11-10 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/tbl/table.cpp (table::init_output): Save value of
+ hyphenation maximum consecutive line count register (\n[.hlm])
+ more carefully to keep it from being incorrectly parsed as a
+ decrement, because negative values of \n[.hlm] are valid (in
+ fact, "-1" is the default). In documents with a large number of
+ tables, this can lead to a Persian chessboard problem and an
+ integer overflow (at the groff language level, caught and
+ handled by src/roff/troff/number.cpp:parse_term()).
- LynxOS 4.0.0 has snprintf (without declaration) but no vsnprintf.
+ It is wise to wrap a non-literal second argument to the .nr
+ request in parentheses if assignment is desired and its value
+ can be negative. See section 5.6.1 ("Setting Registers") of the
+ groff Texinfo manual.
- * configure.ac: Check for vsnprintf.
- * configure: Regenerated.
- * src/include/lib.h: Handle `NEED_DECLARATION_VSNPRINTF' and
- `HAVE_VSNPRINTF'.
- * src/include/config.hin: Regenerated.
+ Fixes <https://savannah.gnu.org/bugs/?59993>.
-2003-11-09 Werner LEMBERG <wl@gnu.org>
+2021-02-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * aclocal.m4: Updated syntax to autoconf 2.59.
- (GROFF_HTML_PROGRAMS): Use AC_FOREACH.
- Don't check for gsos2.
- (GROFF_SRCDIR, GROFF_BUILDDIR): Removed. autoconf 2.59 provides
- working abs_top_srcdir and abs_top_builddir.
+ * test-groff.in: Add support for rfc1345.tmac.
- * configure.ac: Updated syntax to autoconf 2.59.
- Don't call GROFF_SRCDIR and GROFF_BUILDDIR.
- Replace call to AC_DECL_SYS_SIGLIST with call to AC_CHECK_DECLS.
- * configure: Regenerated.
+2021-02-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.in, doc/Makefile.in: s/@top_srcdir@/@abs_top_srcdir@/,
- s/@groff_top_builddir@/@abs_top_builddir@/.
+ Integrate rfc1345.tmac into build system.
- * src/roff/groff/pipeline.c (xstrsignal):
- s/SYS_SIGLIST_DECLARED/HAVE_DECL_SYS_SIGLIST/.
+ * contrib/rfc1345/rfc1345.am: Do it.
+ * Makefile.am: Include contrib/rfc1345/rfc1345.am.
-2003-11-07 Werner LEMBERG <wl@gnu.org>
+2021-02-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grodvi/dvi.cpp (draw_dvi_printer::draw) ['a']: Always
- make start angle smaller than end angle to circumvent a bug in tpic
- handling of some versions of dvipdfm (and dvipdfmx).
+ * src/roff/troff/input.cpp (open_mac_file): Report problem when
+ attempting to open macro files (-m arguments) and the error is
+ something other than ENOENT.
+ (process_macro_file): Update diagnostic to be more precise; the
+ file couldn't be _opened_, not necessarily _found_, and clarify
+ that the string being reported back to the user is the argument
+ to the -m option, not a file name.
+ (macro_source): Update diagnostic to report that the file
+ couldn't be _opened_, not necessarily _found_, and include the
+ nature of the problem.
-2003-10-30 Werner LEMBERG <wl@gnu.org>
+2021-01-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/grops.man: Improve section on creating EPS.
+ [tbl]: Save and restore hyphenation parameters.
-2003-10-29 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/tbl/table.cpp (table::init_output): When starting
+ a table, save the hyphenation parameters (\n[.hy], \n[.hla],
+ \n[.hlm], \n[.hym], \n[.hys]). Restore them in the table reset
+ macro (confusingly called "3init"), which is called before
+ performing each diversion and before exiting a table.
- * contrib/pic2graph/pic2graph.sh: Fix typo (-P-letter ->
- -P-pletter).
+ This enables people to, e.g., turn off hyphenation in a table
+ text block with .nh, just as they can turn off adjustment with
+ .na, without having to manually reset it. The next text block,
+ and the material after the table, will not be affected.
-2003-10-28 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?59971>.
- * doc/groff.texinfo: Fix documentation of `.if'.
+2021-01-30 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-10-27 Michail Vidiassov <master@iaas.msu.ru>
+ Add regression test for Savannah #59971.
- * src/utils/afmtodit/afmtodit.pl: Handle unmapped characters of
- the form `uniXXXX' also.
+ * src/preproc/tbl/tests/\
+ save-and-restore-hyphenation-parameters.sh: Do it.
+ * src/preproc/tbl/tbl.am (tbl_TEST): Run test.
-2003-10-27 Werner LEMBERG <wl@gnu.org>
+2021-01-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * contrib/eqn2graph/eqn2graph.sh, contrib/grap2graph/grap2graph.sh,
- contrib/pic2graph/pic2graph.sh: Implement secure management of
- temporary files.
- Pass `-P-pletter' to groff to avoid data outside of the converted
- area -- some versions of `convert' (for example 5.3.8) don't check
- the bounding box of the image but always use a fixed image size
- (letter paper format).
- * contrib/eqn2graph/eqn2graph.man, contrib/grap2graph/grap2graph.man,
- contrib/pic2graph/pic2graph.man: Updated.
+ * tmac/tmac.am ($(TMACSTRIPFILES)):
+ ($(TMACMDOCSTRIPFILES)): Remove unidiomatic for loop which
+ frustrated parallel make operation.
- * src/roff/groff/groff.man: Document $TMP and $TEMP.
+ Thanks to an anonymous contributor for the report and patch.
-2003-10-26 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?59958>.
- * src/preproc/pic/troff.cpp (troff_output::simple_circle,
- troff_output::simple_ellipse, troff_output::simple_arc,
- troff_output::simple_line, troff_output::simple_spline,
- troff_output::simple_polygon): Insert a space before arguments.
- (troff_output::set_fill): Emit `\&' before `\D'Fg...' since the
- latter doesn't produce a node, so the following `.sp -1' would do
- the wrong thing.
- Don't emit `.sp -1' after \M. This also doesn't produce a token
- (and we don't have to care about compatibility mode).
- (troff_output::set_color, troff_output::reset_color): Don't emit
- `.sp -1' after \M and \m.
+2021-01-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cpp (old_have_input): New global variable.
- (input_stack::get): Handle `old_have_input'.
- (process_input_stack) <token::TOKEN_NEWLINE>: Call
- `trapping_blank_line' depending on `old_have_input', not
- `have_input'.
+ * doc/ms.ms (Document control settings): Document old FAM string
+ and new FR string.
-2003-10-20 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-01-29 T. Kurt Bond <tkurtbond@gmail.com>
- * src/libs/libgroff/tmpfile.cpp [__MSDOS__, _Win32]
- (WIN32_TMPDIR_ENVVAR, MSDOS_TMPDIR_ENVVAR): New macros, providing
- default directory names for temporary files.
- [__MSDOS__, _Win32] (temp_init::temp_init): Use them.
+ [ms]: Add new string FR to hold an expression for computing the
+ footnote length relative to the line length, consistently for
+ single- and multi-column modes, which \n[FL] has never done.
- * src/roff/groff/pipeline.c [__MSDOS__]: Include stdlib.h.
- [__MSDOS__] (run_pipeline): Honour environment variables.
- Don't use `tmpnam' but `tempnam' to work around messy
- implementation.
+ * tmac/s.tmac: Initialize FR string to "11/12".
+ (@MC): Compute footnote column width using \*[FR] instead of a
+ hard-coded "11/12" expression.
+ (par@init): Compute default \n[FL] using \*[FR] instead of a
+ hard-coded "11/12" expression.
- * README.MinGW: New file.
+ * doc/groff.texi (Macro Packages/ms/Document control settings):
+ * tmac/groff_ms.7.man (Usage/Document control registers):
+ Document it.
-2003-10-16 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?59605>.
- * src/preproc/html/pre-html.cpp (write_upto_newline): Don't use
- `(*t)->next' without testing validity of `*t'.
- (usage): Make it more readable.
+2021-01-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-10-16 Keith Marshall <keith.d.marshall@ntlworld.com>
+ * src/roff/troff/env.cpp: Add ADJUST_MAX enumeration constant to
+ record maximum valid numerical adjustment mode.
+ (adjust): Verify numeric argument against ADJUST_MAX instead of
+ a numeric literal. Ignore excessively large values instead of
+ setting adjustment mode to "right". Update warning diagnostic.
- Make html device run under both MS-DOS and Win32.
+2021-01-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/html/pre-html.cpp (MAY_FORK_CHILD_PROCESS,
- MAY_SPAWN_ASYNCHRONOUS_CHILD): New macros to control whether
- spawn or fork+exec has to be used, and whether parent must sleep
- until the child process terminates. Used in
- `char_buffer::run_output_filter'.
- (copyofstdoutfd): Removed.
- (char_buffer): Replace `write_file_html' and `write_file_troff'
- member functions with `emit_troff_output' and `run_output_filter'.
- (DEVICE_FORMAT, HTML_OUTPUT_FILTER, IMAGE_OUTPUT_FILTER): New
- macros.
- (replaceFd): Replaced with...
- (set_redirection): New auxiliary function.
- (waitForChild): Replaced with...
- (save_and_redirect): New auxiliary function for.
+ Add regression test for .ad and .na requests.
- (char_buffer::do_html, char_buffer::do_image): Simplified, using new
- functions.
+ * src/roff/groff/tests/adjustment_works.sh: Do it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
-2003-10-14 Keith Marshall <keith.d.marshall@ntlworld.com>
+2021-01-24 G. Branden Robinson <g.branden.robinson@gmail.com>
- * aclocal.m4 (GROFF_SYS_NERR): Check stdlib.h also.
- (GROFF_LIBC): New function.
- * configure.ac: Call GROFF_LIBC.
- Check for `kill'.
- * configure: Regenerated.
+ * doc/groff.texi (Manipulating Filling and Adjustment):
+ * man/groff.7 (Requests/Request short reference): Clarify
+ behavior of ".na" and ".ad l".
- * src/include/lib.h: Handle __MINGW32__.
- * src/include/nonposix.h [_MSC_VER]: Handle __MINGW32__.
- Add macro for `pipe'.
- Define P_tmpdir.
+ Thanks to Bjarni Ingi Gislason for pointing out the potential
+ for confusion and for his careful review of the new text.
- * src/roff/groff/pipeline.c (run_pipeline): Handle `no_pipe'
- correctly.
+ Fixes <https://savannah.gnu.org/bugs/?59795>.
- * src/utils/indxbib/signal.c (handle_fatal_signal) [!HAVE_KILL]:
- Implement.
+2021-01-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-10-12 Werner LEMBERG <wl@gnu.org>
+ * src/roff/grog/grog.pl: Report program name in fatal error
+ diagnostics. Also drop sentence-ending punctuation since Perl
+ supplies additional information.
- * src/roff/groff/groff.cpp (help), src/devices/grops/ps.cpp (usage),
- src/roff/troff/input.cc (usage): Updated.
+ Continues the long process of fixing Savannah #52463.
- * NEWS, doc/groff.texinfo: Updated.
+2021-01-19 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-10-12 Peter Miller <millerp@canb.auug.org.au>
+ * tmac/an-old.tmac (RE): Style-warn if macro arguments are out
+ of range or redundant.
- * src/libs/libgroff/searchpath.cpp
- (search_path::open_file_cautious): New function which also handles
- `-' as stdin and stdout depending on the access mode.
- * src/include/searchpath.h (search_path): Updated.
+ Fixes <https://savannah.gnu.org/bugs/?55320>.
- * src/devices/grops/ps.cpp (main): Handle new `-I' switch.
- * src/devices/grops/ps.h: Include `searchpath.h'.
- * src/devices/grops/psrm.cpp (resource_manager::supply_resource):
- Open resource file with `include_search_path.open_file_cautious'.
- * src/devices/grops/grops.man: Document new `-I' switch.
+2021-01-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grodvi/dvi.cpp (main), src/devices/grolbp/lbp.cpp
- (main), src/devices/grolj4/lj4.cpp (main),
- src/devices/grotty/tty.cpp (main): Ignore new `-I' switch.
+ Improve style of troffrc{,-end} files. Follow established
+ idioms and make them consistent with each other.
- * src/preproc/soelim/soelim.cpp (include_list_length, include_list):
- Replaced with...
- (include_search_path): New global variable.
- (include_path_append): Removed.
- (main): Use `include_search_path.command_line_dir' to handle `-I'.
- (do_file): Simplify, using new
- `include_search_path.open_file_cautious'.
+ * tmac/troffrc:
+ * tmac/troffrc-end:
+ - Identify files in header comments as part of GNU troff.
- * src/roff/groff/groff.cpp (print_commands): Accept file handle as
- parameter.
- (main): Pass arguments to `-I' to both troff and devices.
- Improve handling of `-V'.
- * src/roff/groff/groff.man: Document changes to -I and -V.
+ * tmac/troffrc:
+ - Clarify purpose of .do request.
+ - Identify .X (set by groff -X) as a register, not a string.
+ - Remove temporary registers one per line to make
+ synchronization with foregoing logic easier. Fixes name
+ space management nits: an undefined string troffrc!Xps was
+ being removed, and troffrc!{ascii,latin1,utf8,cp1047} were
+ not being removed despite being defined.
- * src/roff/troff/input.cpp (include_search_path): New global
- variable.
- (next_file, source, ps_bbox_request, transparent_file,
- process_input_file): Use new
- `include_search_path.open_file_cautious'.
- (main) Handle `-I' switch.
- * src/roff/troff/node.cpp (troff_output_file::really_copy_file):
- Use new `include_search_path.open_file_cautious'.
- * src/roff/troff/node.h: New extern symbol `include_search_path'.
- * src/roff/troff/troff.man: Document new `-I' switch.
+ * tmac/troffrc-end:
+ - Clarify that file is read after -m file arguments (not "all
+ macro sets", which can be loaded with .mso after this file
+ is processed).
+ - Advise usage of .do for groff extensions.
+ - Line-break one-off conditionals as troffrc does.
+ - Add empty string comment to empty string definitions.
-2003-09-15 Ruslan Ermilov <ru@FreeBSD.org>
+2021-01-14 Dave Kemper <saint.snit@gmail.com>
- Support multiple calls of .Lb in LIBRARY section.
+ Commit 87edb525, from 2003, added character U+2026 (HORIZONTAL
+ ELLIPSIS) to most base groff fonts, but there has been no
+ kerning information for this character. To produce consistent
+ typography, it should be kerned the same way as the period,
+ which is in 818 kern pairs across all the devps fonts.
+
+ Apply the following shell command to the groff description files
+ of the PostScript fonts.
+
+ for file in font/devps/*[A-Z]
+ do sed -Ei\~ 's/(.*)(^| )\. (.*)/&\n\1\2u2026 \3/' $file
+ done
+
+ * font/devps/AB:
+ * font/devps/ABI:
+ * font/devps/AI:
+ * font/devps/AR:
+ * font/devps/BMB:
+ * font/devps/BMBI:
+ * font/devps/BMI:
+ * font/devps/BMR:
+ * font/devps/HB:
+ * font/devps/HBI:
+ * font/devps/HI:
+ * font/devps/HNB:
+ * font/devps/HNBI:
+ * font/devps/HNI:
+ * font/devps/HNR:
+ * font/devps/HR:
+ * font/devps/NB:
+ * font/devps/NBI:
+ * font/devps/NI:
+ * font/devps/NR:
+ * font/devps/PB:
+ * font/devps/PBI:
+ * font/devps/PI:
+ * font/devps/PR:
+ * font/devps/TB:
+ * font/devps/TBI:
+ * font/devps/TI:
+ * font/devps/TR:
+ * font/devps/ZCMI: Apply above script.
+
+ Fixes <https://savannah.gnu.org/bugs/?58897>. However, this
+ will need to be done again if afmtodit is used to regenerate the
+ above files, or afmtodit will need to be modified to add this
+ kerning information itself.
+
+2021-01-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libgroff/relocate.cpp (set_current_prefix) [_WIN32]:
+ Move declaration of `pathextstr` to lie within preprocessor
+ conditional, since it is dereferenced only there.
+
+2021-01-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Add support for strsignal().
+
+ POSIX.1-2008 added strsignal() to the C library and recommended
+ its use over sys_siglist[], but groff's pipeline management
+ hadn't been updated in that respect since that time.
+
+ * configure.ac: Check for strsignal().
+ * src/roff/groff/pipeline.c (xstrsignal): Return strsignal() if
+ it is defined.
+
+ Thanks to an anonymous contributor for the report and the patch.
+
+ Fixes <https://savannah.gnu.org/bugs/?59835>.
+
+2021-01-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/libs/libgroff/relocate.cpp (relocatep): Add assertion to
+ identify logic error if `curr_prefix` is unexpectedly a null
+ pointer.
+ (set_current_prefix) [_WIN32]: Allocate memory from heap for
+ `curr_prefix` only on Windows; on other systems, this file's
+ searchpath() is used to populate `curr_prefix`, and that
+ function (except on Windows) performs its own allocation. Fixes
+ memory leak noted by Ingo Schwarze.
+ (set_current_prefix) [!_WIN32]: Move logic attempting to set
+ `curr_prefix` by calling searchpathext() from here...
+ [WIN32]: ...to here. The PATHEXT environment variable has
+ semantics only under Windows, not POSIX systems, so the
+ placement of this code seemed erroneous.
+
+ See <https://savannah.gnu.org/bugs/?55475>.
+
+2021-01-06 Colin Watson <cjwatson@debian.org>
+
+ * contrib/glilypond/glilypond.pl:
+ * contrib/gperl/gperl.pl:
+ * contrib/gpinyin/gpinyin.pl:
+ * tmac/hyphenex.pl: Avoid Perl's unsafe "<>" operator.
+
+ The "<>" operator is implemented using the two-argument form of
+ "open", which interprets magic such as pipe characters, allowing
+ execution of arbitrary commands which is unlikely to be
+ expected. Perl >= 5.22 has a "<<>>" operator which avoids this,
+ but also forbids the use of "-" to mean the standard input,
+ which is a facility that the affected groff programs document.
+
+ ARGV::readonly would probably also fix this, but I fundamentally
+ dislike the approach of escaping data in preparation for a
+ language facility to unescape it, especially when the required
+ escaping is as non-obvious as it is here. (For the same reason,
+ I prefer to use subprocess invocation facilities that allow
+ passing the argument list as a list rather than as a string to
+ be interpreted by the shell.) So I've abandoned this dubious
+ convenience and changed the affected programs to iterate over
+ command-line arguments manually using the three-argument form of
+ open.
+
+ glilypond doesn't need the initial unshift since that's already
+ handled in contrib/glilypond/args.pl.
+
+ Fixes <https://savannah.gnu.org/bugs/?55557>.
+
+2021-01-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/s.tmac: Set footnote line length in multi-column
+ environments to 11/12ths of the text line length for consistency
+ with earlier change to FL register default.
+
+ Thanks to T. Kurt Bond for bringing this issue to my attention.
+
+2021-01-04 John Gardner <gardnerjohng@gmail.com>
+
+ * tmac/strip.sed: Escape '.' wildcard when matching lines using
+ .as and .ds requests.
+
+ Fixes <https://savannah.gnu.org/bugs/?59498>.
+
+2021-01-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Document use of SOURCE_DATE_EPOCH and TZ.
+
+ The semantics of SOURCE_DATE_EPOCH to groff were not established
+ with respect to time zone selection, prompting divergent
+ interpretations; Debian and distributions derived from it have
+ for several years patched groff to implicitly use UTC as the
+ time zone when interpreting the current time (or
+ SOURCE_DATE_EPOCH) as a local time. While a convenient and
+ defensible choice for reproducible build efforts[1], it runs
+ against the grain of user expectations. Systems programmers
+ like monotonically increasing clocks; the broader user base
+ usually prefers a clock that follows an applicable civil
+ calendar. To the latter audience, a difference between
+ $ date "+%Y-%M-%d %H:%m:%S"
+ and
+ $ groff <<EOF
+ .af year 0000
+ .af mo 00
+ .af dy 00
+ .af hours 00
+ .af minutes 00
+ .af seconds 00
+ .tm \n[year]-\n[mo]-\n[dy] \n[hours]:\n[minutes]:\n[seconds]
+ EOF
+ is difficult to explain.
- * tmac/doc-common (doc-in-library-section): New register.
- (doc-section-library): New string.
- (Sh): Set `doc-in-library-section'.
- (Rd): Updated.
- * tmac/doc-syms (Lb): Insert breaks before and after arguments
- if in LIBRARY section.
- * tmac/doc.tmac (doc-save-global-vars): Updated.
- * NEWS, tmac/groff_mdoc.man: Updated.
+ * doc/groff.texi (Environment):
+ * src/devices/grohtml/grohtml.1.man (Environment):
+ * src/devices/gropdf/gropdf.1.man (Environment):
+ * src/devices/grops/grops.1.man (Environment):
+ * src/roff/groff/groff.1.man (Environment):
+ * src/roff/troff/troff.1.man (Environment): Expand description
+ of use of SOURCE_DATE_EPOCH to note that it converts the time
+ {as seconds since the Epoch} to local time, which motivates
+ documentation of the TZ environment variable. Explain what the
+ time stamps are used for: troff merely stores the human-readable
+ time components in registers; the grohtml, gropdf, and grops
+ output drivers write the information to the output in comments.
-2003-09-14 Ruslan Ermilov <ru@FreeBSD.org>
+ Fixes <https://savannah.gnu.org/bugs/?57218>.
- * tmac/doc-common (doc-default-operating-system): New variable.
- (Os): Use it.
+ [1] https://reproducible-builds.org/docs/source-date-epoch/
-2003-09-08 Werner LEMBERG <wl@gnu.org>
+2020-12-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc.tmac (doc-reset-reference): Handle data for `%I' also.
+ * doc/doc.am (.texi.dvi): Call texi2dvi with FORCE_SOURCE_DATE=1
+ in the environment, avoiding an embedded timestamp in the
+ generated groff.dvi file, which frustrated reproducible builds.
+ Thanks to Werner Lemberg for the suggestion.
-2003-08-31 Werner LEMBERG <wl@gnu.org>
+ * src/roff/groff/tests/string_case_xform_unicode_escape.sh: Fix
+ test to no longer use Bash process substitution, resulting in
+ nondeterministic file descriptor numbers appearing in test logs,
+ frustrating reproducible builds.
- * Makefile.comm: Use `test ... ||' in favor of `if test ...; then'.
- (install_dev, uninstall_dev): Check whether $(DEVSCRIPTS) and
- $(DEVFILES) are not empty.
- * Makefile.in: Use `test ... ||' in favor of `if test ...; then'.
+ * contrib/pdfmark/pdfmark.am (PDFROFF): Call pdfroff without
+ `--keep-temporary-files` option. Temporary directories are
+ created with mktemp(1) and files with an embedded process
+ identifier, which frustrates reproducible builds.
-2003-08-23 Stephen Gildea <http://www.gildea.com/stephen>
+ See <https://savannah.gnu.org/bugs/?57218>.
- * src/preproc/refer/ref.cpp (reference::compute_sort_key): Always
- insert SORT_SEP. With certain combinations of sort specifications,
- refer sorted entries in the wrong order. In particular, entries
- with a missing field should be be sorted before all entries that
- have that field, before refer looks to the next field.
+2020-12-21 Dorai Sitaram <ds26gte@yahoo.com>
-2003-08-23 Werner LEMBERG <wl@gnu.org>
+ * tmac/s.tmac (@IP): Handle inter-sentence space correctly in
+ paragraph tags by copying \n[.sss] from the enclosing
+ environment to that used to format the paragraph tag.
- * src/utils/pfbtops/Makefile.sub (LINK.c): Define it so that the
- g++ linker is used. Reported by Mark J. Reed
- <mark.reed@turner.com>.
+ Fixes <https://savannah.gnu.org/bugs/?59742>.
-2003-08-16 Heinz-JĂŒrgen Oertel <hj.oertel@surfeu.de>
+2020-12-21 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add key character `x' to tbl which makes tbl call a user-defined
- macro on a table cell.
+ Add regression test for Savannah #59742.
- * src/preproc/tbl/table.h (entry_modifier): Add `macro'.
- * src/preproc/tbl/table.cpp (block_entry::do_divert): Call
- `set_modifier' after printing the compatibility request.
- (set_modifier): Print call to `m->macro' if not empty.
- * src/preproc/tbl/main.cpp (entry_format::debug_print): Handle
- `macro'.
- (process_format): Implement cases `x' and `X'.
- * src/preproc/tbl/tbl.man, NEWS: Updated.
+ * tmac/tests/s_IP_respects_inter-sentence_space_in_tags.sh: Do
+ it.
+ * tmac/tmac.am (tmac_TESTS): Run it.
-2003-08-15 Werner LEMBERG <wl@gnu.org>
+2020-12-21 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
- * doc/groff.texinfo: Minor fixes.
+ * src/utils/addftinfo/addftinfo.cpp (usage): Use size_t for loop
+ index when iterating over a count of size_t items. Quiets
+ signedness mismatch compiler warning.
-2003-08-09 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?59583>.
- * tmac/an-old.tmac [cR]: Fix redefinition of `bp'.
+2020-12-20 Colin Watson <cjwatson@debian.org>
-2003-08-07 Werner LEMBERG <wl@gnu.org>
+ * src/devices/gropdf/gropdf.pl:
+ * src/utils/afmtodit/afmtodit.pl: Sort Perl hash keys. Hash
+ iteration order may differ between runs, which makes builds
+ harder to reproduce. Sort hash keys in gropdf and afmtodit
+ output to avoid this.
- * doc/Makefile.sub: Not all shells expand wildcards in the `for'
- argument list to nothing if there is no file to match. Use `ls' as
- a protection, similar to autoconf.
+2020-12-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.comm (install_dev, uninstall_dev): Protect `for' against
- empty argument lists.
+ * doc/ms.ms (Basic Information): Tweak unit definitions. groff
+ defines a typesetter's point as precisely 1/72 inches. Also use
+ the correct symbol for inch units--strictly, it's the same as
+ that for "seconds" as in subdivisions of the degree, and not a
+ typographical quote of any sort.
- * doc/groff.texinfo: Improve documentation how vertical spacing
- and line breaks interact.
- Other minor fixes.
+ Fixes <https://savannah.gnu.org/bugs/?59463>.
- * tmac/www.tmac: Initialize `www-htmlimage-gap'.
+2020-12-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-08-03 Werner LEMBERG <wl@gnu.org>
+ [ms]: Set footnote line length to AT&T default.
- * NEWS, src/devices/grops/grops.man: -b16 is necessary to produce
- EPS (using eps2eps or similar programs to compute the bounding box).
+ groff ms has since its initial implementation used a default
+ footnote line length of 5/6ths of the text line length; this may
+ correspond to an early AT&T ms default (perhaps documented in
+ the 1974 version of the M. E. Lesk paper, "Typing Documents on
+ the UNIX System"[1]). However, as early as V6 Unix (1975), AT&T
+ ms actually used a footnote line length of 11/12ths of the text
+ line length instead[2].
-2003-07-24 Werner LEMBERG <wl@gnu.org>
+ Heirloom Doctools and neatroff ms also use this default.
- * doc/groff.texinfo: Use the new @/ command to avoid overlong lines.
- * doc/texinfo.tex: Updated from texinfo 4.6.
- * README.CVS: From now on we need texinfo 4.6.
+ * tmac/s.tmac: Set default footnote line length to 11/12ths of
+ the text line length.
-2003-07-23 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (ms Document Control Settings):
+ * doc/ms.ms (Document control registers): Document new default.
- Add requests `dei1' and `ami1' for completeness.
+ [1] https://www.troff.org/using-ms.pdf
+ [2] https://minnie.tuhs.org/cgi-bin/utree.pl?file=V6/usr/lib/tmac.s
- * src/roff/troff/input.cc (calling_mode): Remove
- CALLING_DISABLE_COMP.
- (comp_mode): New enumeration.
- (do_define_string, define_string, define_nocomp_string,
- append_string, append_nocomp_string): Updated.
- (do_define_macro): Add third parameter.
- (define_macro, define_nocomp_macro, define_indirect_macro,
- append_macro, append_nocomp_macro, append_indirect_macro): Updated.
- (define_indirect_nocomp_macro, append_indirect_nocomp_macro): New
- functions.
- (ignore): Updated.
- (init_input_requests): Add `dei1' and `ami1'.
+2020-12-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/trace.tmac: Handle de1 and am1.
- (de): Improve tracing message.
- (am): Add missing `do'.
- (return): Use de1.
+ Lower new unplanted trap error to 'mac' warning.
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo:
- Document new requests.
+ * src/roff/troff/div.cpp (top_level_diversion::change_trap):
+ Change error upon invalid attempt to move an unplanted trap into
+ a warning of type 'mac'.
-2003-07-22 Heinz-JĂŒrgen Oertel <hj.oertel@surfeu.de>
+ * doc/groff.texi (Warnings):
+ * src/roff/troff/troff.1.man (Warnings): Recast description of
+ 'mac' warning type to include the above scenario.
- Add option -G to .MPIMG to insert a gap between text and the image.
+ Thanks to Bjarni Ingi Gislason for reporting the diagnostic
+ arising in real life, and to Peter Schaffter for the discussion
+ and recommendation. Some bike sheds get painted quickly!
- * tmac/www.tmac (www-finish-left-po, www-finish-right-ll,
- www-finish-left-ll): Updated.
- (www-image-just, www-image-gap, www-htmlimage-gap): New variables.
- (MPIMG): Make option -L and -R optional.
- Implement option -G.
+ Fixes <https://savannah.gnu.org/bugs/?59573>.
-2003-07-22 Gaius Mulley <gaius@glam.ac.uk>
+2020-12-05 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp
- (html_printer::do_file_components): Don't use `stdout' as lvalue
- since it can be a macro.
+ * tmac/groff_mdoc.7.man: Tweak mandatory macro explanations.
-2003-07-22 Werner LEMBERG <wl@gnu.org>
+ Update descriptions and template of .Dd, .Dt, .Os usage to
+ reflect recent changes and recommended conventions.
- * src/libs/libgroff/strerror.c: Include errno.h to be in sync with
- the corresponding test in aclocal.m4.
+ Thanks to Ingo Schwarze, Colin Watson, and Alan D. Salewski for
+ the discussion, and Florent Rougon and Robert Bihlmeyer (many
+ years ago) for the original report.
-2003-07-21 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://bugs.debian.org/284002>.
- * src/preproc/html/pre-html.cpp (TRANSPARENT): Don't use colour
- names but RGB values directly. Otherwise pnmtopng depends on
- an external file `rgb.txt' which maps colour names to values.
+2020-12-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-07-20 Werner LEMBERG <wl@gnu.org>
+ * src/utils/xtotroff/xtotroff.c (MapFont): Avoid writing past
+ the end of a static buffer. Problem found and patch supplied by
+ Bjarni Ingi Gislason. I tweaked it to comment it differently
+ {in case the buffer ever needs to grow, but the prospects of
+ future X11 server-side font rendering development seem dim} and
+ use snprintf() instead of retaining the existing sprintf().
- * aclocal.m4 (GROFF_SYS_ERRLIST): Include stdlib.h for MinGW.
- * configure, src/include/config.hin: Regenerated.
+ Fixes <https://savannah.gnu.org/bugs/?55257>.
- * src/libs/libgroff/strerror.c: Include stdlib.h for MinGW.
+2020-12-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-07-19 Werner LEMBERG <wl@gnu.org>
+ * src/utils/xtotroff/xtotroff.c (CanonicalizeFontName)
+ (FontNamesAmbiguous, MapFont, main): Format diagnostic messages
+ more consistently with GNU Coding Standards. Prefix with name
+ of complaining command. Put argument literals in quotation
+ marks. Put each message on one line only.
- * PROBLEMS: Add solution for UTF-8 problem with hyphens.
+2020-11-28 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-07-18 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Parameters): Fix error in example. Arguments
+ to .als were in the wrong order (.als is not ln(1)). Also mark
+ output to the standard error stream using the @error Texinfo
+ command instead of @result.
- * *.man: Switch to non-compatibility mode temporarily if GNU
- syntax extensions are used in the particular man page.
+ Thanks to Dorai Sitaram for finding this error.
- * PROBLEMS: Add solutions for SGR problems.
+ Fixes <https://savannah.gnu.org/bugs/?59566>.
-2003-07-17 Werner LEMBERG <wl@gnu.org>
+2020-11-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- Don't ignore grotty's command line options if \X'tty: sgr ...' is
- used to change the drawing scheme.
+ * doc/groff.texi (Debugging): Update with a more helpful
+ introduction, summarizing available procedures. Mention
+ backtracing since it is much more useful now (post-groff
+ 1.22.4.)
- * src/devives/grotty/tty.cpp (bold_flag_option,
- underline_flag_option, italic_flag_option, reverse_flag_option,
- bold_underline_mode_option): New global variables.
- (update_options): New function.
- (tty_printer::special): Call update_options.
- (main): Don't set xxx_flag but xxx_flag_option, then call
- update_options.
+ * man/groff.7 (Debugging): Add new section summarizing
+ material added to our Texinfo manual.
-2003-07-14 Werner LEMBERG <wl@gnu.org>
+ * man/groff_diff.7.man (Debugging): Add new section describing
+ groff extensions.
- Make grotty emit proper Unicode box drawing characters for -Tutf8.
+2020-11-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grotty/tty.cpp (START_LINE, END_LINE): New enum
- values.
- (hline_char, vline_char): New global variables.
- (tty_printer::tty_printer): Initialize them.
- (tty_printer::draw): Emit START_LINE and END_LINE flags for both
- horizontal and vertical lines.
- (crossings): New global array.
- (tty_printer::end_page): Use it to determine the proper crossing
- character for -Tutf8.
+ * doc/groff.texi (Traps): Update. Organize subsubsections "Page
+ Location Traps" and "Diversion Traps" under new subsection node
+ "Vertical Position Traps" to make the conceptual organization
+ more clear. Define and discuss trap visibility earlier.
+ Document unit used for page location trap reporting. Introduce
+ analogy of .wh and .ch requests as queue operations. Document
+ what happens when the same macro is planted as a trap in
+ multiple locations; supply example. Supply example of .itc
+ usage. Consistently refer to an end-of-input macro as such, to
+ contrast it with the "end macro" that can be used with, e.g.,
+ .de and .ig requests.
-2003-07-12 Werner LEMBERG <wl@gnu.org>
+ * man/groff.7 (Traps): Add new section summarizing
+ language feature.
- * doc/Makefilesub (HTMLDOCFILESALL): New macro.
- (HTMLDOCFILES): Revert to `pic.html'.
- (CLEANADD, install_html, uninstall_sub): Use HTMLDOCFILESALL.
+2020-11-18 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-07-11 Werner LEMBERG <wl@gnu.org>
+ * tmac/mdoc/doc-common-u (doc-footer): When performing
+ double-sided page layout, set page number on outside of _recto_
+ {odd-numbered} pages, as is conventional and for consistency
+ with man(7).
- * doc/pic.ms: Improve documentation of absolute coordinates.
- Document absolute positioning of pictures.
+ * tmac/groff_mdoc.7.man
+ (Formatting with groff, troff, and nroff): Document what
+ double-sided layout (not "printing") means. Also correct
+ description of continuous rendering, which implied that page
+ headers and footers were not written at all, and used an
+ incorrect groff driver name.
- * NEWS: Add new pic capability.
+ Fixes <https://bugs.debian.org/919890>. Also see:
+ https://lists.gnu.org/archive/html/groff/2019-01/msg00021.html
+ Thanks to Ralph Corderoy for the discussion.
-2003-07-09 Hartmut Henkel <hartmut_henkel@gmx.de>
+ * tmac/tests/doc-D_places_page_numbers_correctly.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * src/libs/libgroff/geometry.cpp (check_output_arc_limits):
- Rewritten.
+2020-11-18 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-07-07 Werner LEMBERG <wl@gnu.org>
+ * tmac/mdoc/doc-common-u (doc-header): Fix infinite loop when
+ attempting to trim header string (like "FTP(1)") to fit when the
+ available title length won't allow even extreme shortening.
+ Measure the string before and after calling .substring on it,
+ and break out of loop if it didn't get shorter.
- Implement support for dashed and dotted ellipses in pic. Based on
- a patch from Hartmut Henkel <hartmut_henkel@gmx.de>.
+ Problem dates back to at least
+ ed63b0ae76a611b581601a1afc192f6a7367be6f (7 July 2002), possibly
+ as far as the Great Mdoc Rewrite of
+ 058f72af832fc68488d33cd09ec819e5c560fa09 (23 March 2001).
- * src/preproc/pic/common.cpp (common_output::ellipse_arc,
- common_output::dashed_ellipse, common_output::dotted_ellipse): New
- functions. Ellipse arcs are approximated with circle arcs.
- * src/preproc/pic/common.h (common_output): Updated.
- * src/preproc/pic/tex.cpp (tex_output::ellipse): Use new ellipse
- functions.
- * src/preproc/pic/troff.cpp (simple_output::ellipse): Ditto.
+ One can never check loop invariants too many times...
- * src/preproc/pic/TODO, src/preproc/pic/pic.man: Updated.
+ Fixes <https://bugs.debian.org/411227>.
-2003-07-06 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/\
+ doc-do_not_loop_infinitely_when_shortening_headers.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- Make grotty work on platforms which have unsigned char as the
- default for char. Based on a patch by Thomas Klausner
- <wiz@netbsd.org>.
+2020-11-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grotty/tty.cpp (schar): New typedef.
- Updated calls to declare_ptable and implement_ptable.
- (glyph): Use schar for back_color_idx and fore_color_idx.
- (tty_printer): Use schar for curr_fore_idx and curr_back_idx.
- (tty_printer::tty_color, tty_printer::tty_printer,
- tty_printer::color_to_idx, tty_printer::put_color): Updated.
+ * src/roff/nroff/nroff.sh: Recognize -b and -z options and pass
+ them through to troff. Document them in usage message.
+ * src/roff/nroff/nroff.1.man: Document new -b and -z options.
-2003-07-06 Ruslan Ermilov <ru@FreeBSD.org>
+2020-11-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/nroff/nroff.sh: Add option -d for completeness.
- * src/roff/nroff/nroff.man: Updated.
+ * src/roff/troff/div.cpp (top_level_diversion::change_trap):
+ Emit error diagnostic if an attempt is made to move an unplanted
+ macro. This could have been a warning, as it's pretty harmless
+ {though possibly a big surprise to anyone who was wondering why
+ their .ch was a no-op}, but there's no good warning category for
+ this kind of problem and I am not about to start a bike shed
+ discussion about it right now.
-2003-07-05 Werner LEMBERG <wl@gnu.org>
+2020-11-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS, tmac/groff_www.man: Updated.
- * doc/Makefile.sub: Updated.
+ * doc/groff.texi: Update. Add introductory material. Rewrite
+ the first section of the "gtroff Reference" chapter of our
+ Texinfo manual. It is written as an introduction for readers
+ who want to go straight to "raw" troff without knowing much or
+ anything about existing macro packages. Thanks to Dave Kemper
+ and John Gardner for feedback and support.
-2003-07-05 Gaius Mulley <gaius@glam.ac.uk>
+ Clarify whitespace usage. "Whitespace" is defined in this
+ manual as "spaces, tabs, and newlines". Say only "spaces and
+ tabs" when newlines should not be included.
- Implement support for multiple HTML output files.
+ Rename "Font Files" to "Device and Font Files".
- * src/preproc/html/pre-html.cpp (scanArguments): Dummy handling for
- -j command line option.
+ Rename "Manipulating Filling and Adjusting" to "Manipulating
+ Filling and Adjustment".
- * src/devices/grohtml/post-html.cpp (job_name, multiple_files): New
- global variables.
- (file): New fields `new_output_file', `require_links',
- `output_file_name'.
- (file::file): Updated.
- (files::set_file_name, files::set_links_required,
- files::are_links_required, files::is_new_output_file,
- files::file_name, files::next_file_name): New functions.
- (header_desc): New fields `no_of_level_one_headings',
- `header_filename'.
- (header_desc::header_desc): Updated.
- (header_desc::write_headings): Handle multiple files.
- (html_printer::write_header): Save file name in which header occurs.
- (html_printer::determine_header_level): Possibly split files on
- level one headings.
- (html_printer::do_links, html_printer::troff_tag): Updated.
- (html_printer::insert_split_file, html_printer::do_job_name,
- html_printer::emit_link, html_printer::write_navigation,
- html_printer::do_file_components): New functions.
- (html_printer::~html_printer): Handle multiple files.
- (main): Handle command line option `-j'.
+ Update discussion of "copy mode". Rename from "copy-in mode",
+ which I don't think eludicdated anything; is there a "copy-out
+ mode"? Rename nodes accordingly. Attempt to explain more
+ clearly. Recast to shift emphasis to what _isn't_ merely copied
+ in copy mode, since that is what seems to cause confusion among
+ the inexperienced.
- * src/devices/grohtml/grohtml.man: Updated.
+ Update "Conditionals and Loops". Add introductory paragraph.
+ Add nodes/subsections "if-then" and "Conditional Blocks". Add
+ subsection "Conditional Blocks" to explain the behavior of the
+ \{ and \} escapes much more precisely. I don't think this
+ syntactical area is well understood. Supply examples.
- * doc/Makefile.sub (pic.html), doc/Makefile.in (pic.html): New rule
- which splits file.
+2020-11-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/www.tmac (JOBNAME): New macro.
- * tmac/s.tmac (SH-NO-TAG): New macro.
- (@SH): Call SH-NO-TAG.
- (@NH): Updated.
+ Add style checks to man(7) macro package.
-2003-07-05 Ruslan Ermilov <ru@FreeBSD.org>
+ Not otherwise documented yet; experimental--subject to change.
- * tmac/groff_mdoc.man: Improve documentation of punctuation
- characters.
+ * tmac/an-old.tmac: Initialize CHECKSTYLE to false if not
+ already set.
+ (an-style-warn): New macro emits diagnostic of type "style" when
+ called if CHECKSTYLE register is true.
+ (TH): Call an-style-warn if fewer than two or more than five
+ arguments are seen.
+ (RI, IR, IB, BI, RB, BR): Call an-style-warn if fewer than two
+ arguments are seen.
-2003-07-04 Ruslan Ermilov <ru@FreeBSD.org>
+2020-11-11 Bertrand Garrigues <bertrand.garrigues@laposte.net>
- * tmac/doc.tmac (Bd): Change to doc-Li-font later.
+ Update copyright.
-2003-07-03 Werner LEMBERG <wl@gnu.org>
+ * update-copyright.sh: use gnulib's 'update-copyright' script.
+ Pass this script in directories 'arch', 'contrib', 'font',
+ 'man', 'tmac', 'src' and on a list of extra files.
- * tmac/an-old.tmac [cR]: Redefine `bp' to avoid empty lines.
+ * FOR-RELEASE: mention this point.
-2003-07-01 Ruslan Ermilov <ru@FreeBSD.org>
+2020-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc.tmac (doc-do-func, doc-do-func-args): Don't print a comma
- after `/*' and `*/'.
- Fix spacing.
- (Fn, Fo): Reduce indentation in synopsis.
+ * src/preproc/preconv/preconv.1.man (Description): Fix error:
+ groff's -K option, not -k, specifies a character econding (and
+ overrides GROFF_ENCODING in the environment). Also explain how
+ valid encoding strings are determined.
- * tmac/doc-common (doc-check-depth): New macro.
- (doc-end-macro, Sh, Ss): Use it.
- (Cd): Fix behaviour in synopsis.
- (In): Make it parsed and callable.
- If not in the synopsis, represent the C header file enclosed in
- angle brackets.
- (doc-str-Rv-std-suffix, doc-str-Rv-stds-suffix, doc-str-Rv-std0):
- Use minus, not hyphen.
+ Thanks to Bjarni Ingi Gislason for the report.
- * tmac/groff_mdoc.man: Updated.
+ Fixes <https://savannah.gnu.org/bugs/?59445>.
-2003-07-01 Werner LEMBERG <wl@gnu.org>
+2020-11-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- Integrated grap2graph, contributed by Eric S. Raymond.
+ * src/preproc/tbl/table.cpp (table::compute_separation_factor):
+ Add word "table" to diagnostic message to better cue the user
+ that it is produced by roff that has been injected into the
+ document by the tbl(1) preprocessor. The other 3 such possible
+ diagnostic messages already do this. Thanks to Bjarni Ingi
+ Gislason for bringing the inconsistency to light.
- * contrib/grap2graph/{Makefile.sub, grap2graph.sh, grap2graph.man}:
- New files.
- * Makefile.in, NEWS, MANIFEST, contrib/eqn2graph.man,
- contrib/pic2graph.man, src/roff/groff/groff.man: Updated.
+ Fixes <https://savannah.gnu.org/bugs/?59443>.
-2003-07-01 Colin Watson <cjwatson@debian.org>
+2020-11-07 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/xditview/*.c: Add prototypes, fix return types, add includes.
- Based on work by Fumitoshi UKAI <ukai@debian.or.jp>.
+ * tmac/groff_mdoc.7.man (Predefined strings): Ensure the table
+ fits even on ASCII and Latin-1 terminals. Thanks to Bjarni Ingi
+ Gislason for the report.
-2003-06-31 Ruslan Ermilov <ru@FreeBSD.org>
+ Fixes <https://savannah.gnu.org/bugs/?59424>.
- * tmac/tty-char.tmac: Provide `lb', `rb', `lk', `rk', `lt', `rt'.
+2020-11-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-06-31 Werner LEMBERG <wl@gnu.org>
+ * tmac/groff_mdoc.7.man (General text domain/Enclosure and
+ Quoting Macros): Fix errors in macro descriptions.
+ <.Dq>: Encloses its arguments in directional double quotes where
+ available.
+ <.Eq>: Misrendered example; say "XstringY" rather than
+ "XXstring".
+ <.Sq>: Encloses its arguments in directional single quotes where
+ available.
- * doc/Makefile.sub (CLEANADD): Remove all files created by
- running `make groff.{pdf,dvi}'.
+2020-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * Makefile.sub (DISTCLEANFILES): Remove all non-source files from
- src/xditview also.
+ Add support for CS and CT registers to mdoc(7), just like in
+ man(7), from a year ago.
-2003-06-30 Werner LEMBERG <wl@gnu.org>
+ * tmac/doc.tmac-u (doc-print-recursive): Call .stringup on each
+ argument if register doc-do-capitalize is true.
+ * tmac/mdoc/doc-common-u (Dt): Call .stringup on
+ doc-document-title if \n[CT] is true.
+ (Sh): Set doc-do-capitalize to value of \n[CS]. Set
+ doc-do-capitalize false before returning.
+ * tmac/mdoc/doc-ditroff-u:
+ * tmac/mdoc/doc-nroff-u: Set CS and CT registers to 0 (false)
+ if the user has not defined them.
- * Makefile.in (SHELL): Define as @SHELL@.
- (mkinstalldirs): Use $(SHELL).
- (MDEFINES): Add $(SHELL).
- * Makefile.comm (SHELL): Removed.
+ * tmac/groff_mdoc.7.man \
+ (Formatting with groff, troff, and nroff): Document it.
-2003-06-29 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/doc-CS_works.sh:
+ * tmac/tests/doc-CT_works.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run tests.
- * tmac/s.tmac (De, Ds): New aliases for .DE and .DS, respectively.
- The X11 documentation files use them.
- * tmac/groff_ms.man, doc/groff.texinfo: Document them.
+2020-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-06-15 Robert Goulding <goulding@Princeton.EDU>
+ * src/roff/troff/input.cpp (do_overstrike, do_bracket)
+ (do_name_test, do_expr_test, do_zero_width, do_width)
+ (do_special, do_if_request, read_color_draw_node): Improve
+ diagnostic messages for missing closing delimiters by describing
+ the incomplete structure and the problem token.
+ (read_rgb, read_cmy, read_cmyk, read_gray): Improve English
+ syntax of diagnostic message when color definition missing.
- * tmac/e.tmac (@C): Handle .ad also.
+2020-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-06-12 Werner LEMBERG <wl@gnu.org>
+ * tmac/mdoc/doc-ditroff-u:
+ * tmac/mdoc/doc-nroff-u: Recognize but ignore the groff_man(7)
+ string HF and registers FT, IN, P, SN, and X (by initializing
+ them empty or zero if they are not set). This reserves them so
+ that they don't become used for divergent purposes. man(1)
+ programs set these and other parameters already handled (like
+ LL) to configure page rendering, and it would break the
+ macro-package agnosticism afforded by andoc.tmac to expose
+ different externally-programmable registers and strings.
+ * tmac/groff_mdoc.7.man \
+ (Formatting with groff, troff, and nroff): Document this.
- * src/preproc/tbl/tbl.man: Document formatting of text blocks.
+2020-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cc (token::next) <handle_escape_char>:
- Assign `n' even here. It is possible to construct a node
- immediately following an escape character:
+ * tmac/s.tmac: Implement \*< and \*> strings for subscripting.
+ groff ms has had (extension) strings for superscripting since
+ 1991 at the latest, and the asymmetry possessed me of a madness.
+ Both pairs of string names follow similar usage in Eric Allman's
+ "me" macros.
- .di xx
- \?\\\?a
- .br
- .di
- .xx
+ * NEWS:
+ * doc/groff.texi:
+ * tmac/groff_ms.7.man: Document it.
-2003-06-10 Werner LEMBERG <wl@gnu.org>
+2020-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * README.WIN32: Removed.
- * MANIFEST: Updated.
+ * tmac/groff_mdoc.7.man (Predefined strings): Fix error: the
+ \*[Lq] and \*[Rq] strings degrade to neutral double quotes (")
+ on "nroff" devices (-Tascii and -Tlatin1), not "``" and "''".
-2003-06-07 Werner LEMBERG <wl@gnu.org>
+2020-10-31 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/nroff/nroff.sh: Don't emit SGR for option -u.
+ * tmac/s.tmac (ds*end!0): Improve diagnostic to mention .RD.
-2003-06-05 Werner LEMBERG <wl@gnu.org>
+2020-10-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/pic.y <sprintf_args>: Implement workaround for bug
- in Compaq C++ V6.5-033 for Compaq Tru64 UNIX V5.1A (Rev. 1885).
+ * tmac/s.tmac: Revise diagnostic messages. Define a common
+ prefix string, starting all such messages with "s.tmac".
+ Continues the long process of fixing Savannah #52463. Drop the
+ word "macro" from diagnostic since this will now be clear from
+ the prefix. Prefix every macro name in a diagnostic message
+ with a leading dot; this was already done in four cases.
+ (cov*first-page-init): Use temporary string to avoid multi-line
+ diagnostic message.
+ (@NH): Use temporary string to prevent overlength line.
-2003-06-03 Werner LEMBERG <wl@gnu.org>
+ A further benefit of this revision is that index information
+ produced by ms's .IX macro (which writes to the standard error
+ stream) will now be trivially easy to extract even for documents
+ that cause diagnostic messages. One can simply filter them with
+ grep -v '^s\.tmac:'
+ or similar.
- * src/preproc/grn/hdb.cpp (DBRead): Don't close file handle; this
- is done by the calling function.
+2020-10-28 Ingo Schwarze <schwarze@openbsd.org>
-2003-05-22 Ruslan Ermilov <ru@FreeBSD.org>
+ * man/roff.7.man, tmac/groff_man.7.man.in: Correct man(7)
+ history.
- * tmac/X.tmac: Fix definition of `em'.
+2020-10-26 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-05-22 Werner LEMBERG <wl@gnu.org>
+ Fix ms .R macro to work as documented, by handling its arguments
+ instead of ignoring them.
- * src/roff/troff/input.cc (return_macro_request): Fix detection of
- argument.
+ * tmac/s.tmac (R): Delete. During set up, call
+ par*define-font-macro for R font just as we do for B, I, and BI.
-2003-05-18 Werner LEMBERG <wl@gnu.org>
+ Problem dates back at least to groff 1.02, June 1991.
- * tmac/doc.tmac (doc-tag-list): Force horizontal mode after tag
- to make items work which consist only of a tag.
+ * tmac/tests/s_R-handles-its-arguments.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2003-05-17 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?59348>.
- * tmac/doc.tmac (doc-tag-list): Don't use \Z to assure that spaces
- aren't stretched in a tag (this can fail with unformatted boxes).
- Instead, insert a break and go back one line.
+2020-10-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-05-16 Werner LEMBERG <wl@gnu.org>
+ Fix ms .TC macro by allowing it to actually use lowercase Roman
+ numerals for the page(s) of the table of contents when a custom
+ title (header or footer) is defined containing '%'.
- * src/roff/troff/input.cc (return_macro_request): If called with
- argument pop macro twice. We need this to trace `return'.
+ As a side effect, eliminate the PN register, which was
+ apparently misused because it was undocumented and had a name
+ just long enough to be both suggestive and ambiguous. Another
+ pin goes into my Ken Thompson voodoo doll.
- * tmac/trace.tmac: Handle `return'.
- Fix typos.
+ * tmac/s.tmac (IX): Write out page number of index term(s) using
+ the % register (instead of PN), obtaining whatever format is
+ assigned to the register at that time.
+ (CH): Similarly, output %, not PN, in the center of the default
+ heading.
+ (PT): Save the format of %, set it to decimal, copy its value to
+ a new register, pg*page-number-in-decimal, then restore %'s
+ previous format. Compare the new register, not %, to 1 to
+ determine whether special page one behavior should be used.
+ (pg*end-page): Assign pg*next-format to %, not PN.
+ (XA): Define toc*num with the interpolation of %, not PN.
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo:
- Document.
+ * tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
-2003-05-15 Larry Kollar <kollar@alltel.net>
+ Problem appears to be very old; as I read it, Larry Kollar was
+ complaining of it in his ms.ms document over 20 years ago.
- * tmac/groff_ms.man, doc/groff.texinfo: Improve documentation of
- registers `FPS', `FVS', and `FPD'.
+ Fixes <https://savannah.gnu.org/bugs/?59345>.
-2003-05-15 Werner LEMBERG <wl@gnu.org>
+2020-10-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/pfbtops/pfbtops.c (get_text): Handle loop counter
- correctly.
+ * man/groff.7 (Requests/Request short reference) <.af>: Fix
+ error; "l" is not a valid register format. Explain what the
+ request does, and the default format, as tersely as possible.
-2003-05-03 Ruslan Ermilov <ru@FreeBSD.org>
+2020-10-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/groff_mdoc.man: Slight improvements.
+ Use only `malloc()` and `free()` to manage memory of paths
+ opened by the parser instead of mixing in C++ new/delete
+ management under some runtime-dependent circumstances.
-2003-05-03 Werner LEMBERG <wl@gnu.org>
+ * src/libs/libgroff/relocate.cpp (relocatep): Use `malloc()`,
+ not new.
+ * src/roff/troff/input.cpp (process_macro_file)
+ (process_startup_file, macro_source): Use `free()`, not
+ `{a_,}delete()`.
- * tmac/doc-common (doc-header): Emit vertical space of 1v instead of
- `doc-header-space' after header line if register `cR' is set.
+ Thanks to an anonymous contributor for the report and patch.
-2003-05-02 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?56694>.
- * TODO: Updated.
+2020-10-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-05-01 Ruslan Ermilov <ru@FreeBSD.org>
+ * man/groff_char.7.man (Description/Special character escape
+ forms): Clarify discussion of Unicode Normalization Form D and
+ its applicability to code points acceptable in Unicode numeric
+ special character escapes. Also document that these escapes
+ must use uppercase hexadecimal digits.
- * tmac/doc-common (Nd): Use \[em].
+ Attempts once again to slay the unkillable beast that is
+ <https://savannah.gnu.org/bugs/?57618>.
-2003-05-01 Werner LEMBERG <wl@gnu.org>
+2020-10-21 Ingo Schwarze <schwarze@openbsd.org>
- * tmac/doc-ditroff, tmac/doc-nroff (doc-header-space,
- doc-footer-space): Initialize to 0.5i.
- (doc-setup-page-layout): Don't set doc-header-space and
- doc-footer-space.
+ On systems without NAME_MAX, use FILENAME_MAX as a last resort.
-2003-04-30 Werner LEMBERG <wl@gnu.org>
+ Problem reported by Eli Zaretskii <eliz at gnu dot org>
+ on MS Windows in https://savannah.gnu.org/bugs/?55449
- * REVISION: Set to 1.
+2020-10-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/pic.ms: Document possible problems with `figname'.
+ * src/roff/troff/env.cpp (environment::possibly_break_line):
+ Emit break warning and return if the output width is not
+ positive. The code assumes that it will be and loops infinitely
+ if it isn't. I _think_ this is because we're not able to get
+ width data for (some?) CJK glyphs. Based on a patch by Osamu
+ Sayama.
-2003-04-29 Werner LEMBERG <wl@gnu.org>
+ * src/roff/groff/tests/\
+ do_not_loop_infinitely_when_breaking_cjk.sh: Test it.
+ * src/roff/groff/groff.am: Run test.
-Version 1.19 released
-=====================
+ Fixes <https://savannah.gnu.org/bugs/?44018>.
- * VERSION: Set to 1.19.
- * REVISION: Set to 0.
- * doc/groff.texinfo, doc/webpage.ms, NEWS: Updated.
+2020-10-20 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp (html_printer::~html_printer):
- Define charset as `US-ASCII' in html output.
+ * src/preproc/tbl/table.cpp (table::init_output): Save the value
+ of \n[.tabs] when starting a table. In the reset macro, restore
+ the saved value.
- * tmac/www.tmac (ULE): Add missing scaling indicator.
+ Based on a patch by Bjarni Ingi Gislason (tweaked to use a more
+ normative preprocessor symbol; "REG"s aren't "NAME"s).
- * win32-diffs: Removed.
+ * src/preproc/tbl/tests/save-and-restore-tab-stops.sh: Test it.
+ * src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
-2003-04-28 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?42978>.
- * doc/groff.texinfo: Document `dn' and `dl' registers if used with
- `.da' and `.boxa'.
- Document how to insert discardable whitespace with `.ss'.
+2020-10-20 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-04-27 Werner LEMBERG <wl@gnu.org>
+ * src/roff/nroff/nroff.sh: Recognize -E option and pass it
+ through to troff. Document it in usage message.
+ * src/roff/nroff/nroff.1.man: Document new -E option.
- * src/preproc/pic/tex.cpp (tex_output::start_picture): Make code
- work with plain TeX also.
+ Based on a patch by Ingo Schwarze.
- * src/preproc/pic/pic.man, doc/pic.ms: Fix TeX code example.
+ Fixes <https://savannah.gnu.org/bugs/?44289>.
-2003-04-25 Gaius Mulley <gaius@glam.ac.uk>
+2020-10-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp (html_printer::~html_printer):
- Use a loose DTD.
+ * tmac/an-old.tmac: Stop remapping ` and '. Our own pages now
+ appear to be clear of wrong-quote problems, so let's make them
+ visible if they recur. Those who don't want to fix bad man
+ pages (distributors, site admins) can restore the mappings in
+ their man.local files.
-2003-04-24 Werner LEMBERG <wl@gnu.org>
+2020-10-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/pic.man, doc/pic.ms: Explain how to get a
- vbox with positive height and zero depth if in TeX mode.
+ * tmac/an-old.tmac (an-warn): New; emits warning diagnostic.
+ (R): Use new macro instead of .tm* requests directly.
- * NEWS: Document glyph name changes for grodvi and grolj4.
+2020-10-18 Ingo Schwarze <schwarze@openbsd.org>
-2003-04-23 Werner LEMBERG <wl@gnu.org>
+ #include "config.h" before <stdio.h>
- * src/preproc/pic/tex.cpp (tex_output::start_picture): Fix TeX code.
- * doc/pic.ms: Fixed.
+ Required with e.g. gcc 4.2.1 because gnulib/lib/stdio.in.h
+ uses the "restrict" keyword since this gnulib commit:
+ commit 182afcba2635cbff91240656c7fb3742dd23ab6f
+ Author: Bruno Haible <bruno@clisp.org>
+ Date: Sat Feb 22 20:57:30 2020 +0100
-2003-04-21 Werner LEMBERG <wl@gnu.org>
+ Otherwise, the build may die from the declaration of
+ various printf-like functions with messages like:
+ ./lib/stdio.h:851: error: expected ',' or '...' before 'fp'
- HP-UX 10.20 has `snprintf' but it isn't declared.
+ * src/libs/libgroff/assert.cpp, src/libs/libgroff/errarg.cpp,
+ src/libs/libgroff/error.cpp, src/preproc/eqn/eqn.ypp:
+ #include "config.h".
- * configure.ac: Add declaration test for snprintf.
- * configure: Regenerated.
- * src/include/lib.h: Handle `NEED_DECLARATION_SNPRINTF'.
- * src/include/config.hin: Regenerated.
+2020-10-18 Bertrand Garrigues <bertrand.garrigues@laposte.net>
-2003-04-19 Werner LEMBERG <wl@gnu.org>
+ hpftodit: incorrect 'delete' after new[]
- Add keyword `figname' to pic, specifying the name of the picture
- box in TeX mode. Based on a patch from William J Poser
- <wjposer@unagi.cis.upenn.edu>.
+ * src/utils/hpftodit/hpftodit.cpp (output_font_name): use
+ 'delete[]'.
- * src/preproc/pic/pic.y: New token `FIGNAME'.
- (macro_name): New rule of type <str>.
- (placeless_element): Handle `FIGNAME'.
- * src/preproc/pic/lex.cpp (lookup_keyword): Add `figname'.
- * src/preproc/pic/main.cpp (graphname): New global variable.
- (do_picture): Initialize `graphname'.
- * src/preproc/pic/pic.h: Updated.
- * src/preproc/pic/tex.cpp (tex_output::start_picture): Use
- `graphname'.
- Simplify TeX code.
- (tex_output::text): Beautify output.
- * src/preproc/pic/object.cpp (object_spec::~object_spec): Deallocate
- `shaded' and `outlined' unconditionally.
- * NEWS, src/preproc/pic/pic.man, doc/pic.ms: Updated.
- Minor improvements.
+ Fixes bug #55331. Found by David Binderman, fixed by Ingo
+ Schwarze.
- * PROBLEMS, README.CVS: Mention that bison version 1.875b or
- greater is necessary.
+2020-10-18 Bertrand Garrigues <bertrand.garrigues@laposte.net>
-2003-04-17 Hartmut Henkel <hartmut_henkel@gmx.de>
+ preconv: don't use libuchardet if input is stdin
- Add option -r to soelim to avoid emission of `.lf' lines.
- Add option -t to produces TeX comment lines instead of `.lf' lines.
+ * src/preproc/preconv/preconv.cpp (do_file): don't call
+ detect_file_encoding if input file is "-"
- * src/preproc/soelim/soelim.cpp: New global variables `raw_flag'
- and `tex_flag'.
- (usage): Updated.
- (main): Handle `-r' and `-t'.
- (set_location): Handle `raw_flag' and `tex_flag'.
- * src/preproc/soelim/soelim.man, NEWS: Updated.
+ This fixes the failure on MS-Windows described #55334, however
+ this does not fix the encoding detection with uchardet if the
+ input is stdin (the user would have to pass with -D the correct
+ encoding as explained in the man page).
-2003-04-17 Werner LEMBERG <wl@gnu.org>
+2020-10-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/hyphenex.sh: Replaced with...
- * tmac/hyphenex.pl: This perl script to avoid sed compatibility
- nightmares.
+ * src/preproc/eqn/lex.cpp (troff_defs): Set the "..." token on
+ the baseline, not vertically centered, aligning the actual
+ behavior with what our eqn(1) man page has claimed since 2007.
- * aclocal.m4 (GROFF_HTML_PROGRAMS): Emit useful warning message
- if --quiet is used for the configure script.
- * configure: Regenerated.
+ Fixes <https://savannah.gnu.org/bugs/?59285>.
-2003-04-16 Werner LEMBERG <wl@gnu.org>
+2020-10-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/post-html.cpp (text_glob::text_glob):
- Add `const' to second argument.
- (html_printer::add_table_end): Add `const' to argument.
- * src/devices/grohtml/html-text.cpp (html_text::issue_tag): Add
- `const' to arguments.
- * src/devices/grohtml/html-text.h: Updated.
+ * src/devices/grops/grops.1.man
+ (Usage/TrueType and other font formats): Remove dead URL to
+ ttftot42 utility. Update URL to fontforge tool. Replace much
+ of the discussion with an example, motivated by Jordan Torbiak's
+ "groff-install-font" script on GitHub Gist, of how to add the
+ Roboto Slab Regular font to a user-local groff font directory
+ {and how to test it, too}.
- * src/devices/grolbp/charset.h (symset): Use `unsigned char'.
- * src/devices/grolbp/lbp.h (lbpputc): Use `unsigned char' for
- argument.
+ Fixes <https://savannah.gnu.org/bugs/?58077>.
- * src/devices/grotty/tty.cpp (tty_printer::make_rgb_string): Use
- cast for integer constant.
-
- * src/preproc/html/pre-html.cpp (image_device): Use `const'.
- (writeNbytes): Add `const' to first argument.
- (writeString): Add `const' to argument.
- (char_buffer::can_see): Add `const' to third argument.
- * src/preproc/html/pushback.cpp (pushBackBuffer::isString): Add
- `const' to argument.
- * src/preproc/html/pushback.h: Updated.
-
- * src/preproc/soelim/soelim.cpp (include_list): Add `const'.
- (include_path_append): Add `const' to argument.
- (do_file): Updated.
-
- * src/roff/troff/uniglyph.cpp (unicode_to_glyph_list): Use `const'
- for `value'.
- (unicode_to_glyph_init::unicode_to_glyph_init): Updated.
- * src/roff/troff/uniuni.cpp (unicode_decompose_list): Use `const'
- for `value'.
- (unicode_decompose_init::unicode_decompose_init): Updated.
- * src/roff/troff/glyphuni.cpp (glyph_to_unicode_list): Use `const'
- for `value'.
- (glyph_to_unicode_init::glyph_to_unicode_init): Updated.
- * src/roff/troff/input.cc (process_startup_file): Add `const' to
- argument.
+2020-10-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Report program name in warning
+ diagnostics.
- * tmac/hyphenex.sh: Make script more portable by using a here
- document.
+ Continues the long process of fixing Savannah #52463.
-2003-04-15 Werner LEMBERG <wl@gnu.org>
+2020-10-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- Renamed all `*.cc' files to `*.cpp'.
- Updated all configuration files, makefiles, and documentation.
+ * tmac/an-old.tmac: Add fallback for lq, rq strings.
-2003-04-14 Werner LEMBERG <wl@gnu.org>
+ Define \*(lq and \*(rq as '"' if the output device has no \(lq
+ or \(rq special character escapes defined (respectively).
- * tmac/hyphenex.sh: Slight improvements.
+ This is a bit belt-and-suspenders for groff since our output
+ devices all guarantee availability of these glyphs, but if this
+ macro file gets used with other implementations (and if they
+ support the 'c' conditional), it should prevent the strings from
+ producing empty output.
-2003-04-13 Werner LEMBERG <wl@gnu.org>
+ Man page writers should simply use \(lq and \(rq unless they are
+ aiming for pathological levels of portability (e.g., composing
+ man pages today for consumption on simulators of 1980s Unix
+ systems).
- * font/devascii/R.proto, font/devcp1037/R.proto,
- font/devlatin1/R.proto, font/devutf8/R.proto: Fill up remaining
- character slots with unnamed glyphs.
+2020-10-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/an-old.tmac: Fix hyphenation value if `cR' is active.
- (an-first): New global variable.
- (an-header): Emit vertical space between multiple man pages.
+ * tmac/an-old.tmac: Define an-end with .de1. We need to define
+ an-end with de1 (execute macro with compatibility mode off)
+ because, as of 37b4180a27a6eeaea429e40ec278abefcda7f3a7 (11
+ October), it can now be called from a trap executing in a
+ context whence compatibility mode might be on (namely,
+ "reload-doc" in andoc.tmac).
-2003-04-11 Werner LEMBERG <wl@gnu.org>
+2020-10-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo, man/groff_out.man: \S only accepts integer
- values.
+ * src/preproc/eqn/main.cpp (main):
+ * src/preproc/pic/main.cpp (main):
+ * src/preproc/tbl/main.cpp (main):
+ * tmac/eqnrc:
+ * tmac/troffrc: Perform checks of register and macro definitions
+ with a .do request, since we might be in compatibility mode.
-2003-04-10 Werner LEMBERG <wl@gnu.org>
+2020-10-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * PROBLEMS: Revised.
+ * src/roff/troff/input.cpp (do_if_request): Emit warning of type
+ "syntax" if a groff conditional expression extension is used
+ when compatibility mode is active.
-2003-04-10 Bernd Warken <bwarken@mayn.de>
+ * doc/groff.texi:
+ * src/roff/troff/troff.1.man: Update description of "syntax"
+ warning type to be more general. It was inaccurate, referring
+ only to "dubious syntax in numeric expressions", which was not
+ the case. Instead it was being used only for poor construction
+ of character classes with the .class request.
- * doc/webpage.ms: Improved.
+2020-10-16 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-04-09 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/tbl/main.cpp (main): Stop ignoring -T. GNU tbl
+ was undocumentedly ignoring the -T option; apparently IRIX tbl
+ implemented it, something on the system called tbl with that
+ option (I'm guessing IRIX's man(1)) and its users spammed James
+ Clark with bug reports. We can probably weather the volume of
+ such spurious reports from IRIX users today.
- Add register \n[.height] which returns the value of \H.
- Add register \n[.slant] which returns the value of \S.
+2020-10-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/env.cc (init_env_requests): Implement.
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo:
- Document.
+ * src/preproc/tbl/main.cpp (main): Clarify fatal diagnostic in
+ generated document by informing the user that the program is
+ aborting, and also that it is groff extensions that are required
+ rather than GNU troff per se (since Heirloom Doctools troff
+ claims groff extension support via the .g register).
-2003-04-08 Werner LEMBERG <wl@gnu.org>
+2020-10-14 Ingo Schwarze <schwarze@openbsd.org>
- * tmac/html.tmac: Move some of the data into html-end.tmac.
- Remove most of the character translations for eqn since html fonts
- now cover those characters.
- Load www.tmac.
- * tmac/html-end.tmac: New file.
- * tmac/troffrc: Load html.tmac not www.tmac for -Thtml.
- * tmac/troffrc-end: Load html-end.tmac not html.tmac for -Thtml.
- * tmac/Makefile.sub (NORMALFILES): Add html-end.tmac.
+ In groff(1), fix the combination of -v with -k, -j, and -J.
-2003-04-07 Werner LEMBERG <wl@gnu.org>
+ * src/roff/groff/groff.cpp: Pass the -v option through to the
+ preconv, chem, and ideal preprocessors, just like for all
+ other preprocessors, to print the version of the preprocessor
+ and to avoid garbage output.
- * man/groff_out.man: Document negative values of `N' if -Thtml is
- used.
+ Bugfix patch from Eli Zaretskii <eliz at gnu dot org>
+ submitted in: https://savannah.gnu.org/bugs/?55297
-2003-04-06 Werner LEMBERG <wl@gnu.org>
+2020-10-12 Bertrand Garrigues <bertrand.garrigues@laposte.net>
- * Makefile.comm (depend.temp): Check location of YTABC.
+ Update 'gnulib' submodule.
-2003-04-05 Maciej W. Rozycki <macro@ds2.pg.gda.pl>
+ * gnulib: now points on d60a35e94c4f5b8f09f15828242418f5073d46e7
+ from 'gnulib' repository.
- * doc/Makefile.in (TROFFBIN): New variable for troff
- binary path.
- (GROFFBIN): New variable for groff binary path.
- (groff_bin_path): Rename to GROFF_BIN_PATH.
- (TROFF): Use TROFFBIN.
- (GROFF): Use GROFFBIN and GROFF_BIN_PATH.
- * doc/Makefile.sub (GROFFBIN): New variable for groff
- binary path.
- (groff_bin_path): Rename to GROFF_BIN_PATH.
- (GROFF): Use GROFFBIN and GROFF_BIN_PATH.
+ * configure.ac: minimum autoconf version is now 2.64 due to
+ gnulib upgrade.
- * Makefile.comm (install_dev): Install scripts from DEVSCRIPTS
- with INSTALL_SCRIPT.
- (uninstall_dev): Uninstall scripts from DEVSCRIPTS.
- * Makefile.dev (all): Depend on DEVSCRIPTS.
- (install_dev): Likewise.
- * font/devdvi/Makefile.sub (DEVSCRIPTS): New variable to hold
- scripts.
- * font/devps/Makefile.sub (DEVSCRIPTS): Likewise.
- (DEVGENSCRIPTS): New variable to hold generated scripts.
+ * FOR-RELEASE: add the gnulib update to the checklist.
-2003-04-05 Werner LEMBERG <wl@gnu.org>
+2020-10-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/input.cc (IntArray::operator[],
- IntArray::get_data): Remove meaningless `const' in return value.
+ * tmac/andoc.tmac: When switching between macro packages in
+ andoc and using continuous-rendering mode, flush any partially
+ collected output line and write page footer.
+ (reload-doc): Call an-end if it is defined.
+ (reload-man): Call doc-end-macro if it is defined.
+ * tmac/tests/andoc-flush-between-packages.sh: Add regression
+ test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * README.CVS: New file.
+ Fixes <https://savannah.gnu.org/bugs/?59106>.
-2003-04-04 Werner LEMBERG <wl@gnu.org>
+2020-10-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- Check for stdint.h in C++, not in C.
+ * tmac/andoc.tmac: Remove traps set by mdoc package by the names
+ they actually use.
+ * tmac/tests/andoc-clear-doc-traps.sh: Add regression test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * aclocal.m4 (GROFF_STDINT_H): New function,
- * configure.ac: Check for stdint.h with GROFF_STDINT_H instead of
- AC_CHECK_HEADERS.
- * configure, src/include/config.hin: Regenerated.
- * src/libs/libgroff/tmpname.cc: Use HAVE_CC_STDINT_H.
+ Fixes <https://savannah.gnu.org/bugs/?59246>.
+2020-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- Fix handling of in grohtml. To do this, troff emits `N'
- with a negative value, representing the width of the unbreakable
- space (only for -Thtml). grohtml then converts this back to
- and uses the value of N as its width.
+ * src/preproc/tbl/table.cpp (table::init_output): In the release
+ macro written to the output, reword the warning diagnostic that
+ is emitted when a table row is to be output without enough room
+ before the next page location trap. The former wording said
+ that a "text block" would not fit on the page, and that is
+ normally how table rows grow longer than one line in the first
+ place. However, there are other ways the conditional can be
+ satisfied, as witnessed in Savannah #57665, so simply say what
+ is known; that the table _row_ overruns the space to the next
+ trap (we say the row won't "fit on [the] page").
- * src/roff/troff/node.cc (space_char_hmotion_node::tprint,
- unbreakable_space_node::tprint): Emit `N-<width>'.
- * src/include/printer.h (printer::set_numbered_char): Make it
- virtual.
- Make members `font_table' and `nfonts' protected instead of private.
- * src/devices/grohtml/post-html.cc
- (html_printer::set_numbered_char): New member function.
+ Fixes <https://savannah.gnu.org/bugs/?59233>.
+2020-10-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/maxfilename.cc:
- s/HAVE_LIMITS_H/HAVE_CC_LIMITS_H/.
+ * src/preproc/tbl/table.cpp
+ (double_line_entry::double_line_entry):
+ (double_line_entry::simple_print): Remove garbage lines
+ inadvertently added in previous commit.
- * src/roff/troff/node.cc (unbreakable_space_node::tprint): Don't
- emit word marker.
+2020-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-04-03 Sergey A. Osokin <osa@freebsd.org.ru>
+ Stop tbl from injecting spurious blank lines (and emitting
+ spurious warnings about tables and "text blocks" not "fitting on
+ a page") into long tables in man pages when continuous rendering
+ is used (the default for nroff output devices).
- * man/roff.man: Small fixes.
+ * src/preproc/tbl/table.cpp (USE_KEEPS_REG): New preprocessor
+ symbol stores name of groff register for dynamic determination
+ of keep usage.
+ (table::init_output): If the NOKEEP flag is not set, then in
+ generated groff output, see if the usekeeps register is defined;
+ if not, define it and enable usage of keeps.
+ (table::do_row): In groff output, check usekeeps register before
+ calling keep and release macros.
+ (table::do_bottom): In groff output, check usekeeps register
+ before calling release macro.
-2003-04-03 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-old.tmac (TS): Set the usekeeps register used by tbl
+ to the logical complement of the man(7) cR (continuous
+ rendering) register.
- Make groff independent from locale's numeric settings.
+ * tmac/tests/an-old_TS_do_not_keep_tables_when_cR_set.sh: Add
+ regression test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * configure.ac: Check for `setlocale'.
- * configure, src/include/config.hin: Regenerated.
+ Problem appears to date back to the introduction of continuous
+ rendering in groff 1.17 (3 May 2001).
- * src/include/lib.h: Handle HAVE_SETLOCALE.
+ Fixes <https://savannah.gnu.org/bugs/?57665>.
- * src/devices/grodvi/dvi.cc (main), src/devices/grolj4/lj4.cc
- (main), src/devices/grops/ps.cc (main), src/preproc/grn/main.cc
- (main), src/preproc/pic/main.cc (main): Call `setlocale'.
+2020-10-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+ * src/preproc/tbl/table.cpp (simple_entry::position_vertically):
+ (block_entry::position_vertically):
+ (table::determine_row_type):
+ (printfs): Update assertions to indicate what actually went
+ wrong.
- * doc/groff.texinfo: Change dir category to `Typesetting'.
- (Man font macros): Mention that there is no space between arguments
- of .BI and friends.
+2020-10-02 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/printer.cc, src/devices/grotty/tty.cc
- (*printer::change_color, *printer::change_fill_color): Add missing
- `const'.
+ * src/roff/troff/node.cpp: Make diagnostics slightly more
+ informative in unusual error cases.
+ (real_output_file::~real_output_file): If ferror() reports error
+ status on a stream say that, instead of "error writing". If it
+ does not, but fflush() fails on the stream, describe the flush
+ as failing, and use strerror() since fflush() sets errno. If
+ pclose() fails, say that we were unable to close a pipe instead
+ of repeating the name of the C library function to the user, who
+ might not be a C programmer. Report strerror() in this case and
+ for a failing fclose().
+ (real_output_file::flush): Repeat updated fflush() logic from
+ previous function.
+
+2020-09-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (register setup): Make interaction of \n[C]
+ register and HTML output more clear in code and comments.
+
+2020-09-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/regression_savannah_59202.sh: Reduce test
+ case.
-2003-04-02 Werner LEMBERG <wl@gnu.org>
+2020-09-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/html-table.cc (html_table::emit_col,
- html_table::is_gap): Compute table widths after converting border
- positions to avoid rounding errors.
+ Fix SEGV arising from recursing destructor.
-2003-04-01 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/node.h (output_file): Add class member
+ `is_dying` to track whether destructor has already been entered;
+ initialize false.
+ * src/roff/troff/node.cpp (real_output_file::~real_output_file):
+ Set `is_dying` true when destructor entered.
+ * src/roff/troff/div.cpp (cleanup_and_exit): Only delete
+ `the_output` object if it is not already being destroyed.
+ * src/roff/groff/tests/regression_savannah_59202.sh: Add test.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * src/devices/grohtml/html-text.cc (html_text::do_space): Handle
- `space_emitted' properly.
+ Thanks to "hackerb9" for reporting the problem. Problem appears
+ to date back to groff 1.02 (June 1991) or earlier.
+
+ Fixes <https://savannah.gnu.org/bugs/?59202>.
+
+2020-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-31 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-old.tmac (register setup): Condition decisions on
+ \n[an-html] rather than a string comparison using \*[.T]; that
+ is what the register is there for.
- * src/devices/grohtml/html-table.cc: Fix column width calculation.
- (html_table::set_linelength): Don't add 1.
- (html_table::add_indent): Don't subtract 1.
+2020-09-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/html.tmac: Set default page offset to zero.
+ * tmac/andoc.tmac: Save alias to .ne request.
+ (reload-doc): Restore .ne request, which an-old.tmac meddles
+ with if continuous rendering is used. (The meddling ultimately
+ dates back to 777e2d262862621966c18d685a000cc88f432bc6, 26
+ January 2002, which simply redefined .ne as empty on nroff
+ devices.)
+
+2020-09-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Ship tests in distribution archive.
+
+ * src/preproc/preconv/preconv.am (EXTRA_DIST):
+ * src/roff/groff/groff.am (EXTRA_DIST):
+ * src/roff/nroff/nroff.am (EXTRA_DIST):
+ * tmac/tmac.am (EXTRA_DIST): Add
+ $({preconv,groff,nroff,tmac}_TESTS), as appropriate.
+
+ * src/roff/nroff/nroff.am (MOSTLYCLEANFILES): Stop adding
+ $(nroff_TESTS), which can only have unhappy consequences.
+
+2020-09-27 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-30 Werner LEMBERG <wl@gnu.org>
+ * tmac/tmac.am: Fix problem with recently-relocated mdoc macro
+ files not ending up in the right place in the distribution
+ archive.
+ (dist_tmac_DATA): Also include $(TMACUNSTRIPFILES).
+ (TMACMDOCSTRIPFILES): Rename from $(TMACMDOCFILES). Update
+ interpolation sites.
+ (TMACMDOCUNSTRIPFILES): New variable holds mdoc macro files in
+ the tmac/mdoc subdirectory. Stop adding these files to
+ $(TMACUNSTRIPFILES) since those reside in tmac/ directly.
+ (EXTRA_DIST): Add $(TMACMDOCUNSTRIPFILES).
+ ($(TMACSTRIPFILES)): Depend only on $(TMACUNSTRIPFILES).
+ ($(TMACMDOCSTRIPFILES)): Add new rule, much like the foregoing.
+ Depend on $(TMACMDOCUNSTRIPFILES) and copy files into tmac/mdoc.
+ (dist-hook, tmac-dist-hook): Remove; they no longer do any
+ distinct work.
- Make groff emit ` ' for `\ ' and `\~' if `-Thtml' is used.
+ Fixes <https://savannah.gnu.org/bugs/?59186>.
- * src/roff/troff/node.cc (space_char_hmotion_node::tprint,
- unbreakable_space_node::tprint): New functions.
- (troff_output_file): Make space_char_hmotion_mode::tprint and
- unbreakable_space_node::tprint to friends.
- * src/roff/troff/node.h: Updated.
+2020-09-26 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devhtml/R.proto: Add ` ' at position 0xA0 (as defined
- in the HTML standard).
+ * src/preproc/tbl/table.cpp (table::init_output):
+ (table::compute_expand_width):
+ (table::compute_separation_factor): Use consistent format for
+ diagnostic messages.
+ - Do not spread a single diagnostic across multiple lines.
+ - Report messages in GNU Coding Standards format, that is:
+ - Report the name of the file the problem is in...
+ - ...then the line number...
+ - ...then the diagnostic severity level...
+ - ...then the specific problem.
+
+2020-09-26 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac: Emit warnings when configuration registers
+ are ignored when producing output for HTML.
-2003-03-29 Werner LEMBERG <wl@gnu.org>
+2020-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/env.cc (point_size): Fix emission of html tag.
- Otherwise, the following code
+ * tmac/an-old.tmac (an-p-footer): Define \*[an-page-string] if
+ (1) the output device is not HTML; (2) \n[X] has been defined;
+ and (3) the page number has not yet reached the threshold
+ defined by \n[X].
- .di xxx
- .ps 10
- a
- .br
- .di
- x\*[xxx]
+ Fixes <https://savannah.gnu.org/bugs/?59179>.
+
+2020-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Add regression test for Savannah #59179.
+
+ * tmac/tests/an-old_X_register_works.sh: Do it.
+ * tmac/tmac.am (tmac_TESTS): Run it.
+
+2020-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac:
+ * tmac/doc.tmac-u: Emit more informative fatal diagnostic when
+ installed version of groff is too old. Report the version found
+ and explicitly note consequent abort.
+
+2020-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tmac.am: Regenerate stripped macro files upon changes to
+ any of their unstripped counterparts. This is crude, but they
+ weren't being regenerated at _all_. Defeating a central
+ function of Make is bad.
+ (TMACUNSTRIPFILES): New variable. Populate with -u files.
+ ($(TMACMDOCFILES) $(TMACSTRIPFILES)): Depend on
+ $(TMACUNSTRIPFILES).
+
+2020-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac:
+ * tmac/andoc.tmac:
+ * tmac/doc.tmac-u:
+ * tmac/s.tmac: Clarify fatal diagnostics by informing the user
+ that the program is aborting.
+
+2020-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/www.tmac.in: Revise diagnostic message handling.
+ (www:fatal): New macro handles fatal macro usage errors.
+ (www:lenstr): Use www:fatal instead of writing to standard error
+ with .tm (rather than www:error) and then calling .ab without
+ arguments, which produces an unsightly "User Abort." message.
+ (www:lenstr):
+ (www:splitstr):
+ (www:url_breaks):
+ (www:url_breaks_split):
+ (LINKSTYLE): Report expected number of arguments in diagnostics.
+ (www:fontstyle): Shorten diagnostic message.
+
+2020-09-25 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/div.cpp
+ (top_level_diversion::clear_diversion_trap): Fix copy and paste
+ error in diagnostic, which wrongly reported that a top-level
+ diversion trap couldn't be "set" when "clear"ed was meant.
+
+2020-09-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/preproc/grn/main.cpp (conv):
+ * src/roff/troff/node.cpp (suppress_node::tprint): Remove
+ embedded newlines from diagnostic messages.
+
+2020-09-18 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac: Move setup of remaining rendering option
+ parameters (registers C, D, P, and X) to end of file.
+
+2020-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (TH): Move setup of rendering parameter
+ registers IN and SN from here to the end of the file. Update
+ comments.
+
+2020-09-17 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac: Drop \*[an-empty] string. This string is
+ documented as preventing "looping" (presumably infinitely) if
+ someone calls a two-font macro with an inconvenient parameter;
+ the example shown is ".RB ( \\ )". This string was being
+ interpolated at the end of each argument pair to the two-font
+ macros BI, BR, IB, RB, and RI. This code dates back to groff
+ 1.10 (dc5351364982f78f8c630f1e856d692d4a82666f, 26 November
+ 1995). Did you notice a two-font macro missing? It was: IR.
+ Using it with the proscribed input fails to cause a problem; the
+ others similarly operate just fine when the empty string
+ interpolation is removed. Presumably at some point in the past
+ 25 years, this workaround became unnecessary.
+ (BI, BR, IB, RB, RI): Remove interpolations of string.
+
+ * tmac/tests/an-old_avoid_two-font_denial_of_service.sh: Add
+ regression test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+
+2020-09-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac: Refactor continuous rendering handling.
+ Relocate set up of \n[cR] to end of file in parallel with other
+ rendering parameter management. Instead of conditionally
+ defining the an-ne and an-bp macros, define them
+ unconditionally. Also define them with .de instead of .de1,
+ since they will only be called within the contexts of macros
+ that are already running with compatibility mode off (i.e., the
+ public interface macros). Relocate definition of an-end to sit
+ alongside these other continuous-rendering-mode specific macros
+ and avoid a forward reference and scattering of \n[cR]
+ conditionals around the file.
+ (an-set-up-continuous-rendering): Define new macro to move
+ macros (and end macro) into place. Call it at the end of the
+ file only if cR eventually winds up being true.
+
+2020-09-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac: Improve name space management. Rename .ne
+ request to .an-ne instead of outright clobbering it (and in
+ parallel with .an-bp). Rename 'an-ne' register to 'an-need' to
+ prevent confusion with renamed request.
+
+2020-09-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac: Drop .ll hack for LL register.
+
+ Drop the .ll hack for setting the line length on nroff devices.
+
+ Once upon a time, the only way to get man pages to render on a
+ terminal at any width other than the nroff default of 65n was to
+ put an .ll request into the page--a mortal sin against
+ portability--or your man(1) program could sneak such a request
+ into nroff's input stream.
+
+ Also, long ago, John Eaton of UT Austin wrote a man(1) program.
+ In a few years this implementation branched into two lines of
+ development, which I'll call man-db man (Wilford/Polacco/Watson)
+ and another, Brouwer/Lucifredi man, which as of this writing saw
+ its last release in 2011 (1.6g).
+
+ The man and mdoc macros of groff 1.18 (July 2002) introduced an
+ LL register to configure the line length, respecting an -rLL
+ command-line option. The source change was made by Werner
+ Lemberg on 3 May 2002 and Colin Watson updated man-db man(1)--on
+ the same day!--to synthesize the option when calling groff.
+
+ Later, in August 2005, Keith Marshall, a user of version 1.5m of
+ Brouwer/Lucifredi man(1), which did not set the LL register,
+ suggested that the existing .ll setting (technically, the value
+ of \n[.l], the only way the result of an .ll request could be
+ introspected) be honored in the absence of the LL register.
+ However, it is impossible to distinguish a user-supplied ".ll
+ 65n" request from nroff's default setting, which was in that
+ case overridden to the modern default of 78n.
+
+ And so, in what is now git commit
+ f9d5df4aebd3d834b4084ffefa52a115e00dce38 (1 September 2005), it
+ was done.
+
+ This led to (1) surprising behavior for users accustomed to old
+ methods and desirous of the nroff default and (2) lengthy
+ apologia in groff source code comments and the groff_man(7) man
+ page.
+
+ Ironically, Brouwer/Lucifredi man(1) had already added support
+ for the LL register by the time of its 1.6 release two months
+ earlier (20 June 2005). (Curiously, it did so similarly to the
+ old .ll hack, by injecting an '.nr LL' request into groff's
+ input stream, rather than using the -r command-line option.)
+ Moreover, Marshall and the groff list were already aware of
+ this, but the change was accepted anyway because version 1.6
+ was "too new"! (Distributions are slow sometimes, true...)
+
+ Let us survey the field in 2020. man-db man(1) has supported
+ the LL register for eighteen years, and Brouwer/Lucifredi man(1)
+ for fifteen. Heirloom Doctools's man macros set the line length
+ to 78n on nroff devices unconditionally. mandoc(1) similarly
+ also always formats for 78 columns on terminals. groff's
+ mdoc(7) macros grew support for LL in parallel with man(7) in
+ 2002 and never added the \n[.l] introspection at all.
+
+ There no longer seems to be any reason to preserve this hack.
+
+ * tmac/an-old.tmac (initialization): Drop complex setup of LL
+ register.
+ (TH): Relocate line length reset; no behavior change.
+ (after .mso man.local): Initialize LL only if the user hasn't;
+ use device default in troff mode, and 78n in nroff mode.
- produces `x a' instead of `xa'. This is a temporary fix, disabling
- font changes in diversions for -Thtml.
+ * tmac/groff_man.7.man.in (Options) <-rLL>: Stop documenting .ll
+ hack.
- * tmac/an-old.tmac (TH, SH): Use `HTML-TAG-NS' instead of
- `HTML-TAG'.
- (an-do-tag-html): Merge with ...
- (an-do-tag): This macro.
- Change code slightly to circumvent grohtml bug.
- * tmac/troffrc-end: Define dummy for HTML-TAG-NS.
+ Fixes <https://savannah.gnu.org/bugs/?58992>.
- * src/devices/grohtml/html-table.cc (html_table::emit_col,
- html_table::is_gap): Round `width' properly.
+2020-09-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/html.tmac: Provide some default layout parameters for
- grohtml.
+ * tmac/tests/an-old_LL_init_sanely.sh: Add test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * font/devhtml/DESC.proto: Don't use discrete values for `sizes'
- command.
+2020-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-28 Werner LEMBERG <wl@gnu.org>
+ * src/devices/xditview/GXditview.ad: Widen the default geometry
+ to accommodate the width of a page rendered using the X100-12
+ device. Display devices these days have much greater horizontal
+ resolution than they did 20 years ago.
- src/devices/grops/ps.cc (ps_printer::do_import): Fix error message.
+2020-09-14 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-27 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-old.tmac: Use correct point size default for
+ X{75,100}-12 devices.
- * tmac/an-old.tmac (BT): Don't call .tl if register `ps4html' is
- defined.
+2020-09-14 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-20 Werner LEMBERG <wl@gnu.org>
+ * tmac/mdoc/doc-common-u (doc-prepare-section-heading): New
+ macro defines new string doc-sec-head to enable recognition of
+ mixed-case section headings in mdoc man pages. For example,
+ "Name" and "Description" are now recognized in addition to
+ "NAME" and "DESCRIPTION".
+ (doc-section-{name,synopsis,library,description,see-also,files,
+ authors}): Redefine strings to be mixed-case. Add trailing
+ comment guard per recommended best practice.
+ (Sh): Call doc-prepare-section-heading instead of
+ doc-first-parameter, and compare predefined section strings to
+ doc-sec-head instead of doc-str-dfp.
- * src/roff/troff/env.cc (vertical_spacing): Allow zero value for
- `.vs'.
- * doc/groff.texinfo: Updated.
+ * tmac/tests/doc-accept-mixed-case-section-headings.sh: Test it.
+ * tmac/tmac.am (tmac_TESTS): Run test.
+ * tmac/tests/doc-smoke-test.sh: Use mixed-case section headings.
-2003-03-19 Werner LEMBERG <wl@gnu.org>
+2020-09-03 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cc (process_input_stack) <TOKEN_BEGIN_TRAP,
- TOKEN_END_TRAP>: Reset `have_input'.
+ * makevarescape.sed: Use \[] form of special character escapes.
-2003-03-18 Werner LEMBERG <wl@gnu.org>
+ The only man page we have that doesn't turn compatibility mode
+ off (neqn) also doesn't use any sed-substituted patterns where
+ characters replaced by a \[] special character escape form are
+ likely to be used.
- * src/roff/groff/groff.man: Mention groff_trace man page.
+ The @g@ command prefix is the main avenue for intrusion of such
+ escapes, but I think it improbable that many people are going to
+ include apostrophes, double quotes, carets, grave accents, or
+ tildes in the command prefix; some or all of these will pick
+ fights with the shell and require quoting that we don't
+ represent in man page text anyway.
-2003-03-16 Werner LEMBERG <wl@gnu.org>
+ On top of that, neqn is largely a stub page.
- * Makefile.in (LIBEXT): New variable to indicate the file extension
- of library files. Computed heuristically from $(OBJEXT).
- (MDEFINES): Add $(LIBEXT).
- * Makefile.lib, Makefile.comm: Use it.
+ If it's a problem, a better fix than reverting this is to make
+ neqn switch out of compatibility mode like our other man pages.
- * src/utils/pfbtops/pfbtops.c (get_text): New function. Split
- overlong lines into smaller chunks.
- (get_binary): New function.
- (main): Use them.
- * src/utils/pfbtops/pfbtops.man: Updated.
+2020-09-03 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-15 Colin Watson <cjwatson@debian.org>
+ * FOR-RELEASE: Start a release checklist. We probably should
+ have done the afmtodit.tables update for 1.22.4. There were no
+ AGL changes and the Unicode decomposition changes were limited
+ to additions for Balinese (11), CJK compatibility ideographs
+ (5), and 13 code points outside the Basic Multilingual Plane.
- * src/roff/groff/groff.man: Minor syntax fix.
+2020-09-02 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-14 Egil Kvaleberg <egil@kvaleberg.no>
+ * src/utils/afmtodit/afmtodit.tables: Regenerate using Unicode
+ 13.0.0.
- * src/devices/grops/ps.cc (ps_printer::media_set,
- ps_printer::~ps_printer): Handle zero paper width and length.
+2020-09-02 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-13 Werner LEMBERG <wl@gnu.org>
+ make-afmtodit-tables: Automate AGL reassignments.
- Add options -p and -l to grodvi.
+ Automate the procedure done manually in
+ b72b91e85e80a69304e6569db535bcca0e0ecab5 (9 April 2007), so that
+ it doesn't regress when we regenerate afmtodit.tables.
- * src/devices/grodvi/dvi.cc: Include paper.h.
- (landscape_flag, user_paper_length, user_paper_width): New global
- variables.
- (dvi_printer::begin_page): Emit `papersize' special.
- Set color after initialization of `cur_h' and `cur_v'.
- (main): Add options `-l' and `-p'.
- * font/devdvi/Makefile.sub (DESC): Set `papersize'.
- * src/devices/grodvi/grodvi.man, NEWS: Updated.
+ * src/utils/afmtodit/make-afmtodit-tables: Do it.
+ * src/utils/afmtodit/afmtodit.tables: Regenerate it.
- * src/devices/grops/psrm.cc (valid_input_table): Fixed.
+2020-09-02 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-12 Werner LEMBERG <wl@gnu.org>
+ * src/roff/groff/groff.1.man (Options) <-E>:
+ * src/roff/troff/troff.1.man (Options) <-E>: Document that -E
+ implies -Ww.
- * src/devices/grops/grops.man: Move documentation of .PSPIC to...
- * man/groff_tmac.man: This man page.
- * man/groff_font.man: Declare `paperwidth' and `paperlength' as
- deprecated.
+ Fixes <https://savannah.gnu.org/bugs/?59030>.
- * tmac/X.tmac: Don't load pspic.tmac.
+2020-09-01 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-11 Werner LEMBERG <wl@gnu.org>
+ * man/groff_char.7.man: Revise glyph descriptions.
- Make variable `pr' local to libdriver/input.cc. Based on a patch
- by Bernd Warken <bwarken@mayn.de>.
+ Fixes <https://savannah.gnu.org/bugs/?59031>.
- * src/include/driver.h (pr): Removed.
+2020-09-01 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/input.cc (pr): New global variable.
- (do_file): Deallocate `pr'.
- * src/libs/libdriver/printer.cc (pr): Removed.
+ * tmac/tty.tmac: Define fallback glyphs for Bell System logo
+ {non-breaking adjustable space} and radical extension and square
+ root extension (both dummy characters '\&') to suppress warnings
+ from groff_char(7). As none of these are encoded in Unicode it
+ seems unlikely they will become supported soon.
- * src/devices/grodvi/dvi.cc (main), src/devices/grohtml/post-html.cc
- (main), src/devices/grolbp/lbp.cc (main), src/devices/grolj4/lj4.cc
- (main), src/devices/grops/ps.cc (main), src/devices/grotty/tty.cc
- (main): Don't delete `pr'.
+2020-08-30 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-10 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/troff.1.man (Options) <-I>: The current working
+ directory is searched _last_, not first, unless the order is
+ altered with "-I .".
- * tmac/a4.tmac, tmac/composite.tmac: Use `.do'.
- * tmac/papersize.tmac: New file.
- * tmac/troffrc: Include `papersize.tmac'.
- * tmac/Makefile.sub (NORMALFILES): Add `papersize.tmac'.
- * tmac/an-old.tmac: Set LT to LL by default.
+ * src/roff/groff/groff.1.man (Options) <-I>: Rearrange
+ description.
- * NEWS, MANIFEST, tmac/groff_man.man, man/groff_tmac.man,
- doc/groff.texinfo: Updated.
+2020-08-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/paper.cc (add_iso_paper): Fix very embarassing
- bug which caused all odd iso papers to have wrong dimensions.
+ Update mdoc package to honor HY register as man does now, per
+ suggestion from Colin Watson. Recognize but ignore AD string
+ for man package compatibility (essentially "reserving" it),
+ though mdoc intentionally does not permit configuration of
+ adjustment.
- * src/devices/grops/ps.cc (user_paper_width): New global variable.
- (main) <'p'>: Set `user_paper_width' also.
- (ps_printer::media_width, ps_printer::media_height): Use values
- given with option `-p'.
+ * tmac/mdoc/doc-ditroff-u:
+ * tmac/mdoc/doc-nroff-u: Do it.
-2003-03-09 Werner LEMBERG <wl@gnu.org>
+ * tmac/mdoc/doc-common-u: Initialize \n[doc-hyphen-flags] from
+ \n[HY].
- * src/include/nonposix.h: Provide default for SET_BINARY.
+ * tmac/groff_mdoc.7.man \
+ (FORMATTING WITH GROFF, TROFF, AND NROFF): Document it.
- * src/devices/grodvi/dvi.cc, src/devices/grolbp/lbp.cc,
- src/devices/grolj4/lj4.cc, src/devices/grops/ps.cc: Call SET_BINARY
- unconditionally.
+2020-08-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/pfbtops/pfbtops.c: Call SET_BINARY unconditionally.
- (main): Treat \r\n as \n.
+ * tmac/an-old.tmac (TH): Reset inter-word and inter-sentence
+ spacing to default with each new page rendered.
-2003-03-08 Werner LEMBERG <wl@gnu.org>
+ {To observe the problem prior to this change,
+ $ groff -mandoc groff_mmse.7 $any_other_man_page
+ groff_mmse(7) loads sv.tmac, which changes the sentence
+ spacing.}
- * tmac/an-old.tmac: Use register `HY' to control hyphenation.
- * NEWS, tmac/groff_man.man, doc/groff.texinfo: Document it.
+2020-08-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-07 Werner LEMBERG <wl@gnu.org>
+ * PROBLEMS: Undocument the problem with test-groff and mdoc.
+ It's resolved.
- Added support to access more than 256 glyphs in Type 1 fonts.
+ Fixes <https://savannah.gnu.org/bugs/?51073>.
- * src/devices/grops/ps.cc (subencoding): New structure.
- (style): Add `sub' field.
- Updated all users.
- (ps_printer): Add `subencodings' and `next_subencoding_index' fields.
- Add `set_subencoding', `get_subfont' and `encode_subfont' member
- functions.
- Updated all users.
- (ps_printer::set_char): Use `set_subencoding'.
- (make_subencoding_name): New function.
- (ps_printer::set_style): Handle case where `sty.sub' is not zero.
- (ps_printer::~ps_printer): Emit subencoding definitions.
+2020-08-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/psrm.cc (valid_input_table): New array to
- properly support EBCDIC.
- (white_space): Add `\f'.
- (ps_get_line): Change first argument to be of type `string &'.
- Updated all callers.
- This allows to get lines of arbitrary length.
- Use `valid_input_table'.
- Remove warning about non-conforming PS line length. This seems
- not to be of great importance -- for example, dvips don't emit
- a warning either.
- (PS_LINE_MAX): Removed.
- (matches_comment): Change first argument to be of type `string &'.
+ * tmac/tmac.am (NORMALFILES, MDOCFILES): Drop unused variables.
+ ($(TMACMDOCFILES) $(TMACSTRIPFILES)): Scrub trailing whitespace.
+ Wrap long line.
- * src/devices/grops/grops.man, src/devices/grops/TODO: Updated.
+2020-08-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/utils/afmtodit/afmtodit.pl (%unicode_decomposed,
- %AGL_to_unicode, %default_ligatures): New hash tables.
- Read all map entries.
- Add unencoded characters.
- Check for default ligatures if there are no `L' entries.
- Print all kern entries.
- Print all characters in charset.
- * src/utils/afmtodit/afmtodit.man: Updated.
+ mdoc: Relocate within build tree.
- * font/devps/*: Regerated all fonts.
+ The (modern) mdoc macro package has not been usable within the
+ build tree, unlike the others. This makes it more troublesome
+ to test changes, and frustrates deploying our test
+ infrastructure against it. Re-arrange the build tree to
+ resemble an installation tree closely enough for the macro
+ package to load.
- * tmac/latin[129].tmac, tmac/cp1047.tmac: Don't test for existence
- of characters, just use `.trin'. Otherwise the mapping depends
- on the font encoding.
- * tmac/ps.tmac: Add `fi' and `fl'.
- Improve `Fi' and `Fl'.
- * tmac/X.tmac, tmac/lbp.tmac, tmac/tty.tmac: Improve `Fi' and `Fl'.
- * tmac/Xps.tmac: Fix `em'.
+ * tmac/doc-common-u:
+ * tmac/doc-ditroff-u:
+ * tmac/doc-nroff-u:
+ * tmac/doc-syms-u: Rename to...
+ * tmac/mdoc/doc-common-u:
+ * tmac/mdoc/doc-ditroff-u:
+ * tmac/mdoc/doc-nroff-u:
+ * tmac/mdoc/doc-syms-u: ...these.
- * NEWS: Updated.
+ * tmac/tmac.am (TMACMDOCFILES): Look for files in tmac/mdoc.
+ ($(TMACMDOCFILES)): Create tmac/mdoc in build tree.
-2003-03-04 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?51003>.
- * src/roff/troff/input.cc (charinfo_to_node_list): Reset
- `have_input'.
+2020-08-25 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-03 Werner LEMBERG <wl@gnu.org>
+ Add regression test for usable in-tree mdoc.
- * Makefile.sub (DISTCLEANFILES): Add gxditview._man.
+ * tmac/tests/doc-smoke-test.sh: Add test.
+ * tmac/tmac.am (tmac_TESTS): Run test.
- * font/devps/generate/textmap: Remove entry `similarequal'.
- * font/devps/symbolmap: Updated.
+2020-08-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-02 Werner LEMBERG <wl@gnu.org>
+ * tmac/tests/an-old_TH_repairs_ad_damage.sh:
+ * tmac/tests/an-old_TH_repairs_hy_damage.sh: Add tests.
+ * tmac/tmac.am (tmac_TESTS): Run tests.
- * src/libs/libgroff/font.cc (font::load): Fix error message for
- bad character type.
+2020-08-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/grops.man: Improve documentation of the -b
- flag.
+ * tmac/an-old.tmac (TH): Set hyphenation mode to user preference
+ with each new page rendered, in case a hostile page meddled with
+ '.hy' or '.nh'.
+ (after .mso man.local): Relocate setting of default hyphenation
+ mode here (instead of just before .mso man.local). Eliminate
+ conditional on \n[an-html]; this doesn't matter because
+ grohtml(1) doesn't support hyphenation anyway. If it does learn
+ to hyphenate, we should treat it the same as other output
+ devices in any case. Add comment explaining why we fall back to
+ different defaults depending on \n[cR].
- * tmac/tty.tmac: Load latin1.tmac for all TTY devices except
- `ascii' and `cp1047'.
+2020-08-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-03-01 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-old.tmac (TH): Set adjustment to user preference with
+ each new page rendered, in case a hostile page meddled with
+ '.ad' or '.na'.
+ (after .mso man.local): Set the default adjustment mode only if
+ a -d option or man.local did not. Also do the same for the HF
+ string; relocate its definition here and make it similarly
+ conditional. Also update comment on setting of CS and CT
+ registers and style their conditionals consistently with the
+ rest of the package.
+
+ * tmac/groff_man.7.man.in (Strings) <\*(AD>: Document it.
+ (Strings) <\*(HF>: Parallelize language with new \*(AD.
+ (Options) Expand introductory sentence to discuss -d and -r
+ options.
+ (Options) <-dAD>: Document default and likely values. Nobody
+ right-justifies or centers man page text; send the curious to
+ groff(7) for '.ad' request documentation.
+ (Options) <-dHF>: Document default and steer people to groff(7)
+ for '.ft' request documentation.
+
+2020-08-21 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-old.tmac (set-an-margin): Rename...
+ (an-set-margin): ...to this. It was the only package-internal
+ register, macro, string, or diversion that wasn't named using
+ the "an-*" schema.
+ (TH, SH, SS): Update call sites.
+
+2020-08-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/an-ext.tmac (.ME, .UE): Restore hyphenation after
+ "punctuation" arguments have been output. The next token will
+ always be a space node, the end of the document, or similar.
+
+ * tmac/tmac.am (tmac_XFAIL_TESTS): Mark the punctuation
+ hyphenation tests as expected to fail, because they now do.
+
+2020-08-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/ps.tmac: Define ordinary hyphen-minus as fallback
+ character for U+2011 (non-breaking hyphen). Prompted by
+ discussion with Dave Kemper in Savannah #58390.
+
+2020-08-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Fix hyphenation bug. The UR/UE and MT/ME macros were much too
+ aggressive about turning hyphenation off. Disable it only when
+ writing the actual URL or email address.
+
+ * tmac/an-ext.tmac (.MT, .UR): Stop disabling hyphenation here.
+ (.ME, .UE): Disable hyphenation right before output of
+ URL/address; restore it right before output of supplementary
+ arguments ("punctuation").
+
+ * tmac/tests/an-ext_ME_punct_hyphenates.sh:
+ * tmac/tests/an-ext_MT_body_hyphenates.sh:
+ * tmac/tests/an-ext_UE_punct_hyphenates.sh:
+ * tmac/tests/an-ext_UR_body_hyphenates.sh: Test behavior.
+
+ * tmac/tmac.am (tmac_TESTS): Run tests.
+
+2020-08-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Adapt to the fact that \: reënables hyphenation. Rename
+ "hyphenless [discretionary] break" to "non-printing break point"
+ in documentation.
+
+ * doc/groff.texi (Manipulating Hyphenation): Rename "hyphenless
+ break" to "non-printing break point". Clarify that it is the
+ soft hyphen glyph, not necessarily a hyphen, that is ordinarily
+ written to the output on hyphenation breaks. Note that the
+ remainder of a word after \: is subject to hyphenation as
+ normal. Note (new) '\:\%' idiom for getting what people will
+ want at least some of the time. Update example to use it.
+ * makevarescape.sed: Insert \% after we insert \: to rewrite
+ slashes in filenames, to protect later portions of the filename
+ from hyphenation.
+ * man/groff.7.man (Escape Sequences/Escape short reference):
+ Rename "hyphenless break" to "non-printing break point".
+ * man/groff_diff.7.man (Language/Escape sequences): Resync with
+ our Texinfo manual.
+ * tmac/groff_man.7.man.in (Description/Hyperlink and email
+ macros): Rename "hyphenless break" to "non-printing break
+ point".
+
+2020-08-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ documentation: Re-christen 'ESCAPE_AMPERSAND'.
+
+ s/zero[- ]width space character/non-printing input break/
+
+ * doc/groff.texi (Requests): Rename. Update conceptual index
+ entries; retain old name (with an appended "[sic]") to aid
+ readers accustomed to it.
+ (Ligatures and kerning): Update conceptual index entries.
+ Supply context ("effect on kerning").
+ (Drawing requests): Update conceptual index entries. Supply
+ context ("effect on '\l'").
+ * man/groff.7.man (Description): Rename in macro-advice-writing
+ shorthand.
+ (Escape Sequences/Escape short reference): Rename.
+ * tmac/groff_man.7.man.in (Description/Command synopsis macros
+ [style]: Rename.
+ (Description/Portability) [style]: Rename.
+ * tmac/groff_mdoc.7.man (TROFF IDIOSYNCRASIES/Macro Usage):
+ Rename.
+ (TROFF IDIOSYNCRASIES/Other Possible Pitfalls): Rename.
+
+2020-08-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/groff_man.7.man.in (Description/{Document structure
+ macros <.TH>, Horizontal and vertical spacing}): Fix erroneous
+ use of "flush left". The current uses were introduced by me,
+ but the page has borne incorrect uses of it as far back as 1999
+ {in the description of .TP}. Simply say "with no indentation"
+ instead.
+
+2020-08-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/groff_man.7.man.in (Description/Number registers): Inform
+ reader that registers can be set in man.local file and
+ cross-reference it.
+ (Files/*/man.local): [style] Supply example of man.local
+ customizations, prompted by recent discussions on groff,
+ linux-man, and man-db mailing lists.
+
+2020-08-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/tmac.am: Use a stamp file for m4 keyword check.
+ (M4CHECK): Add stamp file variable.
+ ($(M4CHECK)): Create stamp file if check succeeds.
+
+2020-08-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Split groff_man(7) into two pages; one a (relatively) terse
+ reference and the other a tutorial and style guide. Both are
+ generated from the same source, which is processed by m4 into
+ two man page sources.
+
+ * tmac/groff_man.7.man: Rename...
+ * tmac/groff_man.7.man.in: ...to this.
+
+ * tmac/groff_man.7.man.in: Add m4 directives and define macros.
+ Protect m4 keywords in English from unintended expansion (this
+ affected the word "include"). Add new .TH and apropos lines for
+ style guide. Convert marker comments into m4 macros for content
+ control. Uncomment material intended only for basic reference
+ page.
+
+ * tmac/tmac.am (man7_MANS): Add groff_man_style.7.
+ (EXTRADIST) Add groff_man.7.man.in.
+ (MOSTLYCLEANFILES): Add m4-generated man page sources
+ tmac/groff_man{,_style}.7.man.
+ Add targets to generate those same two pages from the renamed
+ file. Add target to grep the page for unprotected English m4
+ keywords and halt the build if they are found. Make generation
+ of those pages depend on this new target.
+
+2020-08-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/groff_man.7.man: Add material on hooks and encoding.
+ (Description, ./Deprecated features): Stop identifying .PT and
+ .BT as "deprecated"; they shouldn't ever be called in man pages,
+ but that has never been their intention.
+ (Description): Identify character encoding and line-ending
+ requirements (tutorial/style-guide material).
+ (Description/Hooks): Add new subsection to house descriptions of
+ .PT and .BT. Add mnemonic expansions for both.
+
+2020-07-31 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * man/groff.7.man (Control Characters): Incorrect claims were
+ made. Double quotes can indeed be used to enclose arguments to
+ string interpolations. The statement about a leading " in a
+ string definition (or appendment with .as) was stated too
+ generally. The leading quote is not necessary to include
+ leading tab characters, which can be input as-is, even in
+ compatibility mode.
- Document composite glyphs and the `composite' request.
+2020-07-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- * man/groff.man, man/groff_diff.man, doc/groff.texinfo: Do it.
+ * man/groff.7.man (Requests/Request short reference/.ft): Fix
+ some outright damage in the description of the request; the
+ escape sequences that are synonymous with a nullary .ft had been
+ wrongly removed.
-2003-02-28 Werner LEMBERG <wl@gnu.org>
+2020-07-25 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devdvi/generate/ec.map: Add some more Unicode entities.
- * font/devdvi/*EC: Updated.
+ * doc/meintro.me:
+ * doc/meref.me:
+ * tmac/e.tmac-u: Remove postal address for Eric Allman. It's
+ probably decades out of date. Adjust footnote symbols. Thanks
+ to Dave Kemper for the bug report and the patch. Fixes
+ <https://savannah.gnu.org/bugs/?58726>.
- * tmac/composite.tmac, tmac/latin2.tmac, tmac/latin9.tmac: New files.
- * tmac/latin1 (latin1-tr): Undo any previous mapping.
- * tmac/troffrc: Load `composite.tmac'.
- * tmac/Makefile.sub (NORMALFILES): Updated.
+2020-07-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/groff.texinfo (Input Encodings): New section.
- * NEWS: Updated.
+ Migrate macro packages from font CW to CR. The font name "CW"
+ {"constant-width"} is a legacy item we can dispose of (except
+ for the DVI device, which also has CWI for "constant-width
+ italic"), and much of the groff codebase already did starting
+ with commit 0de1d6d79cdb959ffa7dac3af77c2a36ef31873f {October
+ 2017}. Courier is available in the usual four styles {roman,
+ bold, italic, bold+italic}.
-2003-02-27 Werner LEMBERG <wl@gnu.org>
+ * tmac/an-ext.tmac (.EX): Set font to R, not CW. The existing
+ .ft request was somewhat redundant with the '.do fam C'
+ immediately before, which set the font family to Courier.
+ * tmac/s.tmac (.UC): Use font CR, not CW.
- * doc/texinfo.tex: New version 2003-02-11.06.
+2020-07-23 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/doc-common (Dt): Don't emit warning for unknown section.
- * tmac/groff_mdoc.man: Fix description of `Dt'.
+ * tmac/tty.tmac: Stop suppressing nonexistent font warning.
+ Prompted by a 2017 suggestion and patch from Bjarni Ingi
+ Gislason. Documents and macro packages that want to change the
+ font family should do so in awareness that this is meaningless
+ on terminal (nroff) devices (and -Thtml as well).
-2003-02-26 Egil Kvaleberg <egil@kvaleberg.no>
+ Fixes <https://savannah.gnu.org/bugs/?51364>.
- * font/devps/prologue.ps: Fix for included Postscript that does
- a setpagedevice -- which is now safely ignored.
+2020-07-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Updated.
+ * tmac/groff_man.7.man (.PP, .LP, .P): Fix error: these macros
+ do not reset the left margin.
- * src/devices/grops/ps.cc: Now sets the page size in the generated
- document. This is done in two ways: Via a %%-comment for gv and
- the like, and via a PageSize and setpagedevice for programs that
- understands Postscript proper, like ps2pdf.
+2020-07-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/ps.h: New broken-flag to avoid page size
- definition, if required.
+ * doc/groff.texi (Strings): Document behavior of .ds request
+ when only one argument is supplied. (The string is defined as
+ empty.) Thanks to Dave Kemper for the report and the patch.
- * src/devices/grops/grops.man: New broken-flag 16 mentioned.
+ Fixes <https://savannah.gnu.org/bugs/?58746>.
- * doc/Makefile.in: Added -nosetpage flag (via @pnmtops_nosetpage@).
- Not really necessary due to the fix in prologue.ps, but cleaner:
- Such information does not belong in an .eps file.
+2020-07-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- * doc/Makefile.sub: See doc/Makefile.in.
+ * doc/groff.texi (Using Symbols): Fix error in .rfschar
+ description, which should refer to "font f" rather than "glyph
+ f". Thanks to Dave Kemper for the report and the patch.
-2003-02-26 Ralph Corderoy <ralph@inputplus.co.uk>
+ Fixes <https://savannah.gnu.org/bugs/?58767>.
- * aclocal.m4 (GROFF_PNMTOPS_NOSETPAGE): Use P2 format for testing
- instead of P1 since the latter is broken in some versions of netpbm.
- * configure: Updated.
+2020-07-12 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-02-26 Larry Kollar <kollar@alltel.net>
+ * tmac/groff_man.7.man (.EE, .YS): Fix error: refer to "initial
+ hyphenation setting" instead of "previous hyphenation mode".
+ Incidentally, this fact points out why putting ".hy 0" or ".nh"
+ in your man page is futile.
- Make man pages more customizable.
+2020-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/an-old.tmac (FT): New register holding footer distance from
- bottom.
- (HF): New string holding the default heading font.
- (TH): Handle registers `IN' and `SN' set on the command line.
- Use `FT'.
- (PT, BT): New strings to customize header and footer lines.
- (an-header, an-footer): Use them.
- (SH, SS): Use `HF'.
- * tmac/groff_man.man: Document changes.
+ * man/groff.7.man (Requests/Request short reference): Fix error
+ in description of .hc; it changes the hyphenation character
+ rather than supplying an additional one.
- * doc/groff.texinfo: Document man changes.
- Document Ultrix extensions of man.
+2020-06-12 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-02-26 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi (Groff Options): Remove editorial comment about
+ '-a' option being "useless". It isn't. Update example for
+ contemporary systems (like Debian) and to reflect the fact that
+ the GNU troff(1) man page needs to be preprocessed with tbl(1).
+ (Invoking grotty): Recast discussion of -c option, importing
+ much language from grotty(1) page rewrite from a year ago. Add
+ program index entries for col, more, and ul. Fix transposition
+ error in ISO document number.
- * src/roff/troff/input.cc (do_width, do_if_request): Reset
- `have_input' after changing back to old environment.
+ * src/devices/grotty/grotty.1.man (Description/Legacy output
+ format): Make slight wording changes prompted by content of
+ parallel section in our Texinfo manual.
- * src/devices/grolbp/lbp.cc (lbp_printer::set_line_thickness): Move
- function up to be defined before first call. This is necessary to
- avoid a compilation problem with Sun's WorkShop 6 C++ compiler.
+ * src/roff/groff/groff.1.man (Options/-a): Parallelize with
+ first sentence of corresponding material in our Texinfo
+ manual.
- * src/utils/afmtodit/afmtodit.pl: Make script search for files in
- the default font directory also. Based on a patch from James
- J. Ramsey <jjramsey_6x9eq42@yahoo.com>.
- * src/utils/afmtodit/Makefile.sub (afmtodit): Handle @FONTDIR@.
- * src/utils/afmtodit/afmtodit.man: Document it.
+ * src/roff/troff/troff.1.man (Options/-a): Parallelize with
+ our Texinfo manual.
- * NEWS: Updated.
+ Fixes the rest of
+ <https://savannah.gnu.org/bugs/?55278>.
- * tmac/groff_man.man, doc/groff.texinfo: Many minor fixes.
+2020-06-12 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-02-25 Gaius Mulley <gaius@glam.ac.uk>
+ * man/groff_diff.7.man (Language/Long names): Fix error: groff
+ adds three new requests with short names, not two. List them in
+ an adjacent comment.
- * aclocal.m4 (GROFF_HTML_PROGRAMS): Add test for pnmtops.
- (GROFF_PNMTOPS_NOSETPAGE): New macro.
- * configure.ac: Use it.
- * configure: Regenerated.
- * Makefile.in: Updated.
+2020-06-04 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/Makefile.sub (NORMALFILES): Remove www.tmac.
- (CLEANADD): Add www.tmac-sed.
- (pnmtops_nosetpage): Define default.
- (install_data): Handle www.tmac-sed and substitute
- @PNMTOPS_NOSETPAGE@.
- (stamp-sed): Add www.tmac.
- * tmac/www.tmac: Rewritten, based on a patch by Bernd Warken.
- It now breaks URLs at suitable places.
- (www:substring_ok): New register set by...
- (www:@test_substring): New macro.
- (www:error): New alias to www-error.
- (www:lenstr, www:splitstr, www:url_breaks, www:url_breaks_splitted):
- New macros.
- (URL): Use www:url_breaks.
- (PIMG, MPIMG): Use @PNMTOPS_NOSETPAGE@.
- (CDS, CDE): New macros.
+ * tmac/an-ext.tmac (.ME, .UE): Fix portability issue. While
+ widely supported, the \$* escape is not documented in CSTR #54.
+ If groff is not the typesetter, append macro arguments using
+ \$1, \$2, ..., \$9 instead.
-2003-02-25 Werner LEMBERG <wl@gnu.org>
+2020-05-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/ps.cc (ps_printer::define_encoding): Avoid
- buffer overflow.
+ * man/groff.7.man (Numerical Expressions): Fix error: negative
+ expressions evaluate false, not true as was implied.
+ Parallelize descriptions with our Texinfo manual and
+ groff_diff(7) (in abbreviated form).
-2003-02-24 Werner LEMBERG <wl@gnu.org>
+2020-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- Contrary to the PCL5 Developer's Guide, the ascenders in TFM files
- can be negative also.
+ * doc/groff.texi (Manipulating Filling and Adjusting): Fix error
+ in code sample: missing 'n' in number register interpolation.
- * src/utils/hpftodit/hpftodit.cc (char_info): `ascent' must be
- `int16'.
- (read_char_table): Avoid negative ascenders.
- (output_charset): Add cast.
- * font/devlj4/*: Regenerated.
+2020-05-14 G. Branden Robinson <g.branden.robinson@gmail.com>
- Replace unnamed glyphs for DVI fonts with `uXXXX' glyph names where
- possible.
+ * src/preproc/preconv/tests/smoke-test.sh: Make BOM detection
+ override less hinky (i.e., use more normative input). Add tests
+ for all five detected BOMs.
- * font/devdvi/generate/{tc,texttt,ec,texmi,texsy,textex}.map: Do it.
- * font/devdvi/generate/textex.map: Map glyph 23 to `u21C6' instead
- of `<>'.
- * font/devdvi/*: Regenerated.
+2020-05-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- Map `la' and `ra' to U+27E8 and U+27E9. These two characters have
- normal width, while the previously used characters (U+2329 and
- U+232A) are classified as wide due to canonical equivalence with the
- CJK punctuation characters U+3008 and U+3009.
+ * src/roff/troff/env.cpp (space_size): Prevent assertion
+ failure. If an argument to the .ss request is negative, throw a
+ range warning and ignore it.
+ * src/roff/groff/tests/regression_savannah_58337.sh: Add test.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * font/devutf8/R.proto: Updated.
- * src/roff/troff/uniglyph.cc, src/roff/troff/glyphuni.cc: Ditto.
+ Fixes https://savannah.gnu.org/bugs/?58337.
- * man/groff_char.man: Simplify handling of table traps by
- introducing `start block' and `end block' macros.
- (Ns, Ne, 2s, 2e, Ds, De): New macros.
- (DL): Make it work with Unix troff also.
- Fix code values of `la' and `ra'.
+2020-05-08 G. Branden Robinson <g.branden.robinson@gmail.com>
- * tmac/dvi.tmac: Define `<>' for CW and CWI.
+ Update documentation of .ss request.
-2003-02-23 Gaius Mulley <gaius@glam.ac.uk>
+ * doc/groff.texi (Manipulating Filling and Adjusting): Rewrite
+ documentation of .ss request and \n[.ss] and \n[.sss] escapes.
+ Note that negative values are not permitted in either argument
+ to .ss. Use new terminology, "minimal inter-word spacing" and
+ "additional inter-sentence spacing" for clarity. Clarify that
+ additional inter-sentence spacing is only used when the output
+ line is not full when the end of a sentence occurs. Add index
+ nodes to help readers find discussion of details of spacing
+ between words and sentences. Move discussion of differences
+ from AT&T troff to section "Implementation Differences". Update
+ example to more closely resemble a real-world case, use second
+ argument to .ss request, and eliminate hackish use of .nop
+ request.
- * src/devices/grohtml/post-html.cc (element_list::~element_list):
- New destructor, fixing a major memory leak.
+ * man/groff_diff.7.man (New number registers): Recast in
+ parallel with the foregoing.
+
+ * man/groff.7.man (Read-only registers): Use new terminology and
+ describe \n[.ss] and \n[.sss] in meaningful terms, not by
+ reference to arguments to the .ss request (which wasn't even
+ accurate, because these registers have default values).
-2003-02-22 Werner LEMBERG <wl@gnu.org>
+ Fixes https://savannah.gnu.org/bugs/?54101.
- * font/devhtml/R.proto, font/devutf8/R.proto: Flip `*f' and `+f'
- to be in conformance with Unicode 3.0 and newer.
+2020-05-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * font/devlj4/generate/text.map: Add `Eu'.
- * font/devlj4/generate/special.map: Flip `*e' and `+e'.
- * font/devlj4/S: Regenerated.
+ Undocument plans to support end-of-file GNU Emacs coding tags.
- * man/groff_char.man: Completely rewritten.
+ * src/preproc/preconv/preconv.cpp (check_coding_tag): Update
+ comments.
+ (detect_file_encoding): Alter debugging output so it's easier to
+ grep and verify Emacs coding tag detection.
- * doc/groff.texinfo: Fix description of request and macro arguments.
+ * src/preproc/preconv/preconv.1.man (Bugs): Delete; its sole
+ concern was the absence of this feature.
+ (Usage): Document detection algorithm in more detail. Note
+ which detection methods don't work on unseekable input (pipes).
+ Offer recommendations for those struggling with encoding
+ detection.
+ (Usage/Coding Tags): Stop manipulating line adjustment. Use
+ hyphen-minus (\- escape) characters in coding tag names, since
+ they are literals that one might copy and paste. Stop
+ referencing XEmacs, whose development appears moribund.
+ (See Also): Add cross-references to iconv(3) and locale(7) man
+ pages.
-2003-02-20 Gaius Mulley <gaius@glam.ac.uk>
+ * src/preproc/preconv/tests/smoke-test.sh: Test each of the
+ steps in the detection algorithm.
+ * src/preproc/preconv/preconv.am: Run test.
+ (preconv_TESTS): Add new variable.
+ (TESTS): Append $(preconv_TESTS).
+
+2020-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/afmtodit/afmtodit.pl: Format usage message with
+ full capitals for parameters, and break out -v option in a
+ separate "synopsis".
+
+2020-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * font/devpdf/util/BuildFoundries.pl: Stop throwing away
+ diagnostics from afmtodit. This results in only one extra line
+ of build output:
+
+ both Upsilon1 and Upsilon map to *U at .../afmtodit line
+ 6413.
+
+2020-05-05 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Correct documentation of .pm request.
+
+ * man/groff.7.man (Requests/Request short reference): The .pm
+ request's classical behavior was described instead of groff's,
+ and omitted mention of strings and diversions; correct it.
+
+ * man/groff_diff.7.man (Implementation Differences): Document
+ this difference between AT&T troff and groff.
+
+ * doc/groff.texi (Debugging): Relocate description of .pm
+ behavioral difference...
+ (Implementation Differences): ...hither.
+
+2020-04-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/utils/addftinfo/addftinfo.cpp (usage):
+ * src/utils/tfmtodit/tfmtodit.cpp (usage): Add "usage:" prefix
+ to messages documenting auxiliary modes of invoking the program.
+ The output doesn't look right without one, and it feels
+ dishonest to not document the relevant options (-v, --version)
+ disjunctively. I'm trying to strike a balance between the
+ ultra-terse BSD approach and the ultra-garrulous GNU one (see,
+ e.g., ls(1)). Likely both camps will be unhappy. :-/
- Valgrind fixes.
+2020-04-30 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grohtml/html-table.cc (html_table::~html_table):
- Deallocate `columns' list.
- * src/devices/grohtml/post-html.cc (char_block::~char_block):
- New destructor.
- (text_glob::text_glob_html, text_glob::text_glob_special,
- text_glob::text_glob_line, text_glob::text_glob_auto_image,
- text_glob::text_glob_tag): Avoid memory leaks.
- (text_glob::remember_table): Free memory before reassigning.
+ * src/utils/tfmtodit/tfmtodit.cpp (read_map): Report invalid
+ character code from map file in diagnostic.
+ (main): Report invalid skew character position in diagnostic.
+ Explicitly report insufficient arguments in addition to usage
+ message. Lift invariant computed expressions out of loops (more
+ to shorten long lines than because I think the compiler won't
+ figure it out). Give content to "impossible assertion".
+ (tfm::load): Capitalize TFM initialism in diagnostics.
+ (usage): Use full capitals for parameters as is conventional.
+ Document disjunction of -v/--version flag from other
+ invocations.
-2003-02-19 Werner LEMBERG <wl@gnu.org>
+2020-04-29 G. Branden Robinson <g.branden.robinson@gmail.com>
- Add glyph `+e', greek lunate epsilon symbol, and `-h' (with the
- alias `hbar'), the Planck constant over two pi.
+ * src/utils/addftinfo/addftinfo.cpp (usage): Add overloaded
+ version that accepts a constant string argument, which emits the
+ argument as a diagnostic and then calls usage().
+ (main): Add diagnostics to usage message where the problem is
+ clear. Add comment explaining why it sometimes isn't.
+ (usage): Refactor main usage message (which prints the summary)
+ to report the actual names of the accepted option arguments
+ instead of just "-param", which is not literally accepted.
- * font/devdvi/generate/texmi.map: Use `*e' for position 15 and
- `+e' for position 34.
- * font/devdvi/generate/texsy.map: Replace `DI' and `HE' with
- `u2662' and `u2661'.
- * font/devdvi/{MI,S}: Regenerated.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `+e', `-h', `hbar'.
- * font/devlbp/*: Add `hbar' alias.
- * font/devlj4/generate/special.map: Ditto.
- * font/devlj4/S: Regenerated.
- * font/devps/generate/symbolchars: Add `+e'.
- * font/devps/generate/textmap: Fix PS name for `-h'.
- Add `hbar' alias.
- * font/devps/symbolmap: Regenerated.
+ Sort param_table alphabetically for use by the usage message.
- * src/devices/grops/ps.cc (transform_fill): Removed since unused.
+2020-04-22 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/glyphuni.cc (glyph_to_unicode_list): Add `+e',
- `-h', `hbar'.
- * src/roff/troff/uniglyph.cc (unicode_to_glyph_list): Add `+e',
- `-h'.
+ Delete groffer.
- * tmac/X.tmac, tmac/ps.tmac: Provide definitions for `-h' and
- `hbar'.
- * tmac/tty-char.tmac: Add `+e'.
+ Per discussion on the groff development mailing list, there is
+ no desire to retain the maintenance of this portion of the groff
+ distribution.
+
+ See
+ <https://lists.gnu.org/archive/html/groff/2020-04/msg00051.html>
+ et seq.
+
+ * contrib/groffer: Recursively delete.
+
+ * Makefile.am:
+ * arch/mingw/mingw.am: Stop building groffer.
+
+ * m4/groff.m4 (GROFF_GROFFERDIR_DEFAULT):
+ (GROFF_GROFFERDIR_OPTION): Delete; remove "--with-grofferdir"
+ configuration option.
+ * configure.ac: Stop calling these macros.
-2003-02-17 Werner LEMBERG <wl@gnu.org>
+ * MANIFEST:
+ * NEWS:
+ * PROJECTS:
+ * TODO:
+ * contrib/chem/chem.1.man:
+ * contrib/chem/examples/122/README.txt:
+ * contrib/chem/examples/README.txt:
+ * contrib/glilypond/glilypond.1.man:
+ * contrib/gperl/gperl.1.man:
+ * contrib/gpinyin/gpinyin.1.man:
+ * contrib/groff_filenames/groff_filenames.5.man:
+ * man/groff_font.5.man:
+ * man/roff.7.man:
+ * src/roff/groff/groff.1.man:
+ * src/roff/grog/grog.1.man:
+ * src/utils/addftinfo/addftinfo.1.man:
+ * tmac/groff_trace.7.man: Delete references to groffer.
- Another round trying to really fix problems with `have_input'.
+2020-04-19 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/input.cc (input_stack::get): Handle `have_input'.
- (token::next) <'\n'>, <\'\n'>: Don't handle `have_input'.
+ * src/include/curtime.h: #include <time.h> if we're returning
+ a time_t from current_time().
- * src/devices/grotty/tty.cc (tty_printer::put_color): Fix color
- handling if both foreground and background colors are default.
+ * src/libs/libgroff/curtime.cpp (current_time): Quote
+ $SOURCE_DATE_EPOCH variable content in diagnostics produced due
+ to bad input since it's under user control and could have all
+ kinds of bogosity in it (like whitespace).
- * doc/groff.texinfo (Debugging): Document .lf differences to
- AT&T troff.
+2020-04-19 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * **/*.{man,tmac}: Save compatibility mode robustly.
-2003-02-16 Werner LEMBERG <wl@gnu.org>
+ Use new \n[.cp] register to save compatibility mode.
+
+ Use register names based on the filename (at the source
+ maintenance level) to avoid clobbering other files' saved
+ compatibility modes.
+
+ * tmac/html.tmac: Eliminate test of saved-compatibility
+ register by moving its body inside the block where compatibility
+ mode is off. This is the only part of this changeset that was
+ not automated.
+
+ Fixes <https://savannah.gnu.org/bugs/?58162>.
+
+2020-04-16 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Implement new read-only .cp register.
- * src/devices/grotty/tty.cc (tty_printer::make_rgb_string): Avoid
- null-bytes in created string.
+ Within a .do request, \n[.cp] holds the saved value of
+ compatibility mode.
- * src/roff/troff/input.cc (lookup_color, interpolate_macro,
- alias_macro, lookup_request): Improve warning messages.
+ The register \n[.cp] is specialized and may require a statement
+ of rationale. When writing macro packages or documents that use
+ groff features and which may be mixed with other packages or
+ documents that do notâcommon scenarios include serial processing
+ of man pages or use of the .so or .mso requestsâyou may desire
+ correct operation regardless of compatibility mode in the
+ surrounding context. It may occur to you to save the existing
+ value of \n(.C into a register, say, _C, at the beginning of
+ your file, turn compatibility mode off with â.cp 0â, then
+ restore it from that register at the end with â.cp \n(_Câ. At
+ the same time, a modular design of a document or macro package
+ may lead you to multiple layers of inclusion. You cannot use
+ the same register name everywhere or you risk âclobberingâ the
+ value from a preceding or enclosing context. The twoâcharacter
+ register namespace of AT&T troff is confining and mnemonically
+ challenging; you may wish to use groff's more capacious
+ namespace. However, attempting â.nr _my_saved_C \n(.Câ will not
+ work in compatibility mode; the register name is too long.
+ âThis is exactly what .do is for,â you think, â.do nr
+ _my_saved_C \n(.Câ. The foregoing will always save zero to your
+ register, because .do turns compatibility mode off while it
+ interprets its argument list. What you need is:
+ .do nr _my_saved_C \n[.cp]
+ .cp 0
+ at the beginning of your file, followed by
+ .cp \n[_my_saved_C]
+ at the end. As in the C language, we all have to share one big
+ namespace, so choose a register name that is unlikely to collide
+ with other uses.
+
+ * src/roff/troff/input.cpp (do_request, init_input_requests):
+ Implement it.
+
+ * doc/groff.texi:
+ * man/groff.7.man:
+ * man/groff_diff.7.man: Document it.
+
+ * src/roff/groff/tests/dot-cp_register_works.sh: Test it.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+
+ Enables a fix for
+ <https://savannah.gnu.org/bugs/?58162>.
+
+ Thanks to John Gardner and Ingo Schwarze for the discussion.
+
+2020-04-15 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Implementation Differences):
+ * man/groff_diff.7.man (New requests): Rewrite description of
+ .do request, and replace example with a more illustrative one.
+
+ * man/groff.7.man (Request short reference): Rewrite description
+ of .do request briefly.
+
+2020-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * doc/groff.texi (Implementation Differences): Remove incorrect
+ claim. The .C register cannot be manipulated manually.
+
+2020-04-14 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/smoke-test_html_device.sh: Simplify
+ charmap test.
+
+2020-04-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ It's too easy for the nroff version to get desynced from the
+ groff version when we're running test cases, leading to spurious
+ results. Make it easier to see a discrepancy.
+
+ * src/roff/nroff/nroff.sh: Call groff with -v or --version when
+ we are called that way. Let test cases tell us to use
+ test-groff as groff with an environment variable.
+
+ * src/roff/nroff/tests/verbose_option_works.sh.in: Rename to...
+ * src/roff/nroff/tests/verbose_option_works.sh: ...this. Check
+ the nroff version being tested against the groff version being
+ wrapped. This exposes a bug; the system groff rather than the
+ build tree groff was being invoked. Refactor. Stop messing
+ with @GROFF_BIN_PATH_SETUP@ (enabling the rename); instead, let
+ test-groff handle that for us. Locate it and export the
+ variable GROFF_TEST_GROFF so nroff can find it. Because we
+ manipulate $PATH to run the tests, the $PATH of an installed
+ groff system will _always_ differ from that used by a build
+ tree; ignore it in the test cases. Dispose of bashisms and set
+ shebang to /bin/sh.
+
+ * src/roff/nroff/nroff.am: Stop generating the above test
+ script. It can now be run as it ships.
+
+2020-04-13 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Make our assert() C99-conformant.
+
+ groff has its own implementation of the standard C library's
+ assert() macro. It hasn't been updated since C89. C99 requires
+ that the diagnostic emitted by assert() contain the failing
+ expression and name of the function in scope.
+
+ * src/include/assert.h: Add additional pointer to const char
+ arguments to do_assert() and assertion_failed() for function
+ name and stringified expression.
+ (assertion_failed): Update prototype.
+ (do_assert): Accept 'func' and 'msg' parameters and pass them to
+ assertion_failed().
+ (assert): Update macro to collect '__func__' and stringify the
+ expr parameter (as 'msg') and pass them do do_assert().
+ * src/libs/libgroff/assert.cpp (assertion_failed): Rewrite
+ diagnostic to more closely match GNU Coding Style format and
+ also report function and failing expression.
+
+ Example output:
+ troff: ../src/roff/troff/input.cpp:2644: do_request():
+ assertion failed: '0 == "But first, here's a rotten old
+ BBC programme."'
+
+ We have no excuse to assert(0) ever again. Express the
+ invariant that has been violated.
- * src/roff/troff/node.cc (suppress_node::tprint): Use `strsave',
- not `strdup'.
- Free `last_image_filename'.
+2020-04-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/html/pre-html.cc (char_block::char_block): Initialize
- `buffer'.
- (imageList::createPage, imageList::createImage): Use `free', not
- `a_delete'.
- (imageItem::~imageItem): Free `imageName'.
- (addRegDef): Use `strsave', not `strdup'.
- (get_resolution): Free `pathp'.
+ * src/roff/groff/tests/smoke-test_html_device.sh: Set
+ LC_CTYPE=C.UTF-8 so that byte sequences in the pipelines are
+ handled correctly. Skip the test if the environment doesn't
+ support UTF-8. Thanks to Bjarni Ingi Gislason for the trouble
+ report.
-2003-02-15 Werner LEMBERG <wl@gnu.org>
+ Fixes <https://savannah.gnu.org/bugs/?58164>.
- * src/devices/grotty/tty.cc (tty_printer::tty_printer): Fix pointer
- to `dummy'.
+2020-04-13 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-02-14 Werner LEMBERG <wl@gnu.org>
+ * tmac/html.tmac: Use .do so we correctly load unicode.tmac in
+ compatibility mode.
- Add memory management for colors to deallocate unnamed colors
- properly.
+ Fixes the following problem (wrapped, filenames abbreviated):
- * src/include/color.h (color): New members `free_list' and `next'.
- New member functions `new' and `delete'.
- Add destructor.
- * src/libs/libgroff/color.cc: Implement it.
+ $ echo | ./build/test-groff -C -Thtml >/dev/null
+ troff: backtrace: file '.../groff/build/../tmac/html.tmac':546
+ troff: backtrace: file '.../groff/build/../tmac/troffrc':30
+ troff: .../groff/build/../tmac/html.tmac:546: warning: macro
+ 'ms' not defined
+
+2020-04-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libgroff/font.cc (font::add_kern): Use integer cast
- for array size of new operator.
+ * src/roff/groff/tests/smoke-test_html_device.sh: Add test.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * src/libs/libdriver/input.cc (IntArray::operator[]): Remove
- redundant comparison.
+2020-04-12 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/groff/tests/regression_savannah_58153.sh:
+ * src/roff/groff/tests/\
+ use_point_size_escape_with_single_digit_arg.sh: Use "set -e" to
+ ensure that multi-test script files don't hide problems. There
+ are arguments against "set -e" (and you can ask Greg Wooledge
+ for all of them), but I'm so used to it from years of writing
+ Debian package maintainer scripts that I feel comfortable with
+ it. It is less verbose than several alternatives (especially
+ having one test script per case).
- * src/roff/troff/input.cc (word_space_node::reread,
- hmotion_node::reread): Avoid warning about unused parameter.
- (reset_output_registers): Remove redundant parameter.
- (define_color): Undo change 2003-02-12.
+ * src/roff/groff/tests/string_case_xform_unicode_escape.sh:
+ Update with respect to new failure output (in a comment only,
+ since this is an XFAIL test).
+
+ * tmac/tests/an-old_AT_and_UC_footer_saved_and_restored.sh:
+ Drop unnecessary "|| exit 1" from end of script. Incidentally,
+ this script illustrates an alternative to "set -e".
+
+2020-04-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Rework documentation of .spreadwarn.
+
+ * doc/groff.texi (Debugging):
+ * man/groff.7.man (Request short reference):
+ * man/groff_diff.7.man (New requests): Recast description of
+ .spreadwarn request, some based on suggestions from Dave Kemper.
+ Make more prominent the fact that spreading only applies to
+ adjustment mode 'b'. Document warning type used.
+
+ Fixes half of Savannah #58035.
+
+2020-04-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Require Texinfo 5.0 (February 2013) at a minimum.
+
+ * m4/groff.m4 (GROFF_MAKEINFO): Check for version 5.0 (increased
+ from 4.8). Update diagnostics and comments.
+
+ * INSTALL.extra:
+ * README:
+ * doc/groff.texi:
+ * doc/webpage.ms: Document updated requirement.
+
+ * doc/fixinfo.sh: Delete; it is no longer necessary to work
+ around Texinfo 4.x bugs.
+
+ * doc/doc.am (EXTRA_DIST): Stop shipping fixinfo.sh.
+ (.texi.html): Remove makeinfo < 5.0 version check and consequent
+ execution of fixinfo.sh. Update comment.
+
+2020-04-11 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Enable backtracing across process/file boundaries when errors or
+ non-ignored warnings are encountered.
+
+ Experimentation reveals that .so, .mso, and .pso requests acted
+ as barriers to backtracing except when explicitly requested with
+ the .backtrace request. Judging by the git history, this
+ behavior dates back to June 1991 or earlier. The intention,
+ according to a source comment, was only to suppress the
+ backtrace output for the line corresponding to the outermost
+ level of the input stack (commonly, a file argument to groff).
+ Unfortunately, that wasn't its only effect.
+
+ This change does result in one additional line of output for
+ each error or (non-ignored) warning when -b is given. However,
+ I regard this as unobjectionable because {1} a backtrace was in
+ fact explicitly requested; and {2} it seems a poor tradeoff to
+ suppress most of the backtrace in some complicated and
+ frustrating cases for the sake of one fewer line of backtrace
+ output in a trivial one.
+
+ Now, backtracing behaves the same no matter what triggers it.
+
+ Fixes Savannah #58153.
+
+ * src/roff/troff/input.cpp (file_iterator::backtrace): Call
+ get_location() for its side effect of rewriting a filename of
+ "-" to "<standard input>", for consistency with other diagnostic
+ messages. (In this class, this member function always returns
+ 1, so ignore the return value. This fact is an essential part
+ of what led to the bug; the conditional
+ p && !p->get_location(0, &f, &n)
+ which appeared in the for loop of input_stack::backtrace() prior
+ to this change would always evaluate to false when a node of the
+ file_iterator class was encountered.)
+ (input_stack::backtrace): Replace member function body with that
+ of input_stack::backtrace_all().
+ (input_stack::backtrace_all): Delete.
+ (backtrace_request): Update the only call site of the above.
+
+ * src/roff/groff/tests/regression_savannah_58153.sh: Add test.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+
+ * src/roff/groff/tests/string_case_xform_errors.sh: Update
+ regression test to not be confounded by additional line of
+ backtrace output. Remove bashism along the way.
+
+ * doc/groff.texi:
+ * man/groff.7.man:
+ * man/groff_diff.7.man: Update documentation.
+
+2020-04-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Reorganize backtrace output.
+
+ * src/roff/troff/input.cpp (string_iterator::backtrace):
+ Prefix the output with the program name if it is known. In a
+ deviation from the GNU Coding Standards, put the string
+ "backtrace:" immediately next instead of the file and line
+ number; this is because, particularly in cases where the
+ backtrace is most interesting or needed, it will produce
+ multiple lines of output and the common prefix aids visual
+ understanding.
+ (file_iterator::backtrace): As above; also, change prefix for
+ popened nodes in the iterator from "process" to "pipe". This
+ seemed preferable to omitting the information entirely or using
+ an inscrutable sigil like 'f' or 'p'. The advantage is that the
+ output is better aligned--better ergonomics for those who have
+ to cope with a lot of it. Furthermore, output the filename only
+ once.
+
+ Example of old and new output:
+
+ /tmp/inner:2: backtrace: file '/tmp/inner'
+ echo .so /tmp/inner:1: backtrace: process 'echo .so /tmp/inner'
+ /tmp/outer:1: backtrace: file '/tmp/outer'
+
+ troff: backtrace: file '/tmp/inner':2
+ troff: backtrace: pipe 'echo .so /tmp/inner':1
+ troff: backtrace: file '/tmp/outer':1
+
+2020-04-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (read_size): Add units to diagnostic.
+ This function works only with device-specific basic units
+ internally; users likely think in terms of point size, so add
+ the basic unit suffix "u" to offer a hint about what's going on.
+
+ Example:
+ $ groff -ww >/dev/null
+ \s[10]A\s[-12]B
+ troff: <standard input>:1: warning: point-size escape results in
+ non-positive size -2000u; set to 1u
+
+ On a PostScript device with 1000 basic units to the point, the
+ difference is important and would be confusing without the unit
+ indication.
+
+2020-04-08 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Correct and clarify point size documentation.
+
+ Our Texinfo manual has long documented the request '.ps 0' as
+ restoring the previous point size (just as '\s0' or '.ps' with
+ no argument does), but this is incorrect; since groff 1.02 or
+ earlier (June 1991), the request has not actually worked this
+ way. Instead, '.ps 0' sets the point size to 1 basic unit
+ {though output drivers may clamp this to a higher value}. This
+ behavior is consistent with AT&T troff, Hierloom Doctools troff
+ and, per Ingo Schwarze, Plan 9 troff. (It is, however, not
+ consistent with neatroff.)
+
+ * doc/groff.texi (Changing Type Sizes): Stop claiming that '.ps
+ 0' works like '\s0'. Note that the resulting (computed) point
+ size, not the argument, is clamped. Note that it is
+ non-positive, not negative, point sizes that are clamped to 1u.
+ Add (forward) cross-reference to section where \n[.ps] is
+ defined since it is mentioned here. Move explanation of special
+ handling of zero argument to \s escape description.
+
+ * man/groff.7.man (Request short reference): Explain .ps N
+ independently of \s. Note clamping behavior.
+
+2020-04-06 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (read_size): Correctly brace 'else'
+ block.
+
+ * src/roff/groff/tests/\
+ use_point_size_escape_with_single_digit_arg.sh:
+ Check that we get a diagnostic when relying on ambiguous form.
+
+2020-04-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/roff/troff/input.cpp (read_size): Move special-case
+ interpretation of the '\sN' form of point-size escapes when 'N'
+ is 1, 2, or 3 to compatibility mode (groff -C) only, and throw
+ error diagnostic with suggestion for remedy if encountered.
+
+ Traditionally, '\s36A' is interpreted as "set point size to 36,
+ then emit 'A'". However, only values in the range 10-39 are
+ handled specially; '\s40A' is interpreted as a four-point "0A".
+ This is unlike anything else in *roff grammar; see \*, \$, \f,
+ \F, \g, \k, \m, \M, \n, \V, \Y, and \z.
+
+ To anticipate objections: Why not throw only a warning? Because
+ there isn't a warning category for supported but ambiguous
+ syntax (this behavior of AT&T troff dates back to the mid-1970s
+ but was not documented in the Troff User's Manual until 1992).
+ Why not throw the error outside of compatibility mode too?
+ Because outside of compatibility mode we (now) have an
+ unambiguous parse.
+
+ Background: The Graphic Systems C/A/T phototypesetter (the
+ original device target for AT&T troff) only supported a few
+ discrete point sizes in the range 6..36, so Ossanna
+ special-cased the parser to do what the user must have meant.
+ Kernighan warned of this in the 1992 revision of CSTR #54
+ {§2.3}, and more recently, McIlroy referred to it as a "living
+ fossil".
+
+ See:
+ https://lists.gnu.org/archive/html/groff/2020-03/msg00054.html
+ https://lists.gnu.org/archive/html/groff/2020-04/msg00002.html
+ https://lists.gnu.org/archive/html/groff/2020-04/msg00015.html
+ and follow-ups for discussion.
+
+ * NEWS: Advise users of behavior change and offer guidance.
+
+ * doc/groff.texi:
+ * man/groff.7.man: Document the restriction of special handling
+ of point-size arguments to '\s' to compatibility mode.
+
+ * src/roff/groff/tests/\
+ use_point_size_escape_with_single_digit_arg.sh: Add regression
+ test.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2020-04-04 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Improve point-size escape diagnostics.
+
+ * src/roff/troff/input.cpp (read_size): Disclose context
+ {point-size escape interpretation} in diagnostic messages. When
+ a "bad digit" is encountered, describe it if possible. When a
+ relative adjustment results in a negative point size, report the
+ computed value. Also rename a variable for slightly more
+ clarity ("bad" does not refer to all bad parses, just some cases
+ of bad digits), and update an insufficiently generalized comment
+ {"\s(00" is also an acceptable expression for point-size zero}.
+
+ Based on suggestions by Ingo Schwarze and Bjarni Ingi Gislason.
+
+2020-04-01 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Align diagnostic message format.
+
+ * src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+ * src/roff/troff/input.cpp (do_error):
+ Display the diagnostic level when it is "error", instead of
+ leaving it implicit.
+
+ * src/roff/troff/input.cpp (error_with_file_and_line): Include
+ the program name in the diagnostic message if it is known.
+
+ * src/roff/groff/tests/string_case_xform_errors.sh: Update
+ diagnostic message expectation.
+
+2020-02-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/roff/troff/reg.h: Updated.
+ * doc/groff.texi (Page Motions):
+ * man/groff.7.man (Single-character escapes): Document
+ non-breaking spaces as such.
- * src/roff/troff/node.cc (troff_output_file::really_print_line,
- output_file::put_filename, real_output_file::really_put_filename,
- ascii_output_file::really_print_line,
- break_char_node::get_hyphen_list): Avoid warning about unused
- parameter.
- (suppress_node::tprint): Updated.
+ Report and patch by Dave Kemper <saint.snit@gmail.com>.
+ Fixes <https://savannah.gnu.org/bugs/?55954>.
- * configure.ac: Check declaration for rand() and srand().
- * configure: Regenerated.
+2020-02-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/pic/pic.h: Declare fmod(), rand(), and srand()
- conditionally.
- * src/preproc/pic/pic.y: Remove declaration of fmod(), rand(),
- and srand().
+ nroff: Implement -P and -V options.
- * src/preproc/eqn/delim.cc (delim_table): Add missing initializers
- to avoid compiler warnings.
+ * src/roff/nroff/nroff.sh: Recognize -P option (with argument)
+ and pass it through to groff. Recognize -V option; if given,
+ display constructed groff command instead of executing it.
+ Update usage message to document new options. Tidy up shell
+ style and indentation. Add comments.
+ * src/roff/nroff/nroff.1.man: Document new -P and -V options.
+ * src/roff/nroff/tests/verbose_option_works.sh.in: Test -V
+ option.
+ * src/roff/nroff/nroff.am: Generate test and run it.
- * src/preproc/grn/hgraph.cc (HGPrintElt): Second parameter is
- unused.
+2020-02-06 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/devices/grops/ps.cc (ps_printer::set_char): Last parameter
- is unused.
- * src/devices/grops/psrm.cc (skip_possible_newline): Remove first
- (unused) parameter.
- Updated all callers.
+ Stop ms macro package from manipulating warnings.
- * src/devices/grotty/tty.cc (tty_printer::set_char): Last parameter
- is unused.
- * src/devices/grodvi/dvi.cc (dvi_printer::set_char): Ditto.
- * src/devices/grolj4/lj4.cc (lj4_printer::set_char): Ditto.
+ * tmac/s.tmac: Remove code block that attempted to enable all
+ warnings "only if none are given on the command line". It did
+ this by simply comparing the value of the warn register
+ {\n[.warn]} against the default value; but of course, a user
+ could specify -w options that exactly matched the default and
+ the test would not be able to tell, causing puzzling and
+ undesired behavior. Furthermore, the hard-coded default was out
+ of date and did not correspond to recent releases of groff. If
+ you want all warnings on, use the ".warn" request with no
+ arguments in your ms document or pass "-w w" to groff (see
+ troff(1) or our Texinfo manual for more on warnings).
- * src/devices/grohtml/post-html.cc (html_printer::emit_line):
- Parameter is unused.
- (html_printer::add_table_end): Define parameter conditionally.
- * src/devices/grohtml/output.cc (simple_output::special): Parameter
- is unused.
+ Thanks to Bjarni Ingi Gislason for bringing this issue to our
+ attention.
- * src/devices/grolbp/lbp.cc: Define _GNU_SOURCE conditionally.
- (lbp_printer::set_char): Last parameter is unused.
+ Resolves <https://savannah.gnu.org/bugs/?57583>.
- * src/utils/indxbib/indxbib.cc (main): Remove redundant comparison.
+2020-01-21 George HELFFRICH <ghfbsd@gmail.com>
-2003-02-13 Werner LEMBERG <wl@gnu.org>
+ [me]: Fix regression of '.nm' (#57638).
- New commands \D'Fr ...', \D'Fc ...', etc. for orthogonality.
- Make \D'f ...' move horizontally again for backwards compatibility.
- Replace it with \D'Fg ...' where appropriate to avoid dependency
- on horizontal resolution.
+ * tmac/e.tmac-u (nm): Use saved point size and font position
+ for line numbering only if those registers exist.
- * src/roff/troff/input.cc (do_get_long_name): New function.
- (get_long_name): Call it.
+ Fixes <https://savannah.gnu.org/bugs/?57638>.
- (read_draw_node): Handle `\D'Fx ...' by calling ...
- (read_color_draw_node): New function.
+2020-01-18 Ingo Schwarze <schwarze@openbsd.org>
- (read_rgb, read_cmy, read_cmyk, read_gray): New optional argument
- `end'.
- Pass it to `do_get_long_name' which is used instead of
- `get_long_name'.
+ Accept any number of arguments for .Dd in the groff_mdoc(7)
+ macros.
- * src/libs/libdriver/input.cc (color_from_Df_command): Remove
- unnecessary value guard.
- (parse_D_command) <'f'>: Add horizontal shift.
+ * tmac/doc-common-u: The .Dd macro behaved in a weird way:
+ Without arguments, it printed the string "Epoch".
+ With one, two, four, or more arguments, it ignored all arguments
+ and used the current date instead.
+ Only for exactly three arguments, it printed the arguments.
+ None of this made sense. Giving the date as "Epoch" is
+ absurd, and printing the current date is just misleading:
+ why should a document be considered up-to-date when the author
+ did not even bother to state the date of the last change?
+ Admittedly, the behaviour for 0 and 4 or more arguments
+ already appeared 4.3BSD-Reno, and the behaviour for 2 or 3
+ arguments in 4.4BSD. But it was already wrong even in those
+ days: several manual pages in 4.4BSD gave .Dd a single, quoted
+ argument, e.g. .Dd "June 9, 1993": cap_mkdb(1), id(1), sed(1),
+ err(3), getcap(3), sysctl(3), amd(8), disklabel(8), and others.
+ Consequently, simply print all the arguments, no matter how
+ many there are.
- * src/preproc/grn/hgraph.cc (HGPrintElt) <POLYGON>: Use \D'Fg ...'.
- * src/preproc/pic/troff.cc (troff_output::set_fill): Ditto.
- (FILL_MAX): Removed.
+ This bug was found by Jonathan Gray <jsg@openbsd.org>
+ while he looked at 4.xBSD manual pages.
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo:
- Updated.
+2020-01-18 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-02-12 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texi: Document initial empty set membership of
+ characters with cflags values of 128, 256, or 512 in parallel
+ with preceding paragraphs regarding smaller powers of two.
- * src/roff/troff/input.cc (do_name_test, do_expr_test,
- do_zero_width): Push `\n' if closing delimiter is missing.
+ Report and patch by Dave Kemper <saint.snit@gmail.com>.
+ Fixes <https://savannah.gnu.org/bugs/?57549>.
- (token::next) <ESCAPE_NEWLINE>, <'\n'>, <\'\n'>: Reset `have_input'.
- <'F'>: Make \F non-transparent at the beginning of line.
- (process_input_stack) <token::TOKEN_CHAR, token::TOKEN_NEWLINE,
- token::TOKEN_REQUEST, token::TOKEN_BEGIN_TRAP>: Don't handle
- `have_input'.
+2020-01-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- (define_color): Free color in case of reassignment.
+ * src/roff/groff/tests/*.sh: Rename some tests so their
+ filenames are more self-descriptive.
+ * src/roff/groff/groff.am (groff_TESTS): Update.
- * doc/groff.texinfo (@Defesc, @DefescList, @DefescItem,
- @DefescListEnd): Use @Var, not @var.
- Fix all calls.
+2020-01-18 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/grn/hgraph.cc (HGPrintElt): Fix typo.
+ * src/roff/groff/tests/transparent_end-of-sentence_chars.sh: Add
+ test for end-of-sentence recognition.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
- * src/preproc/pic/object.cc (object_spec::~object_spec): Free
- `shaded' and `outlined' arrays.
- (object_spec::object_spec): Initialize `shaded' and `outlined'.
- (graphic_object::set_fill_color, graphic_object::set_outline_color):
- Use strsave.
- (closed_object::set_fill_color): Ditto.
- * src/preproc/pic/troff.cc (troff_output::set_color): Use strsave
- instead of strdup.
- (troff_output::reset_color): Use a_delete instead of free.
- * src/preproc/pic/main.cc (do_file): Free `out' in case of error.
+2020-01-18 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-02-11 Werner LEMBERG <wl@gnu.org>
+ * src/roff/troff/input.cpp: Mark \[dd] character (double dagger)
+ as transparent for purposes of end-of-sentence recognition.
- * doc/groff.texinfo: Improve documentation of `ad'.
- Document that \D'f...' is dependent on the horizontal resolution.
- * man/groff_diff.man: Improve documentation of \D'f...'.
+ * doc/groff.texi (Sentences):
+ * man/groff_diff.7.man (New requests/.cflags): Document this.
- * src/preproc/grn/hgraph.cc (HGPrintElt) <POLYGON>: Don't emit
- compensating \h'...' for \D'f ...' since the latter no longer moves
- current position.
- * src/preproc/pic/troff.cc (troff_output::set_fill): Ditto.
+ Report and patch by Dave Kemper <saint.snit@gmail.com>.
+ Fixes <https://savannah.gnu.org/bugs/?57546>.
-2003-02-10 Werner LEMBERG <wl@gnu.org>
+2020-01-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- Improve error messages for `x F' (and `F') commands.
+ * src/preproc/refer/refer.1.man (See Also):
+ * src/utils/indxbib/indxbib.1.man (See Also):
+ * src/utils/lkbib/lkbib.1.man (See Also):
+ * src/utils/lookbib/lookbib.1.man (See Also): Add bibliographic
+ reference to the original Bell Labs "refer" paper by Mike Lesk.
- * src/include/error.h: Add declaration for
- `current_source_filename'.
- * src/libs/libgroff/filename.cc: Add `current_source_filename'.
- * src/libs/libgroff/error.cc (do_error_with_file_and_line): Add
- parameter for source file string.
- Updated all callers.
+2020-01-17 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/libs/libdriver/input.cc: Add `current_source_filename'.
- (remember_source_filename): New function.
- (parse_x_command <'F'>, do_file <'F'>): Use it.
+ * tmac/tests/an-old_AT_and_UC_footer_saved_and_restored.sh: Add
+ regression test for Ingo's change below.
-2003-02-09 Werner LEMBERG <wl@gnu.org>
+2020-01-16 Ingo Schwarze <schwarze@openbsd.org>
- Make grotty not emit warnings about unknown colors more than
- necessary.
+ Repair .AT and .UC in the groff_man(7) macros.
- * src/devices/grotty/tty.cc: Include `ptable.h'.
- (TTY_MAX_COLORS): Removed.
- (DEFAULT_COLOR_IDX): Defined to -1.
- (glyph): Change `back_color_idx' and `fore_color_idx' to `char'.
- (tty_printer): Change `curr_back_idx' and `curr_fore_idx' to `char'.
- Change `tty_colors' to be a ptable.
- First arg of `put_color' is now `char'.
- New functions `make_rgb_string' and `tty_color'.
- (tty_printer::tty_printer): Use `tty_color'.
- (tty_printer::color_to_idx): Return value is now `char'.
- Use `tty_color'.
+ * tmac/an-old.tmac: Setting user-defined strings in a macro that
+ will later be called indirectly from page location traps is
+ excessively complicated. Besides, the implementation doesn't
+ work: when the trap is finally sprung, the defaults from the
+ an-init macro clobber what the author specified with .AT or .UC.
+ Instead, all that is needed is setting the strings for the
+ header before triggering the page break, such that they appear
+ right away, while setting the strings for the footer after the
+ page break, such that they don't appear on the previous page.
- * src/include/color.h (color): Add `print_color' member function.
- * src/libs/libgroff/color.cc (color::print_color): Implement it.
+ This bug was found by Jonathan Gray <jsg@openbsd.org> while he
+ looked at 4.xBSD manual pages.
-2003-02-08 Werner LEMBERG <wl@gnu.org>
+2020-01-16 G. Branden Robinson <g.branden.robinson@gmail.com>
- Valgrind fixes.
+ * tmac/groff_man.7.man (Document structure macros/.SH): Fix
+ errors in footer description.
- * src/devices/grops/ps.cc (ps_printer::define_encoding): Close
- encoding file.
+2020-01-12 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/include/ptable.h (PTABLE::~PTABLE, PTABLE::define): Always
- assume that value has been allocated with `new[]', thus use
- `a_delete' for deallocation.
+ * tmac/tests/an-old_CS_register_on.sh: Tweak flags; all the
+ other tests in this group pass "-Tascii -P-cbou" instead of
+ "-Tutf8". (This is so that output is easy to grep from a shell
+ script.) Bring this test into line. Does not regress anything.
- * src/libs/libdriver/input.cc (get_integer_arg,
- get_possibly_int_args, parse_x_command, do_file): Use `a_delete'
- where appropriate.
+2019-12-30 Deri James <deri@chuzzlewit.myzen.co.uk>
- * src/libs/libgroff/new.cc (delete) [!COOKIE_BUG]: Define.
- * src/libs/libgroff/nametoindex.cc
- (character_indexer::named_char_index): Use `new <type>[1]'.
+ Certain pdfmark destination names caused gropdf to fail.
- * src/preproc/eqn/lex.cc (init_table, do_definition): Use `new
- <type>[1]'.
- * src/preproc/eqn/text.cc (set_special_char_type): Ditto.
- (split_text): Use `a_delete'.
+ * src/devices/gropdf/gropdf.pl: Look for pdfmark types, (i.e.
+ DEST, OUT, ANN), only preceding 'pdfmark' at end of line, not
+ anywhere else.
- * src/preproc/pic/pic.y (define_label, define_variable): Use `new
- <type>[1]'.
+2019-12-30 Ingo Schwarze <schwarze@openbsd.org>
- * src/roff/troff/env.cc (environment::choose_breakpoint): Avoid
- harmless memory leak.
- (hyphen_trie::read_patterns_file): Initialize `buf'.
- * src/roff/troff/node.cc (troff_output_file::troff_output_file):
- Initialize `current_fill_color'and `current_glyph_color'.
- * src/roff/troff/glyphuni.cc
- (glyph_to_unicode_init::glyph_to_unicode_init): Use `new <type>[1]'.
- * src/roff/troff/uniuni.cc
- (unicode_decompose_init::unicode_decompose_init): Ditto.
- * src/roff/troff/uniglyph.cc
- (unicode_to_glyph_init::unicode_to_glyph_init): Ditto.
+ Correct output of sprintf("%%") in pic(1).
-2003-01-26 Werner LEMBERG <wl@gnu.org>
+ * src/preproc/pic/pic.ypp: Print "%" rather than "%%".
- * src/utils/indxbib/indxbib.cc (main) [__EMX__]: Check with
- `access' before calling `unlink'.
- (do_file): Handle __EMX__.
+ Bug reported by Doug McIlroy <doug at cs dot dartmouth dot edu>.
+ Patch using feedback from Larry McVoy <lm at mcvoy dot com>.
- * src/include/nonposix.h: Handle __EMX__.
+2019-12-29 Deri James <deri@chuzzlewit.myzen.co.uk>
- * Makefile.in (SEP): New variable; set to @PATH_SEPARATOR@.
- (fontpath,tmacpath): Use it.
- (MDEFINES): Add it.
- Sorted alphabetically.
+ Update man page of gropdf to document \X calls.
- * src/preproc/eqn/neqn.sh, src/roff/nroff/nroff.sh: Use
- @SEP@.
- * src/preproc/eqn/Makefile.sub, src/roff/nroff/Makefile.sub: Handle
- @SEP@.
+ * src/devices/gropdf/gropdf.1.man: The calls 'pagename' and
+ 'switchtopage' (used by mom to relocate TOC) are documented,
+ together with their convenience commands '.pdfpagename' and
+ '.pdfswitchtopage'.
-2003-01-27 Werner LEMBERG <wl@gnu.org>
+2019-12-29 Ingo Schwarze <schwarze@openbsd.org>
- * src/libs/libgroff/strcasecmp.c, src/libs/libgroff/strncasecmp.c:
- New files, copied from gnulib.
- * src/libs/libgroff/Makefile.sub (CSRCS): Add them.
- * configure.ac: Updated.
- * configure: Regenerated.
+ Improve documentation of pic(1) regarding printf.
- * src/include/config.hin: Regenerated.
- * src/include/lib.h [!HAVE_STRCASECMP]: Declare `strcasecmp'.
- Don't define `strcasecmp' as `strcmp'.
- [!HAVE_STRNCASECMP]: Declare `strncasecmp'.
- Dont define `strncasecmp' as `strncmp'.
+ * src/preproc/pic/pic.1.man:
+ Document which conversion specifications are supported.
+ * doc/pic.ms:
+ Correct the list of supported conversion specifications.
- * src/roff/groff/pipeline.c [!HAVE_STRCASECMP, !HAVE_STRNCASECMP]:
- Removed.
+2019-12-21 Ingo Schwarze <schwarze@openbsd.org>
-2003-01-26 Werner LEMBERG <wl@gnu.org>
+ Update NetBSD, OpenBSD, FreeBSD, Darwin, and DragonFly version
+ strings.
- * src/utils/indxbib/indxbib.cc (main) [__EMX__]: Fix typo:
- s/unline/unlink/.
+ * tmac/doc-common-u: Update.
+ * tmac/groff_mdoc.7.man: Synchronize.
-2003-01-25 Werner LEMBERG <wl@gnu.org>
+ Based on a patch from Guillem Jover <guillem@debian.org>
+ via Colin Watson <cjwatson@debian.org>, tweaked by me.
+ Fixes: https://bugs.debian.org/867123
- * doc/groff.texinfo (Ligatures and Kerning): Mention limitations.
+2019-09-22 G. Branden Robinson <g.branden.robinson@gmail.com>
-2003-01-24 Werner LEMBERG <wl@gnu.org>
+ Use a vertical spacing of 1v between paragraphs in man page
+ examples. This looks better (on typesetter devices like
+ PostScript and PDF) with the Courier font family also used in
+ examples. Typewriter devices (like the terminal) already used
+ an inter-paragraph spacing of 1v.
- Add US-english hyphenation exceptions (converted from Barbara
- Beeton's hyphenation exception log reports which appear irregularly
- in TUGBoat).
+ * tmac/an-ext.tmac (EX): Save the value of the PD number
+ register (inter-paragraph distance), and set it to 1v.
+ (EE): Restore previous value of the PD register.
- * tmac/hyphen.us: Updated to latest version.
- * tmac/README: Updated.
- * tmac/hyphenex.us, tmac/hyphenex.sh: New files.
- * tmac/troffrc: Load `hyphenex.us'.
- * tmac/Makefile.sub (NORMALFILES): Add `hyphenex.us'.
- * doc/groff.texinfo: Updated.
+2019-09-21 Deri James <deri@chuzzlewit.myzen.co.uk>
-2003-01-23 Werner LEMBERG <wl@gnu.org>
+ Changes to allow configure to check for URW fonts
- Improve hyphenation slightly. This is a first step in redesigning
- the hyphenation algorithm to make it more flexible (e.g. allowing
- kerns and ligatures between the hyphenation character and the
- following character -- while not used normally in English, other
- languages like German would benefit).
+ * font/devpdf/util/BuildFoundries.pl: Call the program with
+ --dirURW with path provided to ./configure, and --check to do
+ a dry-run just checking if the fonts are available. (bug #56748)
- * src/roff/troff/env.cc (environment::hyphenate_line): Use
- assertion instead of if-clause.
- Let `get_hyphen_list' return the number of involved characters in
- the hyphenation pattern instead of computing it directly (which
- often yields too small values).
- * src/roff/troff/node.h (*::get_hyphen_list): Add second parameter.
- * src/roff/troff/node.cc (*::get_hyphen_list): Handle new second
- parameter.
+2019-09-21 Deri James <deri@chuzzlewit.myzen.co.uk>
-2003-01-22 Werner LEMBERG <wl@gnu.org>
+ Add new ghostscript font names (bug #56748)
- Fixing a bug which caused groff to hang if the hyphenation exception
- dictionary tried to grow.
+ * font/devpdf/Foundry.in: Add changed font names
- * src/roff/troff/env.cc (hyphen_trie::insert_hyphenation,
- hyphen_trie::read_patterns_file, do_hyphenation_patterns_file): Use
- pointer to dictionary.
+2019-09-21 Deri James <deri@chuzzlewit.myzen.co.uk>
-2003-01-20 Werner LEMBERG <wl@gnu.org>
+ Prevent gropdf executing arbitrary commands
- * src/utils/afmtodit/afmtodit.pl: Add switch `-m' to suppress
- negative left italic correction.
- * src/utils/afmtodit/afmtodit.man: Document it.
+ * src/devices/gropdf/gropdf.pl: See bug #55557
- * font/devps/generate/Makefile (RFLAG): Add `-m'.
- * font/devps/{AB,AR,BMB,BMR,CB,CR,EURO,HB,HR,HNB,HNR,NB,NR,PB,PR,
- S,TB,TR,ZD,ZDR}: Regenerated with afmtodit options `-i 0 -m'.
+2019-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Updated.
+ * tmac/an-old.tmac: Move test for definitions of CS and CT
+ registers to after man.local is sourced; this way we can both
+ respect any setting of those registers in that file (which is
+ intended for customization by the site administrator) and ensure
+ that the registers are defined when dereferenced later.
-2003-01-16 Werner LEMBERG <wl@gnu.org>
+2019-09-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- * NEWS: Updated.
+ * **/*.man: Put section headings in title case.
-2003-01-16 Jörgen Grahn <jgrahn@algonet.se>
+2019-09-13 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/refer/refer.man: Mention REFER environment variable.
+ * src/roff/troff/input.cpp: Lift invariant out of loop.
-2003-01-05 Werner LEMBERG <wl@gnu.org>
+2019-09-11 G. Branden Robinson <g.branden.robinson@gmail.com>
- Similar to \[is], the square root glyph (\[sr]) and the square root
- extension glyph (\[radicalex]) are now text symbols. The new
- mathematical versions are called \[sqrt] and \[sqrtex],
- respectively.
+ * src/preproc/refer/refer.1.man: Add mention of man and mm
+ packages as supporting the "refer" preprocessor (GNU mm grew
+ this support back in groff 1.22.1).
- * font/devX*/S: Regenerated.
- * font/devdvi/generate/texex.map: Rename `sr[0123]' to `sqrt[0123]'.
- * font/devdvi/generate/texsy.map: Rename `sr' to `sqrt'.
- * font/devdvi/EX, font/devdvi/S: Regenerated.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `sqrt'.
- * font/devlj4/generate/special.map: Add `sqrt'.
- * font/devlj4/S: Regenerated.
- * font/devps/generate/textmap: Add `sqrt'.
- * font/devps/S, font/devps/symbolmap: Regenerated.
+2019-09-10 G. Branden Robinson <g.branden.robinson@gmail.com>
- * src/preproc/eqn/sqrt.cc (SQRT_CHAR, RADICAL_EXTENSION_CHAR,
- SQRT_CHAIN, BAR_CHAIN): Use `sqrt*' and `sqrtex*'.
- * src/roff/troff/input.cc (init_charset_table): Make `sqrtex'
- overlap horizontally.
-
- * tmac/X.tmac, tmac/ps.tmac, tmac/lj4.tmac: Add `sqrtex'.
- * tmac/dvi.tmac: Add `sr', and `sqrtex'.
- Fix `radicalex'.
-
- * doc/groff.texinfo, man/groff_diff.man: Document that `radicalex'
- and `sqrtex' are overlapping glyphs.
-
-2003-01-04 Werner LEMBERG <wl@gnu.org>
-
- * font/devdvi/generate/texsy.map: Add `is'.
- * font/devps/symbolmap: Regenerated.
- * font/devdvi/*TC, MI, S: Regenerated.
-
- * tmac/dvi.tmac: Remove `is'.
-
-2003-01-03 Werner LEMBERG <wl@gnu.org>
-
- `is' is now a text symbol (only relevant for dvi). The math variant
- can be accessed with `integral'.
-
- * font/devX*/S: Regenerated.
- * font/devdvi/generate/texex.map: Remove `is'.
- * font/devdvi/EX: Updated.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `integral'.
- * font/devlj4/generate/special.map: Ditto.
- * font/devlj4/S: Regenerated.
- * font/devps/generate/textmap: Add `integral'.
- * font/devps/S: Regenerated.
-
- * tmac/dvi.tmac: Define `is'.
-
- * src/roff/troff/glyphuni.cc (glyph_to_unicode_list): Add `integral'.
-
- * src/preproc/tbl/main.cc (process_format): Fix error message.
-
-2003-01-02 Werner LEMBERG <wl@gnu.org>
-
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `ne' and `nc'.
- * font/devps/textmap: Fix entries for `ne' and `nc'.
- * font/devps/symbolmap: Regenerated.
-
- * src/roff/troff/glyphuni.cc (glyph_to_unicode_list),
- src/roff/troff/uniglyph.cc (unicode_to_glyph_list): Add `18',
- `38', `58', `78', `-+', `|=', `nc', `ne'.
-
- * tmac/dvi.tmac: Add `nm', `ne', `nc'.
- Use `schar' for `aq'.
- * tmac/ps.tmac, tmac/X.tmac: Add `nc' and `ne'.
- * tmac/ec.tmac: Add `SC' to special fonts for `CW' and `CWI'.
- * tmac/tty.tmac: Add `ne'.
-
- * src/roff/troff/node.cc (make_glyph_node): Test with `get_macro'
- for fallback glyphs.
-
-2002-12-29 Werner LEMBERG <wl@gnu.org>
-
- Add glyph `|='.
-
- * font/devX*/*: Regenerated.
- * font/devdvi/generate/ec.map: Remove `eq'.
- * font/devdvi/generate/texsy.map: Make `~=' the same as `~~'.
- Assign `|=' to position 39.
- * font/devdvi/*EC, S: Regenerated.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `|='.
- * font/devlj4/generate/special.map: Make `~=' the same as `~~'.
- Assign `|=' to position 549.
- * font/devps/generate/textmap, font/devps/enerate/symbolmap: Remove
- `equalmath'.
- Add `uni2243' for `|='.
-
- * tmac/ec.tmac: Add `eq'.
- * tmac/dvi.tmac: Add `=~'.
- * tmac/tty-char.tmac, tmac/ps.tmac, tmac/X.tmac, tmac/lbp.tmac: Add
- `|='.
-
-2002-12-21 Werner LEMBERG <wl@gnu.org>
-
- * font/devdvi/generate/tc.map: Remove `**'.
- * font/devdvi/*TC: Regenerated.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `18', `38', `58',
- `78', `<<', `>>'.
- * font/devutf8/NOTES: Updated.
-
- * src/roff/troff/charinfo.h (charinfo): Add `setx_macro' function.
- Don't give default parameter to `set_macro'.
- * src/roff/troff/input.cc (do_define_character): Use `setx_macro'
- instead of `set_macro'.
- (charinfo::setx_macro): Implement it.
- (charinfo::set_macro): Don't change `mode'.
-
- * tmac/tty.tmac: Add `18', `38', `58', `78', `<<', `>>'.
- * tmac/ps.tmac, tmac/X.tmac: Add `<<', `>>'.
- * tmac/dvi.tmac: Define `!=' with `.schar'.
-
-2002-12-20 Werner LEMBERG <wl@gnu.org>
-
- * font/devX*/S: Regenerated.
- * font/devdvi/generate/ec.map: Remove `pl'.
- * font/devdvi/generate/tc.map: Remove `mi', `14', `12', `34'.
- * font/devdvi/*{TC,EC}: Regenerated.
- * font/devhtml/R.proto: Add `-+'.
- Remove double entries for `rk', `lk', `lt', `rt', `rb', `lb'.
- * font/devlbp/*: Remove `or'.
- * font/devlj4/generate/special.map: Remove `or'.
- * font/devlj4/S: Regenerated.
- * font/devps/generate/textmap: Add `fiveeighths', `oneeighth',
- `seveneighths', `threeeighths'.
- Remove `plusmath'.
- Replace `minusplus' with `uni2213'.
- * font/devps/symbolmap: Regenerated.
- * font/devutf8/R.proto: Replace `shc' with unnamed glyph.
- Add `-+'.
-
- * src/roff/troff/charinfo.h (charinfo): Add `is_normal' inline
- function.
- * src/roff/troff/node.cc (troff_output_file::put_char_width):
- Call glyph_color and fill_color even if tcommand_flag isn't set.
- (make_node, node::add_char): Check not ci->is_fallback but
- ci->is_normal.
-
- * tmac/lj4.tmac, tmac/lbp.tmac: Define `or'.
- * tmac/ec.tmac: Add .rchar entry for `f/'.
- Don't remove `12', `14', `34'.
- Define `pl' to be always roman.
- * tmac/ps.tmac (ps-frac, ps-frac-mono): New macros.
- Define `18', `38', `58', `78'.
- * tmac/tty.tmac: Add `-+'.
- * tmac/dvi.tmac: Define `f/'.
- (dvi-frac): Use `f/'.
- * tmac/X.tmac (X-frac, X-frac-mono): New macros.
- Define `18', `38', `58', `78'.
-
-2002-12-15 Colin Watson <cjwatson@debian.org>
-
- * contrib/pic2graph/pic2graph.sh: Add missing `;;'.
-
-2002-12-10 Werner LEMBERG <wl@gnu.org>
-
- Add glyph `tno', a textual variant of `no'.
-
- * font/devX*/*: Regenerated.
- * font/{devcp1047,devlatin1,devutf8,devhtml}/R.proto: Add `tno'.
- * font/devdvi/generate/{tc.map: Replace `no' with `tno'.
- * font/devdvi/generated/{texsy,textex}.map: Add `tno'.
- * font/devdvi/*: Regenerated.
- * font/devlbp/*: Add `tno'.
- * font/devlj4/generate/tex.map: Replace `no' with `tno'.
- * font/devlj4/*: Regenerated.
- * font/devps/generate/textmap: Replace `no' with `tno'.
- * font/devps/generate/symbolchars: Add `no'.
- * font/devps/*: Regenerated.
-
- * src/roff/troff/glyphuni.cc (glyph_to_unicode_list): Add `tno'.
-
- * tmac/cp1047.tmac, tmac/latin1.tmac: Replace `no' with `tno'.
- * tmac/tty-char.tmac: Add entry for `tno' and `3d'.
-
- * NEWS: Updated.
-
- * tmac/dvi.tmac: Replace most `\\' with `\E'.
- Add definition for `sd'.
- * tmac/X.tmac, tmac/ps.tmac: Replace most `\\' with `\E'.
-
- * tmac/eqnrc <dvi>: Use `integral' instead of `is' glyph.
-
-2002-12-08 Werner LEMBERG <wl@gnu.org>
-
- * tmac/an-old.tmac (TH): Use integer value for `IN' if in nroff
- mode to avoid rounding errors.
- (an-do-tag, an-do-tag-html, RS, RE): Remove redundant `.br'.
-
- * src/roff/groff/groff.man, src/roff/nroff/nroff.man,
- src/roff/troff/troff.man: Improve documentation of -T.
-
-2002-12-07 Jeff Conrad <jeff_conrad@msn.com>
-
- * src/roff/groff/pipeline.c: Don't define `const' for _WIN32.
- (run_pipeline) [_WIN32]: Provide working function without `fork'.
-
-2002-12-06 Werner LEMBERG <wl@gnu.org>
-
- * font/devps/generate/freeeuro.sfd: Make dimensions of Euro.symbol
- glyphs compatible to Adobe's Euro fonts (scaling them down a bit).
- Scaling Euro.sansserif glyphs down to have the same height as
- digits.
- Removed unnecessary points; added some extrema.
-
- * font/devps/EURO, font/devps/freeeuro.afm, font/devps/freeeuro.pfa:
- Regenerated.
-
-2002-12-04 Werner LEMBERG <wl@gnu.org>
-
- * font/devps/generate/freeeuro.sfd: Add glyphs `Euro.symbol.slanted'
- and `Euro.symbol.bold.slanted'.
- Improve some glyph offsets and widths.
- * font/devps/EURO, font/devps/freeeuro.afm, font/devps/freeeuro.pfa:
- Regenerated.
- * font/devps/generate/Makefile (freeeuro.afm freeeuro.pfa): Fix
- typo.
- * font/devps/generate/sfdtopfa.pe: Generate PFA in current
- direcory.
-
- * tmac/europs.tmac: Updated to new glyph indices.
- Use Euro.symbol for font familiy `A'.
-
- * doc/groff.texinfo: Minor improvements.
-
-2002-12-02 Werner LEMBERG <wl@gnu.org>
-
- * font/devdvi/generate.tc.map: s/%O/%0/.
- * font/devdvi/*TC: Regenerated.
-
- * src/roff/troff/div.cc (init_div_requests): Sorted.
-
- * tmac/dvi.tmac: Remove `Ye'.
- * tmac/ec.tmac: Remove `Ye'.
- Add .rchar entry for `de'.
-
- * man/groff.man, man/groff_diff.man: Document register `.pe'.
- * doc/groff.texinfo: Document registers `.pe', `.n', and `.w'.
- * NEWS: Updated.
-
-2002-11-30 Werner LEMBERG <wl@gnu.org>
-
- Add PS font for various Euro glyphs.
-
- * font/devps/generate/freeeuro.sfd: New master font file for
- pfaedit.
- * font/devps/generate/sfdtopfa.pe: New conversion script for
- pfaedit.
- * font/devps/generate/Makefile (FONTS): Add `EURO'.
- (EURO, freeeuro.afm, freeeuro.pfa): New rules.
- * font/devps/freeeuro.pfa, font/devps/freeeuro.afm: Generated from
- `freeeuro.sfd'.
- * font/devps/EURO: Generated from `freeeuro.afm'.
- * font/devps/download: Add `freeuro.pfa'.
- * font/devps/Makefile.sub (NORMALFILES): Adde `EURO' and
- `freeeuro.pfa'.
-
- * tmac/europs.tmac: New file.
- * tmac/ps.tmac: Include `europs.tmac'.
- * tmac/Makefile.sub (DISTFILES): Add `europs.tmac'.
-
-2002-11-29 Werner LEMBERG <wl@gnu.org>
-
- * font/devdvi/generate/texsy.map: Remove `lh' and `rh'.
- * font/devdvi/S: Regenerated.
- * font/devhtml/R.proto: Fix `CR' and `ci'.
- Add `OK'.
- * font/devps/generate/textmap: Fix `lh', `rh', and `sq'.
- Remove `bs'.
- * font/devps/symbolmap: Regenerated.
- * font/devutf8/R.proto: Fix `CR' and `ci'.
- Add `OK'.
- * font/devutf8/NOTES: Updated.
-
- * src/roff/troff/uniglyph.cc (unicode_to_glyph_list): Fix `CR' and
- `ci'.
- Add `OK'.
- * src/roff/troff/glyphuni.cc (glyph_to_unicode_list): Ditto.
-
- * tmac/dvi.tmac: Add `lh' and `rh'.
- * tmac/Xps.tmac: Fix `lh' and `rh'.
- * tmac/X.tmac: Add `OK'.
- * tmac/lj4.tmac: Ditto.
-
-2002-11-24 Werner LEMBERG <wl@gnu.org>
-
- * font/devX*/S: Regenerated.
- * font/devascii/R.proto, font/devcp1047/R.proto: Remove glyphs `lb',
- `lc', `lf', `lk', `lt', `rb', `rc', `rf', `rk', and `rt'.
- * font/devdvi/generate/texsy.map: Remove `or' glyph.
- * font/devdvi/S: Regenerated.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add/fix glyphs
- `parenlefttp', `parenleftex', `parenleftbt', `parenrighttp',
- `parenrightex', `parenrightbt', `bracketlefttp', `bracketleftex',
- `bracketleftbt', `bracketrighttp', `bracketrightex',
- `bracketrightbt', `bracelefttp', `braceleftmid', `braceleftbt',
- `braceex', `braceleftex', `bracerightex', `bracerighttp',
- `bracerightmid', `bracerightbt', `lt', `lk', `lb', `rt', `rk',
- `rb', and `bv'.
- * src/roff/troff/glyphuni.cc, src/roff/troff/uniglyph.cc: Ditto.
- * font/devutf8/NOTES: Updated.
- * font/devlj4/generate/special.map: Add glyph `braceex'.
- * font/devlj4/S: Regenerated.
-
- * tmac/tty-char.tmac: Add glyphs `lf', `rf', `lc', and `rc'.
-
-2002-11-14 Werner LEMBERG <wl@gnu.org>
-
- * src/roff/troff/uniglyph.cc (unicode_to_glyph_list): Add `va'
- and `vA'.
- Fix code for `an'.
- * src/roff/troff/glyphuni.cc (glyph_to_unicode_list): Ditto.
-
- * doc/texinfo.tex: New version from texinfo 4.3.
- * doc/groff.texinfo: Updated for texinfo 4.3.
- Use @tie{} where appropriate.
- * font/devdvi/generate/ec.map: Don't include `or' and `bv'.
- * font/devdvi/generate/tc.map: Remove `rn'.
- * font/devdvi/*TC, font/devdvi/*EC: Regenerated.
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `vA'.
- Fix code for `an'.
- * font/devX100/*, font/devX100-12/*, font/devX75/*,
- font/devX75-12/*: Regenerated.
-
- * tmac/dvi.tmac: Add special fonts `SA' and `SB'.
- Use .char (again) for `br', `ul', `rn', `or', and `ru'.
- Improve definition of `an'.
- * tmac/ps.tmac: Use .char (again) for `br', `ul', `rn', `or', and
- `ru'.
- * tmac/lj4.tmac: Use .char (again) for `br', `ul', `rn', and `ru'.
- * tmac/X.tmac: Add definition for `or'.
- * tmac/Xps.tmac: Undo change 2002-11-05.
- * tmac/lbp.tmac: Add definitions for `br', `rn', `ul', and `ru'.
-
-2002-11-11 Werner LEMBERG <wl@gnu.org>
-
- * src/roff/troff/node.cc (troff_output_file::put_char): Always
- call flush_tbuf.
-
-2002-11-10 Werner LEMBERG <wl@gnu.org>
-
- Added three new requests `schar', `fschar', and `rfschar'. `schar'
- defines a glyph which is searched after the check for fonts declared
- with `.special' (and before the check for all mounted special
- fonts). `fschar' defines a glyph for a particular font which is
- searched after the check for fonts declared with `.fspecial' (and
- before the check for fonts declared with `.special'). `rfschar'
- removes glyphs defined with `fschar'.
-
- * src/roff/troff/token.h (char_mode): New enum.
- Declare do_define_character.
- * src/roff/troff/charinfo.h (charinfo): Replace `fallback' with
- `mode'.
- (charinfo::is_fallback): Updated.
- (charinfo::is_special): New method.
- * src/roff/troff/input.cc (do_define_character): Add and use
- optional second parameter used as a prefix for font-specific glyph
- names.
- (define_character, define_fallback_character): Updated.
- (define_special_character): New function.
- (init_input_requests): Add `schar'.
- (charinfo::charinfo, charinfo::set_macro): Updated.
- * src/roff/troff/node.cc: Include `stringclass.h'.
- (make_glyph_node): Handle special glyphs defined with `.schar' and
- `.fschar'.
- (define_font_special_character, remove_font_special_character): New
- functions.
- (init_node_requests): Sorted.
- Add `fschar' and `rfschar'.
- * NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo:
- Document new requests.
-
- * font/devhtml/R.proto, font/devutf8/R.proto: Add `va'.
- * tmac/dvi.tmac: Add `va' for CW and CWI (using `.fschar').
-
-2002-11-08 Werner LEMBERG <wl@gnu.org>
-
- Added new font `SC' (cmtex10) to devdvi.
-
- * devdvi/generate/Makefile (FONTS): Add `SC'.
- (SC): New rule.
- * devdvi/generate/textex.map: New map file for cmtex.
- * devdvi/SC: New.
- * devdvi/Makefile.sub (DEVFILES): Updated.
- * tmac/dvi.tmac: Add fspecial entries for SC.
- Add `MI', `S' and `CW' to the `special' call. Otherwise, `SC' is
- found before `S' since the font position of `SC' is lower due to the
- gaps in DESC's `font' line.
- * tmac/ec.tmac: Add a `special' call.
- * NEWS: Updated.
-
- * font/devhtml/R.proto: Remove double entry for `ti'.
- * tmac/tty.tmac: Add entries for `IJ', `ij', and `bq'.
- * tmac/tty-char.tmac: Remove entry for `bq'.
- * tmac/lbp.tmac: Add entries for `lq', `rq', `fo', `fc', and `em'.
- * tmac/ec.tmac: Don't remove `aq' glyph.
- * tmac/X.tmac: Fix entry for `em'.
- Add entries for `fo' and `fc'.
- * tmac/dvi.tmac: Add entries for `em', `en', `hy', `fo', and `fc'.
-
- * doc/groff.texinfo, man/groff.man, man/groff_diff.man: Fix
- documentation of `special' and `fspecial' requests.
-
-2002-11-05 Werner LEMBERG <wl@gnu.org>
-
- * font/devascii/R.proto, font/devcp1047/R.proto,
- font/devlatin1/R.proto: Remove entry for `.i'.
- * font/devdvi/generate/textt.map: Add entry for `ad'.
- * font/devdvi/generate/texr.map, font/devdvi/generate/texb.map,
- font/devdvi/generate/texi.map: Add dummy glyph name `slash@for@l'.
- We need this for getting kerning values to compose `/l' and `/L'.
- * font/devdvi: Regenerated font definition files for CM fonts.
- * font/devhtml/R.proto: Add entries for "'C", "'c", `IJ', and `ij'.
- * font/devutf8/R.proto: Ditto.
- Remove double entry for `ti'.
-
- * src/roff/troff/glyphuni.cc (glyph_to_unicode_list): Fix entries
- for (groff) ligatures, `la', and `ra'.
- Add "'C", "'c", `IJ', and `ij'.
- Remove double entry for `ti'.
- * src/roff/troff/uniglyph.cc (unicode_to_glyph_list): Remove all
- double entries.
- Add "'C", "'c", `IJ', and `ij'.
- Fix entries for (groff) ligatures, `la', and `ra'.
-
- * tmac/ps.tmac (ps-achar): New macro.
- Define "'c" and "'C".
- * tmac/tty.tmac: Add entry for `.i'.
- * tmac/X.tmac (X-achar): New macro.
- Define "'c", "'C", and `:Y'.
- Add entries for `IJ' and `ij'.
- * tmac/Xps.tmac (Xps-achar): New macro.
- Define "'c" and "'C".
- Add entries for `IJ' and `ij'.
- * tmac/lbp.tmac (lbp-achar): New macro.
- Add fallback characters for all groff ligatures and many other
- glyphs.
- * tmac/dvi.tmac: Fix definitions of `_' and `ul'.
- Add entries for `/l' and `/L'.
- Define "'c" and "'C".
- Add entries for `IJ' and `ij'.
-
-2002-11-02 Larry Kollar <kollar@alltel.net>
-
- * PROBLEMS: Document how to solve Mac OS X compilation problems.
-
-2002-11-02 Werner LEMBERG <wl@gnu.org>
-
- Adding support for composite glyphs: \[xxx yyy ...] and the
- `composite' request.
-
- * src/roff/troff/glyphuni.cc: New file for mapping groff glyph names
- to Unicode-based glyph names.
- * src/roff/troff/uniglyph.cc: New file for mapping Unicode-based
- glyph names to groff glyph names.
- * src/roff/troff/uniuni.cc: New file for canonically decomposing
- Unicode-based glyph names.
- * src/roff/troff/unicode.cc, src/roff/troff/unicode.h: New files
- for handling Unicode glyph names.
- * src/roff/troff/input.cc: Include unicode.h.
- (composite_glyph_name): New function.
- (token::next) <'['>: Handle Unicode glyph names and composite
- glyphs.
- (composite_dictionary): New dictionary for the `composite' request.
- (composite_request): Implement `composite' request.
- (init_input_requests): Add `composite'.
- Alphabetically sorted.
- * src/roff/troff/env.cc (tabs_save, tabs_restore): Removed (already
- commented out).
- (init_env_requests): Alphabetically sorted.
- Removed `tas' and `tar' (already commented out).
- * src/roff/troff/Makefile.sub: Updated.
-
-2002-10-31 Ruslan Ermilov <ru@FreeBSD.org>
-
- * src/roff/nroff/nroff.man, src/roff/nroff/nroff.sh: Fix description
- of options.
-
-2002-10-29 Werner LEMBERG <wl@gnu.org>
-
- Fix computation of .trunc register. Additionally, its value (and
- the value of the .ne register) is now always set before entering the
- trap.
-
- * src/roff/troff/div.cc (diversion::need): Set `truncated_space' and
- `needed_space' before calling `space'.
- (top_level_diversion::space): Remove special code for 'sp before the
- first page.
- Call `begin_page' with the discarded space as a parameter.
- (top_level_diversion::begin_page): Add optional parameter to set
- `truncated_space'.
- * src/roff/troff/div.h: Updated.
-
- * doc/groff.texinfo: Improve documentation of .sp, \n[.trunc], and
- \n[.ne].
-
- * tmac/an-old.tmac (SH, SS, TP, IP, HP, TS): Undo change 2002-10-26.
- (LP): Remove superfluous call to `br'.
- * tmac/doc-common (doc-paragraph): Undo change 2002-10-26.
- * tmac/doc.tmac (Bd, Bl, doc-set-vertical-and-indent): Ditto.
-
-2002-10-26 Werner LEMBERG <wl@gnu.org>
-
- * tmac/doc-ditroff: Remove useless switch/variable -rC.
- (doc-setup-header): Don't set page register `%'.
- * tmac/doc-nroff: Remove variable `C'.
- (doc-setup-page-layout): Set doc-header-space to .5i unconditionally.
- (doc-setup-header): Don't set page register `%'.
- Don't call `bp'.
- * tmac/doc-common (doc-header): Call `ns'.
- (doc-paragraph): Protect .sp with .br so that it survives traps
- possibly set by the user.
- * tmac/doc.tmac (Bd, Bl, doc-set-vertical-and-indent): Ditto.
-
- * tmac/doc*: Replace ' with . for consistency if no effect.
-
-2002-10-26 Werner LEMBERG <wl@gnu.org>
-
- * tmac/an-old.tmac (SH, SS, TP, IP, HP, TS): Protect .sp with .br
- so that it survives traps possibly set by the user.
-
- * src/roff/troff/node.cc: Fix the changes from 2002-10-23.
- (troff_output_file::set_font): Call flush_tbuf if necessary.
- (troff_output_file::fill_color, troff_output_file::glyph_color): Call
- flush_tbuf and do_motion only if necessary.
- (troff_output_file::start_special,
- troff_output_file::put_char_width, troff_output_file::put_char,
- troff_output_file::draw): Updated.
- (word_space_node::tprint, space_node::tprint, hmotion_node::tprint,
- vmotion_node::tprint): Undo change 2002-10-23.
-
-2002-10-25 Werner LEMBERG <wl@gnu.org>
-
- * tmac/www.tmac (DC): Fix case of overlapping images.
-
-2002-10-23 Werner LEMBERG <wl@gnu.org>
-
- * src/roff/troff/node.cc (troff_output_file::fill_color,
- troff_output_file::glyph_color): Set current color before testing
- color_flag.
- (troff_output_file::put_char_width, troff_output_file::put_char,
- troff_output_file::draw): Don't call flush_tbuf and/or do_motion
- before glyph_color.
- (troff_output_file::file_color, troff_output_file::glyph_color):
- Call do_motion.
- (word_space_node::tprint, space_node::tprint, hmotion_node::tprint,
- vmotion_node::tprint): Move first, then call fill_color.
-
-2002-10-20 Werner LEMBERG <wl@gnu.org>
-
- * doc/groff.texinfo, man/groff_tmac.man: Document that it is not
- possible to use multiple main macro packages.
-
-2002-10-19 Werner LEMBERG <wl@gnu.org>
-
- * src/devices/grops/ps.cc (cmyk_flag): New global variable.
- (ps_printer::set_color): Set `cmyk_flag' for CMY and CMYK colors.
- (ps_printer::~ps_printer): Emit `%%Extensions: CMYK' if `cmyk_flag'
- is set.
- * font/devps/prologue.ps (Fk, Ck): Enclose definitions with a
- `where' construction since `cmyksetcolor' is a PS Level 2 operator.
-
-2002-10-16 Werner LEMBERG <wl@gnu.org>
-
- * NEWS, doc/webpage.ms: Updated.
-
-2002-10-14 Werner LEMBERG <wl@gnu.org>
-
- * src/roff/troff/node.cc (troff_output_file::put_char_width,
- troff_output_file::put_char, troff_output_file::fill_color,
- troff_output_file::glyph_color): Handle case where color pointer
- is null.
+ Mark expected-to-fail test as XFAIL.
-2002-10-13 Ruslan Ermilov <ru@FreeBSD.org>
+ Automake supports XFAIL and XPASS, so actually use the
+ infrastructure as intended.
- Add the new -r option to grotty. It is similar to the -i option
- except it tells grotty(1) to use the `reverse video' attribute to
- render italic fonts.
-
- * src/devices/grotty/tty.cc (reverse_flag): New global variable.
- (SGR_REVERSE, SGR_NO_REVERSE): New macros.
- (tty_printer::make_underline, tty_printer::put_color,
- tty_printer::end_page): Use it.
- (main): Add -r switch.
- (usage): Updated.
- * src/devices/grotty/grotty.man: Document it.
-
-2002-10-11 Ruslan Ermilov <ru@FreeBSD.org>
+ * Makefile.am: Declare XFAIL_TESTS variable.
+ * src/roff/groff/groff.am (groff_XFAIL_TESTS): Add
+ string_case_xform_unicode_escape.sh.
+ * src/roff/groff/tests/string_case_xform_unicode_escape.sh: Set
+ the expected output to what it would be if string case
+ transforms worked on groff Unicode escapes.
- * src/roff/troff/env.cc (hyphen_trie::read_patterns_file): Add
- cast to `unsigned char' to properly read patterns with 8bit
- characters.
+2019-09-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Retire '@G@' build system macro.
+
+ It existed only for forcibly-capitalized man page titles; it was
+ the uppercase-transformed counterpart of @g@.
+
+ * Makefile.am: Delete sed transformation of @G@.
+ * src/preproc/tbl/tbl.1.man: Replace '@G@EQN' in section heading
+ with '@g@eqn'.
+
+2019-09-10 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * **/*.man: Downcase man page titles, except for glilypond and
+ roff2*, which did not require it.
+
+ Here's a sed script for the aid of those who have a corpus of
+ man pages to migrate.
+
+ # Downcase man page titles.
+ #
+ # Use the first line to skip any .TH lines that require
+ # special handling, perhaps because the name of the
+ # command gets externally macro-expanded. In groff, the
+ # "roff2.1.man" page is an example.
+ #
+ # This script operates _only_ on .TH lines.
+ #
+ # usage: sed -i -f this_script.sed your_man_page.1 ...
+ /@ROFF2MODE@/b
+ /^\.\s*TH/{
+ h
+ s/^\.\s*TH \+\([^ ]\+\) .*/\1/
+ y/ABCDEFGHIJKLMNOPQRSTUVWXYZ/abcdefghijklmnopqrstuvwxyz/
+ G
+ s/\([^ ]\+\)\n\(^\.\s*TH \+\)[^ ]\+\( .*\)/\2\1\3/
+ }
+
+2019-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ The an (man) macro package supports new CS and CT number
+ registers to control rendering of man page section headings and
+ titles, respectively, in full capitals. These default off (with
+ no visible effect on pages which already fully capitalize these
+ strings in man page sources). The rationale is to encourage man
+ page authors to preserve case distinction information in (or
+ restore it to) their titles and section headings, while giving
+ users (including system administrators, distributors,
+ integrators, and maintainers of man(1) implementations) a way to
+ view the rendered page elements in full capitals if desired.
+
+ * tmac/an-old.tmac (TH/an-init): If number register CT is
+ defined and nonzero, call .stringup on \*[an-title].
+ (SH): Store macro argument list to \*[an-section-heading]. If
+ number register CS is defined and nonzero, call .stringup on it.
+ * tmac/groff_man.7.man (OPTIONS): Document the CS and CT number
+ registers.
+ * tmac/tests/an-old_CS_register_off.sh:
+ * tmac/tests/an-old_CS_register_on.sh:
+ * tmac/tests/an-old_CS_register_unspecified.sh:
+ * tmac/tests/an-old_CT_register_off.sh:
+ * tmac/tests/an-old_CT_register_on.sh:
+ * tmac/tests/an-old_CT_register_unspecified.sh: Add tests.
+ * tmac/tmac.am (tmac_TESTS): Run tests.
+
+2019-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Add regression test to check behavior of case transformation
+ request on a string containing a Unicode character escape.
+ Right now, this is not supported, so it is an XFAIL test in the
+ parlance of DejaGNU/POSIX 1003.3.
+
+ * src/roff/groff/tests/string_case_xform_unicode_escape.sh: New
+ test.
+ * src/roff/groff/groff.am (groff_TESTS): Run test.
-2002-10-08 Werner LEMBERG <wl@gnu.org>
+2019-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
- * REVISION: Increased to 2.
+ Implement .stringdown and .stringup requests.
-Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
- Free Software Foundation, Inc.
+ * src/roff/troff/input.cpp: Add .stringdown and .stringup
+ requests.
+ * doc/groff.texi: Document them, including example.
+ * man/groff_diff.7.man: Same.
+ * man/groff.7.man: Document them briefly.
+
+2019-09-09 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ Regression-test string case transform feature.
+
+ * src/roff/groff/tests/string_case_xform_errors.sh: New test.
+ * src/roff/groff/tests/string_case_xform_requests.sh: New test.
+ * src/roff/groff/groff.am (groff_TESTS): Run tests.
+
+2019-06-30 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * src/devices/grotty/grotty.1.man (Options/-i): Note support of
+ recent versions of xterm for italic (oblique) styles.
+
+ Fixes part of <https://savannah.gnu.org/bugs/?55278>.
+
+2019-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ devlatin1: Map \(oq to ' on output.
+
+ * font/devlatin1/R.proto: Render the output glyph \[oq]
+ {opening quote} as 0x27 (apostrophe) instead of 0x60 (grave
+ accent). A grave accent is just flat wrong for the Latin-1
+ character set, a.k.a. ISO 8859-1. The defining document ECMA-94
+ {June 1986} is freely available for perusal. The ECMA-94 Latin
+ character sets do not define any glyphs for directional
+ {"typographer's"} quotation marks, but the apostrophe is
+ depicted as a neutral (vertical) glyph, whereas the grave accent
+ 0x60 and acute accent 0xB4 are mirror-symmetric diacritical
+ marks.
+
+ Note that this change has no effect on _input_ conventions for
+ roff source documents. You can still get directional single
+ quotes on UTF-8, PostScript, PDF, and other output devices
+ supporting them by typing sequences like `this' in the input
+ {character remapping with ".char" requests and similar
+ notwithstanding}.
+
+ Patch and idea from Ingo Schwarze, who originally proposed it
+ for ASCII as well, and included Latin-1 for parallelism.
+ The groff developers could reach no consensus about the wisdom
+ of such a change for ASCII (which was designed to support
+ ambiguity for some code points, requiring the development of
+ supplementary interpretation conventions between parties).
+ ECMA-94/ISO-8859 is more strongly prescriptive.
+
+ See https://savannah.gnu.org/bugs/?55616 and the groff mailing
+ list archives for 31 January to 23 February 2019 at
+ https://lists.gnu.org/archive/html/groff for lengthy discussion.
+
+ * src/roff/groff/tests/on-latin1-device-oq-is-0x27.sh: Check for
+ correct output glyph.
+
+ * src/roff/groff/groff.am: Add test.
+
+2019-06-28 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ * tmac/unicode.tmac: Save and restore compatibility mode since
+ the script uses a GNU extension (.char).
+
+2019-06-27 G. Branden Robinson <g.branden.robinson@gmail.com>
+
+ libdriver: Fix SEGV (Savannah #56555).
+
+ * src/libs/libdriver/printer.cpp: Check result of
+ set_char_and_width() for error condition before relying on it.
+
+ * src/roff/groff/tests/regression-56555.sh: Provoke segfault
+ with five bytes of input using transparent line indicator.
+
+ * src/roff/groff/groff.am: Add test.
+
+ Fixes <https://savannah.gnu.org/bugs/?55278>.
+
+2019-01-12 Ingo Schwarze <schwarze@openbsd.org>
+
+ Correctly handle groff_mdoc(7) .Lk arguments starting with a
+ dot.
+
+ * tmac/doc.tmac-u: Each argument to the .Lk macro is printed
+ on its own roff input line. If it happens to start with a dot
+ or apostroph, it was misinterpreted as a request or macro.
+ Force it to be treated as text by adding "\&" in front of it.
+
+2018-12-31 Ingo Schwarze <schwarze@openbsd.org>
+
+ * man/groff_diff.7.man: remove two stray .RE macros
+
+
+________________________________________________________________________
+
+##### License
+
+Copyright 2018-2021 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
+
+##### Editor settings
Local Variables:
+fill-column: 72
+mode: change-log
version-control: never
-coding: latin-1
End:
+vim:set autoindent textwidth=72:
projects / platform / upstream / groff.git / blobdiff