Add documentation for exception accessor methods

Make sub throw a class method on all exceptions

The throw sub can still be called as a function, since its syntax is
easily compatible both ways.  When called as a function, the exception
type may be abbreviated.

Add documentation for "split-zone" keymaster command to manual

Add "split-zone" keymaster command

Replace magic numbers in flock calls with symbolic constants

This also fixes a long-standing bug where the serials file was never
actually unlocked until it was closed, at which time the kernel will
implicitly release the lock.  The cause of the bug, simply, was the use
of the wrong number in place of LOCK_UN.  Using the constant fixes this.

Add separate serials flag file for flock in gatekeeper

The flag file is zero-length and simply exists as a place to use flock.
This will eventually allow maintaining a lock while rewriting the serials
file using the traditional copy-and-rename method.

Ensure that directories mentioned in keymaster test configurations exist

Copy filename validation patterns to keymaster

Add direct serials file database checks to timestamp ratchet tests

Add serials file timestamp database checks to upload triplet tests

Add testsuite infrastructure for checking use of timestamp database

Combine shared testsuite infrastructure code

Move testsuite tool init files to dedicated directory

Tidy whitespace

Add initial preliminary manual

Ignore generated documentation files

Fix misunderstanding in FTP index builder

Handle tainted values if --with-gpgv or --with-lsof options are used

Expand FTP index builder tool

Use FTP index builder in gatekeeper source tree

Remove "send-gpg-public-keys.sh"

With the ongoing attacks on the public synchronizing keyservers, this tool is
no longer useful.

Rename "generate-ftpindex.sh" to "make-ftpindex.sh"

The shorter name fits better in Info menus.

Document "--with-gpg" keymaster option

Fix documentation error

Fix documentation formatting error

Remove "serials" configuration parameter

The serials file is now always name "serials" in pkgstatedir.

Rename "maintainermap" configuration item to "maintainerlist"

Use proper pkgstatedir with testsuite

Move email addresses to configuration file

The testsuite is expanded to cover the new options.

Ignore default configuration file

This prevents a user's configuration from being picked up into a local
repository and complicating future updates from upstream repositories.

Enforce MAX_FILE_NAME_LEN on implied directory names

A test is added to verify this check.

Remove symlinks to gatekeeper

Update online help to reflect move of zones to configuration

Import GNU Free Documentation License 1.3

Import Texinfo macros

Remove unneeded "global spawn_id" links in testsuite

Fix bug in test driver

This bug was exposed in commit fc58d8e82444d9f949f2ac5cbbed928ad6b12c30,
but only affected testsuite runs when coverage data is collected.

The exact cause is unknown, but that commit changed the processing used
for verifying signatures and the bug caused the testsuite to prematurely
declare the gatekeeper run complete and move on to the next test when a
signature was verified.  Presumably, the improved signature verification
somehow interacted poorly with Expect.

Bizarrely, the issue only occurred when Devel::Cover was used to check
the coverage of the testsuite and did not occur under regular testing.
The root cause is surely timing related, since perl is much slower when
collecting code coverage data.  This is also the reason the bug went
unnoticed for so long:  coverage runs are infrequent except when making
improvements to the testsuite.

Refactor configuration as constants in the gatekeeper

This commit also allows some parameters to be optional.

Revise global storage for serials file name

The serials file is now stored in the package state directory and is
named relative to that directory in the configuration.

Remove ZONE constant and rename variable

Remove obsolete "-s" alias for --zone option

Add tests to complete code coverage for configuration parsing

Add overlooked configuration item

Add tests for gatekeeper configuration parsing

Add blank line in testsuite output before version message

The keymaster tests already have this line.

Add initial configuration support to gatekeeper

Add options for specifying gpgv and lsof tools

This aligns the gatekeeper with the keymaster and permits the external
tools to be placed in a nonstandard location if desired.

Report an error if an unrecognized option is given to the gatekeeper

Revise version message in gatekeeper

This brings the output of ./gatekeeper.pl --version in line with current
GNU standards and moves the copyright notice to the top of the file so
Emacs can easily find it for future updates.

Update copyright notice

Rename directive parsing phase and change tag "PV" to "PS"

While there is still some syntactic validation performed during this
phase, using the word "validation" for two steps seems likely to risk
confusion, so this phase is renamed in the interests of clarity.

The testsuite is adjusted accordingly.

Remove testsuite support for signature verifications during parsing

