From 286be4bf653ba9e48c472b38e443f5350ba9fa07 Mon Sep 17 00:00:00 2001
From: ulif <uli@gnufix.de>
Date: Sun, 10 Sep 2017 20:29:34 +0200
Subject: [PATCH] In README, tell about reduced entropy.

Tell about problems with wordlist lengths and dice side numbers.
---
 README.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.rst b/README.rst
index e5eeb0a..f48aee6 100644
--- a/README.rst
+++ b/README.rst
@@ -278,6 +278,10 @@ Security Traps
 There are issues that might reduce the entropy of the passphrase
 generated. One of them is the `prefix code`_ problem:
 
+
+Prefix Code
+...........
+
 If the wordlist contains, for example, the words::
 
    "air", "airport", "portable", "able"
@@ -299,6 +303,18 @@ Each of these measures is sufficient to protect you against the
 `prefix code`_ problem.
 
 
+Reduced Entropy
+...............
+
+Overall, `diceware` is a kind of mapping input values, dice throws for
+instance, onto wordlist entries. We normally want each of the words in the
+wordlist to be picked for passphrases with the same probability.
+
+This, however, is not possible, if the number of dice sides and the number of
+wordlist entries are relatively prime. In that case we cut some words of the
+wordlist and inform the user about the matter.
+
+
 Developer Install
 -----------------
 
-- 
GitLab