From 6723d581f9777be5206619112a30122439c0ee95 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Wed, 7 Dec 2011 19:07:19 -0600 Subject: Rename KDEHOME and KDEDIR --- doc/userguide/kde-for-admins.docbook | 94 ++++++++++++++++++------------------ 1 file changed, 47 insertions(+), 47 deletions(-) (limited to 'doc/userguide/kde-for-admins.docbook') diff --git a/doc/userguide/kde-for-admins.docbook b/doc/userguide/kde-for-admins.docbook index 47195f284..12bdd50c5 100644 --- a/doc/userguide/kde-for-admins.docbook +++ b/doc/userguide/kde-for-admins.docbook @@ -142,7 +142,7 @@ Position=10,10 Comment -KDEHOME +TDEHOME ~/.kde @@ -151,12 +151,12 @@ Position=10,10 KDEROOTHOME /root/.kde Different variable to prevent -root writing to $KDEHOME of the user after running +root writing to $TDEHOME of the user after running su. -KDEDIR +TDEDIR /opt/trinity, /usr, /usr/trinity @@ -165,27 +165,27 @@ compiled-in default. -KDEDIRS +TDEDIRS /opt/trinity, /usr, /usr/trinity New in &kde;3. Can list multiple locations separated by a -colon. If not set, falls back to $KDEDIR +colon. If not set, falls back to $TDEDIR Don't need to be set, defaults work just fine. -Running &kde;2 next to &kde;3? Point $KDEDIR to -&kde; 2 and $KDEDIRS to &kde; 3. +Running &kde;2 next to &kde;3? Point $TDEDIR to +&kde; 2 and $TDEDIRS to &kde; 3. A staff member at a university could have the following settings: -KDEHOME='~/.trinity' +TDEHOME='~/.trinity' KDEROOTHOME='/root/.trinity' -KDEDIRS='/opt/kde_staff:/opt/trinity' +TDEDIRS='/opt/kde_staff:/opt/trinity' @@ -251,7 +251,7 @@ bastian=staff Directories that are not relevant for a certain tree, or simply not used can be left out though. For example, directories used for temporary files are usually only found under $KDEHOME but not in any other +class="directory">$TDEHOME but not in any other directory tree. @@ -323,7 +323,7 @@ This file is read by all &kde; applications. class="directory">share/config/session This directory is used by session management and is normally only available under $KDEHOME. At the end of a +class="directory">$TDEHOME. At the end of a session &kde; applications store their state here. The file names consist of the name of the application followed by a number. The session manager ksmserver stores references to @@ -418,7 +418,7 @@ the following symlinks and directories will be created using the -$KDEHOME/socket-$HOSTNAME +$TDEHOME/socket-$HOSTNAME Usually /tmp/ksocket-$USER/, this is used for various &UNIX; sockets. @@ -426,14 +426,14 @@ is used for various &UNIX; sockets. -$KDEHOME/tmp-$HOSTNAME +$TDEHOME/tmp-$HOSTNAME Usually /tmp/kde-$USER/, this is used for temporary files. -$KDEHOME/cache-$HOSTNAME +$TDEHOME/cache-$HOSTNAME Usually /var/tmp/kdecache-$USER/, this is used for cached files. @@ -538,7 +538,7 @@ configuration files is combined on a key-by-key basis. If the same key within a certain group is defined in more than one place, the key value read from the directory tree with the highest precedence will be used. Configuration files under $KDEHOME always have the highest +class="directory">$TDEHOME always have the highest precedence. If a key in a certain group is defined multiple times in a single file, the value of the last entry is used. @@ -741,7 +741,7 @@ Caption[fr]=Ma Légende In general the entries that can appear in a configuration file are not documented. With &kde; 3.2 a start has been made to change this. In $KDEDIR/share/config.kcfg, files +class="directory">$TDEDIR/share/config.kcfg, files can be found that provide a formal description of the possible entries in a configuration file. These are used by the new &kde; Configuration Editor when available. @@ -785,7 +785,7 @@ Auto Save Interval=25 &kdm; Always runs as root! Uses -$KDEDIR/share/config/kdmrc and +$TDEDIR/share/config/kdmrc and /etc/X11/xdm/Xservers. The latter contains entries like: @@ -918,7 +918,7 @@ as well as tdeinit loadable modules (KLMs). KLMs work just like binary program files but can be started more efficiently. KLMs live in $KDEDIR/lib/trinity +class="directory">$TDEDIR/lib/trinity The drawback is that programs started this way appear as tdeinit in the output of @@ -1031,7 +1031,7 @@ that klauncher crashed. klauncher can be restarted by restarting tdeinit from a console window. Make sure that $HOME, $DISPLAY and the various -$KDEDIR(S) are set correctly when doing so! +$TDEDIR(S) are set correctly when doing so! @@ -1055,7 +1055,7 @@ the session manager launches auto-start applications and restores applications from the previous session. The applications to auto-start are indicated by .desktop files in the $KDEDIR/share/autostart +class="directory">$TDEDIR/share/autostart directory. Whether or not to auto-start an application can be made conditional upon some configuration entry determined by the X-KDE-autostart-condition entry in the kdesktop in its turn automatically starts applications stored in $KDEHOME/Autostart. kdesktop +class="directory">$TDEHOME/Autostart. kdesktop will automatically open any files stored in this directory including documents, binary files or applications in the form of .desktop files. @@ -1134,7 +1134,7 @@ at the time the session was saved. Sessions are stored in the ksmserverrc configuration file which contains references to application-specific state information. The application-specific state information is saved in $KDEHOME/share/config/session. +class="directory">$TDEHOME/share/config/session. The state information of &twin; contains the location of the application windows of all the other applications in the session. @@ -1149,23 +1149,23 @@ windows of all the other applications in the session. -$KDEDIR +$TDEDIR Has to be set if -KDEDIRS is not set and has to point to the root of the +TDEDIRS is not set and has to point to the root of the &kde; installation tree. Allows &kde; to find its data like icons, menus and libraries. -$KDEDIRS -Overrides KDEDIR and allows you to specify +$TDEDIRS +Overrides TDEDIR and allows you to specify multiple directories where &kde; searches for its data. Useful if you want or have to install some programs to a different prefix than the rest of &kde;. -$KDEHOMEIf +$TDEHOMEIf not set, &kde; uses ~/.kde as the directory where personal data is stored. @@ -1282,7 +1282,7 @@ class="directory">$XDG_DATA_HOME base directory. Default is /usr/local/share/:/usr/share/ -&kde; adds locations from $KDEDIRS and profiles +&kde; adds locations from $TDEDIRS and profiles as well. Used for .desktop and .directory menu files. .desktop files under XDG_CONFIG_HOME base directory. The default is /etc/xdg &kde; adds locations from -$KDEDIRS and profiles as well. Used by .menu descriptions in +$TDEDIRS and profiles as well. Used by .menu descriptions in $XDG_CONFIG_DIRS/menus. @@ -1325,7 +1325,7 @@ as well as tdeinit loadable modules (KLMs). KLMs work just like binary program files but can be started more efficiently. KLMs live in $KDEDIR/lib/trinity +class="directory">$TDEDIR/lib/trinity The drawback is that programs started this way appear as tdeinit in the @@ -1615,11 +1615,11 @@ copied from /etc/skel/Desktop $KDEDIR/apps/kdesktop/Desktop +class="directory">$TDEDIR/apps/kdesktop/Desktop (merged) $KDEDIR/apps/kdesktop/DesktopLinks +class="directory">$TDEDIR/apps/kdesktop/DesktopLinks (copied) Device Icons (dynamically @@ -1704,7 +1704,7 @@ Reader.desktop .menu files describing the menu structure. The files are stored in $KDEDIR/etc/xdg/menus and +class="directory">$TDEDIR/etc/xdg/menus and /etc/xdg/menus. These store the system-wide menu structure and are controlled by $XDG_CONFIG_DIRS. http://www.freedesktop.o .desktop files describe the applications and are stored in: $KDEDIR/share/applications, +class="directory">$TDEDIR/share/applications, /usr/share/applications, /usr/local/share/applications. These are @@ -1733,7 +1733,7 @@ url="http://www.freedesktop.org/Standards/basedir-spec">http://www.freedesktop.o .directory files describing the sub-menus are stored in: $KDEDIR/share/desktop-directories, +class="directory">$TDEDIR/share/desktop-directories, /usr/share/desktop-directories, /usr/local/share/desktop-directories. These are the system-wide menu .directory file Essential Menus $KDEDIR/etc/xdg/menus/applications-merged/ +class="directory">$TDEDIR/etc/xdg/menus/applications-merged/ contains kde-essential.menu which includes some essential menus that are normally not shown in the &kde; menu itself: @@ -1813,7 +1813,7 @@ whose contents are defined by kde-screensavers.menu and whose icon and name are defined by kde-system-screensavers.directory. -$KDEDIR/share/desktop-directories/kde-system-screensavers.directory +$TDEDIR/share/desktop-directories/kde-system-screensavers.directory contains: NoDisplay=true @@ -1828,7 +1828,7 @@ NoDisplay=true &kde; continues to support old-style menus that are defined by the directory structures in $KDEDIR/share/applnk +class="directory">$TDEDIR/share/applnk (system wide) and $HOME/.kde/share/applnk (user specific). This is observed unless the .desktop file has a Categories= line. In that case the categories determine the location in the menu. @@ -1854,7 +1854,7 @@ CheckSycoca=false -To force regeneration, run touch $KDEDIR/share/services/update_ksycoca. +To force regeneration, run touch $TDEDIR/share/services/update_ksycoca. @@ -1918,7 +1918,7 @@ and the following special buttons: File associations associate a file type with an application or applications. The type of a file is established by determining its &MIME; type. &MIME; types known by &kde; are stored in $KDEDIR/share/mimelnk and +class="directory">$TDEDIR/share/mimelnk and each application's .desktop file contains a list of &MIME; types supported by that application. @@ -2046,7 +2046,7 @@ shell_access=false Since this affects the &kde; menu and the available applications, we must force an update of the sycoca database: -touch $KDEDIR/share/services/update_ksycoca +touch $TDEDIR/share/services/update_ksycoca Now re-login to &kde; and check the following points: @@ -2263,12 +2263,12 @@ ftp Information about protocols is stored in *.protocol files stored in $KDEDIR/share/services. +class="directory">$TDEDIR/share/services. The = entry defines the group a protocol is part of: grep -$KDEDIR/share/services/*.protocol +$TDEDIR/share/services/*.protocol General rules: @@ -2317,7 +2317,7 @@ menu. The modules that are visible in the Control Center normally have a .desktop file in $KDEDIR/share/applications/kde +class="directory">$TDEDIR/share/applications/kde and are sorted under the hidden Settings-Modules menu by the kde-settings.menu, included from kde-essential.menu @@ -2325,7 +2325,7 @@ the kde-settings.menu, included from Application specific modules normally have a .desktop file under -$KDEDIR/share/applnk/.hidden which +$TDEDIR/share/applnk/.hidden which corresponds to the hidden .hidden menu, included as a result of <KDELegacyDirs/> kbuildsycoca 2> /dev/null | grep .hidden @@ -2356,7 +2356,7 @@ there. Making it Work Making It Work -KDE 3.2: Set $KDEDIRS from starttde script +KDE 3.2: Set $TDEDIRS from starttde script Distribute profiles to all clients @@ -2604,7 +2604,7 @@ of &UNIX; shell scripting with the ease of use of &kde;. kdialog Saves whether to show again in -$KDEHOME/share/config/myfile (by writing +$TDEHOME/share/config/myfile (by writing into this file the following lines: [Notification Messages] -- cgit v1.2.1