diff options
author | Darrell Anderson <humanreadable@yahoo.com> | 2012-02-24 22:53:44 -0600 |
---|---|---|
committer | Darrell Anderson <humanreadable@yahoo.com> | 2012-02-24 23:26:11 -0600 |
commit | fc2650816b4b95f21750c53c0d45daeff31510d6 (patch) | |
tree | 7227267d1ba5acef3b86db06979667a13bebc7c5 /doc/userguide/kde-for-admins.docbook | |
parent | ca1a4375014b6f78a06c74169a1285abbcbcd819 (diff) | |
download | tdebase-fc2650816b4b95f21750c53c0d45daeff31510d6.tar.gz tdebase-fc2650816b4b95f21750c53c0d45daeff31510d6.zip |
Update tdebase cmake files with STARTKDE->STARTTDE.
Fix tdebase entities, text strings for future maintenance of handbook files. This partially resolves bug report 694.
Update konqueror user agent strings. This partially resolves bug report 774.
Update TDM help options. This resolves bug report 618.
Fix KTips branding issues and obsolete web addresses. This resolves bug report 842.
Diffstat (limited to 'doc/userguide/kde-for-admins.docbook')
-rw-r--r-- | doc/userguide/kde-for-admins.docbook | 301 |
1 files changed, 143 insertions, 158 deletions
diff --git a/doc/userguide/kde-for-admins.docbook b/doc/userguide/kde-for-admins.docbook index 466aba62b..6bf03c0db 100644 --- a/doc/userguide/kde-for-admins.docbook +++ b/doc/userguide/kde-for-admins.docbook @@ -1,24 +1,9 @@ <part id="kde-for-administrators"> -<partinfo> -<authorgroup> -<author> -<personname> -<firstname>Waldo</firstname> -<surname>Bastian</surname> -</personname> -<email>bastian@kde.org</email> -</author> -<othercredit role="reviewer"> -&Philip.Rodrigues; -&Philip.Rodrigues.mail; -</othercredit> -</authorgroup> -</partinfo> - -<title>&kde; for Administrators</title> + +<title>&tde; for Administrators</title> <chapter id="kde-internals"> -<title>&kde; Internals</title> +<title>&tde; Internals</title> <sect1 id="kde-for-admins-overview"> <title>Overview</title> @@ -28,12 +13,12 @@ <sect1 id="directory-layout"> <title>Directory Layout</title> -<para>&kde; defines a filesystem hierarchy which is used by the &kde; -environment itself as well as all &kde; applications. In general &kde; +<para>&tde; defines a filesystem hierarchy which is used by the &tde; +environment itself as well as all &tde; applications. In general &tde; stores all its files in a directory tree with a fixed structure. </para> -<para>By default &kde; uses two directory trees:</para> +<para>By default &tde; uses two directory trees:</para> <itemizedlist> <listitem><para>One at the system level (for example <filename @@ -68,8 +53,8 @@ check which directory trees are used with the following command: <option>--check</option></userinput></para> </informalexample> -<para>&kde; and &kde; applications look up files by scanning all the -&kde; directory trees. The directory trees are checked in order of +<para>&tde; and &tde; applications look up files by scanning all the +&tde; directory trees. The directory trees are checked in order of precedence. When a file is present in multiple directory trees, the file from the last tree takes precedence. Normally, the tree located in the user's home directory has the highest precedence. This @@ -160,7 +145,7 @@ root writing to $TDEHOME of the user after running <seg><filename class="directory">/opt/trinity</filename>, <filename class="directory">/usr</filename>, <filename class="directory">/usr/trinity</filename></seg> -<seg>Vendor dependent. Used by &kde; 2. If not set, falls back to +<seg>Vendor dependent. Used by &tde; 2. If not set, falls back to compiled-in default.</seg> </seglistitem> @@ -169,15 +154,15 @@ compiled-in default.</seg> <seg><filename class="directory">/opt/trinity</filename>, <filename class="directory">/usr</filename>, <filename class="directory">/usr/trinity</filename></seg> -<seg>New in &kde;3. Can list multiple locations separated by a +<seg>New in &tde;3. Can list multiple locations separated by a colon. If not set, falls back to $<envar>TDEDIR</envar></seg> </seglistitem> </segmentedlist> </para> <para>Don't <emphasis>need</emphasis> to be set, defaults work just fine.</para> -<para>Running &kde;2 next to &kde;3? Point $<envar>TDEDIR</envar> to -&kde; 2 and $<envar>TDEDIRS</envar> to &kde; 3.</para> +<para>Running &tde;2 next to &tde;3? Point $<envar>TDEDIR</envar> to +&tde; 2 and $<envar>TDEDIRS</envar> to &tde; 3.</para> <informalexample> <para>A staff member at a university could have the following @@ -222,7 +207,7 @@ userProfileMapFile=/etc/kde-user-profile </programlisting> <para>It is now possible to assign a profile based on either the user name -or based on the &UNIX; group the user is part of.</para> +or based on the &UNIX; group the user is part of.</para> <para>To assign the staff profile to all users that are a member of the &UNIX; group staff_members add the following to @@ -247,7 +232,7 @@ bastian=staff <sect1 id="directory-layout-revisited"> <title>Directory Layout Revisited</title> -<para>Each directory tree used by &kde; has a fixed directory structure. +<para>Each directory tree used by &tde; has a fixed directory structure. Directories that are not relevant for a certain tree, or simply not used can be left out though. For example, directories used for temporary files are usually only found under <filename @@ -264,20 +249,20 @@ directory tree.</para> <variablelist> <varlistentry> <term><filename class="directory">bin</filename></term> -<listitem><para>Used for &kde; executables.</para></listitem> +<listitem><para>Used for &tde; executables.</para></listitem> </varlistentry> <varlistentry> <term><filename class="directory">lib</filename></term> -<listitem><para>Used for &kde; libraries.</para> +<listitem><para>Used for &tde; libraries.</para> </listitem> </varlistentry> <varlistentry> <term><filename class="directory">lib/trinity</filename></term> <listitem><para>This directory contains components, plugins, and other -runtime loadable objects for use by &kde; 3.<replaceable>x</replaceable> -applications.</para></listitem> +runtime loadable objects for use by &tde; 3.<replaceable>x</replaceable> +applications.</para></listitem> </varlistentry> </variablelist> @@ -293,13 +278,13 @@ archs.</para> <varlistentry> <term><filename class="directory">share/applnk</filename></term> <listitem><para><literal role="extension">.desktop</literal> files for -&kde;-menu (old)</para></listitem> +&tde;-menu (old)</para></listitem> </varlistentry> <varlistentry> <term><filename class="directory">share/applications</filename></term> <listitem><para><literal role="extension">.desktop</literal> files for -&kde;-menu (since &kde; 3.2)</para> +&tde;-menu (since &kde; 3.2)</para> </listitem> </varlistentry> @@ -314,8 +299,8 @@ files.</para></listitem> <term><filename class="directory">share/config</filename></term> <listitem><para>Configuration files. Configuration files are normally named after the application they belong to plus the letters -<quote>rc</quote>. A special case is <filename>kdeglobals</filename>. -This file is read by all &kde; applications.</para></listitem> +<quote>rc</quote>. A special case is <filename>kdeglobals</filename>. +This file is read by all &tde; applications.</para></listitem> </varlistentry> <varlistentry> @@ -324,7 +309,7 @@ class="directory">share/config/session</filename></term> <listitem><para>This directory is used by session management and is normally only available under <filename class="directory">$<envar>TDEHOME</envar></filename>. At the end of a -session &kde; applications store their state here. The file names +session &tde; applications store their state here. The file names consist of the name of the application followed by a number. The session manager <command>ksmserver</command> stores references to these numbers when saving a session in @@ -333,7 +318,7 @@ these numbers when saving a session in <varlistentry> <term><filename class="directory">share/doc/HTML</filename></term> -<listitem><para>This directory contains documentation for &kde; +<listitem><para>This directory contains documentation for &tde; applications. Documentation is categorized by language and the application it belongs to. Normally at least two files can be found in a directory: <filename>index.docbook</filename>, which contains the @@ -356,7 +341,7 @@ categorized by theme, dimension and usage category.</para></listitem> <term><filename class="directory">share/mimelnk</filename></term> <listitem><para>In this directory,<literal role="extension">.desktop</literal> files that describe &MIME; types -are stored. &kde; uses &MIME; types to identify the type of a +are stored. &tde; uses &MIME; types to identify the type of a file.</para> </listitem> </varlistentry> @@ -366,7 +351,7 @@ file.</para> <listitem><para>This directory contains <literal role="extension">.desktop</literal> files that describe services. Services are like applications but are usually launched by other applications instead -of the user. Services do not appear in the &kde; menu.</para> +of the user. Services do not appear in the &tde; menu.</para> </listitem> </varlistentry> @@ -408,7 +393,7 @@ background picture</para></listitem> </sect1> <sect1 id="host-specific-directories"> -<title>Host-specific Directories</title> +<title>Host-specific Directories</title> <para>There are three host-specific directories that are usually symlinked to other locations. If the directories do not already exist, @@ -451,9 +436,9 @@ an alternative name and link to that instead.</para> </sect1> <sect1 id="configuration-files"> -<title>Configuration Files</title> <para>&kde; uses a simple +<title>Configuration Files</title> <para>&tde; uses a simple text-based file format for all its configuration files. It consists of -key-value pairs that are placed in groups. All &kde; configuration +key-value pairs that are placed in groups. All &tde; configuration files use <acronym>UTF</acronym>-8 encoding for text outside the <acronym>ASCII</acronym> range.</para> @@ -471,7 +456,7 @@ second group contains the keys <varname>Show hidden files</varname> and <varname>Sort by</varname>:</para> <programlisting> -[KDE] +[TDE] LargeCursor=false SingleClick=true </programlisting> @@ -527,13 +512,13 @@ Description=This is\na very long\ndescription. <para>Empty lines in configuration files are ignored, as are lines that start with a hash mark (<quote>#</quote>). The hash mark can be used to add -comments to configuration files. It should be noted that when a &kde; +comments to configuration files. It should be noted that when a &tde; application updates a configuration file the comments are <emphasis>not</emphasis> preserved.</para> <para>There can be multiple configuration files with the same name in the <filename class="directory">share/config</filename> sub-directory of the -various &kde; directory trees. In this case the information of all these +various &tde; directory trees. In this case the information of all these configuration files is combined on a key-by-key basis. If the same key within a certain group is defined in more than one place, the key value read from the directory tree with the highest precedence will be used. @@ -698,7 +683,7 @@ result in a value equal to <literal>joe@joes_host</literal>. The setting is not locked down.</para> <programlisting> -[Mail Settings] +[Mail Settings] Host[$ie]=$(hostname) Email[$e]=${USER}@${HOST} </programlisting> @@ -739,11 +724,11 @@ Caption[fr]=Ma Légende </informalexample> <para>In general the entries that can appear in a configuration file are not -documented. With &kde; 3.2 a start has been made to change this. In +documented. With &tde; 3.2 a start has been made to change this. In <filename class="directory">$<envar>TDEDIR</envar>/share/config.kcfg</filename>, files can be found that provide a formal description of the possible entries in a -configuration file. These are used by the new &kde; Configuration Editor +configuration file. These are used by the new &tde; Configuration Editor when available.</para> <informalexample> @@ -779,7 +764,7 @@ Auto Save Interval=25 </sect1> <sect1 id="kde-startup-sequence"> -<title>&kde; Startup Sequence</title> +<title>&tde; Startup Sequence</title> <sect2 id="tdm"> <title>&tdm;</title> @@ -811,7 +796,7 @@ Startup - <filename>/etc/X11/xdm/Xstartup</filename> - prepare as root Session - <filename>/etc/X11/xdm/Xsession</filename> - starts session as user </member> <member> -= For a KDE session: <command>kde</command> or <command>starttde</command> += For a TDE session: <command>kde</command> or <command>starttde</command> </member> <member> = If present <filename>~/.xsession</filename> or <filename>~/.xinitrc</filename> @@ -824,9 +809,9 @@ Reset - <filename>/etc/X11/xdm/Xreset</filename> - after session finished </sect2> <sect2 id="starttde"> -<title>The &kde; Startup Script: <command>starttde</command></title> +<title>The &tde; Startup Script: <command>starttde</command></title> -<para>The &kde; startup sequence starts with the +<para>The &tde; startup sequence starts with the <filename>starttde</filename> script. In most cases this script gets called from the display manager (&tdm;) once the user has been authenticated. Their are two very important lines in the <filename>starttde</filename> @@ -839,7 +824,7 @@ ksmserver $TDEWM <para>The first line starts the <command>tdeinit</command> master process. The <command>tdeinit</command> master process is used to start all other -&kde; processes. It show up in the output of <command>ps +&tde; processes. It show up in the output of <command>ps <option>aux</option></command> as <computeroutput>tdeinit: Running...</computeroutput>. The arguments after <command>tdeinit</command> are the names of additional processes to be started. The <token>+</token> @@ -859,7 +844,7 @@ user is logged out.</para> <sect1 id="background-processes"> <title>Background Processes</title> -<para>All &kde; background services are user-specific: unlike system daemons +<para>All &tde; background services are user-specific: unlike system daemons they are not shared between users. As well as being unique per user they are also unique per X-server display. The processes are:</para> @@ -912,7 +897,7 @@ needed</para> <sect2 id="tdeinit"> <title><command>tdeinit</command></title> -<para><command>tdeinit</command> is used to start all other &kde; +<para><command>tdeinit</command> is used to start all other &tde; programs. <command>tdeinit</command> can start normal binary program files as well as <command>tdeinit</command> loadable modules (<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary @@ -954,9 +939,9 @@ command line in the <command>starttde</command> script, normally <title><command>dcopserver</command></title> <para><command>dcopserver</command> is a daemon which provides inter-process -communication (&DCOP;) facilities to all &kde; applications. The &DCOP; +communication (&DCOP;) facilities to all &tde; applications. The &DCOP; facilities are accessible from the command shell via the -<command>dcop</command> command line tool. &DCOP; is essential for all &kde; +<command>dcop</command> command line tool. &DCOP; is essential for all &tde; applications.</para> <para>Some related files:</para> @@ -1018,8 +1003,8 @@ startup problems.</para> <title><command>klauncher</command></title> <para><command>klauncher</command> is a daemon which is responsible for -service activation within &kde;. It operates in close connection with the -<command>tdeinit</command> master process to start new processes. &kde; +service activation within &tde;. It operates in close connection with the +<command>tdeinit</command> master process to start new processes. &tde; applications communicate with <command>klauncher</command> over &DCOP; in order to start new applications or services.</para> @@ -1050,7 +1035,7 @@ methods.</para> <sect1 id="ksmserver"> <title>KSMServer</title> -<para><command>ksmserver</command> is &kde;'s session manager. On startup +<para><command>ksmserver</command> is &tde;'s session manager. On startup the session manager launches auto-start applications and restores applications from the previous session. The applications to auto-start are indicated by <literal role="extension">.desktop</literal> files in the @@ -1084,13 +1069,13 @@ are:</para> <varlistentry> <term><command>kdesktop</command></term> -<listitem><para>The &kde; desktop</para> +<listitem><para>The &tde; desktop</para> </listitem> </varlistentry> <varlistentry> <term><command>&kicker;</command></term> -<listitem><para>The &kde; panel</para> +<listitem><para>The &tde; panel</para> </listitem> </varlistentry> @@ -1127,7 +1112,7 @@ will automatically open any files stored in this directory including documents, binary files or applications in the form of <literal role="extension">.desktop</literal> files.</para> -<para>The &kde; session manager also restores one of the previous +<para>The &tde; session manager also restores one of the previous sessions. A session contains a collection of applications as well as application-specific information that reflects the state of the applications at the time the session was saved. Sessions are stored in the @@ -1144,7 +1129,7 @@ windows of all the other applications in the session. <sect1 id="environment-variables"> <title>Environment variables</title> -<para>Some important environment variables used by &kde;:</para> +<para>Some important environment variables used by &tde;:</para> <variablelist> @@ -1152,30 +1137,30 @@ windows of all the other applications in the session. <term>$<envar>TDEDIR</envar></term> <listitem><para>Has to be set if <envar>TDEDIRS</envar> is not set and has to point to the root of the -&kde; installation tree. Allows &kde; to find its data like icons, +&tde; installation tree. Allows &tde; to find its data like icons, menus and libraries.</para> </listitem> </varlistentry> <varlistentry><term>$<envar>TDEDIRS</envar></term> <listitem><para>Overrides <envar>TDEDIR</envar> and allows you to specify -multiple directories where &kde; searches for its data. Useful if you want +multiple directories where &tde; searches for its data. Useful if you want or have to install some programs to a different prefix than the rest of -&kde;.</para> +&tde;.</para> </listitem> </varlistentry> <varlistentry><term><envar>$TDEHOME</envar></term><listitem><para>If -not set, &kde; uses <filename class="directory">~/.kde</filename> as +not set, &tde; uses <filename class="directory">~/.kde</filename> as the directory where personal data is stored.</para> </listitem> </varlistentry> <varlistentry><term>$<envar>TDEROOTHOME</envar></term><listitem><para>If -not set, &kde; uses <filename class="directory">~root/.kde</filename> +not set, &tde; uses <filename class="directory">~root/.kde</filename> as the directory for <systemitem class="username">root</systemitem>'s -personal data. Was introduced to prevent &kde; from accidently -overwriting user data with root permissions when the user runs a &kde; +personal data. Was introduced to prevent &tde; from accidently +overwriting user data with root permissions when the user runs a &tde; program after switching with <command>su</command> to <systemitem class="username">root</systemitem>.</para> </listitem> @@ -1183,25 +1168,25 @@ class="username">root</systemitem>.</para> <varlistentry><term>$<envar>TDEWM</envar></term><listitem><para>If the <envar>TDEWM</envar> environment variable has been set, then it will -be used as &kde;'s window manager within the +be used as &tde;'s window manager within the <command>starttde</command> script instead of &twin;.</para> </listitem> </varlistentry> -<varlistentry><term>$<envar>KDE_LANG</envar></term><listitem><para>Overrides -the &kde; language configuration, ⪚ <userinput>KDE_LANG=fr kprogram +<varlistentry><term>$<envar>TDE_LANG</envar></term><listitem><para>Overrides +the &tde; language configuration, ⪚ <userinput>TDE_LANG=fr kprogram &</userinput> starts a program with French translation if the necessary files are installed.</para> </listitem> </varlistentry> <varlistentry><term>$<envar>TDE_MULTIHEAD</envar></term><listitem><para>Set -this variable to <literal>true</literal> to indicate that &kde; is running +this variable to <literal>true</literal> to indicate that &tde; is running on a multi-head system.</para> </listitem> </varlistentry> -<varlistentry><term>$<envar>KDE_FORK_SLAVES</envar></term> +<varlistentry><term>$<envar>TDE_FORK_SLAVES</envar></term> <listitem><para>(Since &kde; 3.2.3) Set this variable to spawn <acronym>KIO</acronym>-slaves directly from the application process itself. By default <acronym>KIO</acronym>-slaves are spawned using @@ -1212,35 +1197,35 @@ environment as the application. This can be the case with </listitem> </varlistentry> -<varlistentry><term>$<envar>KDE_HOME_READONLY</envar></term> +<varlistentry><term>$<envar>TDE_HOME_READONLY</envar></term> <listitem><para>Set this variable to indicate that your home directory is mounted as read-only.</para> </listitem> </varlistentry> -<varlistentry><term>$<envar>KDE_NO_IPV6</envar></term><listitem><para> +<varlistentry><term>$<envar>TDE_NO_IPV6</envar></term><listitem><para> (Since &kde; 3.2.3) - Set this variable to disable <acronym>IPv6</acronym> support and <acronym>IPv6</acronym> <acronym>DNS</acronym> lookups.</para> </listitem> </varlistentry> -<varlistentry><term>$<envar>KDE_IS_PRELINKED</envar></term><listitem><para> +<varlistentry><term>$<envar>TDE_IS_PRELINKED</envar></term><listitem><para> (Since &kde; 3.2) - Set this variable to indicate that you have prelinked -your &kde; binaries and libraries. This will turn off +your &tde; binaries and libraries. This will turn off <command>tdeinit</command>.</para> </listitem> </varlistentry> -<varlistentry><term>$<envar>KDE_UTF8_FILENAMES</envar></term><listitem><para>If -this environment variable is set, &kde; assumes all filenames are in +<varlistentry><term>$<envar>TDE_UTF8_FILENAMES</envar></term><listitem><para>If +this environment variable is set, &tde; assumes all filenames are in <acronym>UTF-8</acronym> encoding regardless of the current C locale.</para> </listitem> </varlistentry> <varlistentry><term>$<envar>TDE_FULL_SESSION</envar></term><listitem><para> -(Since &kde; 3.2) Automatically set to true by &kde; startup, it is used +(Since &kde; 3.2) Automatically set to true by &tde; startup, it is used by ⪚ &konqueror; to know if it should consider remaining in memory for future re-use when being closed. If not set, &konqueror; will exit after being closed (⪚ &tdesu; does that, it's also useful for @@ -1248,22 +1233,22 @@ debugging).</para> </listitem> </varlistentry> -<varlistentry><term>$<envar>KDESYCOCA</envar></term><listitem><para>Allows -you to specify the path and the name of the generated &kde; system +<varlistentry><term>$<envar>TDESYCOCA</envar></term><listitem><para>Allows +you to specify the path and the name of the generated &tde; system configuration cache file.</para> </listitem> </varlistentry> <varlistentry><term>$<envar>TDETMP</envar></term><listitem><para>Allows to specify another path than <filename -class="directory">/tmp</filename> where &kde; stores its temporary +class="directory">/tmp</filename> where &tde; stores its temporary files.</para> </listitem> </varlistentry> <varlistentry><term>$<envar>TDEVARTMP</envar></term><listitem><para>Allows to specify another path than <filename -class="directory">/var/tmp</filename> where &kde; stores its variable +class="directory">/var/tmp</filename> where &tde; stores its variable files.</para> </listitem> </varlistentry> @@ -1282,11 +1267,11 @@ class="directory">$<envar>XDG_DATA_HOME</envar></filename> base directory. Default is <literal>/usr/local/share/:/usr/share/</literal></para> -<para>&kde; adds locations from $<envar>TDEDIRS</envar> and profiles +<para>&tde; adds locations from $<envar>TDEDIRS</envar> and profiles as well. Used for <literal role="extension">.desktop</literal> and <literal role="extension">.directory</literal> menu files. <literal role="extension">.desktop</literal> files under <filename -class="directory">$<envar>XDG_DATA_DIRS</envar>/applications</filename>. +class="directory">$<envar>XDG_DATA_DIRS</envar>/applications</filename>. <literal role="extension">.directory</literal> files under $XDG_DATA_DIRS/desktop-directories @@ -1295,16 +1280,16 @@ $XDG_DATA_DIRS/desktop-directories </varlistentry> <varlistentry><term>$<envar>XDG_CONFIG_HOME</envar></term><listitem><para> -(&kde; 3.2) - Defines the base directory relative to which user +(&tde; 3.2) - Defines the base directory relative to which user specific configuration files should be stored. Default is <filename class="directory">$<envar>HOME</envar>/.config</filename>.</para> </listitem> </varlistentry> <varlistentry><term>$<envar>XDG_CONFIG_DIRS</envar></term><listitem><para> -(&kde; 3.2) - Defines the preference-ordered set of base directories +(&tde; 3.2) - Defines the preference-ordered set of base directories to search for configuration files in addition to the $<envar>XDG_CONFIG_HOME</envar> -base directory. The default is <filename class="directory">/etc/xdg</filename> &kde; adds locations from +base directory. The default is <filename class="directory">/etc/xdg</filename> &tde; adds locations from $<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension">.menu</literal> descriptions in <filename class="directory">$<envar>XDG_CONFIG_DIRS</envar>/menus</filename>. </para> @@ -1319,7 +1304,7 @@ $<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension"> <!-- FIXME: Add more words. Fix markup --> -<para><command>tdeinit</command> is used to start all other &kde; +<para><command>tdeinit</command> is used to start all other &tde; programs. <command>tdeinit</command> can start normal binary program f iles as well as <command>tdeinit</command> loadable modules (<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary @@ -1354,7 +1339,7 @@ difficult to kill a process that is causing trouble:</para> <para>You might be tempted to try <userinput><command>killall tdeinit</command></userinput>, but killing all tdeinit processes will have -the effect of shutting down all of &kde;. In effect, total +the effect of shutting down all of &tde;. In effect, total destruction!</para> <para>There are two simple solutions to this:</para> @@ -1362,7 +1347,7 @@ destruction!</para> <screen><prompt>%</prompt> <userinput><command>kdekillall kdesktop</command></userinput> or good old <prompt>%</prompt> <userinput><command>kill 26195</command></userinput></screen> -<para><command>kdekillall</command> is part of the &kde; <acronym>SDK</acronym> +<para><command>kdekillall</command> is part of the &tde; <acronym>SDK</acronym> package.</para> </sect1> @@ -1370,13 +1355,13 @@ package.</para> </chapter> <chapter id="customizing-kde"> -<title>Customizing &kde;</title> +<title>Customizing &tde;</title> <sect1 id="desktop-icons"> <title>Desktop Icons</title> -<para>&kde; uses several types of icons:</para> +<para>&tde; uses several types of icons:</para> <itemizedlist> <listitem><para>Documents</para> </listitem> @@ -1423,7 +1408,7 @@ URL=http://www.kde.org/ role="extension">.desktop</literal> file: <menuchoice><guimenu>Create New</guimenu><guisubmenu>File</guisubmenu><guimenuitem>Link to Application</guimenuitem></menuchoice>. You must provide details -yourself. Drag from &kde; Menu: Either copy or link (creates symlink), +yourself. Drag from &tde; Menu: Either copy or link (creates symlink), much easier</para> <!-- Perhaps legacy and translated should be the other way around, but --> @@ -1496,7 +1481,7 @@ disable if it doesn't work.</para> <callout arearefs="co-x-dcop-servicetype"><para>Has app started ok? Remove if it doesn't work</para> </callout> -<callout arearefs="co-categories"><para>Categories for &kde; Menu, not +<callout arearefs="co-categories"><para>Categories for &tde; Menu, not used on desktop</para> </callout> </calloutlist> @@ -1528,7 +1513,7 @@ open several local files at once.</para> <varlistentry> <term>%u</term> <listitem><para>A single &URL;: if the app can -handle ⪚ &FTP; or &HTTP; &URL;s itself, otherwise &kde;.</para> +handle ⪚ &FTP; or &HTTP; &URL;s itself, otherwise &tde;.</para> </listitem> </varlistentry> @@ -1554,8 +1539,8 @@ have file in current working directory.</para> </varlistentry> <varlistentry> -<term>%i</term> -<listitem><para>The icon; <option>--icon</option> option; &kde; app +<term>%i</term> +<listitem><para>The icon; <option>--icon</option> option; &tde; app will use icon from <varname>Icon</varname>= line in taskbar.</para> </listitem> </varlistentry> @@ -1567,8 +1552,8 @@ will use icon from <varname>Icon</varname>= line in taskbar.</para> </varlistentry> <varlistentry> -<term>%c</term> -<listitem><para>The caption; <option>--caption</option> option; &kde; +<term>%c</term> +<listitem><para>The caption; <option>--caption</option> option; &tde; app will use name from <varname>Name</varname>= line in taskbar.</para> </listitem> @@ -1635,15 +1620,15 @@ class="directory">/opt/trinity/share/config/SuSE/default/</filename></para></lis </sect1> <sect1 id="kde-menu"> -<title>&kde; Menu</title> +<title>&tde; Menu</title> <sect2 id="how-it-works"> <title>How it Works</title> -<para>In &kde; 3.2 a common menu format is introduced at +<para>In &tde; 3.2 a common menu format is introduced at <ulink url="http://freedesktop.org/Standards/menu-spec/">http://freedesktop.org/Standards/menu-spec/</ulink></para> -<para>Before &kde; 3.2: +<para>Before &tde; 3.2: <itemizedlist> <listitem><para>Directory structure under <filename @@ -1658,12 +1643,12 @@ represents a single application</para></listitem> </itemizedlist> </para> -<para>It was difficult to rearrange the structure in &kde; 3.2 so the +<para>It was difficult to rearrange the structure in &tde; 3.2 so the new menu format: <itemizedlist> <listitem><para>Defines structure in a single .menu file</para></listitem> <listitem><para>Is based on categories</para></listitem> -<listitem><para>is shared between <acronym>GNOME</acronym> and &kde;</para></listitem> +<listitem><para>is shared between <acronym>GNOME</acronym> and &tde;</para></listitem> <listitem><para>Supports applnk style menus as well</para></listitem> </itemizedlist> </para> @@ -1781,10 +1766,10 @@ Icon=kcmsystem <para>Applications <emphasis>not</emphasis> in the menu do <emphasis>not</emphasis> exist with regard to other applications or -file associations: If you remove an application from the menu, &kde; assumes you don't want to use it.</para> +file associations: If you remove an application from the menu, &tde; assumes you don't want to use it.</para> <para>When applications are unwanted in the menu, either place them in -<filename>.hidden</filename> menu or a dedicated menu with +<filename>.hidden</filename> menu or a dedicated menu with <programlisting> NoDisplay=true </programlisting> in the <literal @@ -1797,7 +1782,7 @@ role="extension">.directory</literal> file</para> <para><filename class="directory">$<envar>TDEDIR</envar>/etc/xdg/menus/applications-merged/</filename> contains <filename>kde-essential.menu</filename> which includes some -essential menus that are normally not shown in the &kde; menu itself: +essential menus that are normally not shown in the &tde; menu itself: <itemizedlist> <listitem><para>Control Center has a hidden Settings menu whose contents are defined by <filename>kde-settings.menu</filename> and @@ -1826,7 +1811,7 @@ NoDisplay=true <sect2 id="old-style-menus"> <title>Old-Style Menus</title> -<para>&kde; continues to support old-style menus that are defined by +<para>&tde; continues to support old-style menus that are defined by the directory structures in <filename class="directory">$<envar>TDEDIR</envar>/share/applnk</filename> (system wide) and <filename @@ -1843,7 +1828,7 @@ database with which is built lives in <filename class="directory">/var/tmp/kdecache-${<envar>USER</envar>}/ksycoca</filename>. It is automatically updated by <application>KDED</application>, -checked during &kde; login, and <application>KDED</application> +checked during &tde; login, and <application>KDED</application> watches for changes while logged in.</para> <para>To disable watching for changes (since it may hurt over NFS) add @@ -1878,9 +1863,9 @@ profile- or system-wide locations. <!-- This section might be redundant. If it isn't, it needs some screenies --> <sect1 id="kde-panel"> -<title>&kde; Panel</title> +<title>&tde; Panel</title> -<para>The &kde; panel is also known as &kicker;. It is modular and +<para>The &tde; panel is also known as &kicker;. It is modular and consists of the following components: <itemizedlist> <listitem><para>Applets</para></listitem> @@ -1898,7 +1883,7 @@ consists of the following components: </itemizedlist> and the following special buttons: <itemizedlist> -<listitem><para>&kde; menu</para></listitem> +<listitem><para>&tde; menu</para></listitem> <listitem><para>Desktop Button</para></listitem> </itemizedlist> </para> @@ -1917,7 +1902,7 @@ and the following special buttons: <para>File associations associate a file type with an application or applications. The type of a file is established by determining its -&MIME; type. &MIME; types known by &kde; are stored in <filename +&MIME; type. &MIME; types known by &tde; are stored in <filename class="directory">$<envar>TDEDIR</envar>/share/mimelnk</filename> and each application's <literal role="extension">.desktop</literal> file contains a list of &MIME; types supported by that application.</para> @@ -1962,7 +1947,7 @@ role="extension">.gif</literal> files. &kcontrolcenter;. These changes are stored in <filename>$<envar>HOME</envar>/.kde/share/config/profilerc</filename>. To use the same settings for multiple users, store these settings in -user profile directory or the global &kde; config directory to use as +user profile directory or the global &tde; config directory to use as default for multiple users.</para> </informalexample> @@ -1972,12 +1957,12 @@ default for multiple users.</para> </chapter> <chapter id="locking-down-kde"> -<title>Locking Down &kde;</title> +<title>Locking Down &tde;</title> <sect1 id="how-it-works-the-basics"> <title>How It Works - The Basics</title> -<para>&kde;'s lock down features are centered around the following +<para>&tde;'s lock down features are centered around the following options:</para> <itemizedlist> @@ -1995,7 +1980,7 @@ certain configuration modules</link></para></listitem> <sect1 id="immutable-configuration-options"> <title>Immutable Configuration Options</title> -<subtitle>Locking Down &kde;</subtitle> +<subtitle>Locking Down &tde;</subtitle> <para>Immutable options allow system administrator to provide default settings that can not be changed by the user.</para> @@ -2020,7 +2005,7 @@ presented with an user interface option to make such change.</para></note> <sect1 id="action-restrictions"> <title>Action Restrictions</title> -<para>&kde; applications are built around the action-concept. Actions can be +<para>&tde; applications are built around the action-concept. Actions can be activated in various ways, typically via the menu-bar, one of the toolbars or a keyboard shortcut. <action>Save Document</action> is an example of an action. If you know the internal action name it is possible to restrict an @@ -2038,17 +2023,17 @@ functionality that would offer the user access to a &UNIX; shell.</para> <para>In order to prevent the user access to a command shell we can restrict the <option>shell_access</option> action by adding the following to <filename>kdeglobals</filename>: -</para> +</para> -<screen>[KDE Action Restrictions] +<screen>[TDE Action Restrictions] shell_access=false</screen> -<para>Since this affects the &kde; menu and the available applications, we +<para>Since this affects the &tde; menu and the available applications, we must force an update of the sycoca database:</para> <screen><userinput><command>touch</command> <filename>$<envar>TDEDIR</envar>/share/services/update_ksycoca</filename></userinput></screen> -<para>Now re-login to &kde; and check the following points:</para> +<para>Now re-login to &tde; and check the following points:</para> <itemizedlist> <listitem><para>The &kmenu;</para></listitem> @@ -2159,7 +2144,7 @@ accessed.</para> <area id="url_rule1" coords="3"/> <area id="url_rule2" coords="4"/> </areaspec> -<screen>[KDE URL Restrictions] +<screen>[TDE URL Restrictions] rule_count=2 rule_1=open,,,,http,,,false rule_2=open,,,,http,*.ourcompany.com,,true</screen></screenco> @@ -2168,7 +2153,7 @@ rule_2=open,,,,http,*.ourcompany.com,,true</screen></screenco> <callout arearefs="url_commas"> <para>The first four commas skip over the selection criteria with respect to the originating &URL;. This part is only needed with redirect type -rules.</para> +rules.</para> </callout> <callout arearefs="url_rule1"><para><option>rule_1</option> forbids the opening of any http or https &URL;</para></callout> @@ -2186,7 +2171,7 @@ $<envar>HOME</envar> directory:</para> <area id="home_rule1" coords="3"/> <area id="home_rule2" coords="4"/> </areaspec> -<screen>[KDE URL Restrictions] +<screen>[TDE URL Restrictions] rule_count=2 rule_1=list,,,,file,,,false rule_2=list,,,,file,,$HOME,true</screen></screenco> @@ -2200,7 +2185,7 @@ directory.</para></callout> </calloutlist> <para>$<envar>HOME</envar> and $<envar>TMP</envar> are special values to -indicate the users home directory and the &kde; temporary directory of the +indicate the users home directory and the &tde; temporary directory of the user, ⪚ <filename class="directory">/tmp/kde-bastian</filename></para> <para>The following rules makes that the user can no longer open local files @@ -2211,7 +2196,7 @@ that are outside his $<envar>HOME</envar> directory:</para> <area id="local_rule2" coords="4"/> <area id="local_rule3" coords="5"/> </areaspec> -<screen>[KDE URL Restrictions] +<screen>[TDE URL Restrictions] rule_count=3 rule_1=open,,,,file,,,false rule_2=open,,,,file,,$HOME,true @@ -2223,8 +2208,8 @@ opening of any local file</para></callout> <callout arearefs="local_rule2"><para><option>rule_2</option> allows opening files under the users own $<envar>HOME</envar> directory.</para></callout> <callout arearefs="local_rule3"><para><option>rule_3</option> allows opening -files in the &kde; temporary directory of the user. This is needed by -certain &kde; applications that first download a file or document to the +files in the &tde; temporary directory of the user. This is needed by +certain &tde; applications that first download a file or document to the temporary directory and then open it in an application.</para></callout> </calloutlist> @@ -2239,7 +2224,7 @@ refer to locally stored documents.</para> class="systemname">www.mycompany.com</systemitem> the possibility to refer to local files we could add the following rule:</para> -<screen>[KDE URL Restrictions] +<screen>[TDE URL Restrictions] rule_count=1 rule_1=redirect,http,www.mycompany.com,,file,,,true</screen> @@ -2286,8 +2271,8 @@ example.</para></listitem> <sect1 id="configuration-modules"> <title>Configuration Modules</title> -<para>&kde; has configuration modules to configure various aspects of the -&kde; environment. Configuration modules appear in the Control Center, in the +<para>&tde; has configuration modules to configure various aspects of the +&tde; environment. Configuration modules appear in the Control Center, in the Configuration dialog of an application or in both.</para> <informalexample> @@ -2310,7 +2295,7 @@ configuration dialog is an integral part of the application itself.</para></note></para> </informalexample> -<para>All configuration modules are strictly speaking part of the &kde; +<para>All configuration modules are strictly speaking part of the &tde; menu.</para> <itemizedlist> @@ -2319,7 +2304,7 @@ menu.</para> have a <literal role="extension">.desktop</literal> file in <filename class="directory">$<envar>TDEDIR</envar>/share/applications/kde</filename> and are sorted under the hidden <guimenu>Settings-Modules</guimenu> menu by -the <filename>kde-settings.menu</filename>, included from +the <filename>kde-settings.menu</filename>, included from <filename>kde-essential.menu</filename></para> <screen><userinput><command>kbuildsycoca</command> <option>--menutest</option> 2> /dev/null | <command>grep</command> Settings-Modules</userinput></screen> </listitem> @@ -2330,12 +2315,12 @@ corresponds to the hidden .hidden menu, included as a result of <markup><KDELegacyDirs/></markup></para> <screen><userinput><command>kbuildsycoca</command> <option>--menutest</option> 2> /dev/null | <command>grep</command> .hidden</userinput></screen> </listitem> -<listitem><para>In &kde; 3.3 it is possible to edit the Control Center with +<listitem><para>In &tde; 3.3 it is possible to edit the Control Center with <application>kcontroledit</application>. <application>kcontroledit</application> works just like <application>kmenuedit</application>, changes for current user only. Use <application>kiosktool</application> to make changes for -everyone.</para></listitem> +everyone.</para></listitem> </itemizedlist> <para>Individual configuration modules can be disables by adding the @@ -2351,12 +2336,12 @@ Konqueror</guilabel> dialog if the proxy configuration is still there.</para> </sect1> -<!-- +<!-- <sect1 id="making-it-work"> <title>Making it Work</title> Making It Work -KDE 3.2: Set $TDEDIRS from starttde script +TDE 3.2: Set $TDEDIRS from starttde script Distribute profiles to all clients </para> @@ -2380,13 +2365,13 @@ Distribute profiles to all clients The Lazy Admin Overview Deployment - How to get &kde; available on many clients + How to get &tde; available on many clients Remote Desktop Sharing Take a look at someone else desktop DCOP - The DCOP command line tool makes it possible to control &kde; applications from the command line + The DCOP command line tool makes it possible to control &tde; applications from the command line KDialog - A versatile tool to use standard &kde; dialogs in your own scripts + A versatile tool to use standard &tde; dialogs in your own scripts @@ -2418,8 +2403,8 @@ invitation. This is ideal for tech support teams or administrators to gain access to users desktops in order to troubleshoot or remedy a problem or guide a user through a procedure.</para> -<para>Remote desktop sharing involves two applications: &krfb; (&kde; remote -frame buffer, a VNC server) and &krdc; (&kde; remote desktop connection; a +<para>Remote desktop sharing involves two applications: &krfb; (&tde; remote +frame buffer, a VNC server) and &krdc; (&tde; remote desktop connection; a VNC client.)</para> <para>&krfb; can be used by any user to create and manage invitations. @@ -2438,16 +2423,16 @@ appear to ask for confirmation by the current user.</para> </sect1> <sect1 id="kde-diy"> -<title>&kde; DIY - Building Your Own Tools</title> +<title>&tde; DIY - Building Your Own Tools</title> <sect2 id="dcop"> <title>DCOP</title> <para> -Desktop COmmunication Protocol, <acronym>DCOP</acronym>, is a lightweight mechanism for inter-process communication. +Desktop COmmunication Protocol, <acronym>DCOP</acronym>, is a lightweight mechanism for inter-process communication. <acronym>DCOP</acronym> allows the user to interact with programs that are currently running. -&kde; supplies two programs to utilitize <acronym>DCOP</acronym>: -<application>dcop</application>, a command-line program, and +&tde; supplies two programs to utilitize <acronym>DCOP</acronym>: +<application>dcop</application>, a command-line program, and <application>kdcop</application>, a <acronym>GUI</acronym> program. </para> <para> @@ -2463,7 +2448,7 @@ A few notes about using <command>dcop</command>: </listitem> <listitem> <para> -Applications that can open more than one window at a time will be listed as +Applications that can open more than one window at a time will be listed as <application>-<acronym>PID</acronym> </para> </listitem> @@ -2589,10 +2574,10 @@ dcop $konsole $session sendSession 'cd /my/work/directory' <sect2 id="kdialog"> <title>KDialog</title> -<subtitle>&kde; DIY - Building Your Own Tools</subtitle> +<subtitle>&tde; DIY - Building Your Own Tools</subtitle> -<para>You can use &kde; dialogs from your own scripts, to combine the power -of &UNIX; shell scripting with the ease of use of &kde;.</para> +<para>You can use &tde; dialogs from your own scripts, to combine the power +of &UNIX; shell scripting with the ease of use of &tde;.</para> <screen><userinput><command>kdialog</command> <option>--msgbox 'You have new mail!'</option></userinput></screen> |