summaryrefslogtreecommitdiffstats
path: root/FOR-RELEASE
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:44:05 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:44:05 +0000
commitd318611dd6f23fcfedd50e9b9e24620b102ba96a (patch)
tree8b9eef82ca40fdd5a8deeabf07572074c236095d /FOR-RELEASE
parentInitial commit. (diff)
downloadgroff-d318611dd6f23fcfedd50e9b9e24620b102ba96a.tar.xz
groff-d318611dd6f23fcfedd50e9b9e24620b102ba96a.zip
Adding upstream version 1.23.0.upstream/1.23.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'FOR-RELEASE')
-rw-r--r--FOR-RELEASE58
1 files changed, 58 insertions, 0 deletions
diff --git a/FOR-RELEASE b/FOR-RELEASE
new file mode 100644
index 0000000..592a48f
--- /dev/null
+++ b/FOR-RELEASE
@@ -0,0 +1,58 @@
+ 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
+ notice and this notice are preserved.
+
+This file describes how to prepare 'groff' for a new release.
+
+
+########################################################################
+
+* 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
+ src/utils/afmtodit/afmtodit.tables.
+
+ [1] E.g., <https://www.unicode.org/Public/15.0.0/ucd/UnicodeData.txt>.
+ Check for the latest _released_ version of Unicode at the time.
+ Data for the forthcoming release may be available.
+ [2] <https://github.com/adobe-type-tools/agl-aglfn/blob/master/\
+ glyphlist.txt>
+
+ (<https://raw.githubusercontent.com/adobe-type-tools/agl-aglfn/\
+ master/glyphlist.txt> may be more convenient.)
+
+* Update the 'gnulib' sub-module to the latest version and the
+ corresponding required commit hash identifier in 'INSTALL.REPO'.
+
+* Update the release version number where it is hard-coded.
+ + NEWS
+ + BUG-REPORT
+ + arch/mingw/grap2graph.cmd
+ + doc/groff.texi (multiple occurrences)
+ + doc/webpage.ms
+
+* If the major or minor version number is being incremented, split off
+ a historical ChangeLog file and add it to `EXTRA_DIST` in Makefile.am.
+
+* Update in 'src/roff/groff/groff.cpp' the 'printf' that displays the
+ copyright.
+
+* Update the copyright year with 'update-copyright.sh'.
+
+* Increment the version number by tagging the release, beta, or release
+ candidate. groff requires an explicit three-part version,
+ major.minor.revision, due to the .Y register.
+
+ $ git tag 1.23.0.rc1