|
Lines 15-24
Link Here
|
| 15 |
</authorgroup> |
15 |
</authorgroup> |
| 16 |
</partinfo> |
16 |
</partinfo> |
| 17 |
|
17 |
|
| 18 |
<title>&kde; for Administrators</title> |
18 |
<title>&tde; for Administrators</title> |
| 19 |
|
19 |
|
| 20 |
<chapter id="kde-internals"> |
20 |
<chapter id="kde-internals"> |
| 21 |
<title>&kde; Internals</title> |
21 |
<title>&tde; Internals</title> |
| 22 |
|
22 |
|
| 23 |
<sect1 id="kde-for-admins-overview"> |
23 |
<sect1 id="kde-for-admins-overview"> |
| 24 |
<title>Overview</title> |
24 |
<title>Overview</title> |
|
Lines 28-39
Link Here
|
| 28 |
<sect1 id="directory-layout"> |
28 |
<sect1 id="directory-layout"> |
| 29 |
<title>Directory Layout</title> |
29 |
<title>Directory Layout</title> |
| 30 |
|
30 |
|
| 31 |
<para>&kde; defines a filesystem hierarchy which is used by the &kde; |
31 |
<para>&tde; defines a filesystem hierarchy which is used by the &tde; |
| 32 |
environment itself as well as all &kde; applications. In general &kde; |
32 |
environment itself as well as all &tde; applications. In general &tde; |
| 33 |
stores all its files in a directory tree with a fixed structure. |
33 |
stores all its files in a directory tree with a fixed structure. |
| 34 |
</para> |
34 |
</para> |
| 35 |
|
35 |
|
| 36 |
<para>By default &kde; uses two directory trees:</para> |
36 |
<para>By default &tde; uses two directory trees:</para> |
| 37 |
|
37 |
|
| 38 |
<itemizedlist> |
38 |
<itemizedlist> |
| 39 |
<listitem><para>One at the system level (for example <filename |
39 |
<listitem><para>One at the system level (for example <filename |
|
Lines 68-75
Link Here
|
| 68 |
<option>--check</option></userinput></para> |
68 |
<option>--check</option></userinput></para> |
| 69 |
</informalexample> |
69 |
</informalexample> |
| 70 |
|
70 |
|
| 71 |
<para>&kde; and &kde; applications look up files by scanning all the |
71 |
<para>&tde; and &tde; applications look up files by scanning all the |
| 72 |
&kde; directory trees. The directory trees are checked in order of |
72 |
&tde; directory trees. The directory trees are checked in order of |
| 73 |
precedence. When a file is present in multiple directory trees, the |
73 |
precedence. When a file is present in multiple directory trees, the |
| 74 |
file from the last tree takes precedence. Normally, the tree |
74 |
file from the last tree takes precedence. Normally, the tree |
| 75 |
located in the user's home directory has the highest precedence. This |
75 |
located in the user's home directory has the highest precedence. This |
|
Lines 160-166
Link Here
|
| 160 |
<seg><filename class="directory">/opt/trinity</filename>, <filename |
160 |
<seg><filename class="directory">/opt/trinity</filename>, <filename |
| 161 |
class="directory">/usr</filename>, <filename |
161 |
class="directory">/usr</filename>, <filename |
| 162 |
class="directory">/usr/trinity</filename></seg> |
162 |
class="directory">/usr/trinity</filename></seg> |
| 163 |
<seg>Vendor dependent. Used by &kde; 2. If not set, falls back to |
163 |
<seg>Vendor dependent. Used by &tde; 2. If not set, falls back to |
| 164 |
compiled-in default.</seg> |
164 |
compiled-in default.</seg> |
| 165 |
</seglistitem> |
165 |
</seglistitem> |
| 166 |
|
166 |
|
|
Lines 169-183
Link Here
|
| 169 |
<seg><filename class="directory">/opt/trinity</filename>, <filename |
169 |
<seg><filename class="directory">/opt/trinity</filename>, <filename |
| 170 |
class="directory">/usr</filename>, <filename |
170 |
class="directory">/usr</filename>, <filename |
| 171 |
class="directory">/usr/trinity</filename></seg> |
171 |
class="directory">/usr/trinity</filename></seg> |
| 172 |
<seg>New in &kde;3. Can list multiple locations separated by a |
172 |
<seg>New in &tde;3. Can list multiple locations separated by a |
| 173 |
colon. If not set, falls back to $<envar>TDEDIR</envar></seg> |
173 |
colon. If not set, falls back to $<envar>TDEDIR</envar></seg> |
| 174 |
</seglistitem> |
174 |
</seglistitem> |
| 175 |
|
175 |
|
| 176 |
</segmentedlist> |
176 |
</segmentedlist> |
| 177 |
</para> |
177 |
</para> |
| 178 |
<para>Don't <emphasis>need</emphasis> to be set, defaults work just fine.</para> |
178 |
<para>Don't <emphasis>need</emphasis> to be set, defaults work just fine.</para> |
| 179 |
<para>Running &kde;2 next to &kde;3? Point $<envar>TDEDIR</envar> to |
179 |
<para>Running &tde;2 next to &tde;3? Point $<envar>TDEDIR</envar> to |
| 180 |
&kde; 2 and $<envar>TDEDIRS</envar> to &kde; 3.</para> |
180 |
&tde; 2 and $<envar>TDEDIRS</envar> to &tde; 3.</para> |
| 181 |
|
181 |
|
| 182 |
<informalexample> |
182 |
<informalexample> |
| 183 |
<para>A staff member at a university could have the following |
183 |
<para>A staff member at a university could have the following |
|
Lines 247-253
Link Here
|
| 247 |
<sect1 id="directory-layout-revisited"> |
247 |
<sect1 id="directory-layout-revisited"> |
| 248 |
<title>Directory Layout Revisited</title> |
248 |
<title>Directory Layout Revisited</title> |
| 249 |
|
249 |
|
| 250 |
<para>Each directory tree used by &kde; has a fixed directory structure. |
250 |
<para>Each directory tree used by &tde; has a fixed directory structure. |
| 251 |
Directories that are not relevant for a certain tree, or simply not used can |
251 |
Directories that are not relevant for a certain tree, or simply not used can |
| 252 |
be left out though. For example, directories used for temporary files are |
252 |
be left out though. For example, directories used for temporary files are |
| 253 |
usually only found under <filename |
253 |
usually only found under <filename |
|
Lines 264-282
Link Here
|
| 264 |
<variablelist> |
264 |
<variablelist> |
| 265 |
<varlistentry> |
265 |
<varlistentry> |
| 266 |
<term><filename class="directory">bin</filename></term> |
266 |
<term><filename class="directory">bin</filename></term> |
| 267 |
<listitem><para>Used for &kde; executables.</para></listitem> |
267 |
<listitem><para>Used for &tde; executables.</para></listitem> |
| 268 |
</varlistentry> |
268 |
</varlistentry> |
| 269 |
|
269 |
|
| 270 |
<varlistentry> |
270 |
<varlistentry> |
| 271 |
<term><filename class="directory">lib</filename></term> |
271 |
<term><filename class="directory">lib</filename></term> |
| 272 |
<listitem><para>Used for &kde; libraries.</para> |
272 |
<listitem><para>Used for &tde; libraries.</para> |
| 273 |
</listitem> |
273 |
</listitem> |
| 274 |
</varlistentry> |
274 |
</varlistentry> |
| 275 |
|
275 |
|
| 276 |
<varlistentry> |
276 |
<varlistentry> |
| 277 |
<term><filename class="directory">lib/trinity</filename></term> |
277 |
<term><filename class="directory">lib/trinity</filename></term> |
| 278 |
<listitem><para>This directory contains components, plugins, and other |
278 |
<listitem><para>This directory contains components, plugins, and other |
| 279 |
runtime loadable objects for use by &kde; 3.<replaceable>x</replaceable> |
279 |
runtime loadable objects for use by &tde; 3.<replaceable>x</replaceable> |
| 280 |
applications.</para></listitem> |
280 |
applications.</para></listitem> |
| 281 |
</varlistentry> |
281 |
</varlistentry> |
| 282 |
</variablelist> |
282 |
</variablelist> |
|
Lines 293-305
Link Here
|
| 293 |
<varlistentry> |
293 |
<varlistentry> |
| 294 |
<term><filename class="directory">share/applnk</filename></term> |
294 |
<term><filename class="directory">share/applnk</filename></term> |
| 295 |
<listitem><para><literal role="extension">.desktop</literal> files for |
295 |
<listitem><para><literal role="extension">.desktop</literal> files for |
| 296 |
&kde;-menu (old)</para></listitem> |
296 |
&tde;-menu (old)</para></listitem> |
| 297 |
</varlistentry> |
297 |
</varlistentry> |
| 298 |
|
298 |
|
| 299 |
<varlistentry> |
299 |
<varlistentry> |
| 300 |
<term><filename class="directory">share/applications</filename></term> |
300 |
<term><filename class="directory">share/applications</filename></term> |
| 301 |
<listitem><para><literal role="extension">.desktop</literal> files for |
301 |
<listitem><para><literal role="extension">.desktop</literal> files for |
| 302 |
&kde;-menu (since &kde; 3.2)</para> |
302 |
&tde;-menu (since &tde; 3.2)</para> |
| 303 |
</listitem> |
303 |
</listitem> |
| 304 |
</varlistentry> |
304 |
</varlistentry> |
| 305 |
|
305 |
|
|
Lines 315-321
Link Here
|
| 315 |
<listitem><para>Configuration files. Configuration files are normally |
315 |
<listitem><para>Configuration files. Configuration files are normally |
| 316 |
named after the application they belong to plus the letters |
316 |
named after the application they belong to plus the letters |
| 317 |
<quote>rc</quote>. A special case is <filename>kdeglobals</filename>. |
317 |
<quote>rc</quote>. A special case is <filename>kdeglobals</filename>. |
| 318 |
This file is read by all &kde; applications.</para></listitem> |
318 |
This file is read by all &tde; applications.</para></listitem> |
| 319 |
</varlistentry> |
319 |
</varlistentry> |
| 320 |
|
320 |
|
| 321 |
<varlistentry> |
321 |
<varlistentry> |
|
Lines 324-330
Link Here
|
| 324 |
<listitem><para>This directory is used by session management and is |
324 |
<listitem><para>This directory is used by session management and is |
| 325 |
normally only available under <filename |
325 |
normally only available under <filename |
| 326 |
class="directory">$<envar>TDEHOME</envar></filename>. At the end of a |
326 |
class="directory">$<envar>TDEHOME</envar></filename>. At the end of a |
| 327 |
session &kde; applications store their state here. The file names |
327 |
session &tde; applications store their state here. The file names |
| 328 |
consist of the name of the application followed by a number. The |
328 |
consist of the name of the application followed by a number. The |
| 329 |
session manager <command>ksmserver</command> stores references to |
329 |
session manager <command>ksmserver</command> stores references to |
| 330 |
these numbers when saving a session in |
330 |
these numbers when saving a session in |
|
Lines 333-339
Link Here
|
| 333 |
|
333 |
|
| 334 |
<varlistentry> |
334 |
<varlistentry> |
| 335 |
<term><filename class="directory">share/doc/HTML</filename></term> |
335 |
<term><filename class="directory">share/doc/HTML</filename></term> |
| 336 |
<listitem><para>This directory contains documentation for &kde; |
336 |
<listitem><para>This directory contains documentation for &tde; |
| 337 |
applications. Documentation is categorized by language and the |
337 |
applications. Documentation is categorized by language and the |
| 338 |
application it belongs to. Normally at least two files can be found in |
338 |
application it belongs to. Normally at least two files can be found in |
| 339 |
a directory: <filename>index.docbook</filename>, which contains the |
339 |
a directory: <filename>index.docbook</filename>, which contains the |
|
Lines 356-362
Link Here
|
| 356 |
<term><filename class="directory">share/mimelnk</filename></term> |
356 |
<term><filename class="directory">share/mimelnk</filename></term> |
| 357 |
<listitem><para>In this directory,<literal |
357 |
<listitem><para>In this directory,<literal |
| 358 |
role="extension">.desktop</literal> files that describe &MIME; types |
358 |
role="extension">.desktop</literal> files that describe &MIME; types |
| 359 |
are stored. &kde; uses &MIME; types to identify the type of a |
359 |
are stored. &tde; uses &MIME; types to identify the type of a |
| 360 |
file.</para> |
360 |
file.</para> |
| 361 |
</listitem> |
361 |
</listitem> |
| 362 |
</varlistentry> |
362 |
</varlistentry> |
|
Lines 366-372
Link Here
|
| 366 |
<listitem><para>This directory contains <literal |
366 |
<listitem><para>This directory contains <literal |
| 367 |
role="extension">.desktop</literal> files that describe services. Services |
367 |
role="extension">.desktop</literal> files that describe services. Services |
| 368 |
are like applications but are usually launched by other applications instead |
368 |
are like applications but are usually launched by other applications instead |
| 369 |
of the user. Services do not appear in the &kde; menu.</para> |
369 |
of the user. Services do not appear in the &tde; menu.</para> |
| 370 |
</listitem> |
370 |
</listitem> |
| 371 |
</varlistentry> |
371 |
</varlistentry> |
| 372 |
|
372 |
|
|
Lines 451-459
Link Here
|
| 451 |
</sect1> |
451 |
</sect1> |
| 452 |
|
452 |
|
| 453 |
<sect1 id="configuration-files"> |
453 |
<sect1 id="configuration-files"> |
| 454 |
<title>Configuration Files</title> <para>&kde; uses a simple |
454 |
<title>Configuration Files</title> <para>&tde; uses a simple |
| 455 |
text-based file format for all its configuration files. It consists of |
455 |
text-based file format for all its configuration files. It consists of |
| 456 |
key-value pairs that are placed in groups. All &kde; configuration |
456 |
key-value pairs that are placed in groups. All &tde; configuration |
| 457 |
files use <acronym>UTF</acronym>-8 encoding for text outside the |
457 |
files use <acronym>UTF</acronym>-8 encoding for text outside the |
| 458 |
<acronym>ASCII</acronym> range.</para> |
458 |
<acronym>ASCII</acronym> range.</para> |
| 459 |
|
459 |
|
|
Lines 527-539
Link Here
|
| 527 |
|
527 |
|
| 528 |
<para>Empty lines in configuration files are ignored, as are lines that |
528 |
<para>Empty lines in configuration files are ignored, as are lines that |
| 529 |
start with a hash mark (<quote>#</quote>). The hash mark can be used to add |
529 |
start with a hash mark (<quote>#</quote>). The hash mark can be used to add |
| 530 |
comments to configuration files. It should be noted that when a &kde; |
530 |
comments to configuration files. It should be noted that when a &tde; |
| 531 |
application updates a configuration file the comments are |
531 |
application updates a configuration file the comments are |
| 532 |
<emphasis>not</emphasis> preserved.</para> |
532 |
<emphasis>not</emphasis> preserved.</para> |
| 533 |
|
533 |
|
| 534 |
<para>There can be multiple configuration files with the same name in the |
534 |
<para>There can be multiple configuration files with the same name in the |
| 535 |
<filename class="directory">share/config</filename> sub-directory of the |
535 |
<filename class="directory">share/config</filename> sub-directory of the |
| 536 |
various &kde; directory trees. In this case the information of all these |
536 |
various &tde; directory trees. In this case the information of all these |
| 537 |
configuration files is combined on a key-by-key basis. If the same key |
537 |
configuration files is combined on a key-by-key basis. If the same key |
| 538 |
within a certain group is defined in more than one place, the key value read |
538 |
within a certain group is defined in more than one place, the key value read |
| 539 |
from the directory tree with the highest precedence will be used. |
539 |
from the directory tree with the highest precedence will be used. |
|
Lines 739-749
Link Here
|
| 739 |
</informalexample> |
739 |
</informalexample> |
| 740 |
|
740 |
|
| 741 |
<para>In general the entries that can appear in a configuration file are not |
741 |
<para>In general the entries that can appear in a configuration file are not |
| 742 |
documented. With &kde; 3.2 a start has been made to change this. In |
742 |
documented. With &tde; 3.2 a start has been made to change this. In |
| 743 |
<filename |
743 |
<filename |
| 744 |
class="directory">$<envar>TDEDIR</envar>/share/config.kcfg</filename>, files |
744 |
class="directory">$<envar>TDEDIR</envar>/share/config.kcfg</filename>, files |
| 745 |
can be found that provide a formal description of the possible entries in a |
745 |
can be found that provide a formal description of the possible entries in a |
| 746 |
configuration file. These are used by the new &kde; Configuration Editor |
746 |
configuration file. These are used by the new &tde; Configuration Editor |
| 747 |
when available.</para> |
747 |
when available.</para> |
| 748 |
|
748 |
|
| 749 |
<informalexample> |
749 |
<informalexample> |
|
Lines 779-785
Link Here
|
| 779 |
</sect1> |
779 |
</sect1> |
| 780 |
|
780 |
|
| 781 |
<sect1 id="kde-startup-sequence"> |
781 |
<sect1 id="kde-startup-sequence"> |
| 782 |
<title>&kde; Startup Sequence</title> |
782 |
<title>&tde; Startup Sequence</title> |
| 783 |
|
783 |
|
| 784 |
<sect2 id="tdm"> |
784 |
<sect2 id="tdm"> |
| 785 |
<title>&tdm;</title> |
785 |
<title>&tdm;</title> |
|
Lines 824-832
Link Here
|
| 824 |
</sect2> |
824 |
</sect2> |
| 825 |
|
825 |
|
| 826 |
<sect2 id="starttde"> |
826 |
<sect2 id="starttde"> |
| 827 |
<title>The &kde; Startup Script: <command>starttde</command></title> |
827 |
<title>The &tde; Startup Script: <command>starttde</command></title> |
| 828 |
|
828 |
|
| 829 |
<para>The &kde; startup sequence starts with the |
829 |
<para>The &tde; startup sequence starts with the |
| 830 |
<filename>starttde</filename> script. In most cases this script gets called |
830 |
<filename>starttde</filename> script. In most cases this script gets called |
| 831 |
from the display manager (&tdm;) once the user has been authenticated. Their |
831 |
from the display manager (&tdm;) once the user has been authenticated. Their |
| 832 |
are two very important lines in the <filename>starttde</filename> |
832 |
are two very important lines in the <filename>starttde</filename> |
|
Lines 839-845
Link Here
|
| 839 |
|
839 |
|
| 840 |
<para>The first line starts the <command>tdeinit</command> master process. |
840 |
<para>The first line starts the <command>tdeinit</command> master process. |
| 841 |
The <command>tdeinit</command> master process is used to start all other |
841 |
The <command>tdeinit</command> master process is used to start all other |
| 842 |
&kde; processes. It show up in the output of <command>ps |
842 |
&tde; processes. It show up in the output of <command>ps |
| 843 |
<option>aux</option></command> as <computeroutput>tdeinit: |
843 |
<option>aux</option></command> as <computeroutput>tdeinit: |
| 844 |
Running...</computeroutput>. The arguments after <command>tdeinit</command> |
844 |
Running...</computeroutput>. The arguments after <command>tdeinit</command> |
| 845 |
are the names of additional processes to be started. The <token>+</token> |
845 |
are the names of additional processes to be started. The <token>+</token> |
|
Lines 859-865
Link Here
|
| 859 |
<sect1 id="background-processes"> |
859 |
<sect1 id="background-processes"> |
| 860 |
<title>Background Processes</title> |
860 |
<title>Background Processes</title> |
| 861 |
|
861 |
|
| 862 |
<para>All &kde; background services are user-specific: unlike system daemons |
862 |
<para>All &tde; background services are user-specific: unlike system daemons |
| 863 |
they are not shared between users. As well as being unique per user they are |
863 |
they are not shared between users. As well as being unique per user they are |
| 864 |
also unique per X-server display. The processes are:</para> |
864 |
also unique per X-server display. The processes are:</para> |
| 865 |
|
865 |
|
|
Lines 912-918
Link Here
|
| 912 |
|
912 |
|
| 913 |
<sect2 id="tdeinit"> |
913 |
<sect2 id="tdeinit"> |
| 914 |
<title><command>tdeinit</command></title> |
914 |
<title><command>tdeinit</command></title> |
| 915 |
<para><command>tdeinit</command> is used to start all other &kde; |
915 |
<para><command>tdeinit</command> is used to start all other &tde; |
| 916 |
programs. <command>tdeinit</command> can start normal binary program files |
916 |
programs. <command>tdeinit</command> can start normal binary program files |
| 917 |
as well as <command>tdeinit</command> loadable modules |
917 |
as well as <command>tdeinit</command> loadable modules |
| 918 |
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary |
918 |
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary |
|
Lines 954-962
Link Here
|
| 954 |
<title><command>dcopserver</command></title> |
954 |
<title><command>dcopserver</command></title> |
| 955 |
|
955 |
|
| 956 |
<para><command>dcopserver</command> is a daemon which provides inter-process |
956 |
<para><command>dcopserver</command> is a daemon which provides inter-process |
| 957 |
communication (&DCOP;) facilities to all &kde; applications. The &DCOP; |
957 |
communication (&DCOP;) facilities to all &tde; applications. The &DCOP; |
| 958 |
facilities are accessible from the command shell via the |
958 |
facilities are accessible from the command shell via the |
| 959 |
<command>dcop</command> command line tool. &DCOP; is essential for all &kde; |
959 |
<command>dcop</command> command line tool. &DCOP; is essential for all &tde; |
| 960 |
applications.</para> |
960 |
applications.</para> |
| 961 |
|
961 |
|
| 962 |
<para>Some related files:</para> |
962 |
<para>Some related files:</para> |
|
Lines 1018-1025
Link Here
|
| 1018 |
<title><command>klauncher</command></title> |
1018 |
<title><command>klauncher</command></title> |
| 1019 |
|
1019 |
|
| 1020 |
<para><command>klauncher</command> is a daemon which is responsible for |
1020 |
<para><command>klauncher</command> is a daemon which is responsible for |
| 1021 |
service activation within &kde;. It operates in close connection with the |
1021 |
service activation within &tde;. It operates in close connection with the |
| 1022 |
<command>tdeinit</command> master process to start new processes. &kde; |
1022 |
<command>tdeinit</command> master process to start new processes. &tde; |
| 1023 |
applications communicate with <command>klauncher</command> over &DCOP; in |
1023 |
applications communicate with <command>klauncher</command> over &DCOP; in |
| 1024 |
order to start new applications or services.</para> |
1024 |
order to start new applications or services.</para> |
| 1025 |
|
1025 |
|
|
Lines 1050-1056
Link Here
|
| 1050 |
<sect1 id="ksmserver"> |
1050 |
<sect1 id="ksmserver"> |
| 1051 |
<title>KSMServer</title> |
1051 |
<title>KSMServer</title> |
| 1052 |
|
1052 |
|
| 1053 |
<para><command>ksmserver</command> is &kde;'s session manager. On startup |
1053 |
<para><command>ksmserver</command> is &tde;'s session manager. On startup |
| 1054 |
the session manager launches auto-start applications and restores |
1054 |
the session manager launches auto-start applications and restores |
| 1055 |
applications from the previous session. The applications to auto-start are |
1055 |
applications from the previous session. The applications to auto-start are |
| 1056 |
indicated by <literal role="extension">.desktop</literal> files in the |
1056 |
indicated by <literal role="extension">.desktop</literal> files in the |
|
Lines 1084-1096
Link Here
|
| 1084 |
|
1084 |
|
| 1085 |
<varlistentry> |
1085 |
<varlistentry> |
| 1086 |
<term><command>kdesktop</command></term> |
1086 |
<term><command>kdesktop</command></term> |
| 1087 |
<listitem><para>The &kde; desktop</para> |
1087 |
<listitem><para>The &tde; desktop</para> |
| 1088 |
</listitem> |
1088 |
</listitem> |
| 1089 |
</varlistentry> |
1089 |
</varlistentry> |
| 1090 |
|
1090 |
|
| 1091 |
<varlistentry> |
1091 |
<varlistentry> |
| 1092 |
<term><command>&kicker;</command></term> |
1092 |
<term><command>&kicker;</command></term> |
| 1093 |
<listitem><para>The &kde; panel</para> |
1093 |
<listitem><para>The &tde; panel</para> |
| 1094 |
</listitem> |
1094 |
</listitem> |
| 1095 |
</varlistentry> |
1095 |
</varlistentry> |
| 1096 |
|
1096 |
|
|
Lines 1127-1133
Link Here
|
| 1127 |
documents, binary files or applications in the form of <literal |
1127 |
documents, binary files or applications in the form of <literal |
| 1128 |
role="extension">.desktop</literal> files.</para> |
1128 |
role="extension">.desktop</literal> files.</para> |
| 1129 |
|
1129 |
|
| 1130 |
<para>The &kde; session manager also restores one of the previous |
1130 |
<para>The &tde; session manager also restores one of the previous |
| 1131 |
sessions. A session contains a collection of applications as well as |
1131 |
sessions. A session contains a collection of applications as well as |
| 1132 |
application-specific information that reflects the state of the applications |
1132 |
application-specific information that reflects the state of the applications |
| 1133 |
at the time the session was saved. Sessions are stored in the |
1133 |
at the time the session was saved. Sessions are stored in the |
|
Lines 1144-1150
Link Here
|
| 1144 |
<sect1 id="environment-variables"> |
1144 |
<sect1 id="environment-variables"> |
| 1145 |
<title>Environment variables</title> |
1145 |
<title>Environment variables</title> |
| 1146 |
|
1146 |
|
| 1147 |
<para>Some important environment variables used by &kde;:</para> |
1147 |
<para>Some important environment variables used by &tde;:</para> |
| 1148 |
|
1148 |
|
| 1149 |
<variablelist> |
1149 |
<variablelist> |
| 1150 |
|
1150 |
|
|
Lines 1152-1181
Link Here
|
| 1152 |
<term>$<envar>TDEDIR</envar></term> |
1152 |
<term>$<envar>TDEDIR</envar></term> |
| 1153 |
<listitem><para>Has to be set if |
1153 |
<listitem><para>Has to be set if |
| 1154 |
<envar>TDEDIRS</envar> is not set and has to point to the root of the |
1154 |
<envar>TDEDIRS</envar> is not set and has to point to the root of the |
| 1155 |
&kde; installation tree. Allows &kde; to find its data like icons, |
1155 |
&tde; installation tree. Allows &tde; to find its data like icons, |
| 1156 |
menus and libraries.</para> |
1156 |
menus and libraries.</para> |
| 1157 |
</listitem> |
1157 |
</listitem> |
| 1158 |
</varlistentry> |
1158 |
</varlistentry> |
| 1159 |
|
1159 |
|
| 1160 |
<varlistentry><term>$<envar>TDEDIRS</envar></term> |
1160 |
<varlistentry><term>$<envar>TDEDIRS</envar></term> |
| 1161 |
<listitem><para>Overrides <envar>TDEDIR</envar> and allows you to specify |
1161 |
<listitem><para>Overrides <envar>TDEDIR</envar> and allows you to specify |
| 1162 |
multiple directories where &kde; searches for its data. Useful if you want |
1162 |
multiple directories where &tde; searches for its data. Useful if you want |
| 1163 |
or have to install some programs to a different prefix than the rest of |
1163 |
or have to install some programs to a different prefix than the rest of |
| 1164 |
&kde;.</para> |
1164 |
&tde;.</para> |
| 1165 |
</listitem> |
1165 |
</listitem> |
| 1166 |
</varlistentry> |
1166 |
</varlistentry> |
| 1167 |
|
1167 |
|
| 1168 |
<varlistentry><term><envar>$TDEHOME</envar></term><listitem><para>If |
1168 |
<varlistentry><term><envar>$TDEHOME</envar></term><listitem><para>If |
| 1169 |
not set, &kde; uses <filename class="directory">~/.kde</filename> as |
1169 |
not set, &tde; uses <filename class="directory">~/.kde</filename> as |
| 1170 |
the directory where personal data is stored.</para> |
1170 |
the directory where personal data is stored.</para> |
| 1171 |
</listitem> |
1171 |
</listitem> |
| 1172 |
</varlistentry> |
1172 |
</varlistentry> |
| 1173 |
|
1173 |
|
| 1174 |
<varlistentry><term>$<envar>TDEROOTHOME</envar></term><listitem><para>If |
1174 |
<varlistentry><term>$<envar>TDEROOTHOME</envar></term><listitem><para>If |
| 1175 |
not set, &kde; uses <filename class="directory">~root/.kde</filename> |
1175 |
not set, &tde; uses <filename class="directory">~root/.kde</filename> |
| 1176 |
as the directory for <systemitem class="username">root</systemitem>'s |
1176 |
as the directory for <systemitem class="username">root</systemitem>'s |
| 1177 |
personal data. Was introduced to prevent &kde; from accidently |
1177 |
personal data. Was introduced to prevent &tde; from accidently |
| 1178 |
overwriting user data with root permissions when the user runs a &kde; |
1178 |
overwriting user data with root permissions when the user runs a &tde; |
| 1179 |
program after switching with <command>su</command> to <systemitem |
1179 |
program after switching with <command>su</command> to <systemitem |
| 1180 |
class="username">root</systemitem>.</para> |
1180 |
class="username">root</systemitem>.</para> |
| 1181 |
</listitem> |
1181 |
</listitem> |
|
Lines 1183-1208
Link Here
|
| 1183 |
|
1183 |
|
| 1184 |
<varlistentry><term>$<envar>KDEWM</envar></term><listitem><para>If the |
1184 |
<varlistentry><term>$<envar>KDEWM</envar></term><listitem><para>If the |
| 1185 |
<envar>KDEWM</envar> environment variable has been set, then it will |
1185 |
<envar>KDEWM</envar> environment variable has been set, then it will |
| 1186 |
be used as &kde;'s window manager within the |
1186 |
be used as &tde;'s window manager within the |
| 1187 |
<command>starttde</command> script instead of &twin;.</para> |
1187 |
<command>starttde</command> script instead of &twin;.</para> |
| 1188 |
</listitem> |
1188 |
</listitem> |
| 1189 |
</varlistentry> |
1189 |
</varlistentry> |
| 1190 |
|
1190 |
|
| 1191 |
<varlistentry><term>$<envar>KDE_LANG</envar></term><listitem><para>Overrides |
1191 |
<varlistentry><term>$<envar>KDE_LANG</envar></term><listitem><para>Overrides |
| 1192 |
the &kde; language configuration, ⪚ <userinput>KDE_LANG=fr kprogram |
1192 |
the &tde; language configuration, ⪚ <userinput>KDE_LANG=fr kprogram |
| 1193 |
&</userinput> starts a program with French translation if the |
1193 |
&</userinput> starts a program with French translation if the |
| 1194 |
necessary files are installed.</para> |
1194 |
necessary files are installed.</para> |
| 1195 |
</listitem> |
1195 |
</listitem> |
| 1196 |
</varlistentry> |
1196 |
</varlistentry> |
| 1197 |
|
1197 |
|
| 1198 |
<varlistentry><term>$<envar>TDE_MULTIHEAD</envar></term><listitem><para>Set |
1198 |
<varlistentry><term>$<envar>TDE_MULTIHEAD</envar></term><listitem><para>Set |
| 1199 |
this variable to <literal>true</literal> to indicate that &kde; is running |
1199 |
this variable to <literal>true</literal> to indicate that &tde; is running |
| 1200 |
on a multi-head system.</para> |
1200 |
on a multi-head system.</para> |
| 1201 |
</listitem> |
1201 |
</listitem> |
| 1202 |
</varlistentry> |
1202 |
</varlistentry> |
| 1203 |
|
1203 |
|
| 1204 |
<varlistentry><term>$<envar>KDE_FORK_SLAVES</envar></term> |
1204 |
<varlistentry><term>$<envar>KDE_FORK_SLAVES</envar></term> |
| 1205 |
<listitem><para>(Since &kde; 3.2.3) Set this variable to spawn |
1205 |
<listitem><para>(Since &tde; 3.2.3) Set this variable to spawn |
| 1206 |
<acronym>KIO</acronym>-slaves directly from the application process |
1206 |
<acronym>KIO</acronym>-slaves directly from the application process |
| 1207 |
itself. By default <acronym>KIO</acronym>-slaves are spawned using |
1207 |
itself. By default <acronym>KIO</acronym>-slaves are spawned using |
| 1208 |
<command>klauncher</command>/<command>tdeinit</command>. This option is |
1208 |
<command>klauncher</command>/<command>tdeinit</command>. This option is |
|
Lines 1219-1246
Link Here
|
| 1219 |
</varlistentry> |
1219 |
</varlistentry> |
| 1220 |
|
1220 |
|
| 1221 |
<varlistentry><term>$<envar>KDE_NO_IPV6</envar></term><listitem><para> |
1221 |
<varlistentry><term>$<envar>KDE_NO_IPV6</envar></term><listitem><para> |
| 1222 |
(Since &kde; 3.2.3) - Set this variable to disable <acronym>IPv6</acronym> |
1222 |
(Since &tde; 3.2.3) - Set this variable to disable <acronym>IPv6</acronym> |
| 1223 |
support and <acronym>IPv6</acronym> <acronym>DNS</acronym> |
1223 |
support and <acronym>IPv6</acronym> <acronym>DNS</acronym> |
| 1224 |
lookups.</para> |
1224 |
lookups.</para> |
| 1225 |
</listitem> |
1225 |
</listitem> |
| 1226 |
</varlistentry> |
1226 |
</varlistentry> |
| 1227 |
|
1227 |
|
| 1228 |
<varlistentry><term>$<envar>KDE_IS_PRELINKED</envar></term><listitem><para> |
1228 |
<varlistentry><term>$<envar>KDE_IS_PRELINKED</envar></term><listitem><para> |
| 1229 |
(Since &kde; 3.2) - Set this variable to indicate that you have prelinked |
1229 |
(Since &tde; 3.2) - Set this variable to indicate that you have prelinked |
| 1230 |
your &kde; binaries and libraries. This will turn off |
1230 |
your &tde; binaries and libraries. This will turn off |
| 1231 |
<command>tdeinit</command>.</para> |
1231 |
<command>tdeinit</command>.</para> |
| 1232 |
</listitem> |
1232 |
</listitem> |
| 1233 |
</varlistentry> |
1233 |
</varlistentry> |
| 1234 |
|
1234 |
|
| 1235 |
<varlistentry><term>$<envar>KDE_UTF8_FILENAMES</envar></term><listitem><para>If |
1235 |
<varlistentry><term>$<envar>KDE_UTF8_FILENAMES</envar></term><listitem><para>If |
| 1236 |
this environment variable is set, &kde; assumes all filenames are in |
1236 |
this environment variable is set, &tde; assumes all filenames are in |
| 1237 |
<acronym>UTF-8</acronym> encoding regardless of the current C |
1237 |
<acronym>UTF-8</acronym> encoding regardless of the current C |
| 1238 |
locale.</para> |
1238 |
locale.</para> |
| 1239 |
</listitem> |
1239 |
</listitem> |
| 1240 |
</varlistentry> |
1240 |
</varlistentry> |
| 1241 |
|
1241 |
|
| 1242 |
<varlistentry><term>$<envar>TDE_FULL_SESSION</envar></term><listitem><para> |
1242 |
<varlistentry><term>$<envar>TDE_FULL_SESSION</envar></term><listitem><para> |
| 1243 |
(Since &kde; 3.2) Automatically set to true by &kde; startup, it is used |
1243 |
(Since &tde; 3.2) Automatically set to true by &tde; startup, it is used |
| 1244 |
by ⪚ &konqueror; to know if it should consider remaining in memory |
1244 |
by ⪚ &konqueror; to know if it should consider remaining in memory |
| 1245 |
for future re-use when being closed. If not set, &konqueror; will exit |
1245 |
for future re-use when being closed. If not set, &konqueror; will exit |
| 1246 |
after being closed (⪚ &tdesu; does that, it's also useful for |
1246 |
after being closed (⪚ &tdesu; does that, it's also useful for |
|
Lines 1249-1288
Link Here
|
| 1249 |
</varlistentry> |
1249 |
</varlistentry> |
| 1250 |
|
1250 |
|
| 1251 |
<varlistentry><term>$<envar>KDESYCOCA</envar></term><listitem><para>Allows |
1251 |
<varlistentry><term>$<envar>KDESYCOCA</envar></term><listitem><para>Allows |
| 1252 |
you to specify the path and the name of the generated &kde; system |
1252 |
you to specify the path and the name of the generated &tde; system |
| 1253 |
configuration cache file.</para> |
1253 |
configuration cache file.</para> |
| 1254 |
</listitem> |
1254 |
</listitem> |
| 1255 |
</varlistentry> |
1255 |
</varlistentry> |
| 1256 |
|
1256 |
|
| 1257 |
<varlistentry><term>$<envar>KDETMP</envar></term><listitem><para>Allows |
1257 |
<varlistentry><term>$<envar>KDETMP</envar></term><listitem><para>Allows |
| 1258 |
to specify another path than <filename |
1258 |
to specify another path than <filename |
| 1259 |
class="directory">/tmp</filename> where &kde; stores its temporary |
1259 |
class="directory">/tmp</filename> where &tde; stores its temporary |
| 1260 |
files.</para> |
1260 |
files.</para> |
| 1261 |
</listitem> |
1261 |
</listitem> |
| 1262 |
</varlistentry> |
1262 |
</varlistentry> |
| 1263 |
|
1263 |
|
| 1264 |
<varlistentry><term>$<envar>KDEVARTMP</envar></term><listitem><para>Allows |
1264 |
<varlistentry><term>$<envar>KDEVARTMP</envar></term><listitem><para>Allows |
| 1265 |
to specify another path than <filename |
1265 |
to specify another path than <filename |
| 1266 |
class="directory">/var/tmp</filename> where &kde; stores its variable |
1266 |
class="directory">/var/tmp</filename> where &tde; stores its variable |
| 1267 |
files.</para> |
1267 |
files.</para> |
| 1268 |
</listitem> |
1268 |
</listitem> |
| 1269 |
</varlistentry> |
1269 |
</varlistentry> |
| 1270 |
|
1270 |
|
| 1271 |
<varlistentry><term>$<envar>XDG_DATA_HOME</envar></term><listitem><para> |
1271 |
<varlistentry><term>$<envar>XDG_DATA_HOME</envar></term><listitem><para> |
| 1272 |
(Since &kde; 3.2) Defines the base directory relative to which user-specific |
1272 |
(Since &tde; 3.2) Defines the base directory relative to which user-specific |
| 1273 |
data files should be stored. Default is <filename |
1273 |
data files should be stored. Default is <filename |
| 1274 |
class="directory">$<envar>HOME</envar>/.local/share</filename></para> |
1274 |
class="directory">$<envar>HOME</envar>/.local/share</filename></para> |
| 1275 |
</listitem> |
1275 |
</listitem> |
| 1276 |
</varlistentry> |
1276 |
</varlistentry> |
| 1277 |
|
1277 |
|
| 1278 |
<varlistentry><term>$<envar>XDG_DATA_DIRS</envar></term><listitem><para> |
1278 |
<varlistentry><term>$<envar>XDG_DATA_DIRS</envar></term><listitem><para> |
| 1279 |
(Since &kde; 3.2) Defines the preference-ordered set of base directories to |
1279 |
(Since &tde; 3.2) Defines the preference-ordered set of base directories to |
| 1280 |
search for data files in addition to the <filename |
1280 |
search for data files in addition to the <filename |
| 1281 |
class="directory">$<envar>XDG_DATA_HOME</envar></filename> base |
1281 |
class="directory">$<envar>XDG_DATA_HOME</envar></filename> base |
| 1282 |
directory. Default is |
1282 |
directory. Default is |
| 1283 |
<literal>/usr/local/share/:/usr/share/</literal></para> |
1283 |
<literal>/usr/local/share/:/usr/share/</literal></para> |
| 1284 |
|
1284 |
|
| 1285 |
<para>&kde; adds locations from $<envar>TDEDIRS</envar> and profiles |
1285 |
<para>&tde; adds locations from $<envar>TDEDIRS</envar> and profiles |
| 1286 |
as well. Used for <literal role="extension">.desktop</literal> and |
1286 |
as well. Used for <literal role="extension">.desktop</literal> and |
| 1287 |
<literal role="extension">.directory</literal> menu files. <literal |
1287 |
<literal role="extension">.directory</literal> menu files. <literal |
| 1288 |
role="extension">.desktop</literal> files under <filename |
1288 |
role="extension">.desktop</literal> files under <filename |
|
Lines 1295-1310
Link Here
|
| 1295 |
</varlistentry> |
1295 |
</varlistentry> |
| 1296 |
|
1296 |
|
| 1297 |
<varlistentry><term>$<envar>XDG_CONFIG_HOME</envar></term><listitem><para> |
1297 |
<varlistentry><term>$<envar>XDG_CONFIG_HOME</envar></term><listitem><para> |
| 1298 |
(&kde; 3.2) - Defines the base directory relative to which user |
1298 |
(&tde; 3.2) - Defines the base directory relative to which user |
| 1299 |
specific configuration files should be stored. Default is |
1299 |
specific configuration files should be stored. Default is |
| 1300 |
<filename class="directory">$<envar>HOME</envar>/.config</filename>.</para> |
1300 |
<filename class="directory">$<envar>HOME</envar>/.config</filename>.</para> |
| 1301 |
</listitem> |
1301 |
</listitem> |
| 1302 |
</varlistentry> |
1302 |
</varlistentry> |
| 1303 |
|
1303 |
|
| 1304 |
<varlistentry><term>$<envar>XDG_CONFIG_DIRS</envar></term><listitem><para> |
1304 |
<varlistentry><term>$<envar>XDG_CONFIG_DIRS</envar></term><listitem><para> |
| 1305 |
(&kde; 3.2) - Defines the preference-ordered set of base directories |
1305 |
(&tde; 3.2) - Defines the preference-ordered set of base directories |
| 1306 |
to search for configuration files in addition to the $<envar>XDG_CONFIG_HOME</envar> |
1306 |
to search for configuration files in addition to the $<envar>XDG_CONFIG_HOME</envar> |
| 1307 |
base directory. The default is <filename class="directory">/etc/xdg</filename> &kde; adds locations from |
1307 |
base directory. The default is <filename class="directory">/etc/xdg</filename> &tde; adds locations from |
| 1308 |
$<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension">.menu</literal> descriptions in |
1308 |
$<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension">.menu</literal> descriptions in |
| 1309 |
<filename class="directory">$<envar>XDG_CONFIG_DIRS</envar>/menus</filename>. |
1309 |
<filename class="directory">$<envar>XDG_CONFIG_DIRS</envar>/menus</filename>. |
| 1310 |
</para> |
1310 |
</para> |
|
Lines 1319-1325
Link Here
|
| 1319 |
|
1319 |
|
| 1320 |
<!-- FIXME: Add more words. Fix markup --> |
1320 |
<!-- FIXME: Add more words. Fix markup --> |
| 1321 |
|
1321 |
|
| 1322 |
<para><command>tdeinit</command> is used to start all other &kde; |
1322 |
<para><command>tdeinit</command> is used to start all other &tde; |
| 1323 |
programs. <command>tdeinit</command> can start normal binary program f iles |
1323 |
programs. <command>tdeinit</command> can start normal binary program f iles |
| 1324 |
as well as <command>tdeinit</command> loadable modules |
1324 |
as well as <command>tdeinit</command> loadable modules |
| 1325 |
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary |
1325 |
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary |
|
Lines 1354-1360
Link Here
|
| 1354 |
|
1354 |
|
| 1355 |
<para>You might be tempted to try <userinput><command>killall |
1355 |
<para>You might be tempted to try <userinput><command>killall |
| 1356 |
tdeinit</command></userinput>, but killing all tdeinit processes will have |
1356 |
tdeinit</command></userinput>, but killing all tdeinit processes will have |
| 1357 |
the effect of shutting down all of &kde;. In effect, total |
1357 |
the effect of shutting down all of &tde;. In effect, total |
| 1358 |
destruction!</para> |
1358 |
destruction!</para> |
| 1359 |
|
1359 |
|
| 1360 |
<para>There are two simple solutions to this:</para> |
1360 |
<para>There are two simple solutions to this:</para> |
|
Lines 1362-1368
Link Here
|
| 1362 |
<screen><prompt>%</prompt> <userinput><command>kdekillall kdesktop</command></userinput> |
1362 |
<screen><prompt>%</prompt> <userinput><command>kdekillall kdesktop</command></userinput> |
| 1363 |
or good old |
1363 |
or good old |
| 1364 |
<prompt>%</prompt> <userinput><command>kill 26195</command></userinput></screen> |
1364 |
<prompt>%</prompt> <userinput><command>kill 26195</command></userinput></screen> |
| 1365 |
<para><command>kdekillall</command> is part of the &kde; <acronym>SDK</acronym> |
1365 |
<para><command>kdekillall</command> is part of the &tde; <acronym>SDK</acronym> |
| 1366 |
package.</para> |
1366 |
package.</para> |
| 1367 |
|
1367 |
|
| 1368 |
</sect1> |
1368 |
</sect1> |
|
Lines 1370-1382
Link Here
|
| 1370 |
</chapter> |
1370 |
</chapter> |
| 1371 |
|
1371 |
|
| 1372 |
<chapter id="customizing-kde"> |
1372 |
<chapter id="customizing-kde"> |
| 1373 |
<title>Customizing &kde;</title> |
1373 |
<title>Customizing &tde;</title> |
| 1374 |
|
1374 |
|
| 1375 |
|
1375 |
|
| 1376 |
<sect1 id="desktop-icons"> |
1376 |
<sect1 id="desktop-icons"> |
| 1377 |
<title>Desktop Icons</title> |
1377 |
<title>Desktop Icons</title> |
| 1378 |
|
1378 |
|
| 1379 |
<para>&kde; uses several types of icons:</para> |
1379 |
<para>&tde; uses several types of icons:</para> |
| 1380 |
<itemizedlist> |
1380 |
<itemizedlist> |
| 1381 |
<listitem><para>Documents</para> |
1381 |
<listitem><para>Documents</para> |
| 1382 |
</listitem> |
1382 |
</listitem> |
|
Lines 1423-1429
Link Here
|
| 1423 |
role="extension">.desktop</literal> file: <menuchoice><guimenu>Create |
1423 |
role="extension">.desktop</literal> file: <menuchoice><guimenu>Create |
| 1424 |
New</guimenu><guisubmenu>File</guisubmenu><guimenuitem>Link to |
1424 |
New</guimenu><guisubmenu>File</guisubmenu><guimenuitem>Link to |
| 1425 |
Application</guimenuitem></menuchoice>. You must provide details |
1425 |
Application</guimenuitem></menuchoice>. You must provide details |
| 1426 |
yourself. Drag from &kde; Menu: Either copy or link (creates symlink), |
1426 |
yourself. Drag from &tde; Menu: Either copy or link (creates symlink), |
| 1427 |
much easier</para> |
1427 |
much easier</para> |
| 1428 |
|
1428 |
|
| 1429 |
<!-- Perhaps legacy and translated should be the other way around, but --> |
1429 |
<!-- Perhaps legacy and translated should be the other way around, but --> |
|
Lines 1496-1502
Link Here
|
| 1496 |
<callout arearefs="co-x-dcop-servicetype"><para>Has app started ok? |
1496 |
<callout arearefs="co-x-dcop-servicetype"><para>Has app started ok? |
| 1497 |
Remove if it doesn't work</para> |
1497 |
Remove if it doesn't work</para> |
| 1498 |
</callout> |
1498 |
</callout> |
| 1499 |
<callout arearefs="co-categories"><para>Categories for &kde; Menu, not |
1499 |
<callout arearefs="co-categories"><para>Categories for &tde; Menu, not |
| 1500 |
used on desktop</para> |
1500 |
used on desktop</para> |
| 1501 |
</callout> |
1501 |
</callout> |
| 1502 |
</calloutlist> |
1502 |
</calloutlist> |
|
Lines 1528-1534
Link Here
|
| 1528 |
<varlistentry> |
1528 |
<varlistentry> |
| 1529 |
<term>%u</term> |
1529 |
<term>%u</term> |
| 1530 |
<listitem><para>A single &URL;: if the app can |
1530 |
<listitem><para>A single &URL;: if the app can |
| 1531 |
handle ⪚ &FTP; or &HTTP; &URL;s itself, otherwise &kde;.</para> |
1531 |
handle ⪚ &FTP; or &HTTP; &URL;s itself, otherwise &tde;.</para> |
| 1532 |
</listitem> |
1532 |
</listitem> |
| 1533 |
</varlistentry> |
1533 |
</varlistentry> |
| 1534 |
|
1534 |
|
|
Lines 1555-1561
Link Here
|
| 1555 |
|
1555 |
|
| 1556 |
<varlistentry> |
1556 |
<varlistentry> |
| 1557 |
<term>%i</term> |
1557 |
<term>%i</term> |
| 1558 |
<listitem><para>The icon; <option>--icon</option> option; &kde; app |
1558 |
<listitem><para>The icon; <option>--icon</option> option; &tde; app |
| 1559 |
will use icon from <varname>Icon</varname>= line in taskbar.</para> |
1559 |
will use icon from <varname>Icon</varname>= line in taskbar.</para> |
| 1560 |
</listitem> |
1560 |
</listitem> |
| 1561 |
</varlistentry> |
1561 |
</varlistentry> |
|
Lines 1568-1574
Link Here
|
| 1568 |
|
1568 |
|
| 1569 |
<varlistentry> |
1569 |
<varlistentry> |
| 1570 |
<term>%c</term> |
1570 |
<term>%c</term> |
| 1571 |
<listitem><para>The caption; <option>--caption</option> option; &kde; |
1571 |
<listitem><para>The caption; <option>--caption</option> option; &tde; |
| 1572 |
app will use name from <varname>Name</varname>= line in |
1572 |
app will use name from <varname>Name</varname>= line in |
| 1573 |
taskbar.</para> |
1573 |
taskbar.</para> |
| 1574 |
</listitem> |
1574 |
</listitem> |
|
Lines 1635-1649
Link Here
|
| 1635 |
</sect1> |
1635 |
</sect1> |
| 1636 |
|
1636 |
|
| 1637 |
<sect1 id="kde-menu"> |
1637 |
<sect1 id="kde-menu"> |
| 1638 |
<title>&kde; Menu</title> |
1638 |
<title>&tde; Menu</title> |
| 1639 |
|
1639 |
|
| 1640 |
<sect2 id="how-it-works"> |
1640 |
<sect2 id="how-it-works"> |
| 1641 |
<title>How it Works</title> |
1641 |
<title>How it Works</title> |
| 1642 |
|
1642 |
|
| 1643 |
<para>In &kde; 3.2 a common menu format is introduced at |
1643 |
<para>In &tde; 3.2 a common menu format is introduced at |
| 1644 |
<ulink |
1644 |
<ulink |
| 1645 |
url="http://freedesktop.org/Standards/menu-spec/">http://freedesktop.org/Standards/menu-spec/</ulink></para> |
1645 |
url="http://freedesktop.org/Standards/menu-spec/">http://freedesktop.org/Standards/menu-spec/</ulink></para> |
| 1646 |
<para>Before &kde; 3.2: |
1646 |
<para>Before &tde; 3.2: |
| 1647 |
<itemizedlist> |
1647 |
<itemizedlist> |
| 1648 |
|
1648 |
|
| 1649 |
<listitem><para>Directory structure under <filename |
1649 |
<listitem><para>Directory structure under <filename |
|
Lines 1658-1669
Link Here
|
| 1658 |
</itemizedlist> |
1658 |
</itemizedlist> |
| 1659 |
</para> |
1659 |
</para> |
| 1660 |
|
1660 |
|
| 1661 |
<para>It was difficult to rearrange the structure in &kde; 3.2 so the |
1661 |
<para>It was difficult to rearrange the structure in &tde; 3.2 so the |
| 1662 |
new menu format: |
1662 |
new menu format: |
| 1663 |
<itemizedlist> |
1663 |
<itemizedlist> |
| 1664 |
<listitem><para>Defines structure in a single .menu file</para></listitem> |
1664 |
<listitem><para>Defines structure in a single .menu file</para></listitem> |
| 1665 |
<listitem><para>Is based on categories</para></listitem> |
1665 |
<listitem><para>Is based on categories</para></listitem> |
| 1666 |
<listitem><para>is shared between <acronym>GNOME</acronym> and &kde;</para></listitem> |
1666 |
<listitem><para>is shared between <acronym>GNOME</acronym> and &tde;</para></listitem> |
| 1667 |
<listitem><para>Supports applnk style menus as well</para></listitem> |
1667 |
<listitem><para>Supports applnk style menus as well</para></listitem> |
| 1668 |
</itemizedlist> |
1668 |
</itemizedlist> |
| 1669 |
</para> |
1669 |
</para> |
|
Lines 1781-1787
Link Here
|
| 1781 |
|
1781 |
|
| 1782 |
<para>Applications <emphasis>not</emphasis> in the menu do |
1782 |
<para>Applications <emphasis>not</emphasis> in the menu do |
| 1783 |
<emphasis>not</emphasis> exist with regard to other applications or |
1783 |
<emphasis>not</emphasis> exist with regard to other applications or |
| 1784 |
file associations: If you remove an application from the menu, &kde; assumes you don't want to use it.</para> |
1784 |
file associations: If you remove an application from the menu, &tde; assumes you don't want to use it.</para> |
| 1785 |
|
1785 |
|
| 1786 |
<para>When applications are unwanted in the menu, either place them in |
1786 |
<para>When applications are unwanted in the menu, either place them in |
| 1787 |
<filename>.hidden</filename> menu or a dedicated menu with |
1787 |
<filename>.hidden</filename> menu or a dedicated menu with |
|
Lines 1797-1803
Link Here
|
| 1797 |
<para><filename |
1797 |
<para><filename |
| 1798 |
class="directory">$<envar>TDEDIR</envar>/etc/xdg/menus/applications-merged/</filename> |
1798 |
class="directory">$<envar>TDEDIR</envar>/etc/xdg/menus/applications-merged/</filename> |
| 1799 |
contains <filename>kde-essential.menu</filename> which includes some |
1799 |
contains <filename>kde-essential.menu</filename> which includes some |
| 1800 |
essential menus that are normally not shown in the &kde; menu itself: |
1800 |
essential menus that are normally not shown in the &tde; menu itself: |
| 1801 |
<itemizedlist> |
1801 |
<itemizedlist> |
| 1802 |
<listitem><para>Control Center has a hidden Settings menu whose |
1802 |
<listitem><para>Control Center has a hidden Settings menu whose |
| 1803 |
contents are defined by <filename>kde-settings.menu</filename> and |
1803 |
contents are defined by <filename>kde-settings.menu</filename> and |
|
Lines 1826-1832
Link Here
|
| 1826 |
<sect2 id="old-style-menus"> |
1826 |
<sect2 id="old-style-menus"> |
| 1827 |
<title>Old-Style Menus</title> |
1827 |
<title>Old-Style Menus</title> |
| 1828 |
|
1828 |
|
| 1829 |
<para>&kde; continues to support old-style menus that are defined by |
1829 |
<para>&tde; continues to support old-style menus that are defined by |
| 1830 |
the directory structures in <filename |
1830 |
the directory structures in <filename |
| 1831 |
class="directory">$<envar>TDEDIR</envar>/share/applnk</filename> |
1831 |
class="directory">$<envar>TDEDIR</envar>/share/applnk</filename> |
| 1832 |
(system wide) and <filename |
1832 |
(system wide) and <filename |
|
Lines 1843-1849
Link Here
|
| 1843 |
which is built lives in <filename |
1843 |
which is built lives in <filename |
| 1844 |
class="directory">/var/tmp/kdecache-${<envar>USER</envar>}/ksycoca</filename>. |
1844 |
class="directory">/var/tmp/kdecache-${<envar>USER</envar>}/ksycoca</filename>. |
| 1845 |
It is automatically updated by <application>KDED</application>, |
1845 |
It is automatically updated by <application>KDED</application>, |
| 1846 |
checked during &kde; login, and <application>KDED</application> |
1846 |
checked during &tde; login, and <application>KDED</application> |
| 1847 |
watches for changes while logged in.</para> |
1847 |
watches for changes while logged in.</para> |
| 1848 |
|
1848 |
|
| 1849 |
<para>To disable watching for changes (since it may hurt over NFS) add |
1849 |
<para>To disable watching for changes (since it may hurt over NFS) add |
|
Lines 1878-1886
Link Here
|
| 1878 |
|
1878 |
|
| 1879 |
<!-- This section might be redundant. If it isn't, it needs some screenies --> |
1879 |
<!-- This section might be redundant. If it isn't, it needs some screenies --> |
| 1880 |
<sect1 id="kde-panel"> |
1880 |
<sect1 id="kde-panel"> |
| 1881 |
<title>&kde; Panel</title> |
1881 |
<title>&tde; Panel</title> |
| 1882 |
|
1882 |
|
| 1883 |
<para>The &kde; panel is also known as &kicker;. It is modular and |
1883 |
<para>The &tde; panel is also known as &kicker;. It is modular and |
| 1884 |
consists of the following components: |
1884 |
consists of the following components: |
| 1885 |
<itemizedlist> |
1885 |
<itemizedlist> |
| 1886 |
<listitem><para>Applets</para></listitem> |
1886 |
<listitem><para>Applets</para></listitem> |
|
Lines 1898-1904
Link Here
|
| 1898 |
</itemizedlist> |
1898 |
</itemizedlist> |
| 1899 |
and the following special buttons: |
1899 |
and the following special buttons: |
| 1900 |
<itemizedlist> |
1900 |
<itemizedlist> |
| 1901 |
<listitem><para>&kde; menu</para></listitem> |
1901 |
<listitem><para>&tde; menu</para></listitem> |
| 1902 |
<listitem><para>Desktop Button</para></listitem> |
1902 |
<listitem><para>Desktop Button</para></listitem> |
| 1903 |
</itemizedlist> |
1903 |
</itemizedlist> |
| 1904 |
</para> |
1904 |
</para> |
|
Lines 1917-1923
Link Here
|
| 1917 |
|
1917 |
|
| 1918 |
<para>File associations associate a file type with an application or |
1918 |
<para>File associations associate a file type with an application or |
| 1919 |
applications. The type of a file is established by determining its |
1919 |
applications. The type of a file is established by determining its |
| 1920 |
&MIME; type. &MIME; types known by &kde; are stored in <filename |
1920 |
&MIME; type. &MIME; types known by &tde; are stored in <filename |
| 1921 |
class="directory">$<envar>TDEDIR</envar>/share/mimelnk</filename> and |
1921 |
class="directory">$<envar>TDEDIR</envar>/share/mimelnk</filename> and |
| 1922 |
each application's <literal role="extension">.desktop</literal> file |
1922 |
each application's <literal role="extension">.desktop</literal> file |
| 1923 |
contains a list of &MIME; types supported by that application.</para> |
1923 |
contains a list of &MIME; types supported by that application.</para> |
|
Lines 1962-1968
Link Here
|
| 1962 |
&kcontrolcenter;. These changes are stored in |
1962 |
&kcontrolcenter;. These changes are stored in |
| 1963 |
<filename>$<envar>HOME</envar>/.kde/share/config/profilerc</filename>. |
1963 |
<filename>$<envar>HOME</envar>/.kde/share/config/profilerc</filename>. |
| 1964 |
To use the same settings for multiple users, store these settings in |
1964 |
To use the same settings for multiple users, store these settings in |
| 1965 |
user profile directory or the global &kde; config directory to use as |
1965 |
user profile directory or the global &tde; config directory to use as |
| 1966 |
default for multiple users.</para> |
1966 |
default for multiple users.</para> |
| 1967 |
|
1967 |
|
| 1968 |
</informalexample> |
1968 |
</informalexample> |
|
Lines 1972-1983
Link Here
|
| 1972 |
</chapter> |
1972 |
</chapter> |
| 1973 |
|
1973 |
|
| 1974 |
<chapter id="locking-down-kde"> |
1974 |
<chapter id="locking-down-kde"> |
| 1975 |
<title>Locking Down &kde;</title> |
1975 |
<title>Locking Down &tde;</title> |
| 1976 |
|
1976 |
|
| 1977 |
<sect1 id="how-it-works-the-basics"> |
1977 |
<sect1 id="how-it-works-the-basics"> |
| 1978 |
<title>How It Works - The Basics</title> |
1978 |
<title>How It Works - The Basics</title> |
| 1979 |
|
1979 |
|
| 1980 |
<para>&kde;'s lock down features are centered around the following |
1980 |
<para>&tde;'s lock down features are centered around the following |
| 1981 |
options:</para> |
1981 |
options:</para> |
| 1982 |
|
1982 |
|
| 1983 |
<itemizedlist> |
1983 |
<itemizedlist> |
|
Lines 1995-2001
Link Here
|
| 1995 |
|
1995 |
|
| 1996 |
<sect1 id="immutable-configuration-options"> |
1996 |
<sect1 id="immutable-configuration-options"> |
| 1997 |
<title>Immutable Configuration Options</title> |
1997 |
<title>Immutable Configuration Options</title> |
| 1998 |
<subtitle>Locking Down &kde;</subtitle> |
1998 |
<subtitle>Locking Down &tde;</subtitle> |
| 1999 |
|
1999 |
|
| 2000 |
<para>Immutable options allow system administrator to provide default |
2000 |
<para>Immutable options allow system administrator to provide default |
| 2001 |
settings that can not be changed by the user.</para> |
2001 |
settings that can not be changed by the user.</para> |
|
Lines 2020-2026
Link Here
|
| 2020 |
<sect1 id="action-restrictions"> |
2020 |
<sect1 id="action-restrictions"> |
| 2021 |
<title>Action Restrictions</title> |
2021 |
<title>Action Restrictions</title> |
| 2022 |
|
2022 |
|
| 2023 |
<para>&kde; applications are built around the action-concept. Actions can be |
2023 |
<para>&tde; applications are built around the action-concept. Actions can be |
| 2024 |
activated in various ways, typically via the menu-bar, one of the toolbars |
2024 |
activated in various ways, typically via the menu-bar, one of the toolbars |
| 2025 |
or a keyboard shortcut. <action>Save Document</action> is an example of an |
2025 |
or a keyboard shortcut. <action>Save Document</action> is an example of an |
| 2026 |
action. If you know the internal action name it is possible to restrict an |
2026 |
action. If you know the internal action name it is possible to restrict an |
|
Lines 2043-2054
Link Here
|
| 2043 |
<screen>[KDE Action Restrictions] |
2043 |
<screen>[KDE Action Restrictions] |
| 2044 |
shell_access=false</screen> |
2044 |
shell_access=false</screen> |
| 2045 |
|
2045 |
|
| 2046 |
<para>Since this affects the &kde; menu and the available applications, we |
2046 |
<para>Since this affects the &tde; menu and the available applications, we |
| 2047 |
must force an update of the sycoca database:</para> |
2047 |
must force an update of the sycoca database:</para> |
| 2048 |
|
2048 |
|
| 2049 |
<screen><userinput><command>touch</command> <filename>$<envar>TDEDIR</envar>/share/services/update_ksycoca</filename></userinput></screen> |
2049 |
<screen><userinput><command>touch</command> <filename>$<envar>TDEDIR</envar>/share/services/update_ksycoca</filename></userinput></screen> |
| 2050 |
|
2050 |
|
| 2051 |
<para>Now re-login to &kde; and check the following points:</para> |
2051 |
<para>Now re-login to &tde; and check the following points:</para> |
| 2052 |
|
2052 |
|
| 2053 |
<itemizedlist> |
2053 |
<itemizedlist> |
| 2054 |
<listitem><para>The &kmenu;</para></listitem> |
2054 |
<listitem><para>The &kmenu;</para></listitem> |
|
Lines 2200-2206
Link Here
|
| 2200 |
</calloutlist> |
2200 |
</calloutlist> |
| 2201 |
|
2201 |
|
| 2202 |
<para>$<envar>HOME</envar> and $<envar>TMP</envar> are special values to |
2202 |
<para>$<envar>HOME</envar> and $<envar>TMP</envar> are special values to |
| 2203 |
indicate the users home directory and the &kde; temporary directory of the |
2203 |
indicate the users home directory and the &tde; temporary directory of the |
| 2204 |
user, ⪚ <filename class="directory">/tmp/kde-bastian</filename></para> |
2204 |
user, ⪚ <filename class="directory">/tmp/kde-bastian</filename></para> |
| 2205 |
|
2205 |
|
| 2206 |
<para>The following rules makes that the user can no longer open local files |
2206 |
<para>The following rules makes that the user can no longer open local files |
|
Lines 2223-2230
Link Here
|
| 2223 |
<callout arearefs="local_rule2"><para><option>rule_2</option> allows opening |
2223 |
<callout arearefs="local_rule2"><para><option>rule_2</option> allows opening |
| 2224 |
files under the users own $<envar>HOME</envar> directory.</para></callout> |
2224 |
files under the users own $<envar>HOME</envar> directory.</para></callout> |
| 2225 |
<callout arearefs="local_rule3"><para><option>rule_3</option> allows opening |
2225 |
<callout arearefs="local_rule3"><para><option>rule_3</option> allows opening |
| 2226 |
files in the &kde; temporary directory of the user. This is needed by |
2226 |
files in the &tde; temporary directory of the user. This is needed by |
| 2227 |
certain &kde; applications that first download a file or document to the |
2227 |
certain &tde; applications that first download a file or document to the |
| 2228 |
temporary directory and then open it in an application.</para></callout> |
2228 |
temporary directory and then open it in an application.</para></callout> |
| 2229 |
</calloutlist> |
2229 |
</calloutlist> |
| 2230 |
|
2230 |
|
|
Lines 2286-2293
Link Here
|
| 2286 |
<sect1 id="configuration-modules"> |
2286 |
<sect1 id="configuration-modules"> |
| 2287 |
<title>Configuration Modules</title> |
2287 |
<title>Configuration Modules</title> |
| 2288 |
|
2288 |
|
| 2289 |
<para>&kde; has configuration modules to configure various aspects of the |
2289 |
<para>&tde; has configuration modules to configure various aspects of the |
| 2290 |
&kde; environment. Configuration modules appear in the Control Center, in the |
2290 |
&tde; environment. Configuration modules appear in the Control Center, in the |
| 2291 |
Configuration dialog of an application or in both.</para> |
2291 |
Configuration dialog of an application or in both.</para> |
| 2292 |
|
2292 |
|
| 2293 |
<informalexample> |
2293 |
<informalexample> |
|
Lines 2310-2316
Link Here
|
| 2310 |
itself.</para></note></para> |
2310 |
itself.</para></note></para> |
| 2311 |
</informalexample> |
2311 |
</informalexample> |
| 2312 |
|
2312 |
|
| 2313 |
<para>All configuration modules are strictly speaking part of the &kde; |
2313 |
<para>All configuration modules are strictly speaking part of the &tde; |
| 2314 |
menu.</para> |
2314 |
menu.</para> |
| 2315 |
|
2315 |
|
| 2316 |
<itemizedlist> |
2316 |
<itemizedlist> |
|
Lines 2330-2336
Link Here
|
| 2330 |
<markup><KDELegacyDirs/></markup></para> |
2330 |
<markup><KDELegacyDirs/></markup></para> |
| 2331 |
<screen><userinput><command>kbuildsycoca</command> <option>--menutest</option> 2> /dev/null | <command>grep</command> .hidden</userinput></screen> |
2331 |
<screen><userinput><command>kbuildsycoca</command> <option>--menutest</option> 2> /dev/null | <command>grep</command> .hidden</userinput></screen> |
| 2332 |
</listitem> |
2332 |
</listitem> |
| 2333 |
<listitem><para>In &kde; 3.3 it is possible to edit the Control Center with |
2333 |
<listitem><para>In &tde; 3.3 it is possible to edit the Control Center with |
| 2334 |
<application>kcontroledit</application>. |
2334 |
<application>kcontroledit</application>. |
| 2335 |
<application>kcontroledit</application> works just like |
2335 |
<application>kcontroledit</application> works just like |
| 2336 |
<application>kmenuedit</application>, changes for current user only. Use |
2336 |
<application>kmenuedit</application>, changes for current user only. Use |
|
Lines 2380-2392
Link Here
|
| 2380 |
The Lazy Admin |
2380 |
The Lazy Admin |
| 2381 |
Overview |
2381 |
Overview |
| 2382 |
Deployment |
2382 |
Deployment |
| 2383 |
How to get &kde; available on many clients |
2383 |
How to get &tde; available on many clients |
| 2384 |
Remote Desktop Sharing |
2384 |
Remote Desktop Sharing |
| 2385 |
Take a look at someone else desktop |
2385 |
Take a look at someone else desktop |
| 2386 |
DCOP |
2386 |
DCOP |
| 2387 |
The DCOP command line tool makes it possible to control &kde; applications from the command line |
2387 |
The DCOP command line tool makes it possible to control &tde; applications from the command line |
| 2388 |
KDialog |
2388 |
KDialog |
| 2389 |
A versatile tool to use standard &kde; dialogs in your own scripts |
2389 |
A versatile tool to use standard &tde; dialogs in your own scripts |
| 2390 |
|
2390 |
|
| 2391 |
|
2391 |
|
| 2392 |
|
2392 |
|
|
Lines 2418-2425
Link Here
|
| 2418 |
access to users desktops in order to troubleshoot or remedy a problem or |
2418 |
access to users desktops in order to troubleshoot or remedy a problem or |
| 2419 |
guide a user through a procedure.</para> |
2419 |
guide a user through a procedure.</para> |
| 2420 |
|
2420 |
|
| 2421 |
<para>Remote desktop sharing involves two applications: &krfb; (&kde; remote |
2421 |
<para>Remote desktop sharing involves two applications: &krfb; (&tde; remote |
| 2422 |
frame buffer, a VNC server) and &krdc; (&kde; remote desktop connection; a |
2422 |
frame buffer, a VNC server) and &krdc; (&tde; remote desktop connection; a |
| 2423 |
VNC client.)</para> |
2423 |
VNC client.)</para> |
| 2424 |
|
2424 |
|
| 2425 |
<para>&krfb; can be used by any user to create and manage invitations. |
2425 |
<para>&krfb; can be used by any user to create and manage invitations. |
|
Lines 2438-2444
Link Here
|
| 2438 |
</sect1> |
2438 |
</sect1> |
| 2439 |
|
2439 |
|
| 2440 |
<sect1 id="kde-diy"> |
2440 |
<sect1 id="kde-diy"> |
| 2441 |
<title>&kde; DIY - Building Your Own Tools</title> |
2441 |
<title>&tde; DIY - Building Your Own Tools</title> |
| 2442 |
|
2442 |
|
| 2443 |
<sect2 id="dcop"> |
2443 |
<sect2 id="dcop"> |
| 2444 |
<title>DCOP</title> |
2444 |
<title>DCOP</title> |
|
Lines 2446-2452
Link Here
|
| 2446 |
<para> |
2446 |
<para> |
| 2447 |
Desktop COmmunication Protocol, <acronym>DCOP</acronym>, is a lightweight mechanism for inter-process communication. |
2447 |
Desktop COmmunication Protocol, <acronym>DCOP</acronym>, is a lightweight mechanism for inter-process communication. |
| 2448 |
<acronym>DCOP</acronym> allows the user to interact with programs that are currently running. |
2448 |
<acronym>DCOP</acronym> allows the user to interact with programs that are currently running. |
| 2449 |
&kde; supplies two programs to utilitize <acronym>DCOP</acronym>: |
2449 |
&tde; supplies two programs to utilitize <acronym>DCOP</acronym>: |
| 2450 |
<application>dcop</application>, a command-line program, and |
2450 |
<application>dcop</application>, a command-line program, and |
| 2451 |
<application>kdcop</application>, a <acronym>GUI</acronym> program. |
2451 |
<application>kdcop</application>, a <acronym>GUI</acronym> program. |
| 2452 |
</para> |
2452 |
</para> |
|
Lines 2589-2598
Link Here
|
| 2589 |
|
2589 |
|
| 2590 |
<sect2 id="kdialog"> |
2590 |
<sect2 id="kdialog"> |
| 2591 |
<title>KDialog</title> |
2591 |
<title>KDialog</title> |
| 2592 |
<subtitle>&kde; DIY - Building Your Own Tools</subtitle> |
2592 |
<subtitle>&tde; DIY - Building Your Own Tools</subtitle> |
| 2593 |
|
2593 |
|
| 2594 |
<para>You can use &kde; dialogs from your own scripts, to combine the power |
2594 |
<para>You can use &tde; dialogs from your own scripts, to combine the power |
| 2595 |
of &UNIX; shell scripting with the ease of use of &kde;.</para> |
2595 |
of &UNIX; shell scripting with the ease of use of &tde;.</para> |
| 2596 |
|
2596 |
|
| 2597 |
<screen><userinput><command>kdialog</command> <option>--msgbox 'You have new mail!'</option></userinput></screen> |
2597 |
<screen><userinput><command>kdialog</command> <option>--msgbox 'You have new mail!'</option></userinput></screen> |
| 2598 |
|
2598 |
|