[PATCH] doc: Clarify --completes-needed and --marginals-needed.

[Damien Goutte-Gattat]

* doc/gpg.texi: Explain better how --completes-needed and
  --marginals-needed affect a user ID's validity.
* doc/DETAILS: Ditto.

--
New version of previously proposed patch, with better wording.

Signed-off-by: Damien Goutte-Gattat <dgouttegattat at incenp.org>
---
 doc/DETAILS  |  8 ++++----
 doc/gpg.texi | 10 ++++++----
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/doc/DETAILS b/doc/DETAILS
index 97079b0..78af8a9 100644
--- a/doc/DETAILS
+++ b/doc/DETAILS
@@ -250,10 +250,10 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB:
 
     - Field 4 :: Date trustdb was created in seconds since Epoch.
     - Field 5 :: Date trustdb will expire in seconds since Epoch.
-    - Field 6 :: Number of marginally trusted users to introduce a new
-                 key signer (gpg's option --marginals-needed).
-    - Field 7 :: Number of completely trusted users to introduce a new
-                 key signer.  (gpg's option --completes-needed)
+    - Field 6 :: Number of certifications from marginally trusted keys to
+                 fully validate a UID.  (gpg's option --marginals-needed)
+    - Field 7 :: Number of certifications from completely trusted keys to
+                 fully validate a UID.  (gpg's option --completes-needed)
 
     - Field 8 :: Maximum depth of a certification chain. (gpg's option
                  --max-cert-depth)
diff --git a/doc/gpg.texi b/doc/gpg.texi
index 6e62917..cd30415 100644
--- a/doc/gpg.texi
+++ b/doc/gpg.texi
@@ -1682,13 +1682,15 @@ are available for all keyserver types, some common options are:
 
 @item --completes-needed @code{n}
 @opindex compliant-needed
-Number of completely trusted users to introduce a new
-key signer (defaults to 1).
+Consider a user ID (and its associated key) to be fully valid
+if it is certified by at least @code{n} fully trusted keys
+(defaults to 1).
 
 @item --marginals-needed @code{n}
 @opindex marginals-needed
-Number of marginally trusted users to introduce a new
-key signer (defaults to 3)
+Consider a user ID (and its associated key) to be fully valid
+if it is certified by at least @code{n} marginally trusted
+keys (defaults to 3).
 
 @item --tofu-default-policy @code{auto|good|unknown|bad|ask}
 @opindex tofu-default-policy
-- 
1.8.4