gpgme/lang/python/docs/dita/howto/part02/no-pypi.dita
Ben McGinnes f0063afa71 docs: python bindings HOWTO - DITA XML version
* Due to the org-babel bug which breaks Python source code examples
  beyond the most simple snippets, ported the HOWTO to a source format
  which I *know* for sure won't break it.
* Details of the org-mode bug is in https://dev.gnupg.org/T3977
* DITA project uses DITA-OT 2.x (2.4 or 2.5, IIRC) with support for DITA 1.3.
* source files were written with oXygenXML Editor 20.0, hence the
  oXygenXML project file in the directory; however only the .ditamap
  and .dita files are required to generate any output with the
  DITA-OT.

Signed-off-by: Ben McGinnes <ben@adversary.org>
2018-05-15 13:13:16 +10:00

20 lines
1.0 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE dita PUBLIC "-//OASIS//DTD DITA Composite//EN" "ditabase.dtd">
<dita>
<topic id="topic_mss_p2y_5db">
<title>No PyPI</title>
<body>
<p>Most third-party Python packages and modules are available and distributed through
the Python Package Installer, known as PyPI.</p>
<p>Due to the nature of what these bindings are and how they work, it is infeasible to install
the GPGME Python bindings in the same way.</p>
<p>This is because the bindings use SWIG to dynamically generate C bindings against
<codeph>gpgme.h</codeph> and <codeph>gpgme.h</codeph> is generated from
<codeph>gpgme.h.in</codeph> at compile time when GPGME is built from source. Thus to
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.</p>
</body>
</topic>
</dita>