OOoRelease30 Readme

Precautions

The readme file delivered with any version OpenOffice.org is not simply a file. Instead, it's generated while building the installation package.

The base file (readme.xrm) therefor is processed by a XSL filter file (readme.xsl) This filter knows some tags which determine if a given paragraph of the readme.xrm file is included in this builds readme.txt/readme.html. All those files can be found in CVS "readlicense_oo".

Available tags to control the output so far are:

gui: UNX | WNT

os: SOLARIS | LINUX | WNT | MACOSX

cpuname: SPARC | INTEL | POWERPC

By that, we finally at the moment have one readme for Windows, one for Linux, one for Mac OSX (PPC and intel with some specific adaptations) and one for Solaris.

We are happy that great portions of this file are common for all platforms.

Frank will modify the readme file for OOo3 final release inside the CWS ooo3readme2. The corresponding issue is i89681. All content changes must be added to this page or to the issue by Tuesday May, 27 2008 to allow for timely localization. Changes coming in after that cannot be incorporated into the release readme file.

Text common for all Platforms

OpenOffice.org 3.0.x ReadMe

For latest updates to this readme file, see www.openoffice.org/welcome/readme.html

We archived the readme file for OpenOffice.org 2.x

---

Dear User

This file contains important information about this program. Please read this information very carefully before starting work.

The OpenOffice.org Community, responsible for the development of this product, would like to invite you to participate as a community member. As a new user, you can check out the OpenOffice.org site with helpful user information at

www.openoffice.org/about_us/introduction.html

Also read the sections below about getting involved in the OpenOffice.org project.

Is OpenOffice.org really free for any user?

OpenOffice.org is free for use by everybody. You may take this copy of OpenOffice.org and install it on as many computers as you like, and use it for any purpose you like (including commercial, government, public administration and educational use). For further details see the license text delivered together with OpenOffice.org or http://www.openoffice.org/license.html

Why is OpenOffice.org really free for any user?

You can use this copy of OpenOffice.org today free of charge because individual contributors aand corporate sponsors have designed, developed, tested, translated, documented, supported, marketed, and helped in many other ways to make OpenOffice.org what it is today - the world's leading open-source office software.

If you appreciate their efforts, and would like to ensure OpenOffice.org continues into the future, please consider contributing to the project - see http://contributing.openoffice.org for details. Everyone has a contribution to make.

Notes on Installation

See the System Requirements page for the latest information.

---

Here goes the Platform specific content shown below

---

Registration

Please take a little time to complete the minimal Product Registration process when you install the software. While registration is optional, we encourage you to register, since the information enables the community to make an even better software suite and address user needs directly. Through its Privacy Policy, the OpenOffice.org Community takes every precaution to safeguard your personal data. If you missed the registration at installation, you can register at any time later by calling "Help/Registration..." from the OpenOffice.org menu.

User Survey

There is also a User Survey located online which we encourage you to fill out. The User Survey results will help OpenOffice.org move more rapidly in setting new standards for the creation of the next-generation office suite. Through its Privacy Policy, the OpenOffice.org Community takes every precaution to safeguard your personal data.

User Support

The main support page http://support.openoffice.org/ offers various possibilities for help with OpenOffice.org 3.0. Your question may have already been answered - check the Community Forum http://user.services.openoffice.org or search the archives of the 'users@openoffice.org' mailing list at http://www.openoffice.org/mail_list.html. Alternatively, you can send in your questions to users@openoffice.org. How to subscribe to the list (to get an email response) is explained on this page: http://wiki.services.openoffice.org/wiki/Website/Content/help/mailinglists. Also check the FAQ section at http://wiki.services.openoffice.org/wiki/Documentation/FAQ.

Report Bugs & Issues

The OpenOffice.org Web site hosts IssueZilla, our mechanism for reporting, tracking and solving bugs and issues. We encourage all users to feel entitled and welcome to report issues that may arise on your particular platform. Energetic reporting of issues is one of the most important contributions that the user community can make to the ongoing development and improvement of the suite.

