summaryrefslogtreecommitdiff
path: root/FOR-RELEASE
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2022-02-27 21:18:19 +1100
committerG. Branden Robinson <g.branden.robinson@gmail.com>2022-03-02 20:54:16 +1100
commit3c82cbbfe5c378f8fc274b93cce28624b19a1b8a (patch)
tree4ae6cfcad3b6800c438ce255fa057a12e71d259e /FOR-RELEASE
parentb225d5e4f48bb1e29589901fe7dbd6e805e8146d (diff)
downloadgroff-git-3c82cbbfe5c378f8fc274b93cce28624b19a1b8a.tar.gz
Refactor X11 font description generation.
Integrate it with our "new" (post-2014) Automake-based build system. * 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]). * src/utils/xtotroff/xtotroff.am: Define `xtotroff` variable for use by X11 font description generation targets below. * font/devX100-12/devX100-12.am [!WITHOUT_X11]: * font/devX100/devX100.am [!WITHOUT_X11]: * font/devX75-12/devX75-12.am [!WITHOUT_X11]: * font/devX75/devX75.am [!WITHOUT_X11]: Define devX*_fontdir variables here. * 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}-font-descriptions", 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). Add new devX*_fontsrcdir variable to distinguish the source directory for the font description files, and use it in the devX*_font-descriptions targets. * FOR-RELEASE: Document existence of "maintainer-font-descriptions" Make target and when to run it. 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. squash Refactor X11 font description generation.
Diffstat (limited to 'FOR-RELEASE')
-rw-r--r--FOR-RELEASE12
1 files changed, 11 insertions, 1 deletions
diff --git a/FOR-RELEASE b/FOR-RELEASE
index 6ed265040..7d2530e8d 100644
--- a/FOR-RELEASE
+++ b/FOR-RELEASE
@@ -1,4 +1,4 @@
- Copyright 2013-2021 Free Software Foundation, Inc.
+ Copyright 2013-2022 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
@@ -12,6 +12,16 @@ This file describes how to prepare `groff' for a new release.
* Increment the version number. groff requires an explicit three-part
version, major.minor.revision, due to the .Y register.
+* Update font description files that we generate from external data and
+ provide with our source distribution.
+
+ Directory Format Tool
+ --------- ------ ----
+ devX* X11 core/server font xtotroff
+
+ The make(1) target "maintainer-font-descriptions" produces these font
+ descriptions.
+
* Retrieve current versions of UnicodeData.txt[1] and the Adobe Glyph
List (AGL)[2], and use them with
src/utils/afmtodit/make-afmtodit-tables to update