Copyright 2013-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.

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.

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