From 11f3dd1d15b41cb813fe4fcdfc57a75da7adc14a Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Sun, 24 Jun 2012 20:59:48 -0500 Subject: Update Help center: Reorganize TOC, rename files; initial update of FAQ, Welcome, Quick Start guides; numerous revisions. --- doc/faq/install.docbook | 170 +++++++++++++++++++++++++++++------------------- 1 file changed, 103 insertions(+), 67 deletions(-) (limited to 'doc/faq/install.docbook') diff --git a/doc/faq/install.docbook b/doc/faq/install.docbook index 0aa323631..0192af04c 100644 --- a/doc/faq/install.docbook +++ b/doc/faq/install.docbook @@ -6,11 +6,11 @@ Installation instructions -These are the generic installation instructions for the K -Desktop Environment. Please complement your reading with the -READMEs and INSTALLs that -come along with the package. Please read them carefully and try to -help yourself out if anything goes wrong. If you need further +These are the generic installation instructions for the Trinity +Desktop Environment. Please complement your reading with the +README and INSTALL text files that +come along with the package. Please read them carefully and try to +help yourself if anything goes wrong. If you need further assistance, consider joining the &tde; mailing lists (see our web site instructions for joining the &tde; mailing @@ -27,12 +27,12 @@ lists) or newsgroups. So you have heard the rumors. Or you have seen the screenshots. -And you are dying to get hold of &tde;. But you know next to nothing -about this whole alternative OS business. Don't worry! +And you are dying to get hold of &tde;. But you know next to nothing +about this whole alternative operating system business. Don't worry! You only need to do some (well, maybe not some) reading, that's all! -&tde; does not run on any version of &Microsoft; &Windows; or OS/2 (yet). To run +&tde; does not run on any version of &Microsoft; &Windows; or OS/2 (yet). To run &tde;, you need to have a &UNIX; system. Please refer to for more details. @@ -43,12 +43,12 @@ url="http://www.kde.org"> runs on many &UNIX; platforms. Finally, you are ready to commence the &tde; installation. -Please start reading from the next section. To get &tde;, please -refer to . Last but not least, if +Please start reading from the next section. To get &tde;, please +refer to . Last but not least, if you encounter any problems while installing &tde;, please do not -hesitate to make use of the &tde; mailing lists and newsgroups. But do bear this in mind: no +linkend="newsgroups">newsgroups. But do bear this in mind: no question is too silly to ask, but some are too silly to answer, especially when they are already answered in this FAQ. Good luck and have fun! @@ -73,7 +73,7 @@ especially when they are already answered in this FAQ. You can find several kinds of binary and source packages for -different distributions and operating systems on the &kde-ftp;. The +different distributions and operating systems on the &kde-ftp;. The binary packages are not made by the &tde; Team, but by the distributors themselves, or some dedicated individuals. Please refer to &tde; Package Policy @@ -97,15 +97,15 @@ Page. -For &tde; 3.4.1, you need the &Qt; library version 3.3 or greater. -Please make sure you download the correct &Qt;. You will +For &tde; 3.4.1, you need the &Qt; library version 3.3 or greater. +Please make sure you download the correct &Qt;. You will also need the header files, if you want to compile &tde; -yourself. They are all available, at no cost, from http://www.trolltech.com/download. In addition, there are optional libraries that might improve &tde; if -installed on your system. An example is OpenSSL which will enable +installed on your system. An example is OpenSSL which will enable &konqueror; to browse web pages securely and is needed in a version ->=0.9.6. These should be provided by your distributor; if not, ask +>=0.9.6. These should be provided by your distributor; if not, ask for an update. @@ -117,7 +117,7 @@ for an update. The base distribution currently consists of twenty -packages. Some are required, while others are optional. Each package +packages. Some are required, while others are optional. Each package is available in each of the aforementioned package formats. @@ -141,7 +141,7 @@ emulator, the control center, the file manager, and the panel. &arts; Required -The &arts; sound server. A powerful, network transparent sound +The &arts; sound server. A powerful, network transparent sound server. @@ -201,7 +201,7 @@ nifty stuff. tdenetwork Optional -Network applications. Currently contains the instant messaging client &kopete;, the +Network applications. Currently contains the instant messaging client &kopete;, the download manager &kget;, and several other network-related programs. @@ -266,7 +266,7 @@ KDE accessibility programs such as a screen magnifier and speech synthesizer fro - + &arts; and then tdelibs should be installed before everything else, and tdeaddons last. The other packages can be installed in any arbitrary order. @@ -316,12 +316,12 @@ every package you want to install. Installation of the source .tar.bz2 files Since there are always changes and updates to the way &tde; is compiled, please -refer to Download and Install from Source for the most up to date installation instructions for the source packages. +refer to Download and Install from Source for the most up to date installation instructions for the source packages. The general approach should work in most cases though. The source .tar.bz2 package installs into /usr/local/kde by default. You can +class="directory">/usr/local/kde by default. You can override this setting by using the option of the configure script. @@ -331,12 +331,12 @@ the configure script. packagename configure the package: ./configure Some packages (notably tdebase) have special configuration -options that might be applicable to your installation. Type +options that might be applicable to your installation. Type ./configure to see the available options. build the package: make install the package: su (if you aren't already root). If you +install" (if you aren't already root). If you already are, just type make . @@ -354,18 +354,18 @@ already are, just type make First of all, please make sure that you have added &tde;'s binary installation folder (⪚ /usr/local/kde/bin) to your PATH -and &tde;'s +and &tde;'s library installation folder to your LD_LIBRARY_PATH (only -necessary on systems that do not support rpath; on &Linux; &ELF;, it -should work without). This environment variable may be called +necessary on systems that do not support rpath; on &Linux; &ELF;, it +should work without). This environment variable may be called differently on some systems, ⪚ it is called -SHLIB_PATH on &IRIX;. Then set the environment variable +SHLIB_PATH on &IRIX;. Then set the environment variable TDEDIR to the base of your &tde; tree, ⪚ /usr/local/kde. Please bear in mind that it is unwise to set -LD_LIBRARY_PATH blindly. In the vast majority of cases it is -unnecessary and can do more harm than good. There is a web page +LD_LIBRARY_PATH blindly. In the vast majority of cases it is +unnecessary and can do more harm than good. There is a web page written by Dave Barr explaining the evils of LD_LIBRARY_PATH and it can be found at $TDEDIR/bin and is therefore in your path. Edit the file .xinitrc in your home folder (make a backup copy first!), remove everything that looks like calling a window -manager, and insert starttde instead. Restart the &X-Server;. If you use +manager, and insert starttde instead. Restart the &X-Server;. If you use &tdm;/xdm, you will have to edit the file .xsession instead of -.xinitrc. And if there is no .xinitrc or .xsession in your home +.xinitrc. And if there is no .xinitrc or .xsession in your home folder, simply create a new one with just one line containing starttde. Some systems (notably &RedHat; &Linux;) use .Xclients instead. -This should present you with a new shining &tde; desktop. You -can now start to explore the wonderful world of &tde;. In case you -want to read some documentation first, there is a highly recommended +This should present you with a new shining &tde; desktop. You +can now start to explore the wonderful world of &tde;. In case you +want to read some documentation first, there is a highly recommended Quick Start -guide available. Furthermore, every application has an online +guide available. Furthermore, every application has an online help that is available via the help menu. @@ -408,7 +408,7 @@ help that is available via the help menu. one? -In principle, this is not necessary. RPM and Debian packages +In principle, this is not necessary. RPM and Debian packages should take care of all dependencies. If you compile the source code yourself, you should take more care. Instructions for running two different versions of &tde; on the same system are @@ -425,11 +425,11 @@ can lead to problems if you are not careful. The most comfortable method to start &tde; is to use the -starttde script. Simply put the line +starttde script. Simply put the line starttde at the end of your .xsession file (or your .xinitrc or .Xclients -file if you are not using &tdm; or xdm). Please -also remove the lines that start your previous window manager. If there is no +file if you are not using &tdm; or xdm). Please +also remove the lines that start your previous window manager. If there is no .xsession, .xinitrc, or .Xclients in your home folder, simply create a new one that contains just one line: starttde. @@ -443,7 +443,7 @@ Why? When your system uses shadow passwords, the screensaver can only -run properly if the suid bit is set. This bit gives the screensavers +run properly if the suid bit is set. This bit gives the screensavers root privileges, which are needed to access the shadow passwords. The screensavers might be configured to secure the machine until the password is entered. @@ -457,7 +457,7 @@ $TDEDIR/bin/*.kss Alternatively, if you compile &tde; from source, you can use ./configure to -configure tdebase. Then the suid bit is set automatically during +configure tdebase. Then the suid bit is set automatically during make install. @@ -467,14 +467,14 @@ configure tdebase. Then the suid bit is set automatically during Is it possible to install &tde; in my home directory? -Yes, you can install &tde; in any folder you want. What you +Yes, you can install &tde; in any folder you want. What you have to do depends on the kind of packages you want to install: Source packages Configure and install the package using configure ; make; make install to install into /home/me. Replace /home/me with your home directory, generally defined in $HOME -Add the following to your init files. Please note that if +Add the following to your init files. Please note that if it is not necessary for you to set LD_LIBRARY_PATH, it is better to leave it out. @@ -490,7 +490,7 @@ endif if ( ! $?LIBRARY_PATH ) then setenv LIBRARY_PATH $LD_LIBRARY_PATH -endif +endif For bash: @@ -504,7 +504,7 @@ export TDEDIR PATH LD_LIBRARY_PATH LIBRARY_PATH <acronym>RPM</acronym> packages rpm allows you to use the option to select the folder you want to -install to. For example, executing rpm Although &tde; will run from a user folder, there are some problems with programs that require suid root, ⪚ the programs in -the tdeadmin package. But since they are not meant to be run by users +the tdeadmin package. But since they are not meant to be run by users in the first place, this is nothing to worry about. However, on systems using shadow passwords, the screensavers have to be suid root to enable password access for unlocking the @@ -525,15 +525,15 @@ screen, so this option will not work. starttde fails with can not connect to X -server. What is wrong? +server. What is wrong? -You probably tried to start the X server with starttde. The X +You probably tried to start the X server with starttde. The X server is started with startx. -starttde is the +starttde is the script that should be run from your .xinitrc, .xsession, or .Xclients to activate the window manager and the necessary server -daemons for &tde;. See also . +daemons for &tde;. See also . @@ -563,7 +563,7 @@ There is also some older information at $HOME/.kde or $HOME/.kde2 subfolder in your home -folder. Copy your +folder. Copy your old .kde/.kde2 folder to a backup location, install &tde; 3.2, and then copy back any necessary mail and news @@ -641,15 +641,15 @@ removing the old .kde folder, without a hitch. You can override the use of $HOME/.kde by setting the -$TDEHOME variable. +$TDEHOME variable. I upgraded &tde; and it seemed to go fine, but when I start it, -I get a blank gray screen, and nothing happens. There are errors in -the console about DCOPserver. What's going on? +I get a blank gray screen, and nothing happens. There are errors in +the console about DCOPserver. What's going on? @@ -668,7 +668,7 @@ These are usually to be found in the following locations: If the symlinks get broken, usually because a cron or shutdown script is emptying out the /tmp folder, then strange -things will happen. These files, and the symlinks, will all be +things will happen. These files, and the symlinks, will all be created automatically at the start of &tde; so you can safely remove them while &tde; is not running. @@ -680,6 +680,42 @@ seconds off your &tde; startup time by doing so. + + +Is TDE backwards or binary compatible with KDE 3? + + +While many programs designed on KDE 3 will compile on Trinity, binary +compatibility with KDE 3 is not a goal of the TDE project. + + + + + +Is TDE backwards or binary compatible with previous releases of TDE? + + +Possibly, but binary compatibility is not a project goal with major point +releases. A package that built on a previous version of TDE but no longer builds +on the current release should be brought to the attention of the developers. + + + + + +Is my KDE3 profile directory compatible with Trinity? + + +Not quite but don't worry. Some "scrubbing" cleanup is required to migrate +a KDE3 profile. For new users or those with little customization we recommend +creating a fresh profile. For those long-time users who cringe at the thought +of recreating their desktop, we provide a migratekde3 shell script. That script +copies a $HOME/.kde3 profile directory to $HOME/.trinity and performs the required +"scrubbing" cleanup. Although the script has been tested we provide the tool "as is" +with no warranties or guarantees. (The script works really well, actually. :-)) + + + Compiling tdebase gives me a bin/sh: msgfmt: command @@ -688,7 +724,7 @@ not found error! You need the &GNU; msgfmt which is part of the &GNU; i18n package gettext. -You should be able to download it from any +You should be able to download it from any &GNU; mirror. @@ -701,7 +737,7 @@ source? You can uninstall your programs by typing make uninstall in the folder where you did make -install. If you have already deleted that folder, +install. If you have already deleted that folder, then there is only one way, and it is not good: go to $TDEDIR/bin and start deleting files one by one. @@ -716,7 +752,7 @@ consider a program such as &GNU; stow, found at What is up with &GIF; support? -This has to do with issues with Unisys' &LZW; patent. &GIF; +This has to do with issues with Unisys' &LZW; patent. &GIF; support is turned off from &Qt; 1.44 onwards by default. When you want to use &GIF;s and have the relevant license, recompile &Qt; with &GIF; support. ./configure . -- cgit v1.2.1