Move the khelpcenter guides to the directory level in which they are installed.

Signed-off-by: Slávek Banko <[email protected]>
(cherry picked from commit 1b6c123de102f0152d296fba8771d348329ba95c)

1 files changed, 108 insertions, 0 deletions

diff --git a/doc/khelpcenter/userguide/konsole-intro.docbook b/doc/khelpcenter/userguide/konsole-intro.docbook
new file mode 100644
index 000000000..35c49519b
--- /dev/null
+++ b/doc/khelpcenter/userguide/konsole-intro.docbook
@@ -0,0 +1,108 @@
+<chapter id="konsole-intro">
+
+<chapterinfo>
+<authorgroup>
+<author>
+<firstname>Gardner</firstname>
+<surname>Bell</surname>
+</author>
+</authorgroup>
+</chapterinfo>
+
+
+<title>&konsole; Introduction</title>
+
+<para>Extremely brief intro to managing in a shell</para>
+
+<para>Emergency procedures: killing wild apps, etc</para>
+
+<para>SSH, sessions, envars, other fun things</para>
+
+<para>Some tips and tricks</para>
+
+
+<!-- Some Content borrowed from the konsole handbook -->
+
+<para>&konsole; is a terminal emulator for the X Window System. It is
+essentially based on the <ulink url="http://vt100.net">DEC's VT100</ulink> 
+and many of its succesors.  &konsole; &ndash; also referred to as a
+shell &ndash; is an
+essential tool on &Linux; and &UNIX; based machines for fast and productive
+work.</para>
+
+<para>Emergency Procedures:</para>
+
+<para>On &Linux; and &UNIX;-based systems every process runs independently in its own memory
+space so it can't accidentally overwrite any other processes memory, unless
+of course it has <systemitem class="username">root</systemitem> privileges. 
+If a process in &tde; crashes due to a bug one should not need to worry
+about it accessing any other active process.</para>
+
+<para>To keep track of all system processes use the <command>top</command>
+command or <command>ps</command> in &konsole;.  Using these utilities will
+make it much easier to find and kill off rogue programs.</para>
+
+<para>An example of using signals in &konsole;,  &konqueror; has crashed
+leaving behind a running process of
+<application>nspluginviewer</application> which is taking up 12% of your
+memory and 10% of your cpu cycles.  In <command>top</command> use the <keycap>k</keycap>
+command switch to kill the task.  You will be prompted for the PID and then
+the signal to send to kill it.  For more on info on what signals you can
+send to a running process see the full manual on signals (type
+<command>man signal</command> in a &konsole; or go to
+<userinput>#signal</userinput> in &konqueror;).</para>
+
+<para>SSH, sessions, envars, other fun things.</para>
+
+<para>If you are using &konsole; for remote administration consider using
+&konsole;'s <quote>Session</quote> feature.  To use this click on the menu
+entry
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &konsole;</guimenuitem></menuchoice>.
+From here choose the <guimenuitem>Sessions</guimenuitem> tab and fill in the
+name for your new session.  This will now become your default session when
+you start &konsole;.</para>
+
+<para>When &konsole; is invoked <application>bash</application> specific
+commands and &tde; specific variables are read and executed from
+<filename>~/.bashrc</filename> or <filename>~/.bash_profile</filename>. 
+The preferred configuration file for user environments is
+<filename>~/.bash_profile</filename>, the commands
+<command>printenv</command> or <command>env</command> can be used to
+display all currently set variables.  To set a variable in the shell use 
+<command>VARNAME=<replaceable>value</replaceable></command>.  For a full
+list of variables that can be set in &tde; see the <ulink
+url="http://wiki.kde.org/tiki-index.php?page=Environment+Variables">wiki
+</ulink>.</para>
+
+<para>Some tips and tricks</para>
+
+<para>To rename &konsole;'s session use <keycombo
+action="simul">&Ctrl;&Alt;<keycap>S</keycap></keycombo> and enter the new
+name.</para>
+
+<para>If you find the need to run any &tde; program with <systemitem
+class="username">root</systemitem> privileges,  you can use the &tdesu; command with the <option>-c</option> switch
+from the command line like this: <userinput><command>tdesu</command>
+<option>-c -n <replaceable>PROGRAM</replaceable></option></userinput>, using
+the <option>-n</option> switch will prevent &tde; from remembering your
+passwords.</para>
+
+<!-- Add links to "further reading" here -->
+<itemizedlist>
+<title>Related Information</title>
+
+
+<listitem><para>The &konsole;
+Handbook has much more information about the features available in
+&konsole;. You can read it in &khelpcenter; or by entering
+<userinput>help:/konsole</userinput> in &konqueror;'s
+<guilabel>Location</guilabel> bar.</para>
+</listitem>
+
+</itemizedlist>
+
+
+
+
+
+</chapter>