Will leave this thread up and updated every so often, feel free to still comment here as well as work on the Wiki version.
-j
Code:
This is cribbed from the 1.1.2 Read Me written by Ed Peterlin. (hey ed! what copyright does this go under? GPL text?) This is an Alpha level document, mainly because of the 'known limitations' section. I am still looking to get with Eric WRT the fondu parts. There is now some formatting, but i wanted the words up for sure. Items I know i need help with I've tried to mark in BLUE. So editors, start your engines...
Welcome
Please read these instructions carefully to properly install and configure OpenOffice.org 2.0RC3. For future reference you should move this README file onto your hard disk. An FAQ for this release can be found on the NeoWiki (http://neowiki.sixthcrusade.com). This FAQ can provide help for some of the more common issues with this release.
We hope you enjoy working with the new OpenOffice.org 2.0 office suite. Join us online at http://www.openoffice.org!
General Notes
Upgrading from previous versions? Please be sure to read the Upgrading section for important details.
X11 IS REQUIRED: X11 can be found on both of the 10.3 "Panther" and 10.4 "Tiger" install disks. The program is about 40 megs in size and will install in your Utilities folder inside your Applications folder. If you are running 10.3 "Panther, you may also download and install X11 from here: http://www.apple.com/downloads/macosx/apple/x11formacosx.html.
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.
Who Should Use This?
This version of OpenOffice.org 2.0RC3 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.
Even if you are willing to use an X11-based product, please note this version is still being tested! It is not yet a full, stable version of the OpenOffice.org suite.
If you need a something stable for day to day use, either OpenOffice.org 1.1.2 X11 (http://openoffice.org) or NeoOffice/J 1.1 (http://neooffice.org) are available. Both are based on OpenOffice 1.1, and are stable enough for day-to-day use as your primary office productivity suite.
System Requirements
OpenOffice.org X11 2.0RC3 requires:
· Macintosh G4/400 or higher recommended
· Mac OS X 10.3 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.
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.
· Bullets imported from Microsoft Office documents may be different in appearance.
· 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 File > Open menu item 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.
Upgrading from Previous Versions
If you have other versions of OpenOffice.org installed, you will still be able to use them. Unlike OpenOffice.org 1.1.2, OpenOffice.org X11 2.0RC3 is contained in a .app bundle. This includes many of the functions found in "Start OpenOffice.org". When you start 2.0RC3 for the first time, it will as you about importing your preferences from the previous install. This will not overwrite or change those preferences, just import them to the 2.0 application.
Starting OpenOffice.org Manually
To launch OpenOffice.org, simply double click the .app bundle (as you would any other program). It should automatically open X11 for you. If you encounter problems, you may want to try launching OpenOffice.org manually. With your X server running type the following command in the Xterm window (this command assumes you have installed the .app file into your Applications folder):
/Applications/OpenOffice.org2.0.app/contents/openoffice.org/program/soffice
User Support
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:
· http://trinity.neooffice.org
· http://www.ooodocs.org
· http://www.oooforum.org
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.
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.
Getting Involved
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://development.openoffice.org/todo.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.
edited- Nov 16 2005 -added some formatting, updated the note at the top
edited- Nov 21 2005 -fixed program location
Last edited by jakeOSX on Tue Nov 22, 2005 1:47 pm; edited 4 times in total
Joined: Sep 18, 2003 Posts: 434 Location: London, UK
Posted: Wed Nov 16, 2005 11:10 am Post subject:
A few corrections (edits emboldened):
X11 is Required section:
Current: look in the Utilities folder within the Applications folder for a file called X11
Recommended change: look in the Utilities folder within the Applications folder for an application called X11
Who Should Use This?
Current: If you need a something stable
Edit: If you need <a> something stable. (i.e. delete the a)
System Requirements:
Current: Macintosh G4/400 or higher recommended
Edit: Macintosh G4/400MHz or higher recommended
...actually before I go on, any chance of simply making this a wiki article so that we can make the edits directly rather than your having to duplicate the effort.... _________________ PBG4, 1.5GHz, SuperDrive, 1GB RAM, 128MB VRAM, 5400rpm 80GB HD, MacOS X 10.4.5
Posted: Wed Nov 16, 2005 11:16 am Post subject: About this draft of Readme/FAQ
eric->JackOSX
Thank you for your work and your time.
Before to become official, all points of this document need to be verified, and some formulations probably modified : a FAQ must be objective, without personnal opinion.
Please advertise the readers this FAQ is *not official* until a complete verification
Posted: Wed Nov 16, 2005 11:36 am Post subject: Re: About this draft of Readme/FAQ
ericbachard wrote:
Before to become official, all points of this document need to be verified, and some formulations probably modified : a FAQ must be objective, without personnal opinion.
Well, you are the project lead! Now that you have seen the text, feel free to tell us what parts are not correct... _________________ "What do you think of Western Civilization?"
"I think it would be a good idea!"
- Mohandas Karamchand Gandhi
thank you for responding. The major question I have for you is about the fondu conversions and the .app bundle (how does it work?)
also, i pulled the 'known limitations' from the 1.1.2 READ ME. by posting it here I was hoping that those who new if they had been fixed would speak up (and i myself was going to see what I could do).
The hope is, of course, to have a good Read Me for you (being the OpenOffice.org X11 team) to include with your program.
I just checked this URL: it seems the language packs are only for Linux_X86, Solaris_X86 and Windows. Which one (if any) should I choose for my Mac OS X? Please let me kno.
TIA!
Dex
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum You cannot attach files in this forum You cannot download files in this forum