Further tweak the wrapping heuristic

Change the heuristic for when to refrain from wrapping output
paragraphs to ignore the indentation, and increase the threshold
for a short line to 45 characters from 40.

10 files changed, 621 insertions, 0 deletions

diff --git a/t/data/generate/pgp-sign/metadata/blurb b/t/data/generate/pgp-sign/metadata/blurb
new file mode 100644
index 0000000..e2f3ad8
--- /dev/null
+++ b/t/data/generate/pgp-sign/metadata/blurb
@@ -0,0 +1,3 @@
+PGP::Sign is a Perl module for generating and verifying detached OpenPGP
+signatures of textual data using GnuPG.  It was written to support Netnews
+article signatures for signed control messages and PGPMoose.
diff --git a/t/data/generate/pgp-sign/metadata/debian/summary b/t/data/generate/pgp-sign/metadata/debian/summary
new file mode 100644
index 0000000..4688382
--- /dev/null
+++ b/t/data/generate/pgp-sign/metadata/debian/summary
@@ -0,0 +1 @@
+PGP::Sign is packaged for Debian as libpgp-sign-perl.
diff --git a/t/data/generate/pgp-sign/metadata/description b/t/data/generate/pgp-sign/metadata/description
new file mode 100644
index 0000000..f41e56d
--- /dev/null
+++ b/t/data/generate/pgp-sign/metadata/description
@@ -0,0 +1,24 @@
+PGP::Sign is a Perl module that can generate and verify OpenPGP signatures
+on some data.  Currently, only textual data (data that can be processed
+using GnuPG's `--textmode` option) is supported.  It uses GnuPG under the
+hood to do the work.
+
+The original purpose of this module was to factor out common code in a
+News::Article class written by Andrew Gierth that handled PGPMoose and
+control message signatures.  It is used to verify control message
+signatures for the ftp.isc.org Netnews metadata archive, and to generate
+signed control messages for the Big Eight Usenet hierarchies.
+
+Data to be signed or verified can be passed into PGP::Sign in a wide
+variety of formats: scalars, arrays, open files, even code references that
+act as generators.  Keys with passphrases are supported and the passphrase
+is passed to GnuPG securely (although getting the passphrase to the
+PGP::Sign module is a problem for the calling application).
+
+This module supports both GnuPG v2 and GnuPG v1 and, when used with GnuPG
+v1, supports using OpenPGP keys and generating and verifying signatures
+that are backward-compatible with PGP 2.6.2.
+
+PGP::Sign provides both a (recommended) object-oriented API and a (legacy)
+function-based API that uses global variables for configuration and is
+backward-compatible with earlier versions of PGP::Sign.
diff --git a/t/data/generate/pgp-sign/metadata/metadata.json b/t/data/generate/pgp-sign/metadata/metadata.json
new file mode 100644
index 0000000..3a99430
--- /dev/null
+++ b/t/data/generate/pgp-sign/metadata/metadata.json
@@ -0,0 +1,61 @@
+{
+    "name": "PGP::Sign",
+    "version": "1.00",
+    "synopsis": "create and verify detached PGP signatures",
+    "maintainer": "Russ Allbery <rra@cpan.org>",
+    "copyrights": [
+        {
+            "holder": "Russ Allbery <rra@cpan.org>",
+            "years": "1997-2000, 2002, 2004, 2018, 2020",
+        },
+    ],
+    "license": "Perl",
+    "build": {
+        "lancaster": true,
+        "type": "Module::Build",
+    },
+    "support": {
+        "cpan": "PGP-Sign",
+        "email": "rra@cpan.org",
+        "web": "https://www.eyrie.org/~eagle/software/pgp-sign/",
+    },
+    "vcs": {
+        "type": "Git",
+        "url": "https://git.eyrie.org/git/perl/pgp-sign.git",
+        "browse": "https://git.eyrie.org/?p=perl/pgp-sign.git",
+        "github": "rra/pgp-sign",
+        "status": {
+            "workflow": "build",
+        },
+    },
+    "quote": {
+        "author": "William Shakespeare",
+        "work": "Hamlet",
+        "broken": true,
+    },
+    "distribution": {
+        "section": "perl",
+        "tarname": "PGP-Sign",
+        "version": "pgp-sign",
+        "cpan": "PGP-Sign",
+        "ignore": [
+            "^t/data/gnupg1/random_seed$",
+            "^t/data/gnupg./trustdb\\.gpg$",
+        ],
+    },
+    "packaging": {
+        "debian": "libpgp-sign-perl",
+    },
+    "docs": {
+        "user": [
+            {
+                "name": "docs",
+                "title": "Module documentation",
+            },
+            {
+                "name": "thanks",
+                "title": "Thanks and credits",
+            },
+        ],
+    },
+}
diff --git a/t/data/generate/pgp-sign/metadata/quote b/t/data/generate/pgp-sign/metadata/quote
new file mode 100644
index 0000000..df57c5e
--- /dev/null
+++ b/t/data/generate/pgp-sign/metadata/quote
@@ -0,0 +1,3 @@
+This above all: to thine own self be true,
+And it must follow, as the night the day,
+Thou canst not then be false to any man.
diff --git a/t/data/generate/pgp-sign/metadata/requirements b/t/data/generate/pgp-sign/metadata/requirements
new file mode 100644
index 0000000..0b07801
--- /dev/null
+++ b/t/data/generate/pgp-sign/metadata/requirements
@@ -0,0 +1,9 @@
+Perl 5.20 or later and Module::Build are required to build this module,
+and IPC::Run is required to use it.  Either GnuPG v2 or GnuPG v1
+(selectable at runtime) is also required.  It has not been tested with
+versions of GnuPG older than 1.4.23.
+
+PGP::Sign uses IPC::Run features that are documented as not available on
+Windows (primarily higher-numbered file descriptors) and has never been
+tested with Gpg4win, so will probably not work on Windows (or, for that
+matter, other non-UNIX systems).
diff --git a/t/data/generate/pgp-sign/metadata/test/suffix b/t/data/generate/pgp-sign/metadata/test/suffix
new file mode 100644
index 0000000..8125372
--- /dev/null
+++ b/t/data/generate/pgp-sign/metadata/test/suffix
@@ -0,0 +1,14 @@
+The following additional Perl modules will be used by the test suite if
+present:
+
+* Devel::Cover
+* Test::MinimumVersion
+* Test::Perl::Critic
+* Test::Pod
+* Test::Pod::Coverage
+* Test::Spelling
+* Test::Strict
+* Test::Synopsis
+
+All are available on CPAN.  Those tests will be skipped if the modules are
+not available.
diff --git a/t/data/generate/pgp-sign/output/readme b/t/data/generate/pgp-sign/output/readme
new file mode 100644
index 0000000..3216fe7
--- /dev/null
+++ b/t/data/generate/pgp-sign/output/readme
@@ -0,0 +1,163 @@
+                              PGP::Sign 1.00
+               (create and verify detached PGP signatures)
+                Maintained by Russ Allbery <rra@cpan.org>
+
+  Copyright 1997-2000, 2002, 2004, 2018, 2020 Russ Allbery <rra@cpan.org>.
+  This software is distributed under the same terms as Perl itself.
+  Please see the section LICENSE below for more information.
+
+BLURB
+
+  PGP::Sign is a Perl module for generating and verifying detached OpenPGP
+  signatures of textual data using GnuPG.  It was written to support
+  Netnews article signatures for signed control messages and PGPMoose.
+
+DESCRIPTION
+
+  PGP::Sign is a Perl module that can generate and verify OpenPGP
+  signatures on some data.  Currently, only textual data (data that can be
+  processed using GnuPG's --textmode option) is supported.  It uses GnuPG
+  under the hood to do the work.
+
+  The original purpose of this module was to factor out common code in a
+  News::Article class written by Andrew Gierth that handled PGPMoose and
+  control message signatures.  It is used to verify control message
+  signatures for the ftp.isc.org Netnews metadata archive, and to generate
+  signed control messages for the Big Eight Usenet hierarchies.
+
+  Data to be signed or verified can be passed into PGP::Sign in a wide
+  variety of formats: scalars, arrays, open files, even code references
+  that act as generators.  Keys with passphrases are supported and the
+  passphrase is passed to GnuPG securely (although getting the passphrase
+  to the PGP::Sign module is a problem for the calling application).
+
+  This module supports both GnuPG v2 and GnuPG v1 and, when used with
+  GnuPG v1, supports using OpenPGP keys and generating and verifying
+  signatures that are backward-compatible with PGP 2.6.2.
+
+  PGP::Sign provides both a (recommended) object-oriented API and a
+  (legacy) function-based API that uses global variables for configuration
+  and is backward-compatible with earlier versions of PGP::Sign.
+
+REQUIREMENTS
+
+  Perl 5.20 or later and Module::Build are required to build this module,
+  and IPC::Run is required to use it.  Either GnuPG v2 or GnuPG v1
+  (selectable at runtime) is also required.  It has not been tested with
+  versions of GnuPG older than 1.4.23.
+
+  PGP::Sign uses IPC::Run features that are documented as not available on
+  Windows (primarily higher-numbered file descriptors) and has never been
+  tested with Gpg4win, so will probably not work on Windows (or, for that
+  matter, other non-UNIX systems).
+
+BUILDING AND INSTALLATION
+
+  PGP::Sign uses Module::Build and can be installed using the same process
+  as any other Module::Build module:
+
+      perl Build.PL
+      ./Build
+      ./Build install
+
+  You will have to run the last command as root unless you're installing
+  into a local Perl module tree in your home directory.
+
+TESTING
+
+  PGP::Sign comes with a test suite, which you can run after building
+  with:
+
+      ./Build test
+
+  If a test fails, you can run a single test with verbose output via:
+
+      ./Build test --test_files <path-to-test>
+
+  The following additional Perl modules will be used by the test suite if
+  present:
+
+  * Devel::Cover
+  * Test::MinimumVersion
+  * Test::Perl::Critic
+  * Test::Pod
+  * Test::Pod::Coverage
+  * Test::Spelling
+  * Test::Strict
+  * Test::Synopsis
+
+  All are available on CPAN.  Those tests will be skipped if the modules
+  are not available.
+
+  To enable tests that don't detect functionality problems but are used to
+  sanity-check the release, set the environment variable RELEASE_TESTING
+  to a true value.  To enable tests that may be sensitive to the local
+  environment or that produce a lot of false positives without uncovering
+  many problems, set the environment variable AUTHOR_TESTING to a true
+  value.
+
+SUPPORT
+
+  The PGP::Sign web page at:
+
+      https://www.eyrie.org/~eagle/software/pgp-sign/
+
+  will always have the current version of this package, the current
+  documentation, and pointers to any additional resources.
+
+  For bug tracking, use the CPAN bug tracker at:
+
+      https://rt.cpan.org/Dist/Display.html?Name=PGP-Sign
+
+  However, please be aware that I tend to be extremely busy and work
+  projects often take priority.  I'll save your report and get to it as
+  soon as I can, but it may take me a couple of months.
+
+SOURCE REPOSITORY
+
+  PGP::Sign is maintained using Git.  You can access the current source on
+  GitHub at:
+
+      https://github.com/rra/pgp-sign
+
+  or by cloning the repository at:
+
+      https://git.eyrie.org/git/perl/pgp-sign.git
+
+  or view the repository via the web at:
+
+      https://git.eyrie.org/?p=perl/pgp-sign.git
+
+  The eyrie.org repository is the canonical one, maintained by the author,
+  but using GitHub is probably more convenient for most purposes.  Pull
+  requests are gratefully reviewed and normally accepted.  It's probably
+  better to use the CPAN bug tracker than GitHub issues, though, to keep
+  all Perl module issues in the same place.
+
+LICENSE
+
+  The PGP::Sign package as a whole is covered by the following copyright
+  statement and license:
+
+    Copyright 1997-2000, 2002, 2004, 2018, 2020
+        Russ Allbery <rra@cpan.org>
+
+    This program is free software; you may redistribute it and/or modify
+    it under the same terms as Perl itself.  This means that you may
+    choose between the two licenses that Perl is released under: the GNU
+    GPL and the Artistic License.  Please see your Perl distribution for
+    the details and copies of the licenses.
+
+  Some files in this distribution are individually released under
+  different licenses, all of which are compatible with the above general
+  package license but which may require preservation of additional
+  notices.  All required notices, and detailed information about the
+  licensing of each file, are recorded in the LICENSE file.
+
+  Files covered by a license with an assigned SPDX License Identifier
+  include SPDX-License-Identifier tags to enable automated processing of
+  license information.  See https://spdx.org/licenses/ for more
+  information.
+
+  For any copyright range specified by files in this package as YYYY-ZZZZ,
+  the range specifies every single year in that closed interval.
diff --git a/t/data/generate/pgp-sign/output/readme-md b/t/data/generate/pgp-sign/output/readme-md
new file mode 100644
index 0000000..18ccc65
--- /dev/null
+++ b/t/data/generate/pgp-sign/output/readme-md
@@ -0,0 +1,163 @@
+# PGP::Sign 1.00
+
+[![Build
+status](https://github.com/rra/pgp-sign/workflows/build/badge.svg)](https://github.com/rra/pgp-sign/actions)
+[![CPAN
+version](https://img.shields.io/cpan/v/PGP-Sign)](https://metacpan.org/release/PGP-Sign)
+[![License](https://img.shields.io/cpan/l/PGP-Sign)](https://github.com/rra/pgp-sign/blob/master/LICENSE)
+[![Debian
+package](https://img.shields.io/debian/v/libpgp-sign-perl)](https://tracker.debian.org/pkg/libpgp-sign-perl)
+
+Copyright 1997-2000, 2002, 2004, 2018, 2020 Russ Allbery <rra@cpan.org>.
+This software is distributed under the same terms as Perl itself.  Please
+see the section [License](#license) below for more information.
+
+## Blurb
+
+PGP::Sign is a Perl module for generating and verifying detached OpenPGP
+signatures of textual data using GnuPG.  It was written to support Netnews
+article signatures for signed control messages and PGPMoose.
+
+## Description
+
+PGP::Sign is a Perl module that can generate and verify OpenPGP signatures
+on some data.  Currently, only textual data (data that can be processed
+using GnuPG's `--textmode` option) is supported.  It uses GnuPG under the
+hood to do the work.
+
+The original purpose of this module was to factor out common code in a
+News::Article class written by Andrew Gierth that handled PGPMoose and
+control message signatures.  It is used to verify control message
+signatures for the ftp.isc.org Netnews metadata archive, and to generate
+signed control messages for the Big Eight Usenet hierarchies.
+
+Data to be signed or verified can be passed into PGP::Sign in a wide
+variety of formats: scalars, arrays, open files, even code references that
+act as generators.  Keys with passphrases are supported and the passphrase
+is passed to GnuPG securely (although getting the passphrase to the
+PGP::Sign module is a problem for the calling application).
+
+This module supports both GnuPG v2 and GnuPG v1 and, when used with GnuPG
+v1, supports using OpenPGP keys and generating and verifying signatures
+that are backward-compatible with PGP 2.6.2.
+
+PGP::Sign provides both a (recommended) object-oriented API and a (legacy)
+function-based API that uses global variables for configuration and is
+backward-compatible with earlier versions of PGP::Sign.
+
+## Requirements
+
+Perl 5.20 or later and Module::Build are required to build this module,
+and IPC::Run is required to use it.  Either GnuPG v2 or GnuPG v1
+(selectable at runtime) is also required.  It has not been tested with
+versions of GnuPG older than 1.4.23.
+
+PGP::Sign uses IPC::Run features that are documented as not available on
+Windows (primarily higher-numbered file descriptors) and has never been
+tested with Gpg4win, so will probably not work on Windows (or, for that
+matter, other non-UNIX systems).
+
+## Building and Installation
+
+PGP::Sign uses Module::Build and can be installed using the same process
+as any other Module::Build module:
+
+```
+    perl Build.PL
+    ./Build
+    ./Build install
+```
+
+You will have to run the last command as root unless you're installing
+into a local Perl module tree in your home directory.
+
+## Testing
+
+PGP::Sign comes with a test suite, which you can run after building with:
+
+```
+    ./Build test
+```
+
+If a test fails, you can run a single test with verbose output via:
+
+```
+    ./Build test --test_files <path-to-test>
+```
+
+The following additional Perl modules will be used by the test suite if
+present:
+
+* Devel::Cover
+* Test::MinimumVersion
+* Test::Perl::Critic
+* Test::Pod
+* Test::Pod::Coverage
+* Test::Spelling
+* Test::Strict
+* Test::Synopsis
+
+All are available on CPAN.  Those tests will be skipped if the modules are
+not available.
+
+To enable tests that don't detect functionality problems but are used to
+sanity-check the release, set the environment variable `RELEASE_TESTING`
+to a true value.  To enable tests that may be sensitive to the local
+environment or that produce a lot of false positives without uncovering
+many problems, set the environment variable `AUTHOR_TESTING` to a true
+value.
+
+## Support
+
+The [PGP::Sign web page](https://www.eyrie.org/~eagle/software/pgp-sign/)
+will always have the current version of this package, the current
+documentation, and pointers to any additional resources.
+
+For bug tracking, use the [CPAN bug
+tracker](https://rt.cpan.org/Dist/Display.html?Name=PGP-Sign).  However,
+please be aware that I tend to be extremely busy and work projects often
+take priority.  I'll save your report and get to it as soon as I can, but
+it may take me a couple of months.
+
+## Source Repository
+
+PGP::Sign is maintained using Git.  You can access the current source on
+[GitHub](https://github.com/rra/pgp-sign) or by cloning the repository at:
+
+https://git.eyrie.org/git/perl/pgp-sign.git
+
+or [view the repository on the
+web](https://git.eyrie.org/?p=perl/pgp-sign.git).
+
+The eyrie.org repository is the canonical one, maintained by the author,
+but using GitHub is probably more convenient for most purposes.  Pull
+requests are gratefully reviewed and normally accepted.  It's probably
+better to use the CPAN bug tracker than GitHub issues, though, to keep all
+Perl module issues in the same place.
+
+## License
+
+The PGP::Sign package as a whole is covered by the following copyright
+statement and license:
+
+> Copyright 1997-2000, 2002, 2004, 2018, 2020
+>     Russ Allbery <rra@cpan.org>
+>
+> This program is free software; you may redistribute it and/or modify it
+> under the same terms as Perl itself.  This means that you may choose
+> between the two licenses that Perl is released under: the GNU GPL and the
+> Artistic License.  Please see your Perl distribution for the details and
+> copies of the licenses.
+
+Some files in this distribution are individually released under different
+licenses, all of which are compatible with the above general package
+license but which may require preservation of additional notices.  All
+required notices, and detailed information about the licensing of each
+file, are recorded in the LICENSE file.
+
+Files covered by a license with an assigned SPDX License Identifier
+include SPDX-License-Identifier tags to enable automated processing of
+license information.  See https://spdx.org/licenses/ for more information.
+
+For any copyright range specified by files in this package as YYYY-ZZZZ,
+the range specifies every single year in that closed interval.
diff --git a/t/data/generate/pgp-sign/output/thread b/t/data/generate/pgp-sign/output/thread
new file mode 100644
index 0000000..9fe4fdf
--- /dev/null
+++ b/t/data/generate/pgp-sign/output/thread
@@ -0,0 +1,180 @@
+\==[doc]      [2] [\bullet(packed)[\link[\1][\2]]]
+\==[program]  [3]
+    [\tablerow[\1 \version[\2]] [\release[\2]]
+        [\link[https://archives.eyrie.org/software/\3.tar.gz][tar.gz]
+        (\link[https://archives.eyrie.org/software/\3.tar.gz.asc]
+              [PGP signature])]
+        [\link[https://archives.eyrie.org/software/\3.tar.xz][tar.xz]
+        (\link[https://archives.eyrie.org/software/\3.tar.xz.asc]
+              [PGP signature])]]
+\==[download] [3]
+    [\1 \version[\2]\break
+     \link[https://archives.eyrie.org/software/\3.tar.gz][tar.gz]
+     (\link[https://archives.eyrie.org/software/\3.tar.gz.asc]
+           [signature])\break
+     \link[https://archives.eyrie.org/software/\3.tar.xz][tar.xz]
+     (\link[https://archives.eyrie.org/software/\3.tar.xz.asc]
+           [signature])\break
+    Released \release[\2]]
+
+\heading[PGP::Sign][software]
+
+\h1[PGP::Sign]
+
+\quote(broken)[
+
+    This above all: to thine own self be true,
+    And it must follow, as the night the day,
+    Thou canst not then be false to any man.
+
+][William Shakespeare][\cite[Hamlet]]
+
+\div(sidebar)[
+    \h2[Download]
+
+    \download[PGP::Sign][pgp-sign]
+        [perl/PGP-Sign-\version[pgp-sign]]
+
+    \link[https://packages.debian.org/source/sid/libpgp-sign-perl]
+         [Debian packages] \break
+    \link[https://archives.eyrie.org/software/ARCHIVE/PGP-Sign/]
+         [Archive]
+
+    \h2[Documentation]
+
+    \link[readme.html][General overview] \break
+    \link[news.html][Change summary] \break
+    \link[docs.html][Module documentation] \break
+    \link[thanks.html][Thanks and credits]
+
+    \h2[Development]
+
+    \link[todo.html][To-do list] \break
+    \link[https://github.com/rra/pgp-sign]
+         [GitHub] \break
+    \link[https://rt.cpan.org/Dist/Display.html?Name=PGP-Sign]
+         [Bug tracker] \break
+    \link[https://git.eyrie.org/?p=perl/pgp-sign.git]
+         [Git repository] \break
+    \link[https://metacpan.org/release/PGP-Sign]
+         [MetaCPAN] \break
+    \link[https://tracker.debian.org/pkg/libpgp-sign-perl]
+         [Debian package tracker]
+]
+
+\h2[Blurb]
+
+PGP::Sign is a Perl module for generating and verifying detached OpenPGP
+signatures of textual data using GnuPG.  It was written to support Netnews
+article signatures for signed control messages and PGPMoose.
+
+\h2[Description]
+
+PGP::Sign is a Perl module that can generate and verify OpenPGP signatures
+on some data.  Currently, only textual data (data that can be processed
+using GnuPG's \code[--textmode] option) is supported.  It uses GnuPG under
+the hood to do the work.
+
+The original purpose of this module was to factor out common code in a
+News::Article class written by Andrew Gierth that handled PGPMoose and
+control message signatures.  It is used to verify control message
+signatures for the ftp.isc.org Netnews metadata archive, and to generate
+signed control messages for the Big Eight Usenet hierarchies.
+
+Data to be signed or verified can be passed into PGP::Sign in a wide
+variety of formats: scalars, arrays, open files, even code references that
+act as generators.  Keys with passphrases are supported and the passphrase
+is passed to GnuPG securely (although getting the passphrase to the
+PGP::Sign module is a problem for the calling application).
+
+This module supports both GnuPG v2 and GnuPG v1 and, when used with GnuPG
+v1, supports using OpenPGP keys and generating and verifying signatures
+that are backward-compatible with PGP 2.6.2.
+
+PGP::Sign provides both a (recommended) object-oriented API and a (legacy)
+function-based API that uses global variables for configuration and is
+backward-compatible with earlier versions of PGP::Sign.
+
+\h2[Requirements]
+
+Perl 5.20 or later and Module::Build are required to build this module,
+and IPC::Run is required to use it.  Either GnuPG v2 or GnuPG v1
+(selectable at runtime) is also required.  It has not been tested with
+versions of GnuPG older than 1.4.23.
+
+PGP::Sign uses IPC::Run features that are documented as not available on
+Windows (primarily higher-numbered file descriptors) and has never been
+tested with Gpg4win, so will probably not work on Windows (or, for that
+matter, other non-UNIX systems).
+
+\h2[Download]
+
+The distribution:
+
+\table[][
+    \program[PGP::Sign][pgp-sign]
+        [perl/PGP-Sign-\version[pgp-sign]]
+]
+
+An \link[https://archives.eyrie.org/software/ARCHIVE/PGP-Sign/] [archive
+of older releases] is also available.
+
+PGP::Sign is packaged for Debian as libpgp-sign-perl.  See the
+\link[https://tracker.debian.org/pkg/libpgp-sign-perl][Debian package
+tracker] for more information.
+
+PGP::Sign is available from CPAN as the
+\link[https://metacpan.org/release/PGP-Sign]
+[PGP-Sign distribution].
+
+PGP::Sign is maintained using the Git version control system.  To check
+out the current development tree, see
+\link[https://github.com/rra/pgp-sign][GitHub] or clone:
+
+\pre[    https://git.eyrie.org/git/perl/pgp-sign.git]
+
+Pull requests on GitHub are welcome.  You can also
+\link[https://git.eyrie.org/?p=perl/pgp-sign.git][browse the current
+development source].
+
+\h2[Documentation]
+
+User documentation:
+
+\doc[readme.html][README]
+\doc[news.html][Change summary]
+\doc[docs.html][Module documentation]
+\doc[thanks.html][Thanks and credits]
+\doc[license.html][License and copyright]
+
+Developer documentation:
+
+\doc[todo.html][To-do list]
+\doc[https://github.com/rra/pgp-sign]
+    [GitHub]
+\doc[https://rt.cpan.org/Dist/Display.html?Name=PGP-Sign]
+    [Bug tracker]
+
+\h2[License]
+
+The PGP::Sign package as a whole is covered by the following copyright and
+license:
+
+\block[
+
+    Copyright 1997-2000, 2002, 2004, 2018, 2020
+        Russ Allbery <rra@cpan.org>
+
+    This program is free software; you may redistribute it and/or modify
+    it under the same terms as Perl itself.  This means that you may
+    choose between the two licenses that Perl is released under: the GNU
+    GPL and the Artistic License.  Please see your Perl distribution for
+    the details and copies of the licenses.
+
+]
+
+Some individual source files are covered by other, compatible licenses.
+For complete copyright and license information, see the file
+\link[license.html][LICENSE] in the PGP::Sign source distribution.
+
+\signature