diff options
Diffstat (limited to 'doc/en')
| -rw-r--r-- | doc/en/CMakeLists.txt | 1 | ||||
| -rw-r--r-- | doc/en/index.docbook | 270 | ||||
| -rw-r--r-- | doc/en/mainwindow.png | bin | 0 -> 17770 bytes |
3 files changed, 271 insertions, 0 deletions
diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt new file mode 100644 index 0000000..ba3ef3e --- /dev/null +++ b/doc/en/CMakeLists.txt @@ -0,0 +1 @@ +tde_create_handbook( DESTINATION ${PROJECT_NAME} ) diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..6857dc5 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,270 @@ +<?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 % English "INCLUDE"> +]> + +<book lang="&language;"> + +<bookinfo> + <title>The &kmyapplication; Handbook</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>2006-04-22</date> + <releaseinfo>1.09.00</releaseinfo><!-- sync. with KShutDown version --> + <abstract> + <para>&kmyapplication; is an advanced shut down utility for &kde;.</para> + </abstract> + <keywordset> + <keyword>TDE</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>Introduction</title> + <para>&kmyapplication; is an advanced shut down utility for &kde;.</para> + <para> + Features: + <itemizedlist> + <listitem><para>Turn Off Computer (logout and halt the system)</para></listitem> + <listitem><para>Restart Computer (logout and reboot the system)</para></listitem> + <listitem><para>Lock Session (lock the screen using a screen saver)</para></listitem> + <listitem><para>End Current Session (end the current &kde; session and logout the user)</para></listitem> + <listitem><para>Extras (additional, user commands)</para></listitem> + <listitem><para>Time and delay options</para></listitem> + <listitem><para><link linkend="command-line">Command line</link> and <link linkend="dcop">DCOP</link> support</para></listitem> + <listitem><para><link linkend="using-systray">System tray</link></para></listitem> + <listitem><para>Visual and sound notifications</para></listitem> + <listitem><para><link linkend="kiosk">&kde; Kiosk support</link></para></listitem> + </itemizedlist> + </para> +</chapter><!-- introduction --> + +<chapter id="using-kapp"> + <title>Using &kmyapplication;</title> + <sect1 id="using-mainwindow"> + <title>Main Window</title> + <itemizedlist> + <listitem><para>Use the first combo box to select an action (turn off computer, extras, etc).</para></listitem> + <listitem><para>Use the second combo box to select a delay type (no delay, time from now, etc).</para></listitem> + <listitem><para>Click the <guibutton>Start</guibutton> button to activate the selected action. The action will be executed at the selected time.</para></listitem> + <listitem><para>Click the <guibutton>Stop</guibutton> button or press <keycap>Esc</keycap> key to cancel an active action.</para></listitem> + </itemizedlist> + <screenshot> + <screeninfo>&kmyapplication; main window</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="mainwindow.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Main window</phrase> + </textobject> + </mediaobject> + </screenshot> + </sect1> + <sect1 id="using-systray"> + <title>System Tray</title> + <itemizedlist> + <listitem><para>Left mouse button - hide/show main window</para></listitem> + <listitem><para>Middle mouse button - show menu with Actions (no delay!)</para></listitem> + <listitem><para>Right mouse button - show context menu</para></listitem> + </itemizedlist> + </sect1> +</chapter><!-- using-kapp --> + +<chapter id="command-line"> + <title>Command Line</title> +<!-- copied from the kshutdown command line help --> +<programlisting> +Usage: kshutdown [Qt-options] [TDE-options] [options] [time] + +A Shut Down Utility for TDE + +Generic options: + --help Show help about options + --help-qt Show Qt specific options + --help-kde Show TDE specific options + --help-all Show all options + --author Show author information + -v, --version Show version information + --license Show license information + -- End of options + +Options: + -s, --shutdown Turn off computer + -h, --halt Turn off computer + -r, --reboot Restart computer + -k, --lock Lock session + -l, --logout End current session + -e, --extra <file> Execute "Extras" command (.desktop file) + --confirm Confirm command line action + --standard Show standard logout dialog + -c, --cancel Cancel an active action + --init Don't show window at startup + --test Enable test mode + --default Disable test mode + +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 allows you to control some critical features, such as <guibutton>Turn Off Computer</guibutton> or <guibutton>Restart Computer</guibutton> commands. To enable restrictions, you need to create a global configuration file - <filename>kshutdownrc</filename> in your global &kde; directory (<filename>[prefix]/share/config</filename>). + </para> + <note> + <para>In some cases you need to restart &kmyapplication; to see effects.</para> + </note> + <note> + <para>Since version 0.3.1 Beta all Kiosk keys are prefixed with a "kshutdown_" string.</para> + </note> +<example> +<title>Example kshutdownrc file with restrictions</title> +<programlisting> +[TDE Action Restrictions][$i] +# [$i] - user cannot override this group +# false - feature is disabled +# true - feature is enabled +# by default all features are enabled + +# Disables the "Turn Off Computer" action +kshutdown_action_shutdown=true +# kshutdown_action_shutdown=false <- "false" will disable "Shut Down" action + +# Disables the "Restart Computer" action +kshutdown_action_reboot=true + +# Disables the "Lock Session" action +kshutdown_action_lockscreen=true + +# Disables the "End Current Session" action +kshutdown_action_logout=true + +# Disables the "Extras" action +kshutdown_action_extras=true + +# Disables the "Actions" page in the "Settings" dialog +kshutdown_settings_actions=true + +# Disables the "Select a time" combo box, +# and the command line "time" argument +kshutdown_tab_time=true + +# Disables the "Statistics" dialog +kshutdown_tab_stats=true +</programlisting> +</example> +</chapter><!-- kiosk --> + +<chapter id="dcop"> + <title>DCOP API (KShutdownIface)</title> + <sect1 id="dcop-intro"> + <title>Introduction</title> + <orderedlist> + <listitem><para>Make sure &kmyapplication; is running.</para></listitem> + <listitem><para>Type <command>kshutdown --init</command> to start &kmyapplication; without displaying its main window.</para></listitem> + <listitem><para>To display all DCOP functions, type <command>dcop kshutdown KShutdownIface</command>.</para></listitem> + <listitem><para>Run <command>dcop kshutdown MMainWindow hide</command> to hide the main window.</para></listitem> + <listitem><para>Run <command>dcop kshutdown MMainWindow show</command> to restore the main window.</para></listitem> + </orderedlist> + </sect1> + <sect1 id="dcop-func"> + <title>Functions</title> + <sect2 id="dcop-func-cancel"> + <title>ASYNC cancel()</title> + <para>Cancels the active action.</para> + </sect2> + <sect2 id="dcop-func-shutdown"> + <title>bool shutDown(), bool shutdown()</title> + <para>Shuts down the system.</para> + </sect2> + <sect2 id="dcop-func-reboot"> + <title>bool reboot()</title> + <para>Reboots the system.</para> + </sect2> + <sect2 id="dcop-func-lock"> + <title>bool lockScreen()</title> + <para>Locks the screen using a screen saver.</para> + </sect2> + <sect2 id="dcop-func-logout"> + <title>bool logout()</title> + <para>Logouts the current user and ends the session.</para> + </sect2> + <sect2 id="dcop-func-config"> + <title>ASYNC configure()</title> + <para>[Since 0.6] Shows the settings dialog.</para> + </sect2> + <sect2 id="dcop-func-status"> + <title>QString getStatusInfo()</title> + <para>Returns a &kmyapplication; status information.</para> + </sect2> + <sect2 id="dcop-func-makeinvisible"> + <title>ASYNC makeInvisible()</title> + <para>[Since 0.9 Beta] Hiddes the main window and its system tray icon.</para> + </sect2> + <sect2 id="dcop-func-makevisible"> + <title>ASYNC makeVisible()</title> + <para>[Since 0.6] Shows and raises the main window. The window will be visible on the current desktop.</para> + </sect2> + <sect2 id="dcop-func-test"> + <title>ASYNC setTestMode(bool yes)</title> + <para>Enables/disables the test mode.</para> + <example> + <title>Enable test mode</title> + <programlisting>dcop kshutdown KShutdownIface setTestMode true</programlisting> + </example> + <example> + <title>Disable test mode</title> + <programlisting>dcop kshutdown KShutdownIface setTestMode false</programlisting> + </example> + </sect2> + </sect1> +</chapter><!-- dcop --> + +<chapter id="credits"> + <title>Credits and License</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>See <guimenuitem>Help | About &kmyapplication;</guimenuitem> for more credits.</para> + &underFDL;<!-- FDL: do not remove --> + &underGPL;<!-- GPL License --> +</chapter><!-- credits --> + +&documentation.index; + +</book> diff --git a/doc/en/mainwindow.png b/doc/en/mainwindow.png Binary files differnew file mode 100644 index 0000000..1421909 --- /dev/null +++ b/doc/en/mainwindow.png |
