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.

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 (this includes Government, business, educational and private use). For further details see the license text delivered together with OpenOffice.org or http://www.openoffice.org/license.html

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 return and register at any time at http://www.openoffice.org/welcome/registration20.html

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

For help with OpenOffice.org 3.0, search the archives to find questions already answered on 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. Remember to subscribe to the list to get an email response.

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, end 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)

System requirements:

• Microsoft Windows 98, ME, 2000, XP or Vista
• Pentium compatible PC
• 128 MB RAM (256 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 note that copy and paste via clipboard between OpenOffice.org 1.x and OpenOffice.org 2.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 2.0 directly.

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.

Note for Windows 98 users only: If you choose to install Java during the OpenOffice.org installation program, the installer will ask you to reboot your system. You should either ignore this message or open the OpenOffice.org installation program again after the reboot.

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 2.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:

• OpenOffice.org will run on all Intel-based Macs

this one is replaced for PPC Macs by:

• Mac OS X 10.3.9 or higher (which demands a Power Mac G3 Machine and at least 256 MB

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

this one is added for PPC Macs:

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

• Apples X11 must be installed

Problems During Program Startup

If you experience OpenOffice.org startup problems the reason is in most cases due to a missing X11 installation. 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. Close all other programs before starting the installation.

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)

??

Text specific for Solaris (os="SOLARIS")

??