summaryrefslogtreecommitdiff
path: root/FOR-RELEASE
blob: 7d2530e8d07fa1408670365bc3d526de2593b367 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
    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.


########################################################################

* 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
  src/utils/afmtodit/afmtodit.tables.

  [1] E.g., <https://www.unicode.org/Public/13.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>

* Update the 'gnulib' sub-module to the latest version.

* 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.

* Update in 'src/roff/groff/groff.cpp' the 'printf' that displays the
  copyright.

* Update the copyright year with 'update-copyright.sh'.