Getting Involved

The OpenOffice.org Community would very much benefit from your active participation in the development of this important open source project.

As a user, you are already a valuable part of the suite's development process and we would like to encourage you to take an even more active role with a view to being a long-term contributor to the community. Please join and check out the user page at: http://www.openoffice.org

Way to Start

The best way to start contributing is to subscribe to one or more of the mailing lists, lurk for a while, and gradually use the mail archives to familiarize yourself with many of the topics covered since the OpenOffice.org source code was released back in October 2000. When you're comfortable, send an email self-introduction and jump right in. If you are already familiar with open source projects, check out our To-Dos list to see if there is anything you would like to help with at http://development.openoffice.org/todo.html.

Subscribe

Here are a few of the Project mailing lists to which you can subscribe at http://www.openoffice.org/mail_list.html

• News: announce@openoffice.org *recommended to all users* (very light traffic)
• Main user forum: discuss@openoffice.org *easy way to lurk on discussions* (heavy traffic)
• Marketing project: dev@marketing.openoffice.org *beyond development* (light traffic)
• General code contributor list: dev@openoffice.org (moderate/heavy light)

Join One or More Projects

You can make major contributions to this important open source project even if you have limited software design or coding experience. Yes, you!

At http://projects.openoffice.org/index.html you will find projects ranging from Localization, Porting and Groupware to some real core coding projects. If you are not a developer, try the Documentation or the Marketing Project. The OpenOffice.org Marketing Project is applying both guerrilla and traditional commercial techniques to marketing open source software, and we are doing it across language and cultural barriers, so you can help just by spreading the word and telling a friend about this office suite.

You can help by joining the Marketing Communications & Information Network here: http://marketing.openoffice.org/contacts.html where you can provide point communication contact with press, media, government agencies, consultants, schools, Linux Users Groups and developers in your country and local community.

We hope you enjoy working with the new OpenOffice.org 3.0 and will join us online.

The OpenOffice.org Community

Used / Modified Source Code

Portions Copyright 1998, 1999 James Clark. Portions Copyright 1996, 1998 Netscape Communications Corporation.

Text specific for Windows (gui=WNT,os=WNT)

System requirements

• Microsoft 2000, XP or Vista
• Pentium compatible PC
• 256 MB RAM (512 MB RAM recommended)
• 650 MB including Sun JRE (Chinese, Japanese, and Korean versions: 700 MB, multi-language version: 750 MB) available hard disk space during installation
• 500 MB Disk space needed after installation is complete when deleting temporary installer files.
• 800x600 resolution or higher, at least 256 colors

Problems During Program Startup

Difficulties starting OpenOffice.org 3.0 (such as applications hang) as well as problems with the screen display are often caused by the graphics card driver. If these problems occur, please update your graphics card driver or try using the graphics driver delivered with your operating system. Difficulties displaying 3D objects can often be solved by deactivating the option "Use OpenGL" under 'Tools - Options - View - 3D view'.

You can install OpenOffice.org 3.0 alongside of an older version of OpenOffice.org. If you later choose to uninstall the older version of OpenOffice.org, you must call the installation program of the newer version and choose 'Repair'. This ensures that the new version is correctly registered in your system.

Please make sure you have enough disk space in the temporary directory on your system and that read, write and run access rights have been granted. Close all other programs before starting the installation.

Administrator rights are needed for the installation process.

ALPS/Synaptics notebook touchpads in Windows

Due to a Windows driver issue, you cannot scroll through ${PRODUCTNAME} documents when you slide your finger across an ALPS/Synaptics touchpad.

To enable touchpad scrolling, add the following lines to the "C:\Program Files\Synaptics\SynTP\SynTPEnh.ini" configuration file, and restart your computer:

[${PRODUCTNAME}]FC = "SALFRAME"SF = 0x10000000SF |= 0x00004000

Note: The location of the configuration file might vary on different versions of Windows.

Ai Squared ZoomText 7.11

