f0063afa71
* 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>
22 lines
1.2 KiB
XML
22 lines
1.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE dita PUBLIC "-//OASIS//DTD DITA Composite//EN" "ditabase.dtd">
|
|
<dita>
|
|
<topic id="topic_bpb_why_5db">
|
|
<title>Context</title>
|
|
<body>
|
|
<p>One of the reasons which prevents this API from being RESTful is that most operations
|
|
require more than one instruction to the API to perform the task. Sure, there are certain
|
|
functions which can be performed simultaneously, particularly if the result known or
|
|
strongly anticipated (e.g. selecting and encrypting to a key known to be in the public
|
|
keybox).</p>
|
|
<p>There are many more, however, which cannot be manipulated so readily: they must be
|
|
performed in a specific sequence and the result of one operation has a direct bearing on the
|
|
outcome of subsequent operations. Not merely by generating an error either.</p>
|
|
<p>When dealing with this type of persistent state on the web, full of both the RESTful and
|
|
REST-like, it's most commonly referred to as a session. In GPGME, however, it is called a
|
|
context and every operation type has one.</p>
|
|
<p/>
|
|
</body>
|
|
</topic>
|
|
</dita>
|