doc: python binding howto

* Clarified which English dialects this is written in.
* Translating to American can happen *after* it's done.
** The Yank version would probably want to change some of the examples
   anyway.
* Began the description for normal/default signing.

1 files changed, 12 insertions, 1 deletions

diff --git a/lang/python/docs/GPGMEpythonHOWTOen.org b/lang/python/docs/GPGMEpythonHOWTOen.org
index ea4b1116..e4e2a743 100644
--- a/lang/python/docs/GPGMEpythonHOWTOen.org
+++ b/lang/python/docs/GPGMEpythonHOWTOen.org
@@ -16,7 +16,8 @@
   | Version:        | 0.0.1-alpha                              |
   | Author:         | Ben McGinnes <[email protected]>             |
   | Author GPG Key: | DB4724E6FA4286C92B4E55C4321E4E2373590E5D |
-  | Language:       | English                                  |
+  | Language:       | Australian English, British English      |
+  | xml:lang:       | en-AU, en-GB, en                         |
 
   This document provides basic instruction in how to use the GPGME
   Python bindings to programmatically leverage the GPGME library.
@@ -653,6 +654,16 @@
     :CUSTOM_ID: howto-basic-signing-normal
     :END:
 
+    The normal or default signing process is essentially the same as
+    is most often invoked when also encrypting a message or file.  So
+    when the encryption component is not utilised, the result is to
+    produce an encoded and signed output which may or may not be ASCII
+    armoured and which may or may not also be compressed.
+
+    By default compression will be used unless GnuPG detects that the
+    plaintext is already compressed.  ASCII armouring will be
+    determined according to the value of =gpg.Context().armor=.
+
    #+begin_src python
      import gpg