From 4c346d86f41571e4091a3fd3e54caf45fef7c247 Mon Sep 17 00:00:00 2001
From: ulif <uli@gnufix.de>
Date: Sat, 18 Feb 2017 07:40:56 +0100
Subject: [PATCH] Update wordlist docs in API.

---
 docs/wordlists.rst | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/docs/wordlists.rst b/docs/wordlists.rst
index 296deed..ea0bc75 100644
--- a/docs/wordlists.rst
+++ b/docs/wordlists.rst
@@ -8,10 +8,8 @@ words used, the wordlists.
 good choice for usual private use.
 
 .. warning:: We do -- by default -- *not* use the `diceware standard
-	     wordlist`_ (which contains 7,776 words), because
-	     computers prefer powers of two and we use the Python
-	     standard lib random source by default (we do not want to
-	     waste entropy).
+	     wordlist`_, but the `long EFF wordlist`_ (see below), because it is
+         more secure and more comfortable to use.
 
 	     But the "original" list is included in diceware as well
 	     and you can pick it with the ``-w en_orig`` option.  You
@@ -20,9 +18,9 @@ good choice for usual private use.
 
 Currently we provide the following lists:
 
-- `en_securedrop` (8192 words, default)
+- `en_securedrop` (8192 words)
 
-  By default we use a hand-crafted `en_securedrop` wordlist provided
+  We provide a hand-crafted `en_securedrop` wordlist provided
   by `@Heartsucker`_. It contains 8,192 english words and
   phrases. This list is based on the `diceware standard wordlist`_ and
   extended to offer better memorizable words. Please see
@@ -37,14 +35,13 @@ Currently we provide the following lists:
   wordlist for use with binary-geared entities like computers or
   nerds.
 
-- `en_eff` (7776 words)
+- `en_eff` (7776 words, default)
 
-  This is the `long EFF wordlist`_ as published by the `Electronic
-  Frontier Foundation`_ in mid-2016. They put real `scientific
-  effort`_ into the creation of this list which might considerably
-  ease the use of passphrases generated with it. When using real dice
-  (or other six-based randomness generators) use is definitely
-  recommended!
+  This is the `long EFF wordlist`_ as published by the `Electronic Frontier
+  Foundation`_ in mid-2016 and used by default. They put real `scientific
+  effort`_ into the creation of this list which might considerably ease the
+  use of passphrases generated with it. When using real dice (or other
+  six-based randomness generators) use is definitely recommended!
 
   Please note, that this is currently the only list, that provides the
   `prefix property`_. That means it contains no word which is a prefix
-- 
GitLab