Use /usr/bin/env to find python in the install script, Python doc updates

Both from Uri B to mailing list.

1 files changed, 10 insertions, 7 deletions

diff --git a/doc/manual/python.rst b/doc/manual/python.rst
index 295caa3c3..cef9fddd2 100644
--- a/doc/manual/python.rst
+++ b/doc/manual/python.rst
@@ -109,7 +109,8 @@ Ciphers
 
     .. py:method:: update_granularity()
 
-                   Returns update block size
+                   Returns update block size. Call to update() must provide
+                  input of exactly this many bytes
 
     .. py:method:: is_authenticated()
 
@@ -134,15 +135,17 @@ Ciphers
 
     .. py:method:: update(txt)
 
-                   Consumes input text and returns output
+                   Consumes input text and returns output. Input text must be
+                   of update_granularity() length.  Alternately, always call
+                   finish with the entire message, avoiding calls to update
+                   entirely
 
     .. py:method:: finish(txt = None)
 
-       Finish processing (with an optional final input). May throw if
-       message authentication checks fail, in which case all plaintext
-       previously processed must be discarded. Alternately, always
-       call finish with the entire message, avoiding calls to update
-       entirely.
+                   Finish processing (with an optional final input). May throw
+                   if message authentication checks fail, in which case all
+                   plaintext previously processed must be discarded. You may
+                   call finish() with the entire message
 
 Bcrypt
 ----------------------------------------