[git] GPGME - branch, master, updated. gpgme-1.11.1-285-gfbec29f
by Ben McGinnes
cvs at cvs.gnupg.org
Sun Sep 16 03:08:23 CEST 2018
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 fbec29fdac7a4f162e73f24dac2a6b205239ef03 (commit)
via 2a1b0b88d96b722817f3ac9edf002a54c65084b8 (commit)
from 91b26b0638d9f92f0e90aab1c3750c14d72db301 (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 fbec29fdac7a4f162e73f24dac2a6b205239ef03
Author: Ben McGinnes <ben at adversary.org>
Date: Sun Sep 16 11:06:32 2018 +1000
docs: even more edits
* doc/gpgme-python-howto.texi: hunting down and killing commas,
Oxford or not it can't stay in a heading.
diff --git a/doc/gpgme-python-howto.texi b/doc/gpgme-python-howto.texi
index 6e45e47..7b19f72 100644
--- a/doc/gpgme-python-howto.texi
+++ b/doc/gpgme-python-howto.texi
@@ -28,7 +28,7 @@
* Basic Functions::
* Creating keys and subkeys::
* Miscellaneous work-arounds::
-* Copyright, Draft Editions and Licensing: Copyright Draft Editions and Licensing.
+* Copyright and Licensing::
@detailmenu
--- The Detailed Node Listing ---
@@ -124,7 +124,7 @@ Miscellaneous work-arounds
* Group lines::
-Copyright, Draft Editions and Licensing
+Copyright and Licensing
* Copyright::
* Draft Editions of this HOWTO::
@@ -2132,8 +2132,8 @@ script reads all the group entries in a user's @samp{gpg.conf} file and
converts them into crypt-hooks suitable for use with the Mutt and
Neomutt mail clients.
- at node Copyright Draft Editions and Licensing
- at chapter Copyright, Draft Editions and Licensing
+ at node Copyright and Licensing
+ at chapter Copyright and Licensing
@menu
* Copyright::
diff --git a/lang/python/docs/gpgme-python-howto.org b/lang/python/docs/gpgme-python-howto.org
index 69d9c0b..a917f36 100644
--- a/lang/python/docs/gpgme-python-howto.org
+++ b/lang/python/docs/gpgme-python-howto.org
@@ -2043,7 +2043,7 @@ converts them into crypt-hooks suitable for use with the Mutt and
Neomutt mail clients.
-* Copyright, Draft Editions and Licensing
+* Copyright and Licensing
:PROPERTIES:
:CUSTOM_ID: copyright-and-license
:END:
commit 2a1b0b88d96b722817f3ac9edf002a54c65084b8
Author: Ben McGinnes <ben at adversary.org>
Date: Sun Sep 16 10:52:30 2018 +1000
docs: more edits
* lang/python/docs/gpgme-python-howto.org: more tweaks and edits,
along with another build of output formats.
* doc/gpgme-python-howto.texi: updated texinfo version for parent docs.
diff --git a/doc/gpgme-python-howto.texi b/doc/gpgme-python-howto.texi
index 21da963..6e45e47 100644
--- a/doc/gpgme-python-howto.texi
+++ b/doc/gpgme-python-howto.texi
@@ -28,7 +28,7 @@
* Basic Functions::
* Creating keys and subkeys::
* Miscellaneous work-arounds::
-* Copyright and Licensing::
+* Copyright, Draft Editions and Licensing: Copyright Draft Editions and Licensing.
@detailmenu
--- The Detailed Node Listing ---
@@ -66,7 +66,7 @@ Known Issues
* Breaking Builds::
* Multiple installations::
* Won't Work With Windows::
-* I don't like SWIG, Use CFFI instead: I don't like SWIG Use CFFI instead.
+* CFFI is the Best™ and GPGME should use it instead of SWIG::
Fundamentals
@@ -124,9 +124,10 @@ Miscellaneous work-arounds
* Group lines::
-Copyright and Licensing
+Copyright, Draft Editions and Licensing
-* Copyright (C) The GnuPG Project, 2018: Copyright (C) The GnuPG Project 2018.
+* Copyright::
+* Draft Editions of this HOWTO::
* License GPL compatible::
@end detailmenu
@@ -135,13 +136,13 @@ Copyright and Licensing
@node Introduction
@chapter Introduction
- at multitable {aaaaaaaaaaaaaaa} {aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}
+ at multitable {aaaaaaaaaaaaaaa} {aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}
@item Version:
@tab 0.1.4
@item GPGME Version:
@tab 1.12.0-draft
@item Author:
- at tab Ben McGinnes <ben@@gnupg.org>
+ at tab @uref{https://gnupg.org/people/index.html#sec-1-5, Ben McGinnes} <ben@@gnupg.org>
@item Author GPG Key:
@tab DB4724E6FA4286C92B4E55C4321E4E2373590E5D
@item Language:
@@ -327,7 +328,7 @@ include a package in PyPI which actually built correctly would require
either statically built libraries for every architecture bundled with
it or a full implementation of C for each architecture.
-See the additional notes regarding @ref{I don't like SWIG Use CFFI instead, , CFFI and SWIG} at the end of this
+See the additional notes regarding @ref{CFFI is the Best™ and GPGME should use it instead of SWIG, , CFFI and SWIG} at the end of this
section for further details.
@node Requirements
@@ -390,7 +391,7 @@ they be encountered.
* Breaking Builds::
* Multiple installations::
* Won't Work With Windows::
-* I don't like SWIG, Use CFFI instead: I don't like SWIG Use CFFI instead.
+* CFFI is the Best™ and GPGME should use it instead of SWIG::
@end menu
@node Breaking Builds
@@ -526,8 +527,8 @@ what.
Investigations into the extent or the limitations of this issue are
ongoing.
- at node I don't like SWIG Use CFFI instead
- at subsection I don't like SWIG, Use CFFI instead
+ at node CFFI is the Best™ and GPGME should use it instead of SWIG
+ at subsection CFFI is the Best™ and GPGME should use it instead of SWIG
There are many reasons for favouring @uref{https://cffi.readthedocs.io/en/latest/overview.html, CFFI} and proponents of it are
quite happy to repeat these things as if all it would take to switch
@@ -561,6 +562,16 @@ running into trouble with "ifdefs" then you'll know what sort of
things are lacking. That doesn't even take into account the amount of
work saved via SWIG's code generation techniques either.
+There's a greater likelihood of turning to Cython to add something to
+these bindings at this point than there is of turning to CFFI. Except
+that there's little reason to do so when the C code in question either
+already exists or could be produced fairly quickly by the far more
+expedient means of asking either @uref{https://gnupg.org/people/index.html#sec-1-1, Werner}, @uref{https://gnupg.org/people/index.html#sec-1-3, Niibe} or @uref{https://gnupg.org/people/index.html#sec-1-6, Andre} to write
+whatever was missing. Perhaps even @uref{https://gnupg.org/people/index.html#sec-1-4, Jussi}, but there shouldn't be any
+need for these bindings to interface directly with his work and for
+much the same reasons as we recommend people not call libgcrypt
+directly unless they know what they're doing.
+
@node Fundamentals
@chapter Fundamentals
@@ -2121,19 +2132,65 @@ script reads all the group entries in a user's @samp{gpg.conf} file and
converts them into crypt-hooks suitable for use with the Mutt and
Neomutt mail clients.
- at node Copyright and Licensing
- at chapter Copyright and Licensing
+ at node Copyright Draft Editions and Licensing
+ at chapter Copyright, Draft Editions and Licensing
@menu
-* Copyright (C) The GnuPG Project, 2018: Copyright (C) The GnuPG Project 2018.
+* Copyright::
+* Draft Editions of this HOWTO::
* License GPL compatible::
@end menu
- at node Copyright (C) The GnuPG Project 2018
- at section Copyright (C) The GnuPG Project, 2018
+ at node Copyright
+ at section Copyright
Copyright © The GnuPG Project, 2018.
+Copyright (C) The GnuPG Project, 2018.
+
+ at node Draft Editions of this HOWTO
+ at section Draft Editions of this HOWTO
+
+Draft editions of this HOWTO may be periodically available directly
+from the author at any of the following URLs:
+
+ at itemize
+ at item
+ at uref{https://files.au.adversary.org/crypto/gpgme-python-howto.html, GPGME Python Bindings HOWTO draft (XHTML AWS S3 SSL)}
+ at item
+ at uref{http://files.au.adversary.org/crypto/gpgme-python-howto.html, GPGME Python Bindings HOWTO draft (XHTML AWS S3 no SSL)}
+ at item
+ at uref{https://files.au.adversary.org/crypto/gpgme-python-howto.texi, GPGME Python Bindings HOWTO draft (Texinfo file AWS S3 SSL)}
+ at item
+ at uref{http://files.au.adversary.org/crypto/gpgme-python-howto.texi, GPGME Python Bindings HOWTO draft (Texinfo file AWS S3 no SSL)}
+ at item
+ at uref{https://files.au.adversary.org/crypto/gpgme-python-howto.info, GPGME Python Bindings HOWTO draft (Info file AWS S3 SSL)}
+ at item
+ at uref{http://files.au.adversary.org/crypto/gpgme-python-howto.info, GPGME Python Bindings HOWTO draft (Info file AWS S3 no SSL)}
+ at item
+ at uref{https://files.au.adversary.org/crypto/gpgme-python-howto.xml, GPGME Python Bindings HOWTO draft (Docbook 4.2 AWS S3 SSL)}
+ at item
+ at uref{http://files.au.adversary.org/crypto/gpgme-python-howto.xml, GPGME Python Bindings HOWTO draft (Docbook 4.2 AWS S3 no SSL)}
+ at end itemize
+
+All of these draft versions are generated from this document via Emacs
+ at uref{https://orgmode.org/, Org mode} and @uref{https://www.gnu.org/software/texinfo/, GNU Texinfo}. Though it is likely that the specific @uref{https://files.au.adversary.org/crypto/gpgme-python-howto.org, file}
+ at uref{http://files.au.adversary.org/crypto/gpgme-python-howto.org, version} used will be on the same server with the generated output
+formats.
+
+In addition to these there is a significantly less frequently updated
+version as a HTML @uref{https://files.au.adversary.org/crypto/gpgme-python-howto/webhelp/index.html, WebHelp site} (AWS S3 SSL); generated from DITA XML
+source files, which can be found in @uref{https://dev.gnupg.org/source/gpgme/browse/ben%252Fhowto-dita/, an alternative branch} of the GPGME
+git repository.
+
+These draft editions are not official documents and the version of
+documentation in the master branch or which ships with released
+versions is the only official documentation. Nevertheless, these
+draft editions may occasionally be of use by providing more accessible
+web versions which are updated between releases. They are provided on
+the understanding that they may contain errors or may contain content
+subject to change prior to an official release.
+
@node License GPL compatible
@section License GPL compatible
@@ -2146,4 +2203,4 @@ WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
- at bye
+ at bye
\ No newline at end of file
diff --git a/lang/python/docs/gpgme-python-howto.org b/lang/python/docs/gpgme-python-howto.org
index 1f5ceb2..69d9c0b 100644
--- a/lang/python/docs/gpgme-python-howto.org
+++ b/lang/python/docs/gpgme-python-howto.org
@@ -2077,7 +2077,9 @@ from the author at any of the following URLs:
- [[http://files.au.adversary.org/crypto/gpgme-python-howto.xml][GPGME Python Bindings HOWTO draft (Docbook 4.2 AWS S3 no SSL)]]
All of these draft versions are generated from this document via Emacs
-[[https://orgmode.org/][Org mode]] and [[https://www.gnu.org/software/texinfo/][GNU Texinfo]].
+[[https://orgmode.org/][Org mode]] and [[https://www.gnu.org/software/texinfo/][GNU Texinfo]]. Though it is likely that the specific [[https://files.au.adversary.org/crypto/gpgme-python-howto.org][file]]
+[[http://files.au.adversary.org/crypto/gpgme-python-howto.org][version]] used will be on the same server with the generated output
+formats.
In addition to these there is a significantly less frequently updated
version as a HTML [[https://files.au.adversary.org/crypto/gpgme-python-howto/webhelp/index.html][WebHelp site]] (AWS S3 SSL); generated from DITA XML
-----------------------------------------------------------------------
Summary of changes:
doc/gpgme-python-howto.texi | 81 ++++++++++++++++++++++++++++-----
lang/python/docs/gpgme-python-howto.org | 6 ++-
2 files changed, 73 insertions(+), 14 deletions(-)
hooks/post-receive
--
GnuPG Made Easy
http://git.gnupg.org
More information about the Gnupg-commits
mailing list