If you want to use Ai Squared ZoomText with OpenOffice.org 3.0 , you need version 7.11 or higher. The date of the Ai Squared ZoomText download must be after June 12, 2002 for it to contain all the necessary program enhancements.

Changing the User Interface Font

In OpenOffice.org you can change the font used for screen display and printing by replacing it with a different font installed on your system. This can be done using the font replacement function. Choose 'Tools - Options - OpenOffice.org - Fonts' to access the font replacement table.

To change the font of the OpenOffice.org user interface, you have to replace the default font "Andale Sans UI" with another font and mark the "always" setting for this replacement.

Refer to the OpenOffice.org Help for a detailed explanation of the dialog.

Shortcut Keys

Only shortcut keys (key combinations) not used by the operating system can be used in OpenOffice.org. If a key combination in OpenOffice.org does not work as described in the OpenOffice.org Help, check if that shortcut is already used by the operating system. To rectify such conflicts, you can change the keys assigned by your operating system. Alternatively, you can change almost any key assignment in OpenOffice.org. For more information on this topic, refer to the OpenOffice.org Help or the Help documentation of your operating system.

Problems When Sending Documents as E-mails From OpenOffice.org

When sending a document via 'File - Send - Document as E-mail' or 'Document as PDF Attachment' problems might occur (program crashes or hangs). This is due to the Windows system file "Mapi" (Messaging Application Programming Interface) which causes problems in some file versions. Unfortunately, the problem cannot be narrowed down to a certain version number. For more information visit [1]to search the Microsoft Knowledge Base for "mapi dll".

Text specific for Mac OS X

System Requirements:

• Mac OS X 10.4 or higher,

• 500 MB (Chinese, Japanese and Korean versions: 600 MB, multi-language version: 800 MB) available hard disk space,

• Additional 150 MB for the *.dmg file containing the installable program; this one can be deleted after installation was sucessfull.

If your machine doesn't meet these minimal requirements, look out for an older Version of OpenOffice.org.

Problems During Program Startup

If you experience OpenOffice.org startup problems please refer to the MAC Porting FAQ http://porting.openoffice.org/mac/faq/index.html

Please note that copy and paste via clipboard between OpenOffice.org 1.x and OpenOffice.org 3.0 might not work in OpenOffice.org format. If that happens, choose 'Edit - Paste Special' and choose a format other than OpenOffice.org, or open the document in OpenOffice.org 3.0 directly.

Please make sure you have enough free disk space in the temporary directory on your system and that read, write and run access rights have been granted.

Shortcut Keys

Only shortcut keys (key combinations) not used by the operating system can be used in OpenOffice.org. If a key combination in OpenOffice.org does not work as described in the OpenOffice.org Help, check if that shortcut is already used by the operating system. To rectify such conflicts, you can change the keys assigned by your operating system. Alternatively, you can change almost any key assignment in OpenOffice.org. For more information on this topic, refer to the OpenOffice.org Help or the Help documentation of your operating system.

File Locking

In the default setting, file locking is turned on in OpenOffice.org. To deactivate it, you have to set the appropriate environment variables SAL_ENABLE_FILE_LOCKING=0 and export SAL_ENABLE_FILE_LOCKING. These entries are already in enabled form in the soffice script file.

Warning: The activated file locking feature can cause problems with Solaris 2.5.1 and 2.7 used in conjunction with Linux NFS 2.0. If your system environment has these parameters, we strongly recommend that you avoid using the file locking feature. Otherwise, OpenOffice.org will hang when you try to open a file from a NFS mounted directory from a Linux computer.

Text specific for Linux (gui=UNX)

There is a wide variety of Linux distributions, and even within the same distribution there may be different installation options (KDE vs Gnome, etc.). Some distributions ship with their own ‘native’ version of OpenOffice.org, which may have different features from this Community OpenOffice.org. Sometimes you can install the Community OpenOffice.org alongside the ‘native’ version. However, it’s usually safer to remove the ‘native’ version before installing this Community version. Consult the documentation for your distribution for details of how to do this.

Warning: we recommend that you always backup your system before you remove or install software.

