diff --git a/diceware/diceware.py b/diceware/diceware.py
index 5bffc23c40df9daf9638e4cd09f033797c7ab779..9a313d27447cf153fd9d63e0b2caf3dd1bde247b 100644
--- a/diceware/diceware.py
+++ b/diceware/diceware.py
@@ -83,6 +83,14 @@ def insert_special_char(word, specials=SPECIAL_CHARS, rnd=None):
 def get_passphrase(wordnum=6, specialsnum=1, delimiter='', lang='en',
                    capitalized=True):
     """Get a diceware passphrase.
+
+    The passphrase returned will contain `wordnum` words deliimted by
+    `delimiter`.
+
+    If `capitalized` is ``True``, all words will be capitalized.
+
+    The wordlist to pick words from is determined by `lang`,
+    representing a language.
     """
     word_list = get_wordlist(get_wordlist_path(lang))
     rnd = SystemRandom()