[kde-doc-english] [kinit] tier3/kservice/docs/kdeinit5: Initial import from the monolithic kdelibs.

[Jenkins CI]

Git commit 84200fe451d9889b42ada32f19adf1fafdccae16 by Jenkins CI.
Committed on 18/12/2013 at 00:45.
Pushed by alexmerry into branch 'master'.

Initial import from the monolithic kdelibs.

This is the beginning of revision history for this module. If you
want to look at revision history older than this, please refer to the
techbase wiki for how to use Git history grafting. At the time of
writing, this wiki is located here:

http://community.kde.org/Frameworks/GitOldHistory

If you have already performed the grafting and you don't see any
history beyond this commit, try running "git log" with the "--follow"
argument.

Branched from the monolithic repo, kdelibs frameworks branch, at commit
162066dbbecde401a7347a1cff4fe72a9c919f58

Commit f3df40271917af9df754da5b4b46d91d1273c770 in kservice

A  +1    -0    tier3/kservice/docs/kdeinit5/CMakeLists.txt
A  +247  -0    tier3/kservice/docs/kdeinit5/man-kdeinit5.8.docbook

http://commits.kde.org/kinit/84200fe451d9889b42ada32f19adf1fafdccae16

diff --git a/tier3/kservice/docs/kdeinit5/CMakeLists.txt b/tier3/kservice/docs/kdeinit5/CMakeLists.txt
new file mode 100644
index 0000000..f61c2be
--- /dev/null
+++ b/tier3/kservice/docs/kdeinit5/CMakeLists.txt
@@ -0,0 +1 @@
+kdoctools_create_manpage(man-kdeinit5.8.docbook 8 INSTALL_DESTINATION ${MAN_INSTALL_DIR})
diff --git a/tier3/kservice/docs/kdeinit5/man-kdeinit5.8.docbook b/tier3/kservice/docs/kdeinit5/man-kdeinit5.8.docbook
new file mode 100644
index 0000000..5466fe7
--- /dev/null
+++ b/tier3/kservice/docs/kdeinit5/man-kdeinit5.8.docbook
@@ -0,0 +1,247 @@
+<?xml version="1.0" ?>
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY % English "INCLUDE"><!-- change language only here -->
+]>
+
+<refentry>
+
+<refentryinfo>
+<title>&kde; User's Manual</title>
+<author>
+<firstname>Waldo</firstname>
+<surname>Bastian</surname>
+<affiliation>
+<address><email>bastian at kde.org</email></address>
+</affiliation>
+</author>
+
+<author>
+<firstname>Mario</firstname>
+<surname>Weilguni</surname>
+<affiliation>
+<address><email>mweilguni at sime.com</email></address>
+</affiliation>
+</author>
+
+<author>
+<firstname>Lubos</firstname>
+<surname>Lunak</surname>
+<affiliation>
+<address><email>l.lunak at kde.org</email></address>
+</affiliation>
+</author>
+
+<date>2008-10-03</date>
+<releaseinfo>0.01.01</releaseinfo>
+
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>kdeinit5</command></refentrytitle>
+<manvolnum>8</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>kdeinit5</command></refname>
+<refpurpose>&kde; process launcher.</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<title>Synopsis</title>
+
+<cmdsynopsis>
+<command>kdeinit5</command>
+
+<arg choice="opt">--help</arg>
+<group>
+<arg>--no-fork</arg>
+<arg>--no-kded</arg>
+<arg>--suicide</arg>
+</group>
+<group>
+<arg>+programs</arg>
+<arg>programs</arg>
+</group>
+</cmdsynopsis>
+
+</refsynopsisdiv>
+
+<refsect1>
+<title>Description</title>
+
+<para>kdeinit5 is a process launcher somewhat similar to the
+famous <command>init</command> used for booting UNIX. It executes &kde;
+programs and kdeinit loadable modules (KLMs) starting them more efficiently.
+</para>
+
+<para>Using kdeinit5 to launch &kde; applications makes starting a typical
+&kde; application a couple times faster and reduces memory consumption by
+a substantial amount.</para>
+
+<para>kdeinit5 is linked against all libraries a standard &kde; application
+needs. With this technique, starting an application becomes much faster 
+because now only the application itself needs to be linked whereas otherwise
+both the application as well as all the libaries it uses need to be linked.
+</para>
+
+</refsect1>
+
+<refsect1>
+<title>Disadvantages</title>
+
+<para>
+The process name of applications started via kdeinit5
+is "kdeinit5". This problem can be corrected to a degree by changing the
+application name as shown by <command>ps</command>. However, applications
+like <command>killall</command> will only see kdeinit5
+as the process name. To workaround this, use <command>kdekillall</command>
+(from kdesdk/scripts) for applications started via kdeinit5.
+</para>
+
+</refsect1>
+
+<refsect1>
+<title>Options</title>
+
+<variablelist>
+
+<varlistentry>
+<term><option>--help</option></term>
+<listitem>
+<para>
+Show help about options
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--no-fork</option></term>
+<listitem>
+<para>Do not fork, i.e. do not exit until all the executed programs ends</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--no-kded</option></term>
+<listitem>
+<para>Do not start kded</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--suicide</option></term>
+<listitem>
+<para>
+Terminate when no KDE applications are left running
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>+programs</option></term>
+<listitem>
+<para>
+runs the programs handling requests
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>programs</option></term>
+<listitem>
+<para>
+runs the programs without handling requests
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>Usage</title>
+<para>
+A standard way to run this program is by simply specifying the following
+command at the prompt
+<userinput><command>kdeinit5</command> program</userinput> or
+<userinput><command>kdeinit5</command> +program
+</userinput>
+</para>
+
+</refsect1>
+
+<!--
+<refsect1>
+<title>Examples</title>
+<para>
+<userinput><command>kdeinit5</command> +kwrite</userinput>
+</para>
+</refsect1>
+-->
+
+<refsect1>
+<title>Files</title>
+
+<variablelist>
+<varlistentry>
+<term><filename>/tmp/kde-$USER/kdeinit5_$INSTANCE</filename></term>
+<listitem>
+<para>...</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>Environment Variables</title>
+<variablelist>
+
+<varlistentry>
+<term>$<envar>HOME</envar></term>
+<listitem>
+<para>Specifies the home directory of the current user</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>$<envar>KDE_HOME_READONLY</envar></term>
+<listitem>
+<para>Specifies if the home directory of the current user is read only</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>$<envar>KDE_IS_PRELINKED</envar></term>
+<listitem>
+<para>If set, tells kdeinit5 that the &kde; programs are pre-linked.</para>
+<para>(Prelinking is a process that allows you to speed up the process of dynamic linking.)</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>$<envar>KDE_DISPLAY</envar></term>
+<listitem>
+<para>If set, tells kdeinit5 that it is running on a &kde; desktop.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>See Also</title>
+<para>kded, kdekillall</para>
+</refsect1>
+
+<refsect1>
+<title>Bugs</title>
+<para>There are probably tons of bugs. Use <ulink url="http://bugs.kde.org">bugs.kde.org</ulink> to report them.</para>
+</refsect1>
+
+</refentry>
+
+
+