diff options
author | Ben McGinnes <[email protected]> | 2018-10-04 16:30:20 +0000 |
---|---|---|
committer | Ben McGinnes <[email protected]> | 2018-10-04 16:30:20 +0000 |
commit | 0b5930b276186afd1ca1dd91d82db7e60dd20606 (patch) | |
tree | 264b595a41ae6cf798ba0548030bc71deedf1016 /lang/python/doc/src/gpgme-python-howto.org | |
parent | docs: python (diff) | |
download | gpgme-0b5930b276186afd1ca1dd91d82db7e60dd20606.tar.gz gpgme-0b5930b276186afd1ca1dd91d82db7e60dd20606.zip |
docs: python
* Fixed an error in the new index page and then exported to the other
two "source" formats.
Diffstat (limited to 'lang/python/doc/src/gpgme-python-howto.org')
-rw-r--r-- | lang/python/doc/src/gpgme-python-howto.org | 22 |
1 files changed, 9 insertions, 13 deletions
diff --git a/lang/python/doc/src/gpgme-python-howto.org b/lang/python/doc/src/gpgme-python-howto.org index 6eba29e0..caa8e2f1 100644 --- a/lang/python/doc/src/gpgme-python-howto.org +++ b/lang/python/doc/src/gpgme-python-howto.org @@ -7,7 +7,6 @@ #+LATEX_HEADER: \usepackage[margin=1in]{geometry} #+LATEX_HEADER: \setmainfont[Ligatures={Common}]{Times New Roman} #+LATEX_HEADER: \author{Ben McGinnes <[email protected]>} -#+HTML_HEAD_EXTRA: <link type="application/rss+xml" href="https://git.gnupg.org/cgi-bin/gitweb.cgi?p=gpgme.git;a=rss;f=lang/python/docs/GPGMEpythonHOWTOen.org"/> * Introduction @@ -254,8 +253,7 @@ version 3.0 (or any later version). This package is the origin of these bindings, though they are somewhat different now. For details of when and how the PyME package was -folded back into GPGME itself see the /Short History/ document[fn:1] -in the Python bindings =docs= directory.[fn:2] +folded back into GPGME itself see the [[file:short-history.org][Short History]] document.[fn:1] The PyME package was first released in 2002 and was also the first attempt to implement a low level binding to GPGME. In doing so it @@ -365,7 +363,7 @@ For Python 2 it checks for these executables in this order: =python=, =python2= and =python2.7=. For Python 3 it checks for these executables in this order: =python3=, - =python3.7=, =python3.6=, =python3.5= and =python3.4=.[fn:3] + =python3.7=, =python3.6=, =python3.5= and =python3.4=.[fn:2] On systems where =python= is actually =python3= and not =python2= it may be possible that =python2= may be overlooked, but there have been @@ -425,7 +423,7 @@ build directory missing a lot of expected files. Even when this occurs, the solution is actually quite simple and will always work. That solution is simply to run the following commands as either the -*root* user or prepended with =sudo -H=[fn:4] in the =lang/python/= +*root* user or prepended with =sudo -H=[fn:3] in the =lang/python/= directory: #+BEGIN_SRC shell @@ -1928,7 +1926,7 @@ Encrypting to multiple keys essentially just expands upon the key selection process and the recipients from the previous examples. The following example encrypts a message (=text=) to everyone with an -email address on the =gnupg.org= domain,[fn:5] but does /not/ encrypt +email address on the =gnupg.org= domain,[fn:4] but does /not/ encrypt to a default key or other key which is configured to normally encrypt to. @@ -2899,7 +2897,7 @@ support for Python 2.7 as well and is available via PyPI. Since it rewrites the =hkp= protocol prefix as =http= and =hkps= as =https=, the module is able to be used even with servers which do not -support the full scope of keyserver functions.[fn:6] It also works quite +support the full scope of keyserver functions.[fn:5] It also works quite readily when incorporated into a [[#cython][Cython]] generated and compiled version of any code. @@ -3018,16 +3016,14 @@ PURPOSE. [fn:1] =short-history.org= and/or =short-history.html=. -[fn:2] The =lang/python/docs/= directory in the GPGME source. - -[fn:3] With no issues reported specific to Python 3.7, the release of +[fn:2] With no issues reported specific to Python 3.7, the release of Python 3.7.1 at around the same time as GPGME 1.12.0 and the testing with Python 3.7.1rc1, there is no reason to delay moving 3.7 ahead of 3.6 now. Production environments with more conservative requirements will always enforce their own policies anyway and installation to each supported minor release is quite possible too. -[fn:4] Yes, even if you use virtualenv with everything you do in +[fn:3] Yes, even if you use virtualenv with everything you do in Python. If you want to install this module as just your user account then you will need to manually configure, compile and install the /entire/ GnuPG stack as that user as well. This includes libraries @@ -3035,12 +3031,12 @@ which are not often installed that way. It can be done and there are circumstances under which it is worthwhile, but generally only on POSIX systems which utilise single user mode (some even require it). -[fn:5] You probably don't really want to do this. Searching the +[fn:4] You probably don't really want to do this. Searching the keyservers for "gnupg.org" produces over 400 results, the majority of which aren't actually at the gnupg.org domain, but just included a comment regarding the project in their key somewhere. -[fn:6] Such as with ProtonMail servers. This also means that +[fn:5] Such as with ProtonMail servers. This also means that restricted servers which only advertise either HTTP or HTTPS end points and not HKP or HKPS end points must still be identified as as HKP or HKPS within the Python Code. The =hkp4py= module will rewrite |