1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
|
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kmyapplication "<application>KShutDown</application>">
<!ENTITY kappname "&kmyapplication;">
<!ENTITY package "kde-module">
<!ENTITY % addindex "IGNORE">
<!ENTITY % German "INCLUDE">
]>
<book lang="&language;">
<bookinfo>
<title>Das &kmyapplication; Handbuch</title>
<authorgroup>
<author>
<personname>
<firstname>Konrad</firstname>
<surname>Twardowski</surname>
</personname>
<email>kdtonline@poczta.onet.pl</email>
</author>
</authorgroup>
<copyright>
<year>2005</year>
<holder>Konrad Twardowski</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
<date>2005-11-24</date>
<releaseinfo>1.08.00</releaseinfo><!-- sync. with KShutDown version -->
<abstract>
<para>&kmyapplication; ist ein Programm zum erweiterten Herunterfahren in &kde;.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>kshutdown</keyword>
<keyword>shutdown</keyword>
<keyword>shut</keyword>
<keyword>down</keyword>
<keyword>poweroff</keyword>
<keyword>reboot</keyword>
<keyword>lock</keyword>
<keyword>halt</keyword>
<keyword>exit</keyword>
<keyword>logout</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Einführung</title>
<para>&kmyapplication; ist ein Programm zum erweiterten Herunterfahren in &kde;.</para>
<para>
Fähigkeiten:
<itemizedlist>
<listitem><para>Computer abschalten (ausloggen und anhalten des Systems)</para></listitem>
<listitem><para>Computer Neustart (ausloggen und neu booten des Systems)</para></listitem>
<listitem><para>Sitzung sperren (sperrt den Bildschirm mit dem Bildschirmschoner)</para></listitem>
<listitem><para>Beendet aktive Sitzung (Beendet die aktive Sitzung in &kde; und loggt den Benutzer aus)</para></listitem>
<listitem><para>Extras (zusätzliche, Benutzereingaben)</para></listitem>
<listitem><para>Zeit und Verzögerungsoptionen</para></listitem>
<listitem><para><link linkend="command-line">Kommandozeilen-</link> und <link linkend="dcop">DCOP-</link> Unterstützung</para></listitem>
<listitem><para><link linkend="using-systray">System tray</link></para></listitem>
<listitem><para>Visuelle und Klangbenachrichtigungen</para></listitem>
<listitem><para><link linkend="kiosk">&kde; Kiosk Unterstützung</link></para></listitem>
</itemizedlist>
</para>
</chapter><!-- introduction -->
<chapter id="using-kapp">
<title>Benutzen von &kmyapplication;</title>
<sect1 id="using-mainwindow">
<title>Hauptfenster</title>
<itemizedlist>
<listitem><para>Benutzen Sie das erste Aufklappmenü um eine Aktion auszuwählen (Computer ausschalten, Extras, usw).</para></listitem>
<listitem><para>Benutzen Sie das zweite Aufklappmenü um die Verzögerung einzustellen (Keine, Zeit ab jetzt, usw).</para></listitem>
<listitem><para>Klicken Sie den <guibutton>Start</guibutton> Knopf um eine ausgewählte Aktion zu aktivieren. Die Aktion wird zur angegebenen Zeit gestartet.</para></listitem>
<listitem><para>Klicken Sie den <guibutton>Stop</guibutton> Knopf oder die <keycap>Esc</keycap> Taste um die Aktion zu stoppen.</para></listitem>
</itemizedlist>
<screenshot>
<screeninfo>&kmyapplication; Hauptfenster</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Hauptfenster</phrase>
</textobject>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="using-systray">
<title>System Tray</title>
<itemizedlist>
<listitem><para>Linker Mausknopf - versteckt/zeigt Hauptfenster</para></listitem>
<listitem><para>Mittlerer Mausknopf - zeigt das Menü mit den Aktionen (Keine Verzögerung!)</para></listitem>
<listitem><para>Rechter Mausknopf - Zeigt das Kontextmenü</para></listitem>
</itemizedlist>
</sect1>
</chapter><!-- using-kapp -->
<chapter id="command-line">
<title>Kommandozeile</title>
<!-- copied from the kshutdown command line help -->
<programlisting>
Anmerkung: Die Optionen werden in Englisch angezeigt!
Auf der Kommandozeile kshutdown mit den gewünschten Optionen, ohne Klammern, angeben.
Benutzung: kshutdown [Qt-options] [KDE-options] [options] [time]
A Shut Down Utility for KDE
Generic options:
--help Show help about options Hilfe Optionen
--help-qt Show Qt specific options QT-spezifische Optionen
--help-kde Show KDE specific options KDE-spezifische Optionen
--help-all Show all options Alle Optionen
--author Show author information Informationen über den Author
-v, --version Show version information Versionsinformationen
--license Show license information Lizenzinformationen
-- End of options Ende der Optionen
Options:
-s, --shutdown Turn off computer Computer abschalten
-h, --halt Turn off computer " "
-r, --reboot Restart computer Computer neu starten
-k, --lock Lock session Sitzung sperren
-l, --logout End current session Sitzung beenden
--confirm Confirm command line action Bestätigung für Kommandozeilen Aktionen
--standard Show standard logout dialog Zeigt Standard Abmelden Dialog
-c, --cancel Cancel an active action Bricht eine aktive Aktion ab
--init Don't show window at startup Zeigt kein Fenster beim Start
--test Enable test mode Aktiviert Testmodus
--default Disable test mode Deaktiviert Testmodus
Arguments:
time Time; Examples: 01:30 - absolute time (HH:MM); 10 - number of minutes to wait from now
</programlisting>
</chapter><!-- command-line -->
<chapter id="kiosk">
<title>Kiosk</title>
<para>
&kde; Kiosk erlaubt Ihnen die Kontrolle über sämtliche kritische Funktionen, wie zum Beispiel <guibutton>Computer Ausschalten</guibutton> oder <guibutton>Computer neu starten</guibutton>. Wollen Sie diese Restriktionen einschalten, können Sie eine globale Konfigurationsdatei namens <filename>kshutdownrc</filename> im allgemeinen &kde; Verzeichnis anlegen. Dieses liegt in (<filename>[prefix]/share/config</filename>).
</para>
<note>
<para>In den meisten Fällen müssen Sie &kmyapplication; neu starten damit die neuen Einstellungen übernommen werden.</para>
</note>
<note>
<para>Seit Version 0.3.1 Beta ist allen Schlüsseln eine "kshutdown_" Zeichenkette vorangestellt.</para>
</note>
<example>
<title>Beispiel kshutdownrc Datei mit den Einschränkungen</title>
<programlisting>
[KDE Aktionseinschränkungen][$i]
# [$i] - Benutzer kann Gruppe nicht Überschreiben
# false - Feature deaktiviert
# true - Feature aktiviert
# Standard ist angeschaltet
Mit "false" verbieten, mit "true" erlauben.
# Deaktiviert die Aktion "Computer ausschalten"
kshutdown_action_shutdown=false
# kshutdown_action_shutdown=true <- "true" aktiviert diese Aktion
# Computer neu starten
kshutdown_action_reboot=true
# Bilschirm sperren
kshutdown_action_lockscreen=true
# Sitzung beenden
kshutdown_action_logout=true
# "Extras" Aktionen
kshutdown_action_extras=true
# Deaktiviert die Aktionen Seite in den Einstellungen
kshutdown_settings_actions=true
# Deaktiviert "Zeit auswählen" Aufklappmenü und das Kommandozeilenargument dazu
# and the command line "time" argument
kshutdown_tab_time=true
# Deaktiviert den Statistik Dialog
kshutdown_tab_stats=true
</programlisting>
</example>
</chapter><!-- kiosk -->
<chapter id="dcop">
<title>DCOP API (KShutdownIface)</title>
<sect1 id="dcop-intro">
<title>Einführung</title>
<orderedlist>
<listitem><para>Achten Sie darauf das &kmyapplication; gestartet ist.</para></listitem>
<listitem><para>Tippen Sie <command>kshutdown --init</command> zum Starten von &kmyapplication; ohne Hauptfenster.</para></listitem>
<listitem><para>Zum Auflisten aller DCOP Functionen, tippen Sie <command>dcop kshutdown KShutdownIface</command>.</para></listitem>
<listitem><para>Mit <command>dcop kshutdown MMainWindow hide</command> verstecken Sie das Hauptfenster.</para></listitem>
<listitem><para>Mit <command>dcop kshutdown MMainWindow show</command> machen Sie das Hauptfenster wieder sichtbar.</para></listitem>
</orderedlist>
</sect1>
<sect1 id="dcop-func">
<title>Funktionen</title>
<sect2 id="dcop-func-cancel">
<title>ASYNC cancel()</title>
<para>Stoppt eine aktive Aktion.</para>
</sect2>
<sect2 id="dcop-func-shutdown">
<title>bool shutDown(), bool shutdown()</title>
<para>Fährt das System herunter.</para>
</sect2>
<sect2 id="dcop-func-reboot">
<title>bool reboot()</title>
<para>Startet den Rechner neu.</para>
</sect2>
<sect2 id="dcop-func-lock">
<title>bool lockScreen()</title>
<para>Sperrt den Bildschirm.</para>
</sect2>
<sect2 id="dcop-func-logout">
<title>bool logout()</title>
<para>Beendet die Sitzung und meldet den Benutzer ab.</para>
</sect2>
<sect2 id="dcop-func-config">
<title>ASYNC configure()</title>
<para>[Seit 0.6] Zeigt den Einstellungen Dialog.</para>
</sect2>
<sect2 id="dcop-func-status">
<title>QString getStatusInfo()</title>
<para>Zeigt &kmyapplication; Status Informationen.</para>
</sect2>
<sect2 id="dcop-func-makevisible">
<title>ASYNC makeVisible()</title>
<para>[Since 0.6] Macht das Hauptfenster auf der aktuellen Arbeitsfläche sichtbar.</para>
</sect2>
<sect2 id="dcop-func-test">
<title>ASYNC setTestMode(bool yes)</title>
<para>De-/aktiviert den Testmodus.</para>
<example>
<title>Aktiviert Testmodus</title>
<programlisting>dcop kshutdown KShutdownIface setTestMode true</programlisting>
</example>
<example>
<title>Deaktiviert Testmodus</title>
<programlisting>dcop kshutdown KShutdownIface setTestMode false</programlisting>
</example>
</sect2>
</sect1>
</chapter><!-- dcop -->
<chapter id="credits">
<title>Danksagung und Lizenz</title>
<para>&kmyapplication;</para>
<para>
Program Copyright 2005 Konrad Twardowski
<email>kdtonline@poczta.onet.pl</email>
</para>
<para>
Documentation Copyright © 2005 Konrad Twardowski
<email>kdtonline@poczta.onet.pl</email>
</para>
<para>Czech FAQ Copyright © Robert Kratky</para>
<para>Siehe <guimenuitem>Hilfe | Über &kmyapplication;</guimenuitem> für mehr Informationen.</para>
&underFDL;<!-- FDL: do not remove -->
&underGPL;<!-- GPL License -->
</chapter><!-- credits -->
&documentation.index;
</book>
|