summaryrefslogtreecommitdiffstats
path: root/doc/tdeioslave/data
diff options
context:
space:
mode:
Diffstat (limited to 'doc/tdeioslave/data')
-rw-r--r--doc/tdeioslave/data/CMakeLists.txt9
-rw-r--r--doc/tdeioslave/data/Makefile.am2
-rw-r--r--doc/tdeioslave/data/index.docbook73
3 files changed, 84 insertions, 0 deletions
diff --git a/doc/tdeioslave/data/CMakeLists.txt b/doc/tdeioslave/data/CMakeLists.txt
new file mode 100644
index 000000000..60910d4cc
--- /dev/null
+++ b/doc/tdeioslave/data/CMakeLists.txt
@@ -0,0 +1,9 @@
+#################################################
+#
+# Improvements and feedback are welcome
+#
+# This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION tdeioslave/data )
diff --git a/doc/tdeioslave/data/Makefile.am b/doc/tdeioslave/data/Makefile.am
new file mode 100644
index 000000000..b542e7870
--- /dev/null
+++ b/doc/tdeioslave/data/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = tdeioslave/data
diff --git a/doc/tdeioslave/data/index.docbook b/doc/tdeioslave/data/index.docbook
new file mode 100644
index 000000000..e88f4d5a1
--- /dev/null
+++ b/doc/tdeioslave/data/index.docbook
@@ -0,0 +1,73 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;" id="data">
+<title>Data URLs</title>
+
+<articleinfo>
+
+<authorgroup>
+<author><personname><firstname>Leo</firstname><surname>Savernik</surname></personname>
+</author>
+<author>&tde-authors;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
+
+<copyright>
+<year>2003</year>
+<holder>Leo Savernik</holder>
+</copyright>
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
+
+<abstract>
+<para>
+This handbook describes the data protocol.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>TDE</keyword>
+<keyword>data</keyword>
+<keyword>protocol</keyword>
+</keywordset>
+</articleinfo>
+
+<para>Data URLs allow small document data to be included in the URL itself.
+This is useful for very small HTML testcases or other occasions that do not
+justify a document of their own.</para>
+
+<para><userinput>data:,foobar</userinput>
+(note the comma after the colon) will deliver a text document that contains
+nothing but <literal>foobar</literal>
+</para>
+
+<para>The last example delivered a text document. For HTML documents one
+has to specify the MIME type <literal>text/html</literal>:
+<userinput>data:text/html,&lt;title&gt;Testcase&lt;/title&gt;&lt;p&gt;This
+is a testcase&lt;/p&gt;</userinput>. This will produce exactly the same
+output as if the content had been loaded from a document of its own.
+</para>
+
+<para>Specifying alternate character sets is also possible. Note that 8-Bit
+characters have to be escaped by a percentage sign and their two-digit
+hexadecimal codes:
+<userinput>data:;charset=iso-8859-1,Gr%FC%DFe aus Schl%E4gl</userinput>
+results in
+<literal>Gr&uuml;&szlig;e aus Schl&auml;gl</literal>
+whereas omitting the charset attribute might lead to something like
+<literal>Gr??e aus Schl?gl</literal>
+</para>
+
+<para><ulink url="http://www.ietf.org/rfc/rfc2397.txt">IETF
+RFC2397</ulink> provides more information.</para>
+
+</article>