[Pkg-gnupg-commit] [gnupg2] 42/116: doc: Document summary values of TOFU_STATS

[Daniel Kahn Gillmor]

This is an automated email from the git hooks/post-receive script.

dkg pushed a commit to branch master
in repository gnupg2.

commit e1f68337b979fe4b7c3bd095a83ea832e14efb74
Author: Andre Heinecke <aheinecke at intevation.de>
Date:   Fri Jan 6 12:26:01 2017 +0100

    doc: Document summary values of TOFU_STATS
    
    --
    
    Signed-off-by: Andre Heinecke <aheinecke at intevation.de>
---
 doc/DETAILS | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/DETAILS b/doc/DETAILS
index 568500e..ac599fc 100644
--- a/doc/DETAILS
+++ b/doc/DETAILS
@@ -761,6 +761,19 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB:
     takes on value 0.  Instead, if there is a conflict, VALIDITY still
     reflects the key's validity (values: 1-4).
 
+    SUMMARY values use the euclidean distance (m = sqrt(a² + b²)) rather
+    then the sum of the magnitudes (m = a + b) to ensure a balance between
+    verified signatures and encrypted messages.
+
+    Values are calculated based on the number of days where a key was used
+    for verifying a signature or to encrypt to it.
+    The ranges for the values are:
+
+    - 1 :: signature_days + encryption_days == 0
+    - 2 :: 1 <= sqrt(signature_days² + encryption_days²) < 8
+    - 3 :: 8 <= sqrt(signature_days² + encryption_days²) < 42
+    - 4 :: sqrt(signature_days² + encryption_days²) >= 42
+
     SIGN-COUNT and ENCRYPTION-COUNT are the number of messages that we
     have seen that have been signed by this key / encryption to this
     key.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-gnupg/gnupg2.git