The following content will not be added to the readme. I suggest that we pu these instructions online or include it in a setup guide. -- Frank

The following instructions assume that you have a certain level of technical knowledge, that you have administrator (root) access to your system, and you are confident working at the command prompt.

Installation in RPM-based Distributions

Many popular distributions use the RedHat Package Manager (RPM), such as RedHat, Fedora, OpenSUSE, etc. If your Linux distribution is one of these, please read the man rpms page that comes with your distribution and select the options that best apply to your situation. The example below will either install OpenOffice.org for the first time or upgrade an existing copy. There are many, many other options available for rpm – e.g. to allow you to change the installation directory from the OpenOffice.org default of /opt.

1. Uncompress the download file, e.g. tar -xvzf OOo_3.0_LinuxIntel_install_wJRE_en-US. tar.gz (note - the file name will vary depending on which version you downloaded)
2. su to root, if necessary.
3. Locate the directory where the rpms have been extracted. This path will be referred to in this documentation as <path_to_rpms>
4. To install OpenOffice.org, run rpm -Uvh <path_to_rpms>open* (replacing <path_to_rpms> with the path from the previous step)
5. You may optionally choose to include OpenOffice.org in your desktop settings (menus, etc). Check the contents of the desktop-integration directory and run rpm -Uvh <path_to_rpms>/desktop-integration/... for the menu rpm that applies to your system. For example, on a RedHat-based system, you would use rpm -Uvh openoffice.org-redhat-menus-<release>.noarch.rpm or similar.

Installation in Debian based Distributions

Another group of popular Linux distributions (e.g. Ubuntu) are based on Debian Linux. If your Linux distribution is one of these, please read the man dpkg page that comes with your distribution and select the options that best apply to your situation. The example below will either install OpenOffice.org for the first time or upgrade an existing copy. There are many, many other options available for dpkg.

1. Uncompress the download file, e.g. tar -xvzf OOo_3.0_LinuxIntel_install_en-US_deb.tar.gz (note - the file name will vary depending on which version you downloaded)
2. su to root, if necessary.
3. Locate the directory where the debs have been extracted. This path will be referred to in this documentation as <path_to_debs>
4. To install OpenOffice.org, run sudo dpkg --install <path_to_debs>open* (replacing <path_to_debs> with the path from the previous step)
5. You may optionally choose to include OpenOffice.org in your desktop settings (menus, etc). Check the contents of the desktop-integration directory and run sudo dpkg --install <path_to_debs>/desktop-integration/openoffice.org-debian-menus*

Installation in Debian-based Distributions from RPMs

If your copy of OpenOffice.org software is in the RPM format, it may still be possible to use these RPMs on a Debian-based system using the alien utility. Note: to install alien use your standard install command such as sudo apt-get install alien or Synaptic.

Please read the man alien page that comes with your distribution and select the options that best apply to your situation.

1. Uncompress the download file, e.g. tar -xvzf OOo_3.0_LinuxIntel_install_wJRE_en-US.tar.gz (note - the file name will vary depending on which version you downloaded)
2. su to root, if necessary.
3. Locate the directory where the rpms have been extracted. This path will be referred to in this documentation as <path_to_rpms>
4. To install OpenOffice.org, run sudo alien -i <path_to_rpms>open* to produce and install .deb packages (replacing <path_to_rpms> with the path from the previous step). This may take a long time and not generate any progress messages.
5. You may optionally choose to include OpenOffice.org in your desktop settings (menus, etc). Check the contents of the desktop-integration directory and execute alien -i <path_to_rpms>/desktop-integration/... for the menu rpm that applies to your system. For example, on a Debian-based system, you would use alien -i <path_to_rpms>/desktop-integration/openoffice.org-debian-menus-<release>.noarch.rpm or similar.
6. You may optionally choose to install Java if you do not already have it installed on your system (Java is required for some features such as Base, some Wizards, etc.). To install Java, run alien -i <path_to_rpms>jvm*

Text specific for Solaris (os="SOLARIS")

??