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/customizing-desktop.docbook | 2 +- doc/userguide/index.docbook | 6 +- doc/userguide/kde-for-admins.docbook | 94 +++++++++++++++---------------- doc/userguide/under-the-hood.docbook | 4 +- doc/userguide/your-kde-account.docbook | 16 +++--- 5 files changed, 61 insertions(+), 61 deletions(-) (limited to 'doc/userguide') diff --git a/doc/userguide/customizing-desktop.docbook b/doc/userguide/customizing-desktop.docbook index 4d095cbdc..8089725d1 100644 --- a/doc/userguide/customizing-desktop.docbook +++ b/doc/userguide/customizing-desktop.docbook @@ -153,7 +153,7 @@ while this may be unnoticeable on very fast systems. To add an IceWM theme, select IceWM as the window decoration and click on the Open &kde;'s IceWM theme folder link in the window decoration description area. This will open a &konqueror; window -to $KDEHOME/share/apps/twin/icewm-themes. +to $TDEHOME/share/apps/twin/icewm-themes. Extract your IceWM theme to this folder. The theme will then be added to the list of IceWM themes. Select the theme you want to use and click on Apply. diff --git a/doc/userguide/index.docbook b/doc/userguide/index.docbook index 66e312069..e9fb63f47 100644 --- a/doc/userguide/index.docbook +++ b/doc/userguide/index.docbook @@ -218,14 +218,14 @@ we're referring to: &kde; prefix &kde; installs into its own folder tree, which you can find by running the command kde-config . This folder is referred to -by the environment variables $KDEDIRS and possibly -$KDEDIR. +by the environment variables $TDEDIRS and possibly +$TDEDIR. &kde; user-specific settings -The environment variable $KDEHOME +The environment variable $TDEHOME points to the folder where &kde; should find user-specific settings. If it is not set, the default value of ~/.kde is used. 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] diff --git a/doc/userguide/under-the-hood.docbook b/doc/userguide/under-the-hood.docbook index 13cd52877..9b08bf449 100644 --- a/doc/userguide/under-the-hood.docbook +++ b/doc/userguide/under-the-hood.docbook @@ -42,7 +42,7 @@ LastFile=/var/tmp/test.txt The user-specific configuration files are stored in .kde/share/config (replace -.kde with your $KDEHOME setting) and +.kde with your $TDEHOME setting) and the global ones are in the share/config sub-directory of &kde;'s installation path. (You can find this path by running the command @@ -64,7 +64,7 @@ crash. So the first rule is to make a backup of your file before modifying it. The backup is better stored outside any .kde subdirectory -(or the corresponding $KDEHOME directory). Backups are anyway +(or the corresponding $TDEHOME directory). Backups are anyway a good idea in case of a major failure of &kde; that would destroy important configuration files (for example your &kmail; settings, which are in in the file kmailrc). diff --git a/doc/userguide/your-kde-account.docbook b/doc/userguide/your-kde-account.docbook index aa37dddac..2864eb4ba 100644 --- a/doc/userguide/your-kde-account.docbook +++ b/doc/userguide/your-kde-account.docbook @@ -29,21 +29,21 @@ applications which should start each time you start &kde;; and .kde/share/apps/kabc, where your address book is stored. - + -The environment variables KDEDIR and -KDEDIRS tell &kde; where its files are stored. You will -usually only need to set KDEDIR to the directory in which +The environment variables TDEDIR and +TDEDIRS tell &kde; where its files are stored. You will +usually only need to set TDEDIR to the directory in which &kde; is installed, but sometimes you might have other &kde; programs installed elsewhere: in this case, you can use the -KDEDIRS environment variable. Set -KDEDIRS to a list of all the directories containing +TDEDIRS environment variable. Set +TDEDIRS to a list of all the directories containing &kde; programs, separated by commas. For example, if you have &kde; programs in both /usr/local/kde and /home/phil/kde, you can use export -KDEDIR=/usr/local/kde,/home/phil/kde if you use +TDEDIR=/usr/local/kde,/home/phil/kde if you use bash or setenv -KDEDIR=/usr/local/kde,/home/phil/kde if you use sh. +TDEDIR=/usr/local/kde,/home/phil/kde if you use sh. -- cgit v1.2.1