summaryrefslogtreecommitdiff
path: root/ANNOUNCE
blob: a6bf2b5caa7c653d2eb18649837e9b7373276968 (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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
[[ maintainer: send to info-gnu, platform-testers ]]

groff 1.23 release candidate 2, 1.23.0.rc2, 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 formatted output in
PostScript, PDF, HTML, DVI formats or for display to the terminal.
Formatting commands can be low-level typesetting primitives or macros
from a supplied set.  Users may also write their own macros.  All three
may be combined.

Present on most Unix systems owing to its long association with Unix
manuals (including man pages), and notable for its use in the 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
=======

groff 1.23.0.rc2 represents nearly 2 years of development since the
previous release candidate, and nearly four since the last release.

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);
  * version 2.5 of Peter Schaffter's "mom" macro package;
  * the 'ms' package's new strings to assist subscripting; 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 and improving
documentation.

As of this writing, per the GNU Savannah bug tracker, the groff project
has resolved 351 problems as fixed for the 1.23.0 release.  Some of the
bugs we've corrected were over 30 years old.

Another way of capturing the amount of revision is as follows.

$ git diff --stat 1.22.4 HEAD | tail -n 1
 925 files changed, 110263 insertions(+), 64915 deletions(-)

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.rc2.tar.gz
yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy  groff-1.23.0.rc2.tar.gz

The SHA-256 checksum is encoded in Base64 instead of the hexadecimal
form that most checksum tools default to.

[*] 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.rc2.tar.gz

    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.

News
====

[[ maintainer: insert "sed -n '/VERSION 1\.23/,/VERSION 1.22/p' NEWS"
   and trim the ends a little ]]