[git] GPGME - branch, master, updated. gpgme-1.11.1-253-gf7e5ae7

[by Ben McGinnes]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GnuPG Made Easy".

The branch, master has been updated
       via  f7e5ae7f1618bd355b885c5c32dd028afad35453 (commit)
      from  16e566f319004d49f55197238380cc4c03e01f48 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit f7e5ae7f1618bd355b885c5c32dd028afad35453
Author: Ben McGinnes <ben at adversary.org>
Date:   Wed Aug 29 20:30:57 2018 +1000

    docs: python bindings - protonmail examples
    
    * lang/python/docs/GPGMEpythonHOWTOen.org: Updated links to the
      ProtonMail keyserver import scripts and added a warning regarding
      being unable to update third party keys.
    * lang/python/examples/howto/pmkey-import-alt.py: added usage.
    * lang/python/examples/howto/pmkey-import.py: added usage.

diff --git a/lang/python/docs/GPGMEpythonHOWTOen.org b/lang/python/docs/GPGMEpythonHOWTOen.org
index 84ba6a3..4dd3098 100644
--- a/lang/python/docs/GPGMEpythonHOWTOen.org
+++ b/lang/python/docs/GPGMEpythonHOWTOen.org
@@ -383,7 +383,7 @@ There are two theoretical solutions to this issue:
  2. Compile and install Python using the same tools used by choice,
     such as MinGW or Msys2.
 
-Do *NOT* use the official Windows installer for Python unless
+Do *not* use the official Windows installer for Python unless
 following the first method.
 
 In this type of situation it may even be for the best to accept that
@@ -785,6 +785,18 @@ The key IDs for all considered keys were:
         print(e)
 #+END_SRC
 
+Both the above example, [[../examples/howto/pmkey-import.py][pmkey-import.py]], and a version which prompts
+for an alternative GnuPG home directory, [[../examples/howto/pmkey-import-alt.py][pmkey-import-alt.py]], are
+available with the other examples and are executable scripts.
+
+Note that while the ProtonMail servers are based on the SKS servers,
+their server is related more to their API and is not feature complete
+by comparison to the servers in the SKS pool.  One notable difference
+being that the ProtonMail server does not permit non ProtonMail users
+to update their own keys, which could be a vector for attacking
+ProtonMail users who may not receive a key's revocation if it had been
+compromised.
+
 
 ** Exporting keys
    :PROPERTIES:
diff --git a/lang/python/examples/howto/pmkey-import-alt.py b/lang/python/examples/howto/pmkey-import-alt.py
index e9521b7..1b260e1 100755
--- a/lang/python/examples/howto/pmkey-import-alt.py
+++ b/lang/python/examples/howto/pmkey-import-alt.py
@@ -34,6 +34,8 @@ del absolute_import, division, unicode_literals
 print("""
 This script searches the ProtonMail key server for the specified key and
 imports it.  Optionally enables specifying a different GnuPG home directory.
+
+Usage:  pmkey-import-alt.py [search string] [homedir]
 """)
 
 c = gpg.Context(armor=True)
diff --git a/lang/python/examples/howto/pmkey-import.py b/lang/python/examples/howto/pmkey-import.py
index edbd18e..66ad8aa 100755
--- a/lang/python/examples/howto/pmkey-import.py
+++ b/lang/python/examples/howto/pmkey-import.py
@@ -33,6 +33,8 @@ del absolute_import, division, unicode_literals
 print("""
 This script searches the ProtonMail key server for the specified key and
 imports it.
+
+Usage:  pmkey-import.py [search string]
 """)
 
 c = gpg.Context(armor=True)

-----------------------------------------------------------------------

Summary of changes:
 lang/python/docs/GPGMEpythonHOWTOen.org        | 14 +++++++++++++-
 lang/python/examples/howto/pmkey-import-alt.py |  2 ++
 lang/python/examples/howto/pmkey-import.py     |  2 ++
 3 files changed, 17 insertions(+), 1 deletion(-)


hooks/post-receive
-- 
GnuPG Made Easy
http://git.gnupg.org