[[ maintainer: Send to platform-testers for betas/RCs, info-gnu for releases, and CC groff and linux-man@vger.kernel.org for both. ]] groff 1.23 release candidate 2, 1.23.0.rc3, is now available from GNU's alpha FTP site. You may download the distribution archive from there. https://alpha.gnu.org/gnu/groff/ What is groff? ============== groff (GNU roff) is a typesetting system that reads plain text input files that include formatting commands to produce output in PostScript, PDF, HTML, or DVI formats or for display to a terminal. Formatting commands can be low-level typesetting primitives, macros from a supplied package, or user-defined macros. All three approaches can be combined. A reimplementation and extension of the typesetter from AT&T Unix, groff is present on most POSIX systems owing to its long association with Unix manuals (including man pages). It and its predecessor are notable for their production of several best-selling software engineering texts. groff is capable of producing typographically sophisticated documents while consuming minimal system resources. https://www.gnu.org/software/groff/ Changes ======= Since groff 1.22.4 was released in December 2018, 26 people have made a total of over 4,500 commits. [[ maintainer: Insert output of "git shortlog --summary --email 1.22.4..HEAD" _just before tagging_ 1.23.0 so that all commits are captured. ]] Headline features nominated by our development community include: * a new 'man' macro, "MR", for formatting man page cross references; * hyperlinked text in terminals via the ECMA-48 OSC 8 escape sequence; * a new 'rfc1345' macro package, contributed by Dorai Sitaram, enabling use of RFC 1345 mnemonics as groff special characters; * a new 'sboxes' macro package, contributed by Deri James, enabling 'ms' documents to place shaded and/or bordered rectangles underneath any groff page elements (PDF output only); * 'mom' 2.5, a macro package contributed by Peter Schaffter; * the 'ms' package's new strings to assist subscripting; * Italian localization, including hyphenation patterns and macro package string translations, thanks to Edmond Orignac; and * new hyphenation patterns for English. For more on these and other feature changes, see "News" below. Much attention has been given to fixing bugs, improving diagnostic messages, and correcting and expanding documentation. The previous release shipped with three automated unit tests; this one ships with over 160 unit and regression tests. As of this writing, per the GNU Savannah bug tracker, the groff project has resolved 415 problems as fixed for the 1.23.0 release. Some of the bugs we've corrected were over 30 years old. Classifying these issues by type and the component of the project to which they apply, we find the following. Type Component ---- --------- Build/installation 38 Core 96 Crash/unresponsive 11 Driver: grohtml 7 Documentation 101 Driver: gropdf 9 Feature change 40 Driver: grops 2 Incorrect behavior 129 Driver: grotty 4 Lint 15 Driver: others/general 8 Rendering/cosmetics 10 Font: devpdf 1 Test 4 Font: devps 3 Warning/suspicious behavior 67 Font: others/general 4 General 46 Macros: man 33 Macros: mdoc 13 Macros: me 36 Macros: mm 20 Macros: mom 11 Macros: ms 27 Macros: other/general 26 Preprocessor: eqn 5 Preprocessor: grn 3 Preprocessor: pic 5 Preprocessor: preconv 7 Preprocessor: refer 3 Preprocessor: tbl 23 Preprocessor: others/general 5 Utilities 18 Another way of capturing the amount of revision is as follows. $ git diff --stat 1.22.4 1.23.0 | tail -n 1 [[ maintainer: insert output ]] Obtaining groff =============== Here are the compressed sources and a GPG detached signature[*]. [[ maintainer: insert .tar.gz URL ]] [[ maintainer: insert .tar.gz.sig URL ]] [[ maintainer: include the following for final release: Use a mirror for higher download bandwidth. https://ftpmirror.gnu.org/groff/groff-1.23.0.tar.gz https://ftpmirror.gnu.org/groff/groff-1.23.0.tar.gz.sig ]] Here are the SHA-1 and SHA-256 checksums. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx groff-1.23.0.rc3.tar.gz yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy groff-1.23.0.rc3.tar.gz The SHA-256 checksum is encoded in Base64 instead of the hexadecimal form that most checksum tools default to. The mechanism follows. sha256sum < groff-1.23.0.rc3.tar.gz | cut -f1 -d\ | xxd -r -p | base64 [*] Use a .sig file to verify that the corresponding file (without the .sig suffix) is intact. First, be sure to download both the .sig file and the corresponding archive. Then, verify the archive. gpg --verify groff-1.23.0.rc3.tar.gz{.sig,} If that command fails because you don't have the required public key, you can import it. gpg --keyserver keys.gnupg.net --recv-keys [[ maintainer: keyID ]] Re-run the 'gpg --verify' command subsequently. Caveats ======= o A failure in automated testing occurs (if you run "make check") for gdiffmk if GNU diffutils 3.9 is used. This is a known problem with that release; see . o Some automated test failures (if you run "make check") are expected on macOS. These are due to differences between GNU and BSD-descended versions of POSIX-standardized utilities. We hope to resolve these for final release. The following tests are affected. tmac/tests/an_TS-adds-no-vertical-space.sh tmac/tests/an_use-input-traps-correctly.sh tmac/tests/doc_heading-font-remapping-works.sh tmac/tests/latin2_works.sh tmac/tests/latin5_works.sh tmac/tests/latin9_works.sh o Solaris 10 also has known problems with automated tests; see the "PROBLEMS" file in the distribution archive. News ==== [[ maintainer: insert output of "sed -n '/VERSION 1\.23/{n;:X;n;/VERSION 1\.22/q;p;bX}' NEWS" ]] Acknowledgements ================ We'd like to thank the following people for helping ensure the quality of this release. [[ maintainer: Collect "thanks to" credits from the ChangeLog file, for instance with "grep -i -A1 thanks ChangeLog". A manual merge of similar from the contrib/ change log files may also be necessary. ]] "hackerb9" Alan D. Salewski Alex Colomar Alexander Kanavin Andreas Kusalananda Kähäri Axel Kielhorn Ben Wong Bertrand Garrigues Bjarni Ingi Gislason Blake McBride Bruno Haible Colin Watson Dave Kemper Deri James Dorai Sitaram Doug McIlroy Florent Rougon Gene Hans Bezemer Ingo Schwarze Jeff Conrad Jeremy Puhlman John Gardner KUBO Koichi Keith Marshall Ken Mandelberg Nikita Ivanov Oliver Corff Olle Lögdahl Osamu Sayama Peter Schaffter Petru-Florin Mihancea Quentin Monnet Raf Czlonka Rafal Pietrak Ralph Corderoy Robert Bihlmeyer Robert Goulding Russ Allbery Sergei Trofimovich Steffen Nurpmeso T. Kurt Bond Tadziu Hoffman Thomas Dupond Werner Lemberg Wim Stockman наб