summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorRichard Hughes <richard@hughsie.com>2009-04-24 15:02:50 +0100
committerRichard Hughes <richard@hughsie.com>2009-04-24 15:02:50 +0100
commit59a74691d36decdd183a763882ec0a86b2884402 (patch)
tree8eae137cebc815862893b455ff2bd47ed0a75e6f /docs
parenta3d455e876a348d76d32389e86168d440e988986 (diff)
trivial: Remove some docs about the removed DBus interfaces
Diffstat (limited to 'docs')
-rw-r--r--docs/api/spec/pk-backend-dbus.xml33
-rw-r--r--docs/api/spec/pk-introduction.xml5
-rw-r--r--docs/api/spec/pk-structure.svg48
3 files changed, 15 insertions, 71 deletions
diff --git a/docs/api/spec/pk-backend-dbus.xml b/docs/api/spec/pk-backend-dbus.xml
deleted file mode 100644
index d0f0024f9..000000000
--- a/docs/api/spec/pk-backend-dbus.xml
+++ /dev/null
@@ -1,33 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
-
-<chapter id="backend-dbus">
- <title>DBUS Backends</title>
- <para>
- Backend helpers communicating over standard out and standard
- error are easy to write, but can have some performance
- problems.
- For instance, if your packages system has to do a lot of work when it
- starts up and shuts down, performance in the UI may suffer.
- In these cases, you can use a persistant backend daemon that
- communicates to the C backend over DBUS.
- </para>
- <para>
- Your daemon will be started by DBUS, and should be responsible
- for it's own thread management.
- It should receive an <literal>Init()</literal> method call when the C
- backend starts, and an <literal>Exit()</literal> method call before it
- exits.
- You should also consider adding a timeout value to your daemon so that
- it will exit after a set time with no activity from the C backend.
- That way the daemon will still exit even if the C backend crashes for
- some reason.
- </para>
- <para>
- Again, like the helper backends described above, a compiled
- backend stub is needed. An example of a DBUS backend written
- in python can be found in <literal>backends/apt</literal>,
- along with a compiled stub written in C.
- </para>
-</chapter>
-
diff --git a/docs/api/spec/pk-introduction.xml b/docs/api/spec/pk-introduction.xml
index d67838eb9..bf3ef3455 100644
--- a/docs/api/spec/pk-introduction.xml
+++ b/docs/api/spec/pk-introduction.xml
@@ -43,9 +43,8 @@
loaded at run-time and provides an interface to the underlying package
commands.
A backend converts an asynchronous request into either a new thread
- in the same process, executes external "glue" files that
- can be written in any language, or uses DBUS to signal a
- daemon process to handle the request.
+ in the same process, or executes external "glue" files that
+ can be written in any language.
</para>
<para>
Backends do not have to support all of the commands supported
diff --git a/docs/api/spec/pk-structure.svg b/docs/api/spec/pk-structure.svg
index afbee9e86..4929c8dcd 100644
--- a/docs/api/spec/pk-structure.svg
+++ b/docs/api/spec/pk-structure.svg
@@ -1,8 +1,9 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
- xmlns:cc="http://web.resource.org/cc/"
+ xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
@@ -12,15 +13,21 @@
height="1052.3622047"
id="svg2"
sodipodi:version="0.32"
- inkscape:version="0.45.1"
- sodipodi:docbase="/home/hughsie/Code/PackageKit/docs/spec"
+ inkscape:version="0.46+devel"
sodipodi:docname="pk-structure.svg"
- inkscape:export-filename="/home/hughsie/Code/PackageKit/docs/spec/pk-structure.png"
+ inkscape:export-filename="/home/hughsie/Code/PackageKit/docs/api/spec/pk-structure.svg.png"
inkscape:export-xdpi="51.209103"
inkscape:export-ydpi="51.209103"
inkscape:output_extension="org.inkscape.output.svg.inkscape">
<defs
id="defs4">
+ <inkscape:perspective
+ sodipodi:type="inkscape:persp3d"
+ inkscape:vp_x="0 : 526.18109 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_z="744.09448 : 526.18109 : 1"
+ inkscape:persp3d-origin="372.04724 : 350.78739 : 1"
+ id="perspective80" />
<marker
inkscape:stockid="Arrow1Send"
orient="auto"
@@ -110,7 +117,7 @@
inkscape:window-width="1270"
inkscape:window-height="721"
inkscape:window-x="0"
- inkscape:window-y="24"
+ inkscape:window-y="25"
showguides="true"
inkscape:guide-bbox="true" />
<metadata
@@ -121,6 +128,7 @@
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ <dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
@@ -461,36 +469,6 @@
id="path2230"
inkscape:connector-type="polyline"
sodipodi:nodetypes="cc" />
- <rect
- style="opacity:1;fill:#87de87;fill-opacity:1;stroke:#000000;stroke-width:0;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
- id="rect2232"
- width="200"
- height="80"
- x="-100"
- y="342.36218" />
- <text
- xml:space="preserve"
- style="font-size:12px;font-style:normal;font-weight:normal;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans"
- x="4.5527229"
- y="376.9657"
- id="text2234"><tspan
- sodipodi:role="line"
- x="4.5527229"
- y="376.9657"
- style="font-size:28px;text-align:center;text-anchor:middle"
- id="tspan2239">DBUS</tspan><tspan
- sodipodi:role="line"
- x="4.5527229"
- y="411.9657"
- style="font-size:28px;text-align:center;text-anchor:middle"
- id="tspan2245">Service</tspan></text>
- <path
- style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:6;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Send);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;display:inline"
- d="M 89.090907,312.36218 L 50.90909,342.36218"
- id="path2241"
- inkscape:connector-type="polyline"
- inkscape:connection-end="#rect2232"
- inkscape:connection-start="#rect5369" />
<path
style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:6;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Send);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;display:inline;marker-start:url(#Arrow1Sstart)"
d="M 326.13636,452.36218 L 181.36363,312.36218"