Add page about terminology

Paul Schaub 2018-07-30 17:23:44 +02:00
parent 5f0a744d70
commit 24eb607caf
1 changed files with 12 additions and 0 deletions

12
Terminology.md Normal file

@ -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 |