docs: python
authorBen McGinnes <ben@adversary.org>
Tue, 30 Oct 2018 14:24:47 +0000 (01:24 +1100)
committerBen McGinnes <ben@adversary.org>
Tue, 30 Oct 2018 16:06:24 +0000 (03:06 +1100)
* dropped the ".org" extension and added a mode line for each file as
  this will make scripting format conversions a lot easier.

lang/python/doc/src/gpgme-python-howto [moved from lang/python/doc/src/gpgme-python-howto.org with 99% similarity]
lang/python/doc/src/index [moved from lang/python/doc/src/index.org with 96% similarity]
lang/python/doc/src/short-history [moved from lang/python/doc/src/short-history.org with 99% similarity]

similarity index 99%
rename from lang/python/doc/src/gpgme-python-howto.org
rename to lang/python/doc/src/gpgme-python-howto
index 3c389d1..1e83e09 100644 (file)
@@ -1,3 +1,4 @@
+# -*- mode: org -*-
 #+TITLE: GNU Privacy Guard (GnuPG) Made Easy Python Bindings HOWTO (English)
 #+AUTHOR: Ben McGinnes
 #+LATEX_COMPILER: xelatex
@@ -490,7 +491,7 @@ place.
     :CUSTOM_ID: snafu-the-full-monty
     :END:
 
-For a veriety of reasons it may be either necessary or just preferable
+For a variety of reasons it may be either necessary or just preferable
 to install the bindings to alternative installed Python versions which
 meet the requirements of these bindings.
 
@@ -507,6 +508,16 @@ by major version numbers and probably minor numbers too).
 On most POSIX systems, including OS X, this will very likely be the
 case in most, if not all, cases.
 
+Note that from GPGME [[https://dev.gnupg.org/rMff6ff616aea6f59b7f2ce1176492850ecdf3851e][1.12.1]] the default installation installs to each
+version of Python it can find first.  That is that it will currently
+install for the first copies of Python versions 2.7, 3.4, 3.5, 3.6,
+3.7 and 3.8 (dev branch) that it finds.  Usually this will be in the
+same prefix as GPGME itself, but is dictated by the =$PATH= when the
+installation is performed.  The above instructions can still be
+performed on other python installations which the installer does not
+find, including alternative prefixes.
+
+
 
 *** Won't Work With Windows
     :PROPERTIES:
similarity index 96%
rename from lang/python/doc/src/index.org
rename to lang/python/doc/src/index
index 701d986..9fe7a3c 100644 (file)
@@ -1,3 +1,4 @@
+# -*- mode: org -*-
 #+TITLE: GNU Privacy Guard (GnuPG) Made Easy Python Bindings
 #+AUTHOR: Ben McGinnes
 #+LATEX_COMPILER: xelatex
similarity index 99%
rename from lang/python/doc/src/short-history.org
rename to lang/python/doc/src/short-history
index 587cb9f..ac5804d 100644 (file)
@@ -1,3 +1,4 @@
+# -*- mode: org -*-
 #+TITLE: A Short History of the GPGME bindings for Python
 #+LATEX_COMPILER: xelatex
 #+LATEX_CLASS: article