From 24eb607cafa757e74eb00a0a2a589843ab7d7899 Mon Sep 17 00:00:00 2001 From: Paul Schaub Date: Mon, 30 Jul 2018 17:23:44 +0200 Subject: [PATCH] Add page about terminology --- Terminology.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 Terminology.md diff --git a/Terminology.md b/Terminology.md new file mode 100644 index 0000000..4a1525c --- /dev/null +++ b/Terminology.md @@ -0,0 +1,12 @@ +Since PGPainless is based on Bouncycastle, it follows some of the terminology introduced by Bouncycastle. That might be confusing for new users, especially for users coming from GnuPG. + +## Keys, KeyRings, KeyRingCollections + +What is considered a KeyRing in GnuPG (a collection of keys) is called a KeyRingCollection in Bouncycastle/PGPainless. +Similarly a Key in GnuPG is called a KeyRing in BC/PGPainless. This is due to the fact, that an OpenPGP key can actually consist of more than one key (master - subkey structures). A Key in BC/PGPainless is either a master key or a sub key. + +| PGPainless Term | GnuPG Term | Description | +|-------------------|----------------|--------------------------------------------------------------------------| +| KeyRingCollection | KeyRing/KeyBox | Collection of OpenPGP keys (either of a single user or of multiple users | +| KeyRing | Key | Master key which might have sub keys | +| Key | | Single key which might be a master key or a sub key | \ No newline at end of file