From 6ff11968a5e16fd1fc48956d1cebb7f50d530c73 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Sun, 2 Feb 2014 03:12:44 -0600 Subject: Disabled kcontrol/helpindex.html that was part of the old htmlsearch kcontrol module, deleted doc/kcontrol/tdm handbook that was a duplicate of doc/tdm handbook, nominal update of khelpcenter handbook. --- doc/kcontrol/helpindex/CMakeLists.txt | 2 +- doc/kcontrol/helpindex/Makefile.am | 4 +- doc/kcontrol/tdm/CMakeLists.txt | 12 - doc/kcontrol/tdm/Makefile.am | 2 - doc/kcontrol/tdm/index.docbook | 518 ---------------------------------- doc/khelpcenter/help.docbook | 105 +++++-- 6 files changed, 78 insertions(+), 565 deletions(-) delete mode 100644 doc/kcontrol/tdm/CMakeLists.txt delete mode 100644 doc/kcontrol/tdm/Makefile.am delete mode 100644 doc/kcontrol/tdm/index.docbook (limited to 'doc') 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 @@ - - - -]> - -
- - - -&Thomas.Tanghus; &Thomas.Tanghus.mail; -&Steffen.Hansen; &Steffen.Hansen.mail; -&Mike.McBride; &Mike.McBride.mail; - - - -2002-02-13 -3.00.00 - - -KDE -KControl -TDM configuration -login manager -login - - - - -Login Manager - -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. - -In order to organize all of these options, this module is -divided into six sections: Appearance, -Font, Background, -Sessions, -Users and -Convenience. - -You can switch between the sections using the tabs at the top of -the window. - -If you are not currently logged in as a superuser, you -will need to click the Administrator Mode -Button. You will then be asked for a superuser password. Entering a -correct password will allow you to modify the settings of this -module. - - -Appearance - -From this page you can change the visual appearance of &tdm;, -&tde;'s graphical login manager. - -The greeting string is the title of the login screen. If the -string contains the word HOSTNAME it -will be translated to the domainless name of the machine &tdm; is -installed on. - -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 Logo area. Using the -Positions setting, you can choose to either center -the content of the logo area or to position it using fixed -coordinates. - -If you chose Show logo you can now choose a -logo: - - - -Drop an image file on the image button. - - -Click on the image button and select a new image from the image chooser -dialog. - - - -If you do not specify a logo the default -$TDEDIR/share/apps/tdm/pics/kdelogo.png -will be displayed. - -While &tde;'s style depends on the settings of the user logged in, -the style used by &tdm; can be configured using the GUI -Style option. - -Below that, you have two dropdown boxes to choose the language and the -country for your login box. - - - - -Font - -From this section of the module you can change the fonts used in -the login window. - -You can select three different font styles from the drop down box -(Greeting, Fail, -Standard). When you click on the Change -font button a dialog appears from which you can select the -new characteristics for the font style. - - - -The Greeting font is the font used for the title -(Greeting String). - - -The Fail font is used when a login fails. - - -The Standard font is used in all other places in the -login window. - - - -An example of each font can be seen in the -Example Box. - - - - -Background - -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. - -The background colors and effects are controlled by the options on -the tab labeled Background and you select a -background image and its placement from the options on the tab labeled -Wallpaper. - -To change the default background color(s) simply click either of -the color buttons and select a new color. - -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: - - - -Flat -By choosing this mode, you select one color (using the color -button labeled Color 1), and the entire background is -covered with this one color. - - -Pattern -By choosing this mode, you select two colors (using both color -buttons). You then select a pattern by clicking -Setup. 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 OK, and &tde; will render the pattern -you selected using the two colors you selected. For more on patterns, see the -section Background: Adding, Removing and Modifying -Patterns. - - -Background Program -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 Background: Using an external program. - - -Horizontal Gradient -By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by Color -1 on the left edge of the screen, and slowly transform into the -color selected by Color 2 by the time it gets to the -right edge of the screen. - - -Vertical Gradient -By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by Color -1 on the top edge of the screen, and slowly transform into the color -selected by Color 2 as it moves to the bottom of the -screen. - - -Pyramid Gradient -By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by Color -1 in each corner of the screen, and slowly transform into the color -selected by Color 2 as it moves to the center of the -screen. - - -Pipecross Gradient -By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by Color -1 in each corner of the screen, and slowly transform into the color -selected by Color 2 as it moves to the center of the -screen. The shape of this gradient is different then the pyramid -gradient. - - -Elliptic Gradient -By choosing this mode, you select two colors (using both color -buttons). &tde; will then start with the color selected by Color -2 in the center of the screen, and slowly transform into the color -selected by Color 1 as it moves to the edges, in an -elliptical pattern. - - - -The setup button is only needed for if you select Background -program or Patterns. In these instances, -another window will appear to configure the specifics. -Wallpaper -To select a new background image first, click on the -Wallpapers tab, then you can either select an image from the -drop-down list labeled Wallpaper or select -Browse... and select an image file from a file -selector. - -The image can be displayed in six different ways: - - -No wallpaper -No image is displayed. Just the background colors. - - -Centered -The image will be centered on the screen. The background colors -will be present anywhere the image does not cover. - - -Tiled -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. - - -Center Tiled -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. - - -Centered Maxpect -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. - - - -Scaled -The image will be scaled to fit the desktop. It will be -stretched to fit all four corners. - - - - - - -Sessions - -Allow to shutdown -Use this dropdown box to choose who is allowed to shut down: - - -None: No one can shutdown the computer using &tdm;. -You must be logged in, and execute a command. - - -All: Everyone can shutdown the computer using -&tdm;. - -Root only: &tdm; requires that the -root password be entered before shutting down the -computer. -Console only: The user must be at this -console, to shut down the computer. - - -Commands -Use these 3 blanks to define the exact shutdown command. -The shutdown command defaults to: - -/sbin/shutdown - -The restart command defaults to: - -/sbin/reboot - -The Console mode (which restarts the computer as a console only terminal) -defaults to: - -/sbin/init - -When Show boot options 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 lilo command and to -lilo's map file. - - - -Session types - -Define which session types should be accessible from the login -window. - - For more information on this subject, look at /etc/X11/xdm/Xsession to find your -xdm setup files. Also review the xdm man pages, especially under the SESSION -PROGRAM section. - -To add a session, type its name in the -blank entitled New types, and click -Add new. - -To remove a session, select the session from the list and click -Remove. - - - - - - - -Users - -From here you can change the way users are represented in the -login window. - -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. - -The first thing you must decide, is if you are going to show users -or not. - - -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. - -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. - - -To show (and sort) or not to show users - -Along the right edge of the window are two check boxes: - -If Show users is selected, you have chosen to -show images of users, instead of making them type their login -name. - -If Sort users 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 -Show users is not checked, this has no -effect. - - - - -How to determine which users to show and which users to hide - -Below the user image box, and above the Show -users check box, is a set of two radio buttions: - - -Show only selected users: If this option is selected, only the -users contained in the list labelled Selected Users, will -be displayed in the login window. If Show users is not -checked, this has no effect. -Show all users but no-show users: If this option is selected, -all users will be listed, except those users contained in -the list entitled No show users. If Show -users is not checked, this has no effect. - - - - - -Select users - -This page contains three listboxes. The large listbox on the left -shows all the users on the system which might be a genuine user. - -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. - -To move a user from one listbox to another you click on the -username in the listbox and click >> to -move the user from the left-most box the the right-most box or -<< to move the user from the right-most box -to the left-most box. - - - - -Images - -This section of the manual only applies if Show -users is selected. If it is not, this image box has no -effect. - -Every user on the system can be represented by a image. The image -for the user is kept in a file called -$TDEDIR/share/apps/tdm/pics/users/$USER.xpm. -If the user doesn't have such a file the file -$TDEDIR/share/apps/tdm/pics/users/default.xpm -will be used instead. - -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. - -If no user is currently selected you will be asked if you want to change -the default image. - -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 -not have to press the Apply -button. - - - - - - -Convenience - -In the convenience tab you can configure some -options that make life easier for lazy people, like auto login or -disabling passwords. - -Please think more than twice before using these -options. Every option in the convenience 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. - - -Automatic Login - -Automatic login will give anyone access to a certain account on -your system without doing any authentication. You can enable it using -the option Enable auto-login. - -Automatic login comes in two flavors: truly automatic -login acts like you would expect automatic login to, &ie; -&tdm; will automatically login without expecting any input from the -user. Enable this using the Truly automatic login -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 &Ctrl;&Alt;Backspace. - -You can choose the account to be used for automatic login in the -list below. - - - - -Password-less Login - -Using this feature, you can allow certain users to login without -having to provide their password. Enable this feature using the -Enable password-less logins option. - -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 Enable password-less -logins is enabled, you can move users from one list into the -other, by selecting them and then clicking the ->> and << -buttons. - -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, ⪚ -guest. - -The Automatically login after X server crash -option allows you to skip the authentication procedure when your X -server accidentally crashed. Show previous user -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. - - - - - - - - -
diff --git a/doc/khelpcenter/help.docbook b/doc/khelpcenter/help.docbook index a2ab707e3..fd6e68d34 100644 --- a/doc/khelpcenter/help.docbook +++ b/doc/khelpcenter/help.docbook @@ -189,11 +189,11 @@ contents of either pane. -The Contents pane is further divided into two -tabs, one containing a menu -showing all the help information &khelpcenter; is aware of, and the -other contains the &tde; glossary -of terms. +The Contents pane includes three tabs, the +Contents tab selects the Contents pane, +the Glossary tab opens the &tde; +glossary of terms, and the Search Options +tab allows searching all help handbooks. @@ -234,7 +234,16 @@ installation, configuration and customization, and use. -Application manuals +&tde; Administrator Guide +A reference guide to &tde; features, structure, framework +and configurations useful to administrators. The information also is useful +to single-user systems. + + + + + +Application Manuals Native &tde; application documentation. &tde; applications have @@ -251,6 +260,15 @@ application you are looking for. + +Applet Manuals + + +Similar to Application Manuals but for applets that run in the &tde; panel. + + + + Unix manual pages @@ -422,6 +440,57 @@ some time. + +The Glossary + + +The glossary provides a quick reference point, where you can look up +the definitions of words that may be unfamiliar to you. These range +from &tde; specific applications and technologies, through to general +&UNIX; computing terms. + + + +In the left hand pane you will see a tree view, with two choices: +Alphabetically or By topic. +Both contain the same entries, sorted differently, to allow you to +quickly find the item of interest. + + + +Navigate down the tree views to the left, and items you select will be +displayed on the right. + + + + + +Search Options + +&tde; comes with a lot of documentation for applications and +components. While possible to just browse the manuals until you +find that piece of information you're looking for, this may be a very +time-consuming task. To make this easier for you, &tde; offers +full text search using a program called +ht://dig. It works quite similar to search +engines on the web and some search engines might even use +ht://dig. + +To use ht://dig, select the Search +Options tab in the &khelpcenter; Contents pane, +enter the word you are looking for, then select the Search. + +However, to use this feature, ht://dig +must be installed on your system. If you haven't installed +ht://dig and the package wasn't shipped with your +operating system you have to get ht://dig yourself. Use your package manager +to search for the package. + +To build the search index, at the bottom of the Contents pane, +select the Build Search Index button. + + + The <application>Man</application> and <application>Info</application> sections @@ -478,30 +547,6 @@ one page long. - -The &tde; glossary - - -The glossary provides a quick reference point, where you can look up -the definitions of words that may be unfamiliar to you. These range -from &tde; specific applications and technologies, through to general -&UNIX; computing terms. - - - -In the left hand pane you will see a tree view, with two choices: -Alphabetically or By topic. -Both contain the same entries, sorted differently, to allow you to -quickly find the item of interest. - - - -Navigate down the tree views to the left, and items you select will be -displayed on the right. - - - - The menus and toolbar -- cgit v1.2.1