Last updated 2004 June 22 by Edward
Peterlin
Additions/Changes by Waldo, Smokey, Louis
build 061104
Welcome
Please read these instructions carefully to properly install and configure OpenOffice.org 1.1.2. The Installer will place this README file on your hard disk.
Upgrading from previous versions? Please be sure to read the Upgrading section for important details.
Mac OS X 10.2 or above is required. This installer already includes all additional programs required in order to use OpenOffice.org on Mac OS X.
10.3.x "Panther" Note: If Apple X11 is not yet installed, have Install Disc 3 of your OS X retail set handy before installation. If Install Disc 3 is unavailable, you must download and install Apple X11 manually from http://www.apple.com/macosx/features/x11/download/ before continuing. If you are unsure as to whether or not Apple X11 is installed, look in the Utilities folder within the Applications folder for a file called X11. If you do not have it, run the OpenOffice.org installer from a hard drive (if you obtained it on CD instead of downloading it) and have the Panther Install Disk 3 ready to insert when prompted.
We hope you enjoy working with the new OpenOffice.org 1.1.2 office suite. Join us online at http://www.openoffice.org!
This version of OpenOffice.org 1.1.2 requires the X11 windowing system. As such, it does not yet have the standard Mac OS look-and-feel and is targeted for advanced Mac OS X users who are comfortable using X11.
If you are willing to use an X11-based product, this version is now stable enough for day-to-day use as your primary office productivity suite. If you're unfamiliar with the X11 windowing system or require tight integration with the Mac OS X font, imaging, and/or user experience, wait for the native Quartz or Aqua version currently in development.
OpenOffice.org 1.1.2 Mac OS X (X11) requires:
Macintosh G4/400 or higher recommended
Mac OS X 10.2 or higher
256 MB of memory for decent performance. 512 MB recommended.
300 MB free hard drive space for OpenOffice.org
600 MB additional hard drive space for installation of auxiliary applications required to run OpenOffice.org.
1 GB additional free space on your System drive for use as swap space during installation and execution.
XFree86/XDarwin or Apple X11, dlcompat, ESP-Ghostscript 7.05, fondu, and libfreetype 6.2+. The Installer will attempt to detect whether you are missing any of these required components, and if necessary will install them for you.
For a full listing of what's new in 1.1.2, see http://www.openoffice.org/dev_docs/features/1.1/.
Please be aware that the license agreements state that all software is provided AS IS and is not guaranteed fit for any particular purpose. The following are known limitations, but others may exist:
OpenOffice.org does not launch with a blank document. Users must create a blank document using File > New on first launch.
It is not possible to collapse windows in OOo 1.1.2 or have non-floating toolbars due to intentional design changes between 1.0.x and 1.1.x.
OOo is installed in a single-user mode by default. Multiple user accounts, particularly user accounts with networked home directories, may not be fully supported.
PDFs generated by the internal OpenOffice.org PDF exporter may not be 100% compatible with the Apple Preview application.
Keyboard input of "dead keys" required for some foreign language input methods may not function properly.
Full keyboard navigation of menus may not be functional due to Option/Alt being reserved for Macintosh keyboard input.
Accessibility support for Assistive Technologies is not fully implemented.
When used with Apple X11 Beta 0.3, windows may exhibit an unavoidable positioning "creep" by the height of the menubar as they are opened. This may result in dialogs eventually being positioned offscreen after long-term usage. This behaviour is not present in Apple X11 Final for Panther.
Bullets imported from Microsoft Office documents may be different in apperance.
To use ODBC, you must use a jdbc-odbc bridge. Native ODBC is not functional.
Netscape plugins cannot be embedded within OpenOffice.org documents.
Some printers may have corrupt PPDs. Select a generic PPD for your printer, if available. Otherwise, use the PDF Converter to create PDF files that you can print from Preview or Adobe Acrobat.
Paper sizes for some PPDs may not be usable from OOo.
Printing may be incompatible with GhostScript distributions other then ESP-Ghostscript 7.05.
If your printer does not have a PPD, it may not be possible to print from OOo.
It is not possible to open files that are locked on disk. OpenOffice.org will report a general Read/Write error, but not report the file as locked.
Attempting to load a remote file via the Open URL menu or the Open File menu may result in an unexpected error in some cases.
Locally mounted disks and partitions may appear as "network mounts" in file choosers and dialogs.
OOo cannot resolve Mac aliases and will open the alias rather then the file to which it points.
It is not possible to embed Java applets within OpenOffice.org documents.
TWAIN scanner image capture may or may not be functional.
PowerPoint graphics may be corrupted on import.
OLE communication between OOo and other Mac OS X applications is non-functional.
ActiveX control is not supported.
Clipboard data exchange is limited to 128 character plain text copy/paste.
Page sizes set through Format > Page Settings will override defaults for Printer Settings.
Crashes may occur when undoing operations in documents that contain multiple page sizes.
When deleting graphics embedded in tables, other graphics occurring later in the document may need to be re-inserted.
Font face and size for formulas may not be retained across save/load.
Importing Microsoft Office documents containing OLE objects that have their own version histories may result in crashes.
It may not be possible to import "dual format" PowerPoint files that advertise themselves as PP95 files that actually have PP97 formatted contents.
This build has been tested only on Mac OS X 10.2 and higher only. Mac OS X 10.1 and earlier systems are not supported.
Macintosh fonts for foreign languages, particularly languages with multi-byte character sets or non-MacRoman encodings, may not be functional with OOo. TrueType fonts may need to be copied from Windows or other OOo supported operating systems for these languages.
Some symbol/glyph TrueType fonts are incompatible with FreeType 6.2 and may cause bullets or math symbols to be drawn incorrectly or not at all. The problem symbol fonts will need to be replaced with compatible fonts.
Some fonts, particularly Arabic fonts, use kerning, hinting, and glyph substitution that cannot be properly replicated by FreeType.
Fonts that are rendered as X11 screen bitmap fonts will not be antialiased.
Bold and italic text for some TrueType fonts that do not have their own bold and italic variants may not appear.
Some converted fonts may lose metric and kerning information.
To use native Macintosh fonts, the Macintosh fonts must first be converted to plain TrueType format and then added into the OpenOffice.org environment. This installer will attempt to convert many fonts automatically. For fonts that do not get converted automatically, they must be converted manually using the fondu tool. The fondu tool is installed automatically by this installer and is also available for download at http://fondu.sourceforge.net Once a font has had a .ttf file generated for it from fondu, simply copy the .ttf file into /Applications/OpenOffice.org1.1.2/share/fonts/truetype and it will be available in the OpenOffice.org environment. You can use Start OpenOffice.org as a droplet for converting fonts by dropping the dfont directly on Start OOo.
Not all fonts can be properly converted by fondu for use with OOo.
If you have other versions of OpenOffice.org installed, you will need to perform some additional work to properly install OpenOffice.org 1.1.2 on your computer.
If you are upgrading from OpenOffice.org 1.0.3 and no longer need your previous version, please uninstall OpenOffice.org 1.0.3 immediately after installing 1.1.2. That's right, after. By delaying uninstallation of the previous version until after installing 1.1.2, you will be able to retain any fonts and settings from that version. The OpenOffice.org 1.1.2 installer will migrate manually installed fonts from your older installation to the new one. However, you will need to manually re-apply any other changes to the default OpenOffice.org settings.
If you want to retain OpenOffice.org 1.0.3 on your computer, it is recommended that you rename its installation directory. The default name for the 1.0.3 installation folder is OpenOffice.org1.0.3 within the Applications directory. Renaming this folder will allow Start OpenOffice.org to prompt each user account to locate the new 1.1.2 location upon first launch.
If you do not remove or rename the older 1.0.3 folder, Start OpenOffice.org will continue to launch the old version. To fix this, launch Start OpenOffice.org, then select Preferences under the Start OpenOffice.org menu. Next, select the new version as your preferred version. Finally quit the applications and then relaunch Start OpenOffice.org.
If you are upgrading from a previously installed OpenOffice.org Tech Preview or Release Candidate installer, you need to manually uninstall OpenOffice.org 1.1.x from your computer before you can successfully run OpenOffice.org 1.1.2 GM. Remove the OpenOffice.org installation directory as well as the .sversionrc file for each user account. This file is located in each user account's home directory. If the .sversionrc files are not removed, they will not be properly updated to run OpenOffice.org 1.1.2 GM.
If you have manually installed or reconfigured your fonts with a previous installation of OpenOffice.org, keep the truetype folder (in the fonts folder within the share folder) from that previous OpenOffice.org version. To do this, first install OpenOffice.org 1.1.2. Then copy the truetype folder from the previous version over the corresponding folder in the new 1.1.2 installation.
To launch OpenOffice.org, use the included Start OpenOffice.org program by Terry Teague. If you encounter problems, you may want to try launching OpenOffice.org manually. With your X server running, open a Terminal and execute the following four commands (do not include the bullets):
A small community of Mac OS X OpenOffice.org users frequently help newbies install and use OpenOffice.org. Our Web-based support forums are online at:
Since we're volunteers, please read through the forums, this document, and other online documentation first to see if your question has already been answered. End-user questions and feedback are welcome. Please post your questions and test results on the Mac OS X Testing forum on OOodocs.org
Also, be sure to check the Frequently Asked Questions (FAQ) section, found on the left-hand navigation bar of the OpenOffice.org home page. In the Mac OS X Testing forum, you will find testing tips and links to a Standard Test Suite of multi-purpose OOo documents.
For more information specifically about the Mac OS X or other OpenOffice.org ports, visit http://porting.openoffice.org/. Instructions for Mac OS X can be found at http://porting.openoffice.org/mac/. Feel free to stop by, learn, and even lend a helping hand!
We encourage you to fill out our online End User Survey to help OpenOffice.org rapidly set new standards in the next-generation office suite. In accordance with its Privacy Policy, the OpenOffice.org Community takes every precaution to safeguard your personal data.
The OpenOffice.org community would very much benefit from your active participation in the development of this important open-source project. As an end user, you are already a valuable part of the suite's development process, and it's important we hear from you. You can make major contributions-- even if you have limited software design or coding experience.
At http://projects.openoffice.org/index.html, you will find projects ranging from Localization, Porting and Groupware to real core coding projects. If you are not a developer, try the Documentation or the Marketing projects. The Marketing project applies both guerrilla and traditional commercial techniques to marketing open-source software across language and cultural barriers, so you can help just by spreading the word and telling a friend. The Marketing Communications & Information Network at http://marketing.openoffice.org/contacts.html lets you provide point communication contact with press, media, government agencies, consultants, schools, Linux Users Groups and developers in your country and local community.
Consider subscribing via www.openoffice.org/mail_list.html to one or more of the OpenOffice.org mailing lists. Lurk for a while and use the mail archives to familiarize yourself with many of the topics covered since the OpenOffice.org source code was released back in 2000. When you're comfortable, make an E-mail self-introduction and jump right in. If you are familiar with open-source Projects, check out our To-dos list and see if there is anything you would like to help with at http://www.openoffice.org/dev_docs/todos.html.
Here are a few of the mailing lists to which you can subscribe. Following the description of each list is an indication of approximately how much email you should expect.
News: announce@openoffice.org (recommended to all users) - light traffic
Main user forum: discuss@openoffice.org (easy way to lurk on discussions) - heavy
Marketing project: dev@marketing.openoffice.org (beyond development) - getting heavy
General code contributors: dev@openoffice.org - moderate/heavy
Groupware: groupware@whiteboard.openoffice.org - moderate
Developers are encouraged to discuss bugs on the developer mailing list. Advanced Mac OS X and Darwin users are encouraged to post their test results and questions on the Mac OS X Testing forum. The porting team will monitor this forum for bugs and issues to be entered into the OOo IssueZilla system. Feel free to post bugs and issues directly to IssueZilla if you are comfortable with this system.
Whether you are an end user or experienced software developer, the OpenOffice.Org project could use your help. The community is made of people just like you who believe in the value of open source and contribute their time and energy to offer the world a terrific product. We thank you in advance for your contribution.
Special Thanks...
Special thanks to Dan Williams, Riccardo and Kevin for pushing 1.1.2 to completion. Many thanks to the rest of the Mac OS X volunteer porting team for an astounding effort that makes this port possible: Dan B., Scott H., Terry T., Jim W., Chad P., Richard S., Scott D., Patrick L., Meinhard M., Timothy, Eric, Kevin, asxless, Flip, Louis, Stefan, Herbert, Joerg, Smokey, Jake, all of the help from marketing and our testers and all you other volunteers that may not be on this list!
Very special thanks to ZeroG Software for providing InstallAnywhere to build the native Mac OS X installer for OpenOffice.org.
All trademarks are the property of their respective owners.