User manual OPEN OFFICE OPENOFFICE.ORG 2.0 - SETUP GUIDE

OpenOffice.org 2.0 Setup Guide [Setup Guide 2.0] [0.22] First edition: [2005-02-24] First English edition: [2005-02-24]] OpenOffice.org 2.0 Setup Guide i Contents Contents Contents..............................................................................................................................................2 Overview............................................................................................................................................4 Copyright and trademark information............................................................................................4 Feedback........................................................................................................................................4 Acknowledgments.........................................................................................................................4 Modifications and updates.............................................................................................................5 General Installation Information.........................................................................................................1 RPM-based Installation......................................................................................................................3 Installation......................................................................................................................................3 Removal.........................................................................................................................................3 Debian-based Installation...................................................................................................................5 Installing .debs...............................................................................................................................5 Removing .debs.............................................................................................................................5 Installing from Linux RPMs..........................................................................................................5 Solaris Installation..............................................................................................................................7 Installation......................................................................................................................................7 Removal.........................................................................................................................................7 FreeBSD Installation..........................................................................................................................9 Quick method.................................................................................................................................9 Removal.........................................................................................................................................9 Gentoo installation............................................................................................................................11 Slackware Installation.......................................................................................................................13 Uninstalling .................................................................................................................................13 Installation on Other UNIX systems.................................................................................................15 Mac OS X Installation......................................................................................................................17 Windows® 98/ME/NT/2000/XP Installation..................................................................................21 Single-User Installation...............................................................................................................21 Multiple User Environment under Windows NT/2000/XP.........................................................23 Workstation installation from a Multi-user install.......................................................................27 OpenOffice.org 2.0 Setup Guide ii Contents Customizing an Installation..............................................................................................................31 Autoinstallation............................................................................................................................31 Manual Integration with the Desktop..........................................................................................31 Public Documentation License, Version 1.0....................................................................................33 OpenOffice.org 2.0 Setup Guide iii Overview Overview This document is designed to provide users with instructions on installing OpenOffice.org2.0 and its successors on their systems. Copyright and trademark information The contents of this Documentation are subject to the Public Documentation License, Version 1.0 (the "License"); you may only use this Documentation if you comply with the terms of this License. A copy of the License is available at: http://www.openoffice.org/licenses/PDL.rtf The Original Documentation is Setup Guide 2.0. The Initial Writer(s) of the Original Documentation is/are G. Roderick Singleton © 2005. All Rights Reserved. (Initial Writer contact(s):G. Roderick Singleton.) Contributor(s): Jacqueline McNally, Sophie Gautier_________________________________. Portions created by G. Roderick Singleton are Copyright © 2005. All Rights Reserved. (Contributor contact(s):G. Roderick Singleton. All trademarks within this guide belong to legitimate owners. [Note: a copy of the PDL is included in this template and is also available at: http://www.openoffice.org/licenses/PDL.rtf.] Feedback Please direct any comments or suggestions about this document to: grsingleton@openoffice.org Acknowledgments Derek Dreger for taking care of the 1.x.x Setup Guides. mantas@openoffice.org for debian install from rpm, Jaqueline for Windows, Shaun McDonald for the Mac graphics, maveric@openoffice.org and too many others to mention individually. OpenOffice.org 2.0 Setup Guide iv Overview Modifications and updates Version [0.4] [0.5] [0.6] [0.8] [0.9] [0.B] [0.12] [0.13] [0.14] [0.15a] [0.16] [0.17] [0.18] [0.19] [0.20] [0.21] Date [2005-03-10] [2005-03-12] [2005-04-15] [2005-04-26] [2005-04-29] [2005-05-09] [2005-07-07] [2005-07-19] 2005-07-24] [2005-08-18] [2005-08-29] [2005-08-31] [2005-09-05] [2005-09-07] [2005-09-20] [2005-10-02] Description of Change [grs: 4th edition issued for comment] [Jacqueline: 5th edition added draft Windows material] [grs: 6th edition added removal information] [grs: 8th edition spell checked and fixed PDL and corrected] [grs: 9th updates, especially for Mac OS X] [grs: 11th update RPM section] [grs: 12th add info on response ] [grs: 13th updated per SG ] [grs: 14th updated per OooAuthors suggestions ] [Markomlm/grs: Solaris Part added and minor edits for style] [grs: 16th -- added upgrade from 1.1.x warning] [grs: 17th ­ changed install script hyperlink] [grs: 18th -- fixed typos, removce Ubuntu script note [grs: 19th -- Changed debian section to reflect new filenames [grs: 20th -- Updated to Uhv methos in RPM section [grs: 22nd Updated with Slackware installation ] OpenOffice.org 2.0 Setup Guide v Overview OpenOffice.org 2.0 Setup Guide vi General Installation Information General Installation Information Starting with OpenOffice.org 2.0, installation is done using the native installers available on each system. This means that installation only requires that you unpack the download image and then launch the local tool. Using the native installers will provide better upgrades et cetera. Language packs are mostly available from each Native Language Community and may also be available from http://oootranslation.services.openoffice.org/pub/OpenOffice.org/ plus the appropriate release. For example, http://oootranslation.services.openoffice.org/pub/OpenOffice.org/680m125/ Warning: Please keep in mind that upgrading from 1.1.x to any beta release is NOT recommended, keep the installation of each separate. Further, as stated at http://download.openoffice.org/2.0beta2/index.html, use the beta releases with caution. Use for production work at your own risk. OpenOffice.org 2.0 Setup Guide 1 General Installation Information OpenOffice.org 2.0 Setup Guide 2 RPM-based Installation RPM-based Installation Installation 1. Unpack the downloaded image into a directory. For example,Currently, the following command would unpack into the current directory: tar xvzf Ooo_1.9.xxx_native_LinuxIntel_install.tar.gz where 1.9.xxx could also be 2.0 plus extra text. 1. su to root, if necessary. 2. cd into the directory with the unpacked image. This could be RPMS. 3. Then execute rpm -Uvh *rpm for the standard installation in /opt. If you prefer to install in another directory, try rpm -Uvh --prefix /where/ooo/should/go *.rpm or something similar. When relocating, only relocate the base rpms, in other words, do not include any user interface RPMs as these must go in their default locations for proper system integration. NOTE: Upgrade the core first and then upgrade the user interface. Separating steps 4 and 5 ensures a good upgrade. 4. cd into the desktop-integration directory and execute rpm -Uvh for the menu rpm that applies to your system. For example, on a RedHatbased system, you would use rpm -Uvh openoffice.org-redhat-menus-.noarch.rpm or similar. 5. Download and install any language packs needed for OpenOffice.org. For example, if you relocated Openoffice.org, you need rpm -Uvh --prefix /where/you/put/OOo .rpm Please read the man page for the rpm that comes with your distribution and select the options that best apply to your situation. The examples above are only that, examples. Installing individual components is the same as above but only requires the specific module be installed. For example, install all core rpms and then install those for each module you wish, such as, openoffice.org-impress-2.0.0-1.i586.rpm to install only Impress. Other modules may also be necessary. Note: You may substitute -ihv for -Uhv in any of the above commands to install in upgrade mode. Removal I found the following useful: rpm -qa | grep openoffice > rmlist which records what is installed in the file rmlist. The grep string will, of course, vary according to the release. Edit rmlist for anything you do not want to remove. Then when it OpenOffice.org 2.0 Setup Guide 3 RPM-based Installation is time to remove a release one simply has to enter: rpm -e `cat rmlist` Another method of removing an OpenOffice.org release is to use the xargs utility as follows: rpm -qa openofficeorg\* | xargs rpm --erase --nodeps Warning: Using rpm -e openoffice.org\* does not work. under FC3 or Suse 9.3 and possibly other distributions. Remember with the development and beta releases that it may be best to remove /openoffice* and any $HOME/.openoffice* files and directories before installing a new version. There may be better ways to do this but I find the above effective. Please check http://installation.openoffice.org/source/browse/installation/setup_native/scripts/ for example install and uninstall scripts or use them as a model for your own. OpenOffice.org 2.0 Setup Guide 4 Debian-based Installation Debian-based Installation Installing .debs The simplest way to install the OpenOffice.org package you've downloaded is use the command dpkg -i (short for dpkg ­install). 1. First log on as root or from the GUI, open a root terminal. 2. Type: dpkg -i -­force-overwrite openoffice.org*.deb \ desktop-integration/openoffice.org-debian-menus*.deb and openoffice.org will be installed. If you already had an older version, dpkg will upgrade it rather than installing both versions at once. 3. Install any language packs needed for OpenOffice.org. Removing .debs 4. If you want to remove a package, you have two options. The first is most intuitive: dpkg -r openoffice.org This will remove the openoffice.org package (-r is short for --remove). Note that you give only the 'openoffice.org' for --remove, while --install requires the entire .deb filename. Installing from Linux RPMs 1. Download Ooo_1.9.xxx__install.tar.gz where 1.9.xxx could also be 2.0 plus extra text 1. Unpack downloaded .tar.gz archive, for example with command 'tar xvzf' 2. cd into RPMS subfolder, which will be created after unpacking the .tar.gz 3. Run su (or sudo -s, if your system uses sudo and you are allowed to run a shell as root with sudo -s. For example, Debian-based Ubuntu Linux uses sudo as the default utility that permits a user to become administrator (root) 4. Delete any openoffice.org*menus*.rpm files that do not apply to your system. For example openoffice.org-suse-menus*.rpm and openoffice.org-redhat-menus*.rpm are not for Debian. 5. Install the alien utility for converting RPM packages to native Debian packages (.DEB) with command 'apt-get install alien' or by manually downloading from http://packages.debian.org/alien/. OpenOffice.org 2.0 Setup Guide 5 Debian-based Installation NOTE: alien versions 8.50 and earlier are known not to set the correct file permissions for some files. Please refer to issue 54163 Solution: Use alien version 8.51 or newer or workaround the problem by manually correcting the file-permissions 6. Run command 'alien -k *.rpm' to produce .deb packages 7. Install .deb packages with command dpkg -i -­force-overwrite openoffice.org*.deb Note: Using -­force-overwrite option can prevent errors where files belong to several packages. 8. Optionally install java runtime environment (j2re) from www.blackdown.org 9. Install any language packs needed for OpenOffice.org (also converted to .deb format with alien utility) 10. Exit from administrator (root) shell with command 'exit' 11. Now you can run OpenOffice with the command /opt/openoffice.org1.9./program/soffice' where 1.9.xxx could also be 2.0 plus extra text Note: For those willing to accept development snapshots, there is another possibility, simply grab the debs from ftp://ftp.linux.cz/pub/localization/OpenOffice.org/devel/ in the 680 directory. Pick your release and let us know which works for you. OpenOffice.org 2.0 Setup Guide 6 Solaris Installation Solaris Installation Installation 1. Download Ooo_1.9.xxx_SOLARIS_install.tar.gz where 1.9.xxx could also be 2.0 plus extra text 1. Unpack the downloaded image into a directory. For example, the following command will unpack into the current directory: gunzip -c OOo_*_Solaris*_install.tar.gz | tar -xf - This creates a new subdirectory which includes the installation-files. Use the ls command to find the name of the new directory then usethe cd command to enter it. 2. cd into the packages subfolder. In this Directory you will find the needed packages to install OpenOffice.org and a package for the destop-integration in Gnome. 3. Run su to become the root user. 4. If Gnome is not installed on your system, delete the subdirectory gnome-desktopintegration 5. To permanently avoid recurring queries at the installation, you should produce an admin file with the following content: action=nocheck conflict=nocheck idepend=nocheck. You can do this with the following commands: echo action=nocheck >admin echo conflict=nocheck >>admin echo idepend=nocheck >>admin 6. Install the packages with: pkgadd -a admin -d . openofficeorg* Install any language packs needed for OpenOffice.org. Removal No info. Probably pkgrm OpenOffice.org 2.0 Setup Guide 7 Solaris Installation OpenOffice.org 2.0 Setup Guide 8 FreeBSD Installation FreeBSD Installation This is a quick outline of installation on a FreeBSD system. For a detailed description, please see http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-overview.html. Quick method 1. Download from 2. Unpack from its distribution format (typically a tarball compressed with compress(1), gzip(1), or bzip2(1). 3. pkg_add 4. Install Java as needed. 5. Install any language packs needed for OpenOffice.org. Removal No info. Probably pkg_rm OpenOffice.org 2.0 Setup Guide 9 FreeBSD Installation OpenOffice.org 2.0 Setup Guide 10 Gentoo installation Gentoo installation When 2.0 is released the command to install on Gentoo is emerge openoffice-bin Until such time as a gentoo release is available, users can also install the rpms using the following steps : 1. emerge rpm 2. rpm -i --nodeps openoffice.org-*.rpm Another method, uses rpm2cpio as suggested in the next section. OpenOffice.org 2.0 Setup Guide 11 Gentoo installation OpenOffice.org 2.0 Setup Guide 12 Slackware Installation Slackware Installation Installing from Linux RPMs 1. Download Ooo_1.9.xxx__install.tar.gz where 1.9.xxx could also be 2.0 plus extra text 2. Unpack downloaded .tar.gz archive, for example with command 'tar xvzf' 3. cd into RPMS subfolder, which will be created after unpacking the .tar.gz 4. Run su (or sudo -s, if your system uses sudo and you are allowed to run a shell as root with sudo -s. 5. Delete any openoffice.org*menus*.rpm files that do not apply to your system. For example openoffice.org-debian-menus*.rpm is not for Slackware. 6. Install the rpm2tgz utility, if it is missing, for converting RPM packages to native Slackware packages (.tgz). 7. Running rpm2tgz produces a .tgz file which can be installed using the installpkg or pkgtool utility. 8. Install .tgz packages with either command installpkg or pkgtool. For example, installpkg openoffice.org-base-2.0.0-1.i586.tgz. Repeat as necessary to install all the packages. 9. Use rpm2tgz to convert the desktop integration package and install. 10. Optionally install java runtime environment (j2re). 11. Install any language packs needed for OpenOffice.org (also converted to .tgz format with rpm2tgz utility) 12. Exit from administrator (root) shell with command 'exit' 13. Now you can run OpenOffice with the command /opt/openoffice.org1.9./program/soffice' where 1.9.xxx could also be 2.0 plus extra text Note: Please check paths, permissions and users when using rpm2tgz. Uninstalling 1. Use removepkg openoffice.org to remove the suite. OpenOffice.org 2.0 Setup Guide 13 Slackware Installation OpenOffice.org 2.0 Setup Guide 14 Installation on Other UNIX systems Installation on Other UNIX systems If you have a UNIX distribution that does not have an up-to-date rpm or you are unsure that you system is current and rpm installation is failing, then try the following: a) Use the --nodeps flag to install a rpm without having dependent packages in the rpm database. b) Get and use rpm2cpio to convert the rpm files to cpio archives and then employ cpio to install the software. There is a perl version of rpm2cpio at http://www.iagora.com/~espel/rpm2cpio that should be portable. However, if it fails, try precompiled rpm-package (including rpm2cpio) from ftp://ftp.rpm.org/pub/rpm/dist/rpm-4.1.x/rpm-4.1.i386.tar.gz or get the sources from ftp://ftp.rpm.org/pub/rpm/dist/rpm-4.1.x/rpm-4.1.tar.gz c) Install any language packs needed for OpenOffice.org. OpenOffice.org 2.0 Setup Guide 15 Installation on Other UNIX systems OpenOffice.org 2.0 Setup Guide 16 Mac OS X Installation Mac OS X Installation At the time of writing, 2.0 for MacOS X has not been completed. However the following should be close to what will be the procedure: 1. Log in as an administrator. a) Make sure you have all of the required other open source projects installed properly. You will need XFree86, an X server if you do not choose to use XDarwin, libfreetype 6.2 or newer, and dlcompat. You can use apple's X11.which can be installed from the last install CD with Mac OS X 10.3. b) Check to make sure you have sufficient permissions to write into the destination directory. The installer will place OpenOffice.org into Applications by default. c) Check to see if you have the file libdl.dylib and libdl.0.dylib in the /usr/local/lib directory. This is where the installer expects the file to exist and is the default install location for the OSXGNU dlcompat installer. If you have installed dlcompat through another method (e.g. Fink), you will need to either run the /usr/OSXGNU dlcompat installer or you must find your libdl.dylib library and copy it into the /usr/local/lib directory and create a symlink to libdl.0.dylib in that location. 2. Open the file management program and go to the directory where the Openoffice.org image is located. 3. Run the installer. OpenOffice.org 2.0 Setup Guide 17 Mac OS X Installation 4. You may find the install folder open behind the installer window. (This behaviour may change!) 5. Step through the install procedure as shown below: OpenOffice.org 2.0 Setup Guide 18 Mac OS X Installation OpenOffice.org 2.0 Setup Guide 19 Mac OS X Installation 6. Install any language packs needed for OpenOffice.org. OpenOffice.org 2.0 Setup Guide 20 Windows® 98/ME/NT/2000/XP Installation Windows® 98/ME/NT/2000/XP Installation This section assumes some basic knowledge of Windows and is not intended to be a lesson in Windows administration as there are too many variations. The following step-by-step instructions will allow you to install OpenOffice.org version 2.0 Beta and later releases on a Windows-based system from a downloaded image. If you are installing from a CD, you will not have to unpack the image but, depending upon your Windows release, you may have to copy the installation files from the CD to disk. The first thing you'll want to do is read through these instructions completely, and use the OpenOffice.org site to answer any questions you might have. The site contains documentation for users of all levels, beginner to advanced and is definitely the best place to get information. All new Windows users of OpenOffice.org and even more experienced users should start by e browsing the FAQs. Note: If you will be installing OpenOffice.org on a Windows PC running NT/2000/XP that will be used by more than one user, and all users are to be able to use OpenOffice.org (each user logs in separately), please see Multiple User Environment under Windows NT/2000/XP. Checklist for all installations. 1. Read through these instructions and print them, if desired. 2. Decide whether to install for single users or multiple users. 3. Review the System Requirements for OpenOffice.org use. 4. Unpack the Downloaded OpenOffice.org 2.0 file. 5. Install Java JRE if you need the features that are Java dependent, such as Base. 6. Execute the Installation Program. 7. Run OpenOffice.org 2.0. Single-User Installation Unpack the downloaded OpenOffice.org 2.0 file Either using Windows Explorer or Mozilla/Netscape's Download Manager, navigate to the OpenOffice.org file you downloaded. Windows Explorer users will want to find the file and double-click to launch whichever unpacking program is installed; for example, WinZip, 7zip or XP's native unpacking utility. Alternately, Mozilla/Netscape users will want to open the Download Manager, highlight the file, and click Launch File. In either case, your unpacking utility will start. OpenOffice.org 2.0 Setup Guide 21 Windows® 98/ME/NT/2000/XP Installation Execute the installation program Once the files are unpacked, navigate to this folder, find SETUP.EXE, and double-click to launch the OpenOffice.org installation program. Follow the prompts, and OpenOffice.org will be installed on your system, ready for use. 1. Install Java JRE if you need the features that are Java dependent. 2. Unpack the downloaded OpenOffice.org 2.0 file. Note: Depending on your install set you may be asked if you want OpenOffice.org to be your default Office suite. If you answer "yes" and then change your mind, returning to the prior state is tedious. You need to reassociate all Office filesLogin as administrator and run the installation program. OpenOffice.org 2.0 Setup Guide 22 Windows® 98/ME/NT/2000/XP Installation Multiple User Environment under Windows NT/2000/XP Login as Administrator. 1. Unpack the downloaded image into a directory. 2. Navigate to the directory with the unpacked files. This could be the opened unpacked folder. 3. Then execute "setup.exe". The following graphics show the initial steps: 1. 4. Follow each of the dialogues as they follow. 5. Click Finish on the last dialogue. 6. Logout as Administrator. This action will install OpenOffice.org in multi-user configuration. Each user can then invoke OpenOffice.org from the program menu which will allow the user to configure OpenOffice.org as a workstation copy with no further effort on the part of the user. Note: You will need to use the scroll bar to view all of the license text If you do not wish to accept the license, you will be prompted to confirm this before the installation program closes. 1. Read the license, select "I accept the terms in the license agreement", and click Next. The Customer Information window appears. OpenOffice.org 2.0 Setup Guide 23 Windows® 98/ME/NT/2000/XP Installation You may leave this form blank, or enter your User Name and if applicable, Organization. .If you logged in as administrator you will be prompted to install for all users. 1. Complete Customer Information form and click Next. The Setup Type window appears. 1. Select a setup type (we recommend Complete) and click Next. The File Type window is displayed. OpenOffice.org 2.0 Setup Guide 24 Windows® 98/ME/NT/2000/XP Installation Select the file types that you wish to open with the OpenOffice.org program and click Next... Note: If you change your mind, returning to the prior state is tedious. You will need to re-associate all Office files with the appropriate file type.. For example, in the above window, none of the file types are selected. This means that an existing application or program will start when these file types are opened. To use OpenOffice.org to view, edit and print these file types you will need to start the OpenOffice.org program then open the file by choosing Open from the File menu. To read more about file associations, please see the FAQ on the OpenOffice.org web site. The Ready to Install the Program window is displayed. Click the Back button to return to previous windows to change your installation options. OpenOffice.org 2.0 Setup Guide 25 Windows® 98/ME/NT/2000/XP Installation 1. Click Install to begin the installation process. 1. Click the Finish button when the Installation Wizard Finished window is displayed. 2. If you logged in as administrator, logout. OpenOffice.org 2.0 Setup Guide 26 Windows® 98/ME/NT/2000/XP Installation Workstation installation from a Multi-user install Each user should then invoke OpenOffice.org from the program menu which will allow the user to configure OpenOffice.org as a workstation copy with no further effort on the part of the user. Run OpenOffice.org to ensure that the installation was successful When you first run OpenOffice.org after a successfully installing the program, you will be prompted to accept the license, enter your user name and register your copy. 1. Login using your user account, and if you installed OpenOffice.org successfully it will appear on the Programs sub-menu of the Start menu. 2. Click on one of the OpenOffice.org components (we recommend Writer). The Welcome window is displayed. OpenOffice.org 2.0 Setup Guide 27 Windows® 98/ME/NT/2000/XP Installation 3. Click Next to display the License Agreement window. 4. Scroll to read the license and click Accept to continue. 5. The user information window is displayed. You are prompted to enter your name. This is used in the document properties, templates and when you record changes made to documents. This is useful if you are working on a document with others, but you don't need to complete this information in order to proceed. This information can also be entered later when using the program. 6. Complete the form and click Next to display the Registration window. OpenOffice.org 2.0 Setup Guide 28 Windows® 98/ME/NT/2000/XP Installation You will need to be connected to the Internet if you select "I want to register now" and click Finish. Your browser will display a welcome message on the OpenOffice.org web site and then redirect you to a user survey page. If you are not connected to the Internet, you can choose to register later. Registration of OpenOffice.org and completion of the user survey is optional and is not required for you to ensure full use of OpenOffice.org. Note: Registration of the OpenOffice.org program is completely separate from subscribing to various OpenOffice.org mailing lists and registering yourself with the www.openoffice.org site to submit bugs, enhancement requests and contribute to projects. You have successfully installed and run OpenOffice.org. You should now refer to the on-line help (Help->OpenOffice.org Help) or connect to the Internet to obtain support from the www.openoffice.org web site by clicking the Support tab available from any web page. OpenOffice.org 2.0 Setup Guide 29 Windows® 98/ME/NT/2000/XP Installation OpenOffice.org 2.0 Setup Guide 30 Customizing an Installation. Customizing an Installation. Autoinstallation With OpenOffice.org 1.1x, Response Files could be used to customize an installation. Now with 2.0 using native installers, this option is no longer available for most operating systems. Nonetheless, Windows installer does offer an alternative for customizing as follows: 1. If you only want to make a silent installation, you can use the /qn parameter from msiexec.exe (the Windows Installer service). 2. If you want to change some other default values in the installation wizard, you can use the freely available Orca Tool to edit the Windows Installer database and to create a transformation. Then you can start the installation with a command line like: msiexec.exe /i openoffice.msi /qn TRANSFORMS=myTransform.mst Of course the creation of the transformation requires some knowledge of the Windows Installer database. But for many problems this is not so difficult. Manual Integration with the Desktop 1. Download the tarball that I just made of OpenOffice.org's KDE menu from version 1.1.5: http://www.afolkey2.net/net.tar.bz2 This directory contains all of the icons that you will need, as well as the *.desktop files that make up the actual menu. 2. Edit any .directory & all *.desktop files to reflect the location of the icons that I just told you are located in the tarball that I just gave you the link to. I use the Bluefish HTML editor to do this, since it makes it real easy to make the changes that you need to make on ALL of the files that you need to edit, all at the same time :) Search for Bluefish on freshmeat.net if you don't already have it installed. 3. Open up the directory that you just edited in Konqueror and see if you got the path's to the icons set correctly in each file that you edited. You will know your success if you see icons instead of placeholders :) If this was successful, copy that entire directory to KDEDIR/share/applnk For example, my KDEDIR is "/usr/local/kde-svn" So, as root, I did cp -R /home/steve/Desktop/OpenOffice.org1.9.126/ /usr/local/kde-svn/share/applnk/ where 1.9.xxx could also be 2.0 plus extra text. Fedora Core's default KDE directory is "/usr" So in that case, you'd do "cp 1.9.xxx could also be 2.0 plus extra text. I've never actually done this as a submenu in the KDE start menu, so you might enjoy a OpenOffice.org 2.0 Setup Guide 31 -R /home/steve/Desktop/OpenOffice.org1.9.126/ /usr/share/applnk/" where Customizing an Installation. screenshot to prove that the above instructions work: If you need further instructions, please let me know. After going through all this, it occurs to me that depending on what your abilities are right now, these instructions MIGHT be enough. So I will not bother you unless you contact me. But again, feel free to contact me with any questions about this. I will be eagerly watching the list to see if there is an easier way to do this. Maybe I can locate where the OO.org 2 icons are located..... I've never actually done this as a submenu in the KDE start menu, so you might enjoy a screenshot to prove that the above instructions work: http://www.afolkey2.net/oo-kdemenu.jpg If you need further instructions, please let me know. After going through all this, it occurs to me that depending on what your abilities are right now, these instructions MIGHT be enough. So I will not bother you unless you contact me. But again, feel free to contact me with any questions about this. I will be eagerly watching the list to see if there is an easier way to do this. Maybe I can locate where the OO.org 2 icons are located..... OpenOffice.org 2.0 Setup Guide 32 Public Documentation License, Version 1.0 Public Documentation License, Version 1.0 1.0 DEFINITIONS. 1.1. "Commercial Use" means distribution or otherwise making the Documentation available to a third party. 1.2. "Contributor" means a person or entity who creates or contributes to the creation of Modifications. 1.3. "Documentation" means the Original Documentation or Modifications or the combination of the Original Documentation and Modifications, in each case including portions thereof. 1.4. "Electronic Distribution Mechanism" means a mechanism generally accepted for the electronic transfer of data. 1.5. "Initial Writer" means the individual or entity identified as the Initial Writer in the notice required by the Appendix. 1.6. "Larger Work" means a work which combines Documentation or portions thereof with documentation or other writings not governed by the terms of this License. 1.7. "License" means this document. 1.8. "Modifications" means any addition to or deletion from the substance or structure of either the Original Documentation or any previous Modifications, such as a translation, abridgment, condensation, or any other form in which the Original Documentation or previous Modifications may be recast, transformed or adapted. A work consisting of editorial revisions, annotations, elaborations, and other modifications which, as a whole represent an original work of authorship, is a Modification. For example, when Documentation is released as a series of documents, a Modification is: A. Any addition to or deletion from the contents of the Original Documentation or previous Modifications. B. Any new documentation that contains any part of the Original Documentation or previous Modifications. 1.9. "Original Documentation" means documentation described as Original Documentation in the notice required by the Appendix, and which, at the time of its release under this License is not already Documentation governed by this License. 1.10. "Editable Form" means the preferred form of the Documentation for making Modifications to it. The Documentation can be in an electronic, compressed or archival form, provided the appropriate decompression or dearchiving software is widely available for no charge. 1.11. "You" (or "Your") means an individual or a legal entity exercising rights under, and complying with all of the terms of this License or a future version of this License issued under Section 5.0 ("Versions of the License"). For legal entities, "You" includes any entity which controls, is controlled by, or is under common control with You. For purposes of this definition, "control" means (a) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity. 2.0 LICENSE GRANTS. 2.1 Initial Writer Grant. The Initial Writer hereby grants You a world-wide, royaltyfree, non-exclusive license to use, reproduce, prepare Modifications of, compile, publicly perform, publicly display, demonstrate, market, disclose and distribute the Documentation in any form, on any media or via any Electronic Distribution Mechanism or other method now known or later discovered, and to sublicense the foregoing rights to third parties through multiple tiers of sublicensees in accordance with the terms of this License. The license rights granted in this Section 2.1 ("Initial Writer Grant") are effective on the date Initial Writer first distributes Original Documentation under the terms of this License. 2.2. Contributor Grant. Each Contributor hereby grants You a world-wide, royaltyfree, non-exclusive license to use, reproduce, prepare Modifications of, compile, publicly perform, publicly display, demonstrate, market, disclose and distribute the Documentation in any form, on any media or via any Electronic Distribution Mechanism or other method now known or later discovered, and to sublicense the foregoing rights to third parties through multiple tiers of sublicensees in accordance with the terms of this License. The license rights granted in this Section 2.2 ("Contributor Grant") are effective on the date Contributor first makes Commercial Use of the Documentation. 3.0 DISTRIBUTION OBLIGATIONS. 3.1. Application of License. The Modifications which You create or to which You contribute are governed by the terms of this License, including without limitation Section 2.2 ("Contributor Grant"). The Documentation may be distributed only under the terms of this License or a future version of this License released in accordance with Section 5.0 ("Versions of the License"), and You must include a copy of this License with every copy of the Documentation You distribute. You may not offer or impose any terms that alter or restrict the applicable version of this License or the recipients' rights hereunder. However, You may include an additional document offering the additional rights described in Section 3.5 ("Required Notices"). 3.2. Availability of Documentation. Any Modification which You create or to which You contribute must be made available publicly in Editable Form under the terms of this License via a fixed medium or an accepted Electronic Distribution Mechanism. [Document Title] 33 Public Documentation License, Version 1.0 3.3. Description of Modifications. All Documentation to which You contribute must identify the changes You made to create that Documentation and the date of any change. You must include a prominent statement that the Modification is derived, directly or indirectly, from Original Documentation provided by the Initial Writer and include the name of the Initial Writer in the Documentation or via an electronic link that describes the origin or ownership of the Documentation. The foregoing change documentation may be created by using an electronic program that automatically tracks changes to the Documentation, and such changes must be available publicly for at least five years following release of the changed Documentation. 3.4. Intellectual Property Matters. Contributor represents that Contributor believes that Contributor's Modifications are Contributor's original creation(s) and/or Contributor has sufficient rights to grant the rights conveyed by this License. 3.5. Required Notices. You must duplicate the notice in the Appendix in each file of the Documentation. If it is not possible to put such notice in a particular Documentation file due to its structure, then You must include such notice in a location (such as a relevant directory) where a reader would be likely to look for such a notice, for example, via a hyperlink in each file of the Documentation that takes the reader to a page that describes the origin and ownership of the Documentation. If You created one or more Modification(s) You may add your name as a Contributor to the notice described in the Appendix. You must also duplicate this License in any Documentation file (or with a hyperlink in each file of the Documentation) where You describe recipients' rights or ownership rights. You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations to one or more recipients of Documentation. However, You may do so only on Your own behalf, and not on behalf of the Initial Writer or any Contributor. You must make it absolutely clear than any such warranty, support, indemnity or liability obligation is offered by You alone, and You hereby agree to indemnify the Initial Writer and every Contributor for any liability incurred by the Initial Writer or such Contributor as a result of warranty, support, indemnity or liability terms You offer. 3.6. Larger Works. You may create a Larger Work by combining Documentation with other documents not governed by the terms of this License and distribute the Larger Work as a single product. In such a case, You must make sure the requirements of this License are fulfilled for the Documentation. 4.0 APPLICATION OF THIS LICENSE. This License applies to Documentation to which the Initial Writer has attached this License and the notice in the Appendix. 5.0 VERSIONS OF THE LICENSE. 5.1. New Versions. Initial Writer may publish revised and/or new versions of the License from time to time. Each version will be given a distinguishing version number. 5.2. Effect of New Versions. Once Documentation has been published under a particular version of the License, You may always continue to use it under the terms of that version. You may also choose to use such Documentation under the terms of any subsequent version of the License published by______________________ [Insert name of the foundation, company, Initial Writer, or whoever may modify this License]. No one other than ________________________[Insert name of the foundation, company, Initial Writer, or whoever may modify this License] has the right to modify the terms of this License. Filling in the name of the Initial Writer, Original Documentation or Contributor in the notice described in the Appendix shall not be deemed to be Modifications of this License. 6.0 DISCLAIMER OF WARRANTY. DOCUMENTATION IS PROVIDED UNDER THIS LICENSE ON AN "AS IS'' BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENTATION IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENTATION IS WITH YOU. SHOULD ANY DOCUMENTATION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER OR ANY OTHER CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENTATION IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER. 7.0 TERMINATION. This License and the rights granted hereunder will terminate automatically if You fail to comply with terms herein and fail to cure such breach within 30 days of becoming aware of the breach. All sublicenses to the Documentation which are properly granted shall survive any termination of this License. Provisions which, by their nature, must remain in effect beyond the termination of this License shall survive. 8.0 LIMITATION OF LIABILITY. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE INITIAL WRITER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF DOCUMENTATION, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL [Document Title] 34 Public Documentation License, Version 1.0 OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO THE USE OF THE DOCUMENTATION, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES. 9.0 U.S. GOVERNMENT END USERS. If Documentation is being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), then the Government's rights in Documentation will be only as set forth in this Agreement; this is in accordance with 48 CFR 227.7201 through 227.7202-4 (for Department of Defense (DOD) acquisitions) and with 48 CFR 2.101 and 12.212 (for non-DOD acquisitions). 10.0 MISCELLANEOUS. This License represents the complete agreement concerning the subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. This License shall be governed by California law, excluding its conflict-of-law provisions. With respect to disputes or any litigation relating to this License, the losing party is responsible for costs, including without limitation, court costs and reasonable attorneys' fees and expenses. The application of the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not apply to this License. Appendix Public Documentation License Notice The contents of this Documentation are subject to the Public Documentation License Version 1.0 (the "License"); you may only use this Documentation if you comply with the terms of this License. A copy of the License is available at http://www.openoffice.org/licenses/PDL.rtf. The Original Documentation is _________________. The Initial Writer of the Original Documentation is ______________________ (C) ____. All Rights Reserved. (Initial Writer contact(s):_______________[Insert hyperlink/alias].) Contributor(s): ______________________________________. Portions created by ______ are Copyright (C)_________[Insert year(s)]. All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/alias]). Note: The text of this Appendix may differ slightly from the text of the notices in the files of the Original Documentation. You should use the text of this Appendix rather than the text found in the Original Documentation for Your Modifications. [Document Title] 35