This was only present to accommodate the extra signature verification
that as previously used to obtain an email address.  The key index now
fills that requirement.

Align actual behavior with stated intent

Any directive with a valid signature from any known key should be sent
to the public archive; the internal archive catches the rest that could
include abusive messages from anonymous parties.  Previously, the code
could only reliably recognize a valid signature if the directive syntax
is valid.  The testsuite is adjusted accordingly.

Remove scaffolding that guessed email addresses from signatures

The key index is now queried for email addresses associated with the
key used to sign the directive.

Add key index support to gatekeeper

The testsuite is adjusted accordingly to handle signature verfications
during the report phase.

Add key index support in gatekeeper test infrastructure

Improve testsuite performance

I am not certain what exactly this tickles in Expect, but it dramatically
reduces the running time of the keymaster tests.

Remove obsolete scripts for tasks now handled using the keymaster tool

Add initial keymaster administrative tool and associated testsuite

Fix bug in testsuite keyring checks

Add support for whole-keyring export to mock gpg tool

Add --batch option to mock gpg tool

Add support for key revocation in mock gpg tool

Add mock gpg tool for listing and manipulating keyrings

Move infrastructure for failure tracking to common "mock" tool init file

Revise mock tool testsuite to prepare for additional tests

A mock GPG for handling keyrings will soon be added to support testing the
keymaster tool currently under early development.

Change default GNUPGHOME in mock signature verification tool

This reduces the possibility of confusion, and will be more important when
a mock GPG is implemented to support testing the keymaster tool.

Tidy whitespace

Remove "pgpg" helper script

Merge from upstream

minor: punctuation

minor: README

make README be a basic overview of this package

add license header to tiny scripts for completeness

add overlooked ftp-rmkey.sh file

Preserve error string during rename checks at initialization

The test file is unlinked if a rename call fails; this could reset $! to
indicate success, so the initial value of $! is saved first.

Rename "in-stage" directory to "scratch" directory

Rename "incoming" directory to "inbox" directory

Reorganize log message patterns in testsuite

This groups the message patterns by processing phase.

Prior to committing, this was validated with:
    (DIFF='git diff --cached';
     comm -3 <($DIFF | grep ^- | sed -e 's/^-//' | sort) \
             <($DIFF | grep ^+ | sed -e 's/^+//' | sort) )

The output shows only a blank line and diff headers.  To replicate, change
the "git diff" command to compare this commit with its parent.

Remove another piece of testsuite scaffolding

Remove testsuite scaffolding for verification during execution phase

All signatures are now verified before the execution phase begins.

Remove testsuite scaffolding for the validation phase

Remove testsuite logic that supported email outside of report phase

All email messages are now sent during the report phase.

Remove obsolete message pattern from testsuite

Add tests for inbox and scratch cleanup

Reorganize gatekeeper to reflect processing phases

Prior to committing, this was validated with:
    (DIFF='git diff --cached';
     comm -3 <($DIFF | grep ^- | sed -e 's/^-//' | sort) \
             <($DIFF | grep ^+ | sed -e 's/^+//' | sort) )

The output shows only blank lines, diff headers, POD structure, and the
addition of a forward declaration for verify_clearsigned_message as a
temporary measure ahead of a call that will eventually be removed, after
all lines are sorted and paired for analysis.  To replicate, change the
"git diff" command to compare this commit with its parent.

Remove obsolete comment

Move directive archival to report phase

Each successfully processed directive is sent to a public archival list,
but directives not signed with a known key or with invalid syntax are only
sent to the internal report inbox.

This commit also reverts the testsuite changes from the previous
commit f9e77b3dd2d94986ff095abd4c50fb957196b05b.

Refactor install_files as execute_install

This also moves staging files and validating that the "replace" option is
set if needed to top-level.

Factor move_filepair out of install_files

Merge execute_commands into top-level

Factor symlink operations out of execute_commands

Proofread POD

Convert section heading comments to POD section headings

This commit also removes some leftover comments.

Update internal documentation to reflect improvements

Add checks to avoid removing backup files in scan_incoming

Also update internal documentation and adjust testsuite to properly cover
the new edge case.

Revise calls to ftp_syslog

The ftp_syslog procedure now requires exactly two arguments and all calls
have been changed to use Perl's fat comma and its implicit quoting for the
syslog severity keywords.

Add POD block for ftp_syslog

Rename local variable in ftp_syslog

This change of terms aligns with RFC3164.

Fixup oversights in recent commits