| freepg-tools | ||
| master-freepg | ||
| STABLE-BRANCH-2-2-freepg | ||
| STABLE-BRANCH-2-4-freepg | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| CONTRIBUTING.md | ||
| DIFF.md | ||
| MAINTENANCE.md | ||
| README.md | ||
| SOURCES.md | ||
FreePG GnuPG patchset
The FreePG GnuPG patchset is a common resource for GnuPG downstream packagers to track, maintain, and apply commonly-used patches for GnuPG that have been refused by upstream.
Rationale
It is common for GnuPG downstream distributions to apply patches to change default policies and disable (or re-enable) support for various features. This results in duplication of effort, and an inconsistent experience for the end user. FreePG is intended to assist these downstreams to co-ordinate their patching efforts.
FreePG has the following goals:
- Minimise divergence from the IETF OpenPGP specification
- Support reading of LibrePGP artifacts for compatibility
- Fix security issues that remain unresolved upstream
- Support the maintenance needs of downstream distributions
See DIFF.md for a full list of current differences.
Usage
The FreePG project builds binaries for the purposes of testing, but does not distribute them or recommend their use in production. End users should consult their preferred downstream distribution for official binaries.
Branches
FreePG maintains a mirror of the GnuPG upstream stable and development branches, together with their patched equivalents:
| Upstream branch | Patched branch |
|---|---|
master |
master-freepg |
STABLE-BRANCH-2-4 |
STABLE-BRANCH-2-4-freepg |
STABLE-BRANCH-2-2 |
STABLE-BRANCH-2-2-freepg |
It is not recommended to use the master or master-freepg branches in a production environment.
All other branches, including the default branch main, are used to maintain the FreePG patchset.
Patches
Patches are sourced from various downstreams, see SOURCES.md for a (non-exhaustive) list.
The applied patches are kept in the *-freepg subdirectories of this directory.
These may differ from the downstream patches slightly due to merge conflict resolution, but are attributed to their original authors.
To contribute patches to FreePG, please follow the guidance in CONTRIBUTING.md .