summaryrefslogtreecommitdiffstats
path: root/doc/kdearch/index.docbook
diff options
context:
space:
mode:
authorSlávek Banko <slavek.banko@axis.cz>2013-09-03 20:03:11 +0200
committerSlávek Banko <slavek.banko@axis.cz>2013-09-03 21:03:17 +0200
commite19722342046756a90d65060c756198e31ff4457 (patch)
tree8f0f73d20b41d6c9b183ed58a8a13ebc8e5b2f67 /doc/kdearch/index.docbook
parentc3a7a4fbdcd78a66c18b90dc17b7070d517eed17 (diff)
downloadtdevelop-e19722342046756a90d65060c756198e31ff4457.tar.gz
tdevelop-e19722342046756a90d65060c756198e31ff4457.zip
Additional k => tde renaming and fixes
Diffstat (limited to 'doc/kdearch/index.docbook')
-rw-r--r--doc/kdearch/index.docbook34
1 files changed, 17 insertions, 17 deletions
diff --git a/doc/kdearch/index.docbook b/doc/kdearch/index.docbook
index eb7ca4e9..97dee33d 100644
--- a/doc/kdearch/index.docbook
+++ b/doc/kdearch/index.docbook
@@ -16,7 +16,7 @@
<author>
<firstname>Bernd</firstname>
<surname>Gehrmann</surname>
-<affiliation><address><email>bernd@tdevelop.org</email></address></affiliation>
+<affiliation><address><email>bernd@kdevelop.org</email></address></affiliation>
</author>
</authorgroup>
@@ -71,9 +71,9 @@ respecting user preferences.
</varlistentry>
<varlistentry>
-<term><ulink url="kdeapi:tdeio/index.html">kio</ulink></term>
+<term><ulink url="kdeapi:tdeio/index.html">tdeio</ulink></term>
<listitem><para>
-The <literal>kio</literal> library contains facilities for asynchronous,
+The <literal>tdeio</literal> library contains facilities for asynchronous,
network transparent I/O and access to mimetype handling. It also provides the
KDE file dialog and its helper classes.
</para></listitem>
@@ -2074,7 +2074,7 @@ needed. It then goes into a loop and listens for DCOP connections. The program
may be an interactive one, but it may also run completely or for a part of its
lifetime as a daemon in the background without the user noticing it. An example
for such a daemon is <literal>tdeio_uiserver</literal>, which implements user interaction
-such as progress dialog for the KIO library. The advantage of such a centralized
+such as progress dialog for the TDEIO library. The advantage of such a centralized
daemon in this context is that e.g. the download progress for several different
files can be shown in one window, even if those downloads were initiated from
different applications.
@@ -2393,7 +2393,7 @@ else
</programlisting>
<para>
-This starts a KIO job to download a part of the file and check this.
+This starts a TDEIO job to download a part of the file and check this.
Note that this function is perhaps quite slow and blocks the program. Normally
you will only want to use this if <function>KMimeType::findByURL()</function>
has returned <literal>"application/octet-stream"</literal>.
@@ -2401,7 +2401,7 @@ has returned <literal>"application/octet-stream"</literal>.
<para>
On the other hand, if you do not want to block your application, you can also
-explicitly start the KIO job and connect to some of its signals:
+explicitly start the TDEIO job and connect to some of its signals:
</para>
<programlisting>
@@ -2558,7 +2558,7 @@ completely available, but should updated regularly as data comes in.
</para>
<para>
-In the KDE libraries, network transparency is implemented in the KIO API. The
+In the KDE libraries, network transparency is implemented in the TDEIO API. The
central concept of this architecture is an IO <emphasis>job</emphasis>. A job
may copy, or delete files or similar things. Once a job is started, it works
in the background and does not block the application. Any communication from
@@ -2589,10 +2589,10 @@ http://www-com.physik.hu-berlin.de/~bernd/article.tgz#tar:/paper.tex
<simplesect id="nettransparency-usingkio">
-<title>Using KIO</title>
+<title>Using TDEIO</title>
<para>
-In most cases, jobs are created by calling functions in the KIO namespace.
+In most cases, jobs are created by calling functions in the TDEIO namespace.
These functions take one or two URLs as arguments, and possible other
necessary parameters. When the job is finished, it emits the signal
<literal>result(TDEIO::Job*)</literal>. After this signal has been emitted, the job
@@ -2855,7 +2855,7 @@ easier to use: the class <classname>KFileItem</classname>.
<title>Synchronous usage</title>
<para>
-Often, the asynchronous API of KIO is too complex to use and therefore
+Often, the asynchronous API of TDEIO is too complex to use and therefore
implementing full asynchronicity is not a priority. For example, in a program
that can only handle one document file at a time, there is little that can be
done while the program is downloading a file anyway. For these simple cases,
@@ -2965,7 +2965,7 @@ void FooClass::transferResult(TDEIO::Job *job)
<title>Scheduling</title>
<para>
-When using the KIO API, you usually do not have to cope with the details of
+When using the TDEIO API, you usually do not have to cope with the details of
starting IO slaves and communicating with them. The normal use case is to
start a job and with some parameters and handle the signals the jobs emits.
</para>
@@ -2973,7 +2973,7 @@ start a job and with some parameters and handle the signals the jobs emits.
<para>
Behind the curtains, the scenario is a lot more complicated. When you create a
job, it is put in a queue. When the application goes back to the event loop,
-KIO allocates slave processes for the jobs in the queue. For the first jobs
+TDEIO allocates slave processes for the jobs in the queue. For the first jobs
started, this is trivial: an IO slave for the appropriate protocol is started.
However, after the job (like a download from an http server) has finished, it
is not immediately killed. Instead, it is put in a pool of idle slaves and
@@ -2988,7 +2988,7 @@ Of course, reusing is only possible when the existing slave has already finished
its previous job. when a new request arrives while an existing slave process is
still running, a new process must be started and used. In the API usage in the
examples above, there are no limitation for creating new slave processes: if you
-start a consecutive series of downloads for 20 different files, then KIO will
+start a consecutive series of downloads for 20 different files, then TDEIO will
start 20 slave processes. This scheme of assigning slaves to jobs is called
<emphasis>direct</emphasis>. It not always the most appropriate scheme, as it
may need much memory and put a high load on both the client and server machines.
@@ -3093,14 +3093,14 @@ The "input" and "output" lines are not used currently.
<para>
The remaining lines in the <literal>.protocol</literal> file define which
abilities the slave has. In general, the features a slave must implement are
-much simpler than the features the KIO API provides for the application. The
+much simpler than the features the TDEIO API provides for the application. The
reason for this is that complex jobs are scheduled to a couple of subjobs. For
example, in order to list a directory recursively, one job will be started for
the toplevel directory. Then for each subdirectory reported back, new subjobs
-are started. A scheduler in KIO makes sure that not too many jobs are active
+are started. A scheduler in TDEIO makes sure that not too many jobs are active
at the same time. Similarly, in order to copy a file within a protocol that
does not support copying directly (like the <literal>ftp:</literal> protocol),
-KIO can read the source file and then write the data to the destination
+TDEIO can read the source file and then write the data to the destination
file. For this to work, the <literal>.protocol</literal> must advertise the
actions its slave supports.
</para>
@@ -3174,7 +3174,7 @@ functions:
<para>
Additionally, there are reimplementable functions not listed in the <literal>.protocol</literal>
-file. For these operations, KIO automatically determines whether they are supported
+file. For these operations, TDEIO automatically determines whether they are supported
or not (i.e. the default implementation returns an error).
</para>