TDE
/
tdebase
mirror of https://mirror.git.trinitydesktop.org/gitea/TDE/tdebase
0
0
Fork 0
Code Issues Releases Wiki Activity

Update Admin Guide.

Browse Source
pull/2/head
Darrell Anderson 10 years ago
parent f40339d46c
commit 504dfac148
2 changed files with 114 additions and 153 deletions
Show Stats Download Patch File Download Diff File

2
doc/adminguide/groupware-kontact.docbook
Unescape View File

@ -38,7 +38,7 @@ without the need of installing the <application>Kolab</application> server
or another groupware backend. It can work with just an or another groupware backend. It can work with just an
<acronym>IMAP</acronym> server, that can be easily set up.</para> <acronym>IMAP</acronym> server, that can be easily set up.</para>
<para>My scenario is a server with Debian unstable and &tde; 3.4. I access <para>My scenario is a server with Debian unstable and &kde; 3.4. I access
&kontact; and other fabulous GNU/Linux apps from windows using Cygwin/X, &kontact; and other fabulous GNU/Linux apps from windows using Cygwin/X,
while waiting Wine project to be able to run the last Windows programs I while waiting Wine project to be able to run the last Windows programs I
need (and that are not available under GNU/Linux). I want to share contacts, need (and that are not available under GNU/Linux). I want to share contacts,

199
doc/adminguide/index.docbook
Unescape View File

@ -41,8 +41,8 @@
</abstract> </abstract>
<keywordset> <keywordset>
<keyword>KDE</keyword>
<keyword>TDE</keyword> <keyword>TDE</keyword>
<keyword>administration</keyword>
<keyword>desktop</keyword> <keyword>desktop</keyword>
<keyword>handbook</keyword> <keyword>handbook</keyword>
<keyword>tutorial</keyword> <keyword>tutorial</keyword>
@ -58,11 +58,11 @@
<para>This handbook is a reference guide to <para>This handbook is a reference guide to
some &tde; features that are useful to administrators configuring some &tde; features that are useful to administrators configuring
multi-user systems. This part also has information that might be useful multi-user systems. This guide also has information useful
to &tde; users with single-user systems: where configuration files are to &tde; users with single-user systems: where configuration files are
stored, what environment variables affect &tde;, and so on. The KIOSK stored, what environment variables affect &tde;, and so on. The KIOSK
framework is the &tde; system which allows administrators to limit framework is the &tde; system that allows administrators to limit
what users can do in &tde;. That framework is potentially useful in many what users can do in &tde;. That framework is useful in many
situations, but especially for running single-function kiosks with, situations, but especially for running single-function kiosks with,
for example, only a web browser, hence the name.</para> for example, only a web browser, hence the name.</para>
@ -90,22 +90,21 @@ class="directory">/opt/trinity</filename>).</para></listitem>
additional trees can be used for <link additional trees can be used for <link
linkend="user-profiles">profiles</link></para> linkend="user-profiles">profiles</link></para>
<informalexample><para>&SuSE; &Linux; for example uses:</para> <informalexample><para>For example:</para>
<itemizedlist> <itemizedlist>
<listitem><para><filename <listitem><para><filename
class="directory">$<envar>HOME</envar>/.trinity</filename></para></listitem> class="directory">$<envar>HOME</envar>/.trinity</filename></para></listitem>
<listitem><para><filename <listitem><para><filename
class="directory">/opt/trinity</filename>. (This is class="directory">/opt/trinity</filename>. (This location is a
&SuSE;-specific; other distributions may use typical default. Some distributions might use
<filename class="directory">/usr</filename> or <filename <filename class="directory">/usr</filename> or <filename
class="directory">/usr/trinity</filename>)</para></listitem> class="directory">/usr/trinity</filename>)</para></listitem>
<listitem><para><filename <listitem><para><filename
class="directory">/etc/opt/trinity</filename>. (This was added by class="directory">/etc/trinity</filename>.</para></listitem>
&SuSE;).</para></listitem>
</itemizedlist> </itemizedlist>
<para>If you have the KIOSK Admin tool v0.7 or later installed you can <para>If you have the KIOSK Admin tool installed you can
check which directory trees are used with the following command: check which directory trees are used with the following command:
<userinput><command>kiosktool-tdedirs</command> <userinput><command>kiosktool-tdedirs</command>
<option>--check</option></userinput></para> <option>--check</option></userinput></para>
@ -128,7 +127,7 @@ class="directory">$<envar>HOME</envar>/.trinity/share/mimelnk/text/plain.desktop
<listitem><para><filename <listitem><para><filename
class="directory">/opt/trinity/share/mimelnk/text/plain.desktop</filename></para></listitem> class="directory">/opt/trinity/share/mimelnk/text/plain.desktop</filename></para></listitem>
<listitem><para><filename <listitem><para><filename
class="directory">/etc/opt/trinity/share/mimelnk/text/plain.desktop</filename></para></listitem> class="directory">/etc/trinity/share/mimelnk/text/plain.desktop</filename></para></listitem>
</itemizedlist> </itemizedlist>
<para>If a user makes a change, the change is written to <filename <para>If a user makes a change, the change is written to <filename
@ -154,7 +153,7 @@ Shape=circle
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><filename>/etc/opt/trinity/share/config/foobar</filename></term> <term><filename>/etc/trinity/share/config/foobar</filename></term>
<listitem><programlisting> <listitem><programlisting>
Color=blue Color=blue
Position=10,10 Position=10,10
@ -203,7 +202,7 @@ root writing to $TDEHOME of the user after running
<seg><filename class="directory">/opt/trinity</filename>, <filename <seg><filename class="directory">/opt/trinity</filename>, <filename
class="directory">/usr</filename>, <filename class="directory">/usr</filename>, <filename
class="directory">/usr/trinity</filename></seg> class="directory">/usr/trinity</filename></seg>
<seg>Vendor dependent. Used by &tde; 2. If not set, falls back to <seg>Vendor dependent. If not set, falls back to
compiled-in default.</seg> compiled-in default.</seg>
</seglistitem> </seglistitem>
@ -212,15 +211,13 @@ compiled-in default.</seg>
<seg><filename class="directory">/opt/trinity</filename>, <filename <seg><filename class="directory">/opt/trinity</filename>, <filename
class="directory">/usr</filename>, <filename class="directory">/usr</filename>, <filename
class="directory">/usr/trinity</filename></seg> class="directory">/usr/trinity</filename></seg>
<seg>New in &tde;3. Can list multiple locations separated by a <seg>Can list multiple locations separated by a
colon. If not set, falls back to $<envar>TDEDIR</envar></seg> colon. If not set, falls back to $<envar>TDEDIR</envar></seg>
</seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
</para> </para>
<para>Don't <emphasis>need</emphasis> to be set, defaults work just fine.</para> <para>Don't <emphasis>need</emphasis> to be set, defaults work just fine.</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> <informalexample>
<para>A staff member at a university could have the following <para>A staff member at a university could have the following
@ -228,7 +225,7 @@ settings:</para>
<programlisting> <programlisting>
TDEHOME='~/.trinity' TDEHOME='~/.trinity'
TDEROOTHOME='/root/.trinity' TDEROOTHOME='/root/.trinity'
TDEDIRS='/opt/kde_staff:/opt/trinity' TDEDIRS='/opt/tde_staff:/opt/trinity'
</programlisting> </programlisting>
</informalexample> </informalexample>
@ -239,21 +236,19 @@ TDEDIRS='/opt/kde_staff:/opt/trinity'
<title>User Profiles</title> <title>User Profiles</title>
<para>In the previous example <filename <para>In the previous example <filename
class="directory">/opt/kde_staff</filename> contained additional settings class="directory">/opt/tde_staff</filename> contained additional settings
and applications for staff members. <quote>User Profiles</quote> allow you and applications for staff members. <quote>User Profiles</quote> allow you
to add this directory only for certain users and not for others. Add the to add this directory only for certain users and not for others. Add the
following to <filename>/etc/tderc</filename>:</para> following to <filename>/etc/tderc</filename>:</para>
<programlisting> <programlisting>
[Directories-staff] [Directories-staff]
prefixes=/opt/kde_staff prefixes=/opt/tde_staff
</programlisting> </programlisting>
<para>This creates a profile named <quote>staff</quote> that adds the <para>This creates a profile named <quote>staff</quote> that adds the
<filename class="directory">/opt/kde_staff</filename> directory <filename class="directory">/opt/tde_staff</filename> directory
tree. (Note that &SuSE; &Linux; uses tree. Now that we have a named profile it
<filename>/etc/kde3rc</filename> instead of
<filename>/etc/tderc</filename>. Now that we have a named profile it
can be assigned to users.</para> can be assigned to users.</para>
<para>To map profiles to users a mapping file needs to be specified in <para>To map profiles to users a mapping file needs to be specified in
@ -261,7 +256,7 @@ can be assigned to users.</para>
<programlisting> <programlisting>
[Directories] [Directories]
userProfileMapFile=/etc/kde-user-profile userProfileMapFile=/etc/tde-user-profile
</programlisting> </programlisting>
<para>It is now possible to assign a profile based on either the user name <para>It is now possible to assign a profile based on either the user name
@ -269,7 +264,7 @@ 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 <para>To assign the staff profile to all users that are a member of the
&UNIX; group staff_members add the following to &UNIX; group staff_members add the following to
<filename>/etc/kde-user-profile</filename>:</para> <filename>/etc/tde-user-profile</filename>:</para>
<programlisting> <programlisting>
[General] [General]
@ -319,8 +314,7 @@ directory tree.</para>
<varlistentry> <varlistentry>
<term><filename class="directory">lib/trinity</filename></term> <term><filename class="directory">lib/trinity</filename></term>
<listitem><para>This directory contains components, plugins, and other <listitem><para>This directory contains components, plugins, and other
runtime loadable objects for use by &tde; 3.<replaceable>x</replaceable> runtime loadable objects for use by &tde; applications.</para></listitem>
applications.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -336,7 +330,7 @@ archs.</para>
<varlistentry> <varlistentry>
<term><filename class="directory">share/applnk</filename></term> <term><filename class="directory">share/applnk</filename></term>
<listitem><para><literal role="extension">.desktop</literal> files for <listitem><para><literal role="extension">.desktop</literal> files for
&tde;-menu (old)</para></listitem> &tde;-menu (legacy)</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -471,7 +465,7 @@ is used for various &UNIX; sockets.</para>
<varlistentry> <varlistentry>
<term><filename>$<envar>TDEHOME</envar>/tmp-$<envar>HOSTNAME</envar></filename></term> <term><filename>$<envar>TDEHOME</envar>/tmp-$<envar>HOSTNAME</envar></filename></term>
<listitem><para>Usually <filename <listitem><para>Usually <filename
class="directory">/tmp/kde-$<envar>USER</envar>/</filename>, this is used for temporary files.</para> class="directory">/tmp/tde-$<envar>USER</envar>/</filename>, this is used for temporary files.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -593,7 +587,7 @@ contains:
Color=red Color=red
Shape=circle Shape=circle
</programlisting> </programlisting>
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains and <filename>/etc/trinity/share/config/foobar</filename> contains
<programlisting> <programlisting>
[MyGroup] [MyGroup]
Color=blue Color=blue
@ -620,13 +614,13 @@ Shape=circle
[MyGroup] [MyGroup]
Color=green Color=green
</programlisting> </programlisting>
and <filename>/opt/kde_staff/share/config/foobar</filename> contains and <filename>/opt/tde_staff/share/config/foobar</filename> contains
<programlisting> <programlisting>
[MyGroup] [MyGroup]
Color=purple Color=purple
Position=20,20 Position=20,20
</programlisting> </programlisting>
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains and <filename>/etc/trinity/share/config/foobar</filename> contains
<programlisting> <programlisting>
[MyGroup] [MyGroup]
Color=blue Color=blue
@ -643,7 +637,7 @@ Position=20,20
</informalexample> </informalexample>
<para>To prevent users being able to override default settings, <para>To prevent users being able to override default settings,
settings can be marked immutable. Settings can be made immutable settings can be marked <emphasis>immutable</emphasis>. Settings can be made immutable
individually, per group or per file. An individual entry can be locked individually, per group or per file. An individual entry can be locked
down by adding <userinput>[$i]</userinput> behind the key, &eg;: down by adding <userinput>[$i]</userinput> behind the key, &eg;:
<programlisting> <programlisting>
@ -672,7 +666,7 @@ Color[$i]=blue
Color=red Color=red
Shape=circle Shape=circle
</programlisting> </programlisting>
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains: and <filename>/etc/trinity/share/config/foobar</filename> contains:
<programlisting> <programlisting>
[MyGroup][$i] [MyGroup][$i]
Color=blue Color=blue
@ -695,13 +689,13 @@ Position=10,10
Color=red Color=red
Shape=circle Shape=circle
</programlisting> </programlisting>
and <filename>/opt/kde_staff/share/config/foobar</filename> contains and <filename>/opt/tde_staff/share/config/foobar</filename> contains
<programlisting> <programlisting>
[MyGroup] [MyGroup]
Color=purple Color=purple
Shape=rectangle Shape=rectangle
</programlisting> </programlisting>
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains and <filename>/etc/trinity/share/config/foobar</filename> contains
<programlisting> <programlisting>
[MyGroup][$i] [MyGroup][$i]
Color=blue Color=blue
@ -782,9 +776,7 @@ Caption[fr]=Ma L&eacute;gende
</informalexample> </informalexample>
<para>In general the entries that can appear in a configuration file are not <para>In general the entries that can appear in a configuration file are not
documented. With &tde; 3.2 a start has been made to change this. In documented. In <filename class="directory">$<envar>TDEDIR</envar>/share/config.kcfg</filename>, files
<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 can be found that provide a formal description of the possible entries in a
configuration file. These are used by the new &tde; Configuration Editor configuration file. These are used by the new &tde; Configuration Editor
when available.</para> when available.</para>
@ -827,7 +819,7 @@ Auto Save Interval=25
<sect2 id="tdm"> <sect2 id="tdm">
<title>&tdm;</title> <title>&tdm;</title>
<para>Always runs as <systemitem class="username">root</systemitem>! Uses <para>&tdm; always runs as <systemitem class="username">root</systemitem>. &tdm; uses
<filename>$<envar>TDEDIR</envar>/share/config/tdmrc</filename> and <filename>$<envar>TDEDIR</envar>/share/config/tdmrc</filename> and
<filename>/etc/X11/xdm/Xservers</filename>. The latter contains entries <filename>/etc/X11/xdm/Xservers</filename>. The latter contains entries
like:</para> like:</para>
@ -854,7 +846,7 @@ Startup - <filename>/etc/X11/xdm/Xstartup</filename> - prepare as root
Session - <filename>/etc/X11/xdm/Xsession</filename> - starts session as user Session - <filename>/etc/X11/xdm/Xsession</filename> - starts session as user
</member> </member>
<member> <member>
= For a TDE session: <command>kde</command> or <command>starttde</command> = For a TDE session: <command>tde</command> or <command>starttde</command>
</member> </member>
<member> <member>
= If present <filename>~/.xsession</filename> or <filename>~/.xinitrc</filename> = If present <filename>~/.xsession</filename> or <filename>~/.xinitrc</filename>
@ -872,17 +864,17 @@ Reset - <filename>/etc/X11/xdm/Xreset</filename> - after session finished
<para>The &tde; startup sequence starts with the <para>The &tde; startup sequence starts with the
<filename>starttde</filename> script. In most cases this script gets called <filename>starttde</filename> script. In most cases this script gets called
from the display manager (&tdm;) once the user has been authenticated. Their from the display manager (&tdm;) once the user has been authenticated. Their
are two very important lines in the <filename>starttde</filename> are two important lines in the <filename>starttde</filename>
script:</para> script:</para>
<programlisting> <programlisting>
LD_BIND_NOW=true tdeinit +kcminit +knotify and kwrapper LD_BIND_NOW=true $TDEDIR/bin/start_tdeinit_wrapper --new-startup +kcminit_startup
ksmserver $TDEWM $TDEDIR/bin/tdeinit_phase1
</programlisting> </programlisting>
<para>The first line starts the <command>tdeinit</command> master process. <para>The first line starts the <command>tdeinit</command> master process.
The <command>tdeinit</command> master process is used to start all other The <command>tdeinit</command> master process is used to start all other
&tde; processes. It show up in the output of <command>ps &tde; processes. It shows up in the output of <command>ps
<option>aux</option></command> as <computeroutput>tdeinit: <option>aux</option></command> as <computeroutput>tdeinit:
Running...</computeroutput>. The arguments after <command>tdeinit</command> Running...</computeroutput>. The arguments after <command>tdeinit</command>
are the names of additional processes to be started. The <token>+</token> are the names of additional processes to be started. The <token>+</token>
@ -957,10 +949,9 @@ needed</para>
<title><command>tdeinit</command></title> <title><command>tdeinit</command></title>
<para><command>tdeinit</command> is used to start all other &tde; <para><command>tdeinit</command> is used to start all other &tde;
programs. <command>tdeinit</command> can start normal binary program files programs. <command>tdeinit</command> can start normal binary program files
as well as <command>tdeinit</command> loadable modules as well as <command>tdeinit</command> loadable modules. Loadable modules
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary work just like binary program files but can be started more efficiently.
program files but can be started more efficiently. <acronym>KLM</acronym>s Loadable modules live in <filename
live in <filename
class="directory">$<envar>TDEDIR</envar>/lib/trinity</filename></para> class="directory">$<envar>TDEDIR</envar>/lib/trinity</filename></para>
<para>The drawback is that programs started this way appear as <para>The drawback is that programs started this way appear as
@ -983,7 +974,7 @@ knotify
<para><computeroutput>tdeinit: Running...</computeroutput> indicates the <para><computeroutput>tdeinit: Running...</computeroutput> indicates the
master <command>tdeinit</command> process. The other processes listed are master <command>tdeinit</command> process. The other processes listed are
programs started as <acronym>KLM</acronym>s.</para> programs started as loadable modules.</para>
<para>When <command>tdeinit</command> starts for the first time it will <para>When <command>tdeinit</command> starts for the first time it will
launch <command>dcopserver</command>, <command>tdelauncher</command>, and launch <command>dcopserver</command>, <command>tdelauncher</command>, and
@ -1150,7 +1141,7 @@ are:</para>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>&klipper;</term> <term><command>&klipper;</command></term>
<listitem><para>A clipboard utility that docks in the panel</para> <listitem><para>A clipboard utility that docks in the panel</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1338,14 +1329,14 @@ $XDG_DATA_DIRS/desktop-directories
</varlistentry> </varlistentry>
<varlistentry><term>$<envar>XDG_CONFIG_HOME</envar></term><listitem><para> <varlistentry><term>$<envar>XDG_CONFIG_HOME</envar></term><listitem><para>
(&tde; 3.2) - Defines the base directory relative to which user - Defines the base directory relative to which user
specific configuration files should be stored. Default is specific configuration files should be stored. Default is
<filename class="directory">$<envar>HOME</envar>/.config</filename>.</para> <filename class="directory">$<envar>HOME</envar>/.config</filename>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry><term>$<envar>XDG_CONFIG_DIRS</envar></term><listitem><para> <varlistentry><term>$<envar>XDG_CONFIG_DIRS</envar></term><listitem><para>
(&tde; 3.2) - Defines the preference-ordered set of base directories - Defines the preference-ordered set of base directories
to search for configuration files in addition to the $<envar>XDG_CONFIG_HOME</envar> 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> &tde; 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 $<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension">.menu</literal> descriptions in
@ -1364,9 +1355,8 @@ $<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension">
<para><command>tdeinit</command> is used to start all other &tde; <para><command>tdeinit</command> is used to start all other &tde;
programs. <command>tdeinit</command> can start normal binary program f iles programs. <command>tdeinit</command> can start normal binary program f iles
as well as <command>tdeinit</command> loadable modules as well as <command>tdeinit</command> loadable modules. Loadable modules work just like binary
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary program files but can be started more efficiently. Loadable modules
program files but can be started more efficiently. <acronym>KLM</acronym>s
live in <filename live in <filename
class="directory">$<envar>TDEDIR</envar>/lib/trinity</filename></para> class="directory">$<envar>TDEDIR</envar>/lib/trinity</filename></para>
@ -1412,7 +1402,7 @@ package.</para>
</chapter> </chapter>
<chapter id="customizing-kde"> <chapter id="customizing-tde">
<title>Customizing &tde;</title> <title>Customizing &tde;</title>
@ -1436,7 +1426,7 @@ package.</para>
</itemizedlist> </itemizedlist>
</para> </para>
</listitem> </listitem>
<listitem><para>Vendor-specific (&eg; &SuSE;'s My Computer)</para> <listitem><para>Vendor-specific</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
@ -1454,7 +1444,7 @@ role="extension">.desktop</literal> file:
Encoding=UTF-8 Encoding=UTF-8
Icon=/opt/trinity/share/apps/kdesktop/pics/ksslogo.png Icon=/opt/trinity/share/apps/kdesktop/pics/ksslogo.png
Type=Link Type=Link
URL=http://www.kde.org/ URL=http://www.trinitydesktop.org/
</programlisting> </programlisting>
</para> </para>
</sect2> </sect2>
@ -1658,19 +1648,17 @@ copied from <filename
class="directory">/etc/skel/Desktop</filename></para></listitem> class="directory">/etc/skel/Desktop</filename></para></listitem>
<listitem><para><filename <listitem><para><filename
class="directory">$<envar>TDEDIR</envar>/apps/kdesktop/Desktop</filename> class="directory">$<envar>TDEDIR</envar>/share/apps/kdesktop/Desktop</filename>
(merged)</para></listitem> (merged)</para></listitem>
<listitem><para><filename <listitem><para><filename
class="directory">$<envar>TDEDIR</envar>/apps/kdesktop/DesktopLinks</filename> class="directory">$<envar>TDEDIR</envar>/share/apps/kdesktop/DesktopLinks</filename>
(copied)</para></listitem> (copied)</para></listitem>
<listitem><para>Device Icons (dynamically <listitem><para>Device Icons (dynamically
merged)</para></listitem> merged)</para></listitem>
<listitem><para>Distribution Specific SUSE Linux copies certain icons <listitem><para>Distribution Specific</para></listitem>
in starttde.theme from <filename
class="directory">/opt/trinity/share/config/SuSE/default/</filename></para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
@ -1683,36 +1671,21 @@ class="directory">/opt/trinity/share/config/SuSE/default/</filename></para></lis
<sect2 id="how-it-works"> <sect2 id="how-it-works">
<title>How it Works</title> <title>How it Works</title>
<para>In &tde; 3.2 a common menu format is introduced at <para>A common menu format is used as defined at
<ulink <ulink
url="http://freedesktop.org/Standards/menu-spec/">http://freedesktop.org/Standards/menu-spec/</ulink></para> url="http://freedesktop.org/Standards/menu-spec/">http://freedesktop.org/Standards/menu-spec/</ulink></para>
<para>Before &tde; 3.2:
<itemizedlist>
<listitem><para>Directory structure under <filename
class="directory">share/applnk</filename></para></listitem>
<listitem><para>Directory structure represents menu
structure</para></listitem>
<listitem><para>Each <literal role="extension">.desktop</literal> file
represents a single application</para></listitem>
</itemizedlist>
</para>
<para>It was difficult to rearrange the structure in &tde; 3.2 so the <para>The menu format:
new menu format:
<itemizedlist> <itemizedlist>
<listitem><para>Defines structure in a single .menu file</para></listitem> <listitem><para>Defines structure in a single .menu file</para></listitem>
<listitem><para>Is based on categories</para></listitem> <listitem><para>Is based on categories</para></listitem>
<listitem><para>is shared between <acronym>GNOME</acronym> and &tde;</para></listitem> <listitem><para>is shared between &tde;, &kde;, <acronym>GNOME</acronym>, and Xfce</para></listitem>
<listitem><para>Supports applnk style menus as well</para></listitem> <listitem><para>Supports applnk style menus as well</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<informalexample> <informalexample>
<para>Example from <filename>kde-applications.menu</filename>: <para>Example from <filename>tde-applications.menu</filename>:
<programlisting> <programlisting>
<markup> <markup>
&lt;Menu&gt; &lt;Menu&gt;
@ -1747,7 +1720,7 @@ Reader.desktop</filename></para></listitem>
<para><literal role="extension">.menu</literal> files describing the <para><literal role="extension">.menu</literal> files describing the
menu structure. The files are stored in <filename menu structure. The files are stored in <filename
class="directory">$<envar>TDEDIR</envar>/etc/xdg/menus</filename> and class="directory">$<envar>TDEDIR</envar>/xdg/menus</filename> and
<filename class="directory">/etc/xdg/menus</filename>. These store the <filename class="directory">/etc/xdg/menus</filename>. These store the
system-wide menu structure and are controlled by system-wide menu structure and are controlled by
$<envar>XDG_CONFIG_DIRS</envar>. <filename $<envar>XDG_CONFIG_DIRS</envar>. <filename
@ -1786,7 +1759,7 @@ These are controlled by $<envar>XDG_DATA_HOME</envar>. For more
information, see <ulink url="http://www.freedesktop.org/Standards/basedir-spec">http://www.freedesktop.org/Standards/basedir-spec</ulink></para> information, see <ulink url="http://www.freedesktop.org/Standards/basedir-spec">http://www.freedesktop.org/Standards/basedir-spec</ulink></para>
<informalexample> <informalexample>
<para>Example from <filename>kde-applications.menu</filename>: <para>Example from <filename>tde-applications.menu</filename>:
<programlisting> <programlisting>
<markup> <markup>
&lt;Menu&gt; &lt;Menu&gt;
@ -1838,25 +1811,20 @@ role="extension">.directory</literal> file</para>
<title>Essential Menus</title> <title>Essential Menus</title>
<para><filename <para><filename
class="directory">$<envar>TDEDIR</envar>/etc/xdg/menus/applications-merged/</filename> class="directory">/etc/trinity/xdg/menus/applications-merged/</filename>
contains <filename>kde-essential.menu</filename> which includes some contains <filename>tde-essential.menu</filename> which includes some
essential menus that are normally not shown in the &tde; menu itself: essential menus that are normally not shown in the &tde; menu itself:
<itemizedlist> <itemizedlist>
<listitem><para>Control Center has a hidden Settings menu whose <listitem><para>Control Center has a hidden Settings menu whose
contents are defined by <filename>kde-settings.menu</filename> and contents are defined by <filename>tde-settings.menu</filename> and
whose icon and name are defined by <filename>kde-settings.directory</filename></para> whose icon and name are defined by <filename>tde-settings.directory</filename></para>
</listitem>
<listitem><para>Info Center has a hidden Information menu whose
contents are defined by <filename>kde-information.menu</filename> and
whose icon and name are defined by <filename>kde-information.directory</filename>.</para>
</listitem> </listitem>
<listitem><para>Screensavers contains a hidden System/Screensavers menu, <listitem><para>Screensavers contains a hidden System/Screensavers menu,
whose contents are defined by whose contents are defined by
<filename>kde-screensavers.menu</filename> and whose icon and name <filename>tde-screensavers.menu</filename> and whose icon and name
are defined by are defined by
<filename>kde-system-screensavers.directory</filename>. <filename>tde-system-screensavers.directory</filename>.
<filename>$<envar>TDEDIR</envar>/share/desktop-directories/kde-system-screensavers.directory</filename> <filename>$<envar>TDEDIR</envar>/share/desktop-directories/tde-system-screensavers.directory</filename>
contains: contains:
<programlisting> <programlisting>
NoDisplay=true NoDisplay=true
@ -1878,8 +1846,8 @@ class="directory">$<envar>HOME</envar>/.trinity/share/applnk</filename>
</sect2> </sect2>
<sect2 id="tdesycoca"> <sect2 id="tdesycoca">
<title><application>KSycoca</application></title> <title><application>TDESycoca</application></title>
<para><application>KSycoca</application> caches menu structure and <para><application>TDESycoca</application> caches menu structure and
information about all available applications. You can rebuild the information about all available applications. You can rebuild the
database with database with
<userinput><command>tdebuildsycoca</command></userinput>. The database <userinput><command>tdebuildsycoca</command></userinput>. The database
@ -1890,7 +1858,7 @@ checked during &tde; login, and <application>KDED</application>
watches for changes while logged in.</para> watches for changes while logged in.</para>
<para>To disable watching for changes (since it may hurt over NFS) add <para>To disable watching for changes (since it may hurt over NFS) add
the following to <filename>kdedrc</filename>: the following to <filename>tdedrc</filename>:
<programlisting> <programlisting>
[General] [General]
CheckSycoca=false CheckSycoca=false
@ -2014,7 +1982,7 @@ default for multiple users.</para>
</chapter> </chapter>
<chapter id="locking-down-kde"> <chapter id="locking-down-tde">
<title>Locking Down &tde;</title> <title>Locking Down &tde;</title>
<sect1 id="how-it-works-the-basics"> <sect1 id="how-it-works-the-basics">
@ -2103,8 +2071,9 @@ action="simul">&Alt;<keycap>F2</keycap></keycombo> run
command</para></listitem> command</para></listitem>
</itemizedlist> </itemizedlist>
</example> </example>
<para>Full documentation about available actions can be found on <ulink <!--<para>Full documentation about available actions can be found on <ulink
url="http://www.kde.org/areas/sysadmin/">http://www.kde.org/areas/sysadmin/</ulink>.</para> url="http://techbase.kde.org/KDE_System_Administration/Kiosk/Keys">
http://techbase.kde.org/KDE_System_Administration/Kiosk/Keys</ulink>.</para>-->
<para>A few of the more interesting actions are listed below:</para> <para>A few of the more interesting actions are listed below:</para>
@ -2244,7 +2213,7 @@ directory.</para></callout>
<para>$<envar>HOME</envar> and $<envar>TMP</envar> are special values to <para>$<envar>HOME</envar> and $<envar>TMP</envar> are special values to
indicate the users home directory and the &tde; temporary directory of the indicate the users home directory and the &tde; temporary directory of the
user, &eg; <filename class="directory">/tmp/kde-bastian</filename></para> user, &eg; <filename class="directory">/tmp/tde-bastian</filename></para>
<para>The following rules makes that the user can no longer open local files <para>The following rules makes that the user can no longer open local files
that are outside his $<envar>HOME</envar> directory:</para> that are outside his $<envar>HOME</envar> directory:</para>
@ -2345,6 +2314,8 @@ as part of the <guilabel>Configure Konqueror</guilabel> dialog in
<itemizedlist> <itemizedlist>
<listitem><para><command>tdecmshell</command> <listitem><para><command>tdecmshell</command>
<filename>tde-proxy.desktop</filename></para></listitem> <filename>tde-proxy.desktop</filename></para></listitem>
<listitem><para><command>tdecmshell</command>
<filename>tde-proxy</filename></para></listitem>
<listitem><para><command>tdecmshell</command> proxy</para></listitem> <listitem><para><command>tdecmshell</command> proxy</para></listitem>
</itemizedlist> </itemizedlist>
@ -2362,8 +2333,8 @@ menu.</para>
have a <literal role="extension">.desktop</literal> file in <filename have a <literal role="extension">.desktop</literal> file in <filename
class="directory">$<envar>TDEDIR</envar>/share/applications/tde</filename> class="directory">$<envar>TDEDIR</envar>/share/applications/tde</filename>
and are sorted under the hidden <guimenu>Settings-Modules</guimenu> menu by and are sorted under the hidden <guimenu>Settings-Modules</guimenu> menu by
the <filename>kde-settings.menu</filename>, included from the <filename>tde-settings.menu</filename>, included from
<filename>kde-essential.menu</filename></para> <filename>tde-essential.menu</filename></para>
<screen><userinput><command>tdebuildsycoca</command> <option>--menutest</option> 2&gt; /dev/null | <command>grep</command> Settings-Modules</userinput></screen> <screen><userinput><command>tdebuildsycoca</command> <option>--menutest</option> 2&gt; /dev/null | <command>grep</command> Settings-Modules</userinput></screen>
</listitem> </listitem>
<listitem> <listitem>
@ -2373,15 +2344,15 @@ corresponds to the hidden .hidden menu, included as a result of
<markup>&lt;KDELegacyDirs/&gt;</markup></para> <markup>&lt;KDELegacyDirs/&gt;</markup></para>
<screen><userinput><command>tdebuildsycoca</command> <option>--menutest</option> 2&gt; /dev/null | <command>grep</command> .hidden</userinput></screen> <screen><userinput><command>tdebuildsycoca</command> <option>--menutest</option> 2&gt; /dev/null | <command>grep</command> .hidden</userinput></screen>
</listitem> </listitem>
<listitem><para>In &tde; 3.3 it is possible to edit the Control Center with <listitem><para>It is possible to edit the Control Center with
<application>kcontroledit</application>. <application>kcontroledit</application>.
<application>kcontroledit</application> works just like <application>kcontroledit</application> works like
<application>kmenuedit</application>, changes for current user only. Use <application>kmenuedit</application>, changes for current user only. Use
<application>kiosktool</application> to make changes for <application>kiosktool</application> to make changes for
everyone.</para></listitem> everyone.</para></listitem>
</itemizedlist> </itemizedlist>
<para>Individual configuration modules can be disables by adding the <para>Individual configuration modules can be disabled by adding the
following to <filename>kdeglobals</filename>:</para> following to <filename>kdeglobals</filename>:</para>
<screen>[TDE Control Module Restrictions] <screen>[TDE Control Module Restrictions]
@ -2394,17 +2365,7 @@ Konqueror</guilabel> dialog if the proxy configuration is still
there.</para> there.</para>
</sect1> </sect1>
<!--
<sect1 id="making-it-work">
<title>Making it Work</title>
Making It Work
TDE 3.2: Set $TDEDIRS from starttde script
Distribute profiles to all clients
</para>
</sect1>
-->
</chapter> </chapter>
<chapter id="the-lazy-admin"> <chapter id="the-lazy-admin">

Write Preview
Loading…
Cancel
Save