diff options
Diffstat (limited to 'doc/kcontrol')
| -rw-r--r-- | doc/kcontrol/helpindex/CMakeLists.txt | 2 | ||||
| -rw-r--r-- | doc/kcontrol/helpindex/Makefile.am | 4 | ||||
| -rw-r--r-- | doc/kcontrol/tdm/CMakeLists.txt | 12 | ||||
| -rw-r--r-- | doc/kcontrol/tdm/Makefile.am | 2 | ||||
| -rw-r--r-- | doc/kcontrol/tdm/index.docbook | 518 |
5 files changed, 3 insertions, 535 deletions
diff --git a/doc/kcontrol/helpindex/CMakeLists.txt b/doc/kcontrol/helpindex/CMakeLists.txt index 09158264f..f2c0c72b3 100644 --- a/doc/kcontrol/helpindex/CMakeLists.txt +++ b/doc/kcontrol/helpindex/CMakeLists.txt @@ -9,4 +9,4 @@ # ################################################# -tde_create_handbook( DESTINATION kcontrol/helpindex.html ) +# tde_create_handbook( DESTINATION kcontrol/helpindex ) diff --git a/doc/kcontrol/helpindex/Makefile.am b/doc/kcontrol/helpindex/Makefile.am index 0529b36f5..130eaca75 100644 --- a/doc/kcontrol/helpindex/Makefile.am +++ b/doc/kcontrol/helpindex/Makefile.am @@ -1,2 +1,2 @@ -KDE_LANG = en -KDE_DOCS = kcontrol/helpindex.html +# KDE_LANG = en +# KDE_DOCS = kcontrol/helpindex.html diff --git a/doc/kcontrol/tdm/CMakeLists.txt b/doc/kcontrol/tdm/CMakeLists.txt deleted file mode 100644 index 4bdd0a66d..000000000 --- a/doc/kcontrol/tdm/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( DESTINATION kcontrol/tdm ) diff --git a/doc/kcontrol/tdm/Makefile.am b/doc/kcontrol/tdm/Makefile.am deleted file mode 100644 index c81f42bd9..000000000 --- a/doc/kcontrol/tdm/Makefile.am +++ /dev/null @@ -1,2 +0,0 @@ -KDE_LANG = en -KDE_DOCS = kcontrol/tdm diff --git a/doc/kcontrol/tdm/index.docbook b/doc/kcontrol/tdm/index.docbook deleted file mode 100644 index e4b70de80..000000000 --- a/doc/kcontrol/tdm/index.docbook +++ /dev/null @@ -1,518 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" -"dtd/kdex.dtd" [ -<!ENTITY % addindex "IGNORE"> -<!ENTITY % English "INCLUDE" > <!-- change language only here --> -]> - -<article lang="&language;"> -<articleinfo> - -<authorgroup> -<author>&Thomas.Tanghus; &Thomas.Tanghus.mail;</author> -<author>&Steffen.Hansen; &Steffen.Hansen.mail;</author> -<author>&Mike.McBride; &Mike.McBride.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2002-02-13</date> -<releaseinfo>3.00.00</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>KControl</keyword> -<keyword>TDM configuration</keyword> -<keyword>login manager</keyword> -<keyword>login</keyword> -</keywordset> -</articleinfo> - -<sect1 id="login-manager"> -<title>Login Manager</title> - -<para>Using this module, you can configure the &tde; graphical login -manager, &tdm;. You can change how the login screen looks, who has -access using the login manager and who can shutdown the -computer.</para> - -<para>In order to organize all of these options, this module is -divided into six sections: <link -linkend="tdmconfig-appearance"><guilabel>Appearance</guilabel></link>, -<link linkend="tdmconfig-font"><guilabel>Font</guilabel></link>, <link -linkend="tdmconfig-background"><guilabel>Background</guilabel></link>, -<link -linkend="tdmconfig-sessions"><guilabel>Sessions</guilabel></link>, -<link linkend="tdmconfig-users"><guilabel>Users</guilabel></link> and -<link -linkend="tdmconfig-convenience"><guilabel>Convenience</guilabel></link>.</para> - -<para>You can switch between the sections using the tabs at the top of -the window.</para> - -<note><para>If you are not currently logged in as a superuser, you -will need to click the <guibutton>Administrator Mode</guibutton> -Button. You will then be asked for a superuser password. Entering a -correct password will allow you to modify the settings of this -module.</para></note> - -<sect2 id="tdmconfig-appearance"> -<title>Appearance</title> - -<para>From this page you can change the visual appearance of &tdm;, -&tde;'s graphical login manager.</para> - -<para>The greeting string is the title of the login screen. If the -string contains the word <computeroutput>HOSTNAME</computeroutput> it -will be translated to the domainless name of the machine &tdm; is -installed on.</para> - -<para>You can then choose to show either the current system time, a logo -or nothing special in the login box. Make your choice in the radio -buttons labeled <guilabel>Logo area</guilabel>. Using the -<guilabel>Positions</guilabel> setting, you can choose to either center -the content of the logo area or to position it using fixed -coordinates.</para> - -<para>If you chose <guilabel>Show logo</guilabel> you can now choose a -logo:</para> - -<itemizedlist> -<listitem> -<para>Drop an image file on the image button.</para> -</listitem> -<listitem> -<para>Click on the image button and select a new image from the image chooser -dialog.</para> -</listitem> -</itemizedlist> - -<para>If you do not specify a logo the default -<filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/kdelogo.png</filename> -will be displayed.</para> - -<para>While &tde;'s style depends on the settings of the user logged in, -the style used by &tdm; can be configured using the <guilabel>GUI -Style</guilabel> option.</para> - -<para>Below that, you have two dropdown boxes to choose the language and the -country for your login box.</para> - -</sect2> - -<sect2 id="tdmconfig-font"> -<title>Font</title> - -<para>From this section of the module you can change the fonts used in -the login window.</para> - -<para>You can select three different font styles from the drop down box -(<guilabel>Greeting</guilabel>, <guilabel>Fail</guilabel>, -<guilabel>Standard</guilabel>). When you click on the <guibutton>Change -font</guibutton> button a dialog appears from which you can select the -new characteristics for the font style.</para> - -<itemizedlist> -<listitem> -<para>The <guilabel>Greeting</guilabel> font is the font used for the title -(Greeting String).</para> -</listitem> -<listitem> -<para>The <guilabel>Fail</guilabel> font is used when a login fails.</para> -</listitem> -<listitem> -<para>The <guilabel>Standard</guilabel> font is used in all other places in the -login window.</para> -</listitem> -</itemizedlist> - -<para>An example of each font can be seen in the -<guilabel>Example</guilabel> Box.</para> - -</sect2> - -<sect2 id="tdmconfig-background"> -<title>Background</title> - -<para>Here you can change the desktop background which will be displayed -when a user logs in. You can have a single color or an image as a -background. If you have an image as the background and select center, the -selected background color will be used around the image if it isn't -large enough to cover the entire desktop.</para> - -<para>The background colors and effects are controlled by the options on -the tab labeled <guilabel>Background</guilabel> and you select a -background image and its placement from the options on the tab labeled -<guilabel>Wallpaper</guilabel>.</para> - -<para>To change the default background color(s) simply click either of -the color buttons and select a new color.</para> - -<para>The dropdown box above the color buttons provides you with several -different blend effects. Choose one from the list, and it will be -previewed on the small monitor at the top of the window. Your choices -are:</para> - -<variablelist> -<varlistentry> -<term>Flat</term> -<listitem><para>By choosing this mode, you select one color (using the color -button labeled <guibutton>Color 1</guibutton>), and the entire background is -covered with this one color.</para></listitem> -</varlistentry> -<varlistentry> -<term>Pattern</term> -<listitem><para>By choosing this mode, you select two colors (using both color -buttons).</para> <para>You then select a pattern by clicking -<guilabel>Setup</guilabel>. This opens a new dialog window, which gives you -the opportunity to select a pattern. Simply click once on the pattern of your -choice, then click on <guilabel>OK</guilabel>, and &tde; will render the pattern -you selected using the two colors you selected. For more on patterns, see the -section <ulink url="help:/kcontrol/background/index.html#bkgnd-patterns">Background: Adding, Removing and Modifying -Patterns</ulink>.</para></listitem> -</varlistentry> -<varlistentry> -<term>Background Program</term> -<listitem><para>By selecting this option, you can have &tde; use an external -program to determine the background. This can be any program of your choosing. -For more information on this option, see the section entitled <ulink -url="help:/kcontrol/background/index.html#bkgnd-programs">Background: Using an external program</ulink>.</para></listitem> -</varlistentry> -<varlistentry> -<term>Horizontal Gradient</term> -<listitem><para>By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by <guilabel>Color -1</guilabel> on the left edge of the screen, and slowly transform into the -color selected by <guilabel>Color 2</guilabel> by the time it gets to the -right edge of the screen.</para></listitem> -</varlistentry> -<varlistentry> -<term>Vertical Gradient</term> -<listitem><para>By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by <guilabel>Color -1</guilabel> on the top edge of the screen, and slowly transform into the color -selected by <guilabel>Color 2</guilabel> as it moves to the bottom of the -screen.</para></listitem> -</varlistentry> -<varlistentry> -<term>Pyramid Gradient</term> -<listitem><para>By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by <guilabel>Color -1</guilabel> in each corner of the screen, and slowly transform into the color -selected by <guilabel>Color 2</guilabel> as it moves to the center of the -screen.</para></listitem> -</varlistentry> -<varlistentry> -<term>Pipecross Gradient</term> -<listitem><para>By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by <guilabel>Color -1</guilabel> in each corner of the screen, and slowly transform into the color -selected by <guilabel>Color 2</guilabel> as it moves to the center of the -screen. The <quote>shape</quote> of this gradient is different then the pyramid -gradient.</para></listitem> -</varlistentry> -<varlistentry> -<term>Elliptic Gradient</term> -<listitem><para>By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by <guilabel>Color -2</guilabel> in the center of the screen, and slowly transform into the color -selected by <guilabel>Color 1</guilabel> as it moves to the edges, in an -elliptical pattern.</para></listitem> -</varlistentry> -</variablelist> - -<para>The setup button is only needed for if you select <guilabel>Background -program</guilabel> or <guilabel>Patterns</guilabel>. In these instances, -another window will appear to configure the specifics.</para> -<para><emphasis>Wallpaper</emphasis></para> -<para>To select a new background image first, click on the -<guilabel>Wallpapers</guilabel> tab, then you can either select an image from the -drop-down list labeled <guilabel>Wallpaper</guilabel> or select -<guibutton>Browse...</guibutton> and select an image file from a file -selector.</para> - -<para>The image can be displayed in six different ways:</para> -<variablelist> -<varlistentry> -<term>No wallpaper</term> -<listitem><para>No image is displayed. Just the background colors.</para> -</listitem></varlistentry> -<varlistentry> -<term>Centered</term> -<listitem><para>The image will be centered on the screen. The background colors -will be present anywhere the image does not cover.</para> </listitem> -</varlistentry> -<varlistentry> -<term>Tiled</term> -<listitem><para>The image will be duplicated until it fills the entire -desktop. The first image will be placed in the upper left corner of the screen, -and duplicated downward and to the right.</para> </listitem> -</varlistentry> -<varlistentry> -<term>Center Tiled</term> -<listitem><para>The image will be duplicated until it fills the entire -desktop. The first image will be placed in the center of the screen, and -duplicated upward, downward to the right, and to the left.</para> </listitem> -</varlistentry> -<varlistentry> -<term>Centered Maxpect</term> -<listitem><para>The image will be placed in the center of the screen. It will -be scaled to fit the desktop, but it will not change the aspect ratio of the -original image. This will provide you with an image that is not distorted. -</para> </listitem> -</varlistentry> -<varlistentry> -<term>Scaled</term> -<listitem><para>The image will be scaled to fit the desktop. It will be -stretched to fit all four corners.</para> </listitem> -</varlistentry> -</variablelist> - -</sect2> - -<sect2 id="tdmconfig-sessions"> -<title>Sessions</title> - -<para><guilabel>Allow to shutdown</guilabel></para> -<para>Use this dropdown box to choose who is allowed to shut down:</para> -<itemizedlist> -<listitem> -<para><guilabel>None</guilabel>: No one can shutdown the computer using &tdm;. -You must be logged in, and execute a command.</para> -</listitem> -<listitem> -<para><guilabel>All</guilabel>: Everyone can shutdown the computer using -&tdm;.</para> -</listitem> -<listitem><para><guilabel>Root only</guilabel>: &tdm; requires that the -<systemitem>root</systemitem> password be entered before shutting down the -computer.</para></listitem> -<listitem><para><guilabel>Console only</guilabel>: The user must be at this -console, to shut down the computer.</para></listitem> -</itemizedlist> - -<para><emphasis>Commands</emphasis></para> -<para>Use these 3 blanks to define the exact shutdown command.</para> -<para>The shutdown command defaults to:</para> - -<para><command>/sbin/shutdown</command></para> - -<para>The restart command defaults to:</para> - -<para><command>/sbin/reboot</command></para> - -<para>The Console mode (which restarts the computer as a console only terminal) -defaults to:</para> - -<para><command>/sbin/init <option>3</option></command></para> - -<para>When <guilabel>Show boot options</guilabel> is enabled, &tdm; will on reboot -offer you options for the lilo boot manager. For this feature to work, you will -need to supply the correct paths to your <command>lilo</command> command and to -lilo's map file.</para> - - -<sect3 id="tdmconfig-sess"> -<title>Session types</title> - -<para>Define which session types should be accessible from the login -window.</para> - -<para> For more information on this subject, look at <filename -class="directory">/etc/X11/xdm/Xsession</filename> to find your -<application>xdm</application> setup files. Also review the <ulink -url="man:xdm">xdm man pages</ulink>, especially under the SESSION -PROGRAM section.</para> - -<para>To add a session, type its name in the -blank entitled <guilabel>New types</guilabel>, and click -<guibutton>Add new</guibutton>.</para> - -<para>To remove a session, select the session from the list and click -<guibutton>Remove</guibutton>.</para> - -</sect3> - -</sect2> - - -<sect2 id="tdmconfig-users"> -<title>Users</title> - -<para>From here you can change the way users are represented in the -login window.</para> - -<para>As you look on this window, you will see three lists (All users, -selected users, and no-show users). You also see an image box, and a -set of options along the right side of the window.</para> - -<para>The first thing you must decide, is if you are going to show users -or not.</para> - - -<para>If you choose to show users, then the login window will show -images (which you select), of a list of users. When someone is ready to -login, they select their user name/image, enter their password, and they -are granted access.</para> - -<para>If you choose not to show users, then the login window will be -more traditional. Users will need to type their username, and password -to gain entrance. This is the preferred way if you have many users on -this terminal.</para> - -<sect3 id="tdmconfig-showusers"> -<title>To show (and sort) or not to show users</title> - -<para>Along the right edge of the window are two check boxes:</para> - -<para>If <guilabel>Show users</guilabel> is selected, you have chosen to -show images of users, instead of making them type their login -name.</para> - -<para>If <guilabel>Sort users</guilabel> is selected, then the list of -users will be sorted alphabetically in the login window. If unchecked, -users will be listed in the same order as they are on this page. If -<guilabel>Show users</guilabel> is not checked, this has no -effect.</para> - -</sect3> - -<sect3 id="tdmconfig-whichusers"> -<title>How to determine which users to show and which users to hide</title> - -<para>Below the user image box, and above the <guilabel>Show -users</guilabel> check box, is a set of two radio buttions:</para> - -<itemizedlist> -<listitem><para>Show only selected users: If this option is selected, only the -users contained in the list labelled <guilabel>Selected Users</guilabel>, will -be displayed in the login window. If <guilabel>Show users</guilabel> is not -checked, this has no effect.</para></listitem> -<listitem><para>Show all users but no-show users: If this option is selected, -all users will be listed, <emphasis>except</emphasis> those users contained in -the list entitled <guilabel>No show users</guilabel>. If <guilabel>Show -users</guilabel> is not checked, this has no effect.</para></listitem> -</itemizedlist> - -</sect3> - -<sect3 id="tdmconfig-select"> -<title>Select users</title> - -<para>This page contains three listboxes. The large listbox on the left -shows all the users on the system which might be a genuine user.</para> - -<para>The top right-most listbox shows the selected users and the bottom -right-most listbox shows the users we don't want displayed in the login -window.</para> - -<para>To move a user from one listbox to another you click on the -username in the listbox and click <guibutton>>></guibutton> to -move the user from the left-most box the the right-most box or -<guibutton><<</guibutton> to move the user from the right-most box -to the left-most box.</para> - -</sect3> - -<sect3 id="tdmconfig-image"> -<title>Images</title> - -<note><para>This section of the manual only applies if <guilabel>Show -users</guilabel> is selected. If it is not, this image box has no -effect.</para></note> - -<para>Every user on the system can be represented by a image. The image -for the user is kept in a file called -<filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/$<envar>USER</envar>.xpm.</filename> -If the user doesn't have such a file the file -<filename>$<envar>TDEDIR</envar>/share/apps/tdm/pics/users/default.xpm</filename> -will be used instead.</para> - -<para>To assign a new image to a user just select the user in one of the -listboxes and either drop an imagefile on the image button to the right -or click on the image button and select a new image from the image -selector.</para> - -<para>If no user is currently selected you will be asked if you want to change -the default image.</para> - -<para>The replacement is performed by a &konqueror; process so if the -image file already exists you will be prompted by &konqueror; if you -want to replace it. If you confirm the image will be replaced - you will -<emphasis>not</emphasis> have to press the <guibutton>Apply</guibutton> -button.</para> - -</sect3> -</sect2> - - -<sect2 id="tdmconfig-convenience"> -<title>Convenience</title> - -<para>In the <guilabel>convenience</guilabel> tab you can configure some -options that make life easier for lazy people, like auto login or -disabling passwords.</para> - -<important><para>Please think more than twice before using these -options. Every option in the <guilabel>convenience</guilabel> tab is -well-suited to seriously compromise your system security. Practically, -these options are only to be used in a completely non-critical -environment, ⪚ a private computer at home.</para></important> - -<sect3 id="loginmanager-convenience-autologin"> -<title>Automatic Login</title> - -<para>Automatic login will give anyone access to a certain account on -your system without doing any authentication. You can enable it using -the option <guilabel>Enable auto-login</guilabel>.</para> - -<para>Automatic login comes in two flavors: <guilabel>truly automatic -login</guilabel> acts like you would expect automatic login to, &ie; -&tdm; will automatically login without expecting any input from the -user. Enable this using the <guilabel>Truly automatic login</guilabel> -option. If this option is not enabled, &tdm; will start normally, -enabling you to login as any user, and will only perform automatic login -if you kill the X server, ⪚ by pressing <keycombo -action="simul">&Ctrl;&Alt;<keycap>Backspace</keycap></keycombo>.</para> - -<para>You can choose the account to be used for automatic login in the -list below.</para> - -</sect3> - -<sect3 id="loginmanager-convenience-nopasswd"> -<title>Password-less Login</title> - -<para>Using this feature, you can allow certain users to login without -having to provide their password. Enable this feature using the -<guilabel>Enable password-less logins</guilabel> option.</para> - -<para>Below this option you will see a list of users for which a password -is required, as well as a (by default, empty) list of users that do not -need to provide a password. When <guilabel>Enable password-less -logins</guilabel> is enabled, you can move users from one list into the -other, by selecting them and then clicking the -<guibutton>>></guibutton> and <guibutton><<</guibutton> -buttons.</para> - -<important><para>Again, this option should only be used in a safe -environment. If you enable it on a rather public system you should take -care that only users with heavy access restrictions are granted -password-less login, ⪚ -<systemitem>guest</systemitem>.</para></important> - -<para>The <guilabel>Automatically login after X server crash</guilabel> -option allows you to skip the authentication procedure when your X -server accidentally crashed. <guilabel>Show previous user</guilabel> -will show the name of the last login already entered into the login -field in &tdm;. Some site administrators would consider even this a -possible security weakness, because potential attackers then know at -least one valid login.</para> - - -</sect3> - -</sect2> - -</sect1> - -</article> |