← Back to branch summary

~ubuntu-branches/ubuntu/maverick/packagekit/maverick-proposed

« back to all changes in this revision

Viewing changes to docs/api/html/introduction-ideas-transactions.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Heinlein
  • Date: 2009-08-25 13:03:26 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20090825130326-jrky8pfx0ukz0lib
Tags: 0.4.9+20090825-0ubuntu1
https://launchpad.net/bugs/342671
https://launchpad.net/bugs/374011
https://launchpad.net/bugs/374011
https://launchpad.net/bugs/256245
https://launchpad.net/bugs/388623
https://launchpad.net/bugs/348053
https://launchpad.net/bugs/415993
https://launchpad.net/bugs/396513
https://launchpad.net/bugs/347327
https://launchpad.net/bugs/345706
https://launchpad.net/bugs/378419
* New upstream snapshot provding a lot of APT backend improvements:
  - Allow to install updates which require the installation of additional
    packages. Updates depending on the removal of a package are still
    blocked (LP: #342671, LP: #374011, LP: #374011)
  - Warn about the installation of untrusted package (LP: #256245)
  - Don't crash in APT post update hook if system D-Bus daemon isn't 
    running (LP: #388623)
  - Don't try to estimate a download progress during cache updating, since
    APT reports only a forth- and backwards running progress. (LP: #348053)
  - Support for python-apt 0.7.12 (LP: #415993)
  - Translated package descriptions
* debian/patches:
  - Remove ignore_packages_in_conffile (Merged upstream)
  - Remove fix_typo (Merged upstream)
  - Add fix_unicode: Handle the encoding messages via stdin/stdout correctly
    (LP: #396513)
  - Add fix_unicode_debfile: Convert the path of the local file which
    should be installed to the correct encoding (LP: #347327)
* debian/libpackagekit-qt-dev.install: Fix install location of CMake module.
  Thanks to Sveinung Kvilhaugsvik (LP: #345706)
* debian/control: Fix spelling of Qt. Thanks to Sveinung Kvilhaugsvik
  (LP: #378419)

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/api/html/introduction-ideas-transactions.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Transactions</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
7
<link rel="home" href="index.html" title="PackageKit Reference Manual">
8
8
<link rel="up" href="concepts.html" title="Important Concepts">
9
9
<link rel="prev" href="introduction-cancellation.html" title="Cancellation">
29
29
<th width="100%" align="center">PackageKit Reference Manual</th>
30
30
<td><a accesskey="n" href="introduction-ideas-transactionid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
31
</tr></table>
32
 
<div class="sect1" lang="en">
 
32
<div class="sect1" title="Transactions">
33
33
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
34
34
<a name="introduction-ideas-transactions"></a>Transactions</h2></div></div></div>
35
35
<p>
48
48
      New methods require a new transaction path (i.e. another call to <code class="literal">GetTid</code>)
49
49
      which is synchronous and thus very fast.
50
50
    </p>
51
 
<div class="sect2" lang="en">
 
51
<div class="sect2" title="Transaction example: Success">
52
52
<div class="titlepage"><div><div><h3 class="title">
53
53
<a name="introduction-ideas-transactions-success"></a>Transaction example: Success</h3></div></div></div>
54
54
<div class="mediaobject" align="center">
64
64
<p>
65
65
        These different signals are needed for a few different reasons:
66
66
      </p>
67
 
<div class="itemizedlist"><ul type="disc">
68
 
<li><p>
 
67
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
 
68
<li class="listitem"><p>
69
69
            <code class="literal">::StatusChanged()</code>: The global state of the
70
70
            transaction, which will be useful for some GUIs.
71
71
            Examples include downloading or installing, and this is designed
72
72
            to be a 40,000ft view of what is happening.
73
73
          </p></li>
74
 
<li><p>
 
74
<li class="listitem"><p>
75
75
            <code class="literal">::Package()</code>: Used to either return a result
76
76
            (e.g. returning results of the <code class="literal">SearchName()</code> method)
77
77
            or to return progress about a _specific_ package.
81
81
            in the transaction allows a GUI to position the cursor on the worked
82
82
            on package and show the correct icon for that package.
83
83
          </p></li>
84
 
<li><p>
 
84
<li class="listitem"><p>
85
85
            <code class="literal">::ErrorCode()</code>: to show an error to the user about
86
86
            the transaction, which can be cleaned up before sending
87
87
            <code class="literal">::Finished()</code>.
88
88
          </p></li>
89
 
<li><p>
 
89
<li class="listitem"><p>
90
90
            <code class="literal">::Finished()</code>: to show the transaction has
91
91
            finished, and others can be scheduled.
92
92
          </p></li>
93
93
</ul></div>
94
94
</div>
95
 
<div class="sect2" lang="en">
 
95
<div class="sect2" title="Transaction example: Failure">
96
96
<div class="titlepage"><div><div><h3 class="title">
97
97
<a name="introduction-ideas-transactions-failure"></a>Transaction example: Failure</h3></div></div></div>
98
98
<div class="mediaobject" align="center">
103
103
        The user is not given the chance to requeue the transaction as it is a fatal error.
104
104
      </p>
105
105
</div>
106
 
<div class="sect2" lang="en">
 
106
<div class="sect2" title="Transaction example: Trusted">
107
107
<div class="titlepage"><div><div><h3 class="title">
108
108
<a name="introduction-ideas-transactions-trusted"></a>Transaction example: Trusted</h3></div></div></div>
109
109
<div class="mediaobject" align="center">
128
128
        unsigned files.
129
129
      </p>
130
130
</div>
131
 
<div class="sect2" lang="en">
 
131
<div class="sect2" title="Transaction example: Package signature install">
132
132
<div class="titlepage"><div><div><h3 class="title">
133
133
<a name="introduction-ideas-transactions-sig-install"></a>Transaction example: Package signature install</h3></div></div></div>
134
134
<div class="mediaobject" align="center">
149
149
<p>
150
150
        This is best explained using an example:
151
151
      </p>
152
 
<div class="itemizedlist"><ul type="disc">
153
 
<li><p>User clicks "install vmware" followed by "confirm".</p></li>
154
 
<li><p>User walks away from the computer and takes a nap</p></li>
155
 
<li><p>System upgrade is scheduled (300Mb of updates)</p></li>
 
152
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
 
153
<li class="listitem"><p>User clicks "install vmware" followed by "confirm".</p></li>
 
154
<li class="listitem"><p>User walks away from the computer and takes a nap</p></li>
 
155
<li class="listitem"><p>System upgrade is scheduled (300Mb of updates)</p></li>
156
156
</ul></div>
157
157
<p>
158
158
        The vmware package is downloaded, but cannot be installed until a EULA
177
177
        callbacks block and stop other transactions from happening.
178
178
      </p>
179
179
</div>
180
 
<div class="sect2" lang="en">
 
180
<div class="sect2" title="Transaction example: Download">
181
181
<div class="titlepage"><div><div><h3 class="title">
182
182
<a name="introduction-ideas-transactions-download"></a>Transaction example: Download</h3></div></div></div>
183
183
<div class="mediaobject" align="center">
215
215
        every signal by copying each file.
216
216
      </p>
217
217
</div>
218
 
<div class="sect2" lang="en">
 
218
<div class="sect2" title="Transaction example: Setting the locale">
219
219
<div class="titlepage"><div><div><h3 class="title">
220
220
<a name="introduction-ideas-transactions-set-locale"></a>Transaction example: Setting the locale</h3></div></div></div>
221
221
<div class="mediaobject" align="center">