Welcome to NeoOffice developer notes and announcements
NeoOffice
Developer notes and announcements
 
 

This website is an archive and is no longer active
NeoOffice announcements have moved to the NeoOffice News website


Support
· Forums
· NeoOffice Support
· NeoWiki


Announcements
· Twitter @NeoOffice


Downloads
· Download NeoOffice


  
NeoOffice :: View topic - OO.oX11 RC3 FAQ
OO.oX11 RC3 FAQ
 
   NeoOffice Forum Index -> OpenOffice.org MacOS X X11 Support
View previous topic :: View next topic  
Author Message
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Tue Nov 15, 2005 8:50 am    Post subject: OO.oX11 RC3 FAQ

This has been added to the Wiki:
http://neowiki.sixthcrusade.com/index.php/FAQ_for_OO.oX11_2.0RC3




This will stay up as a draft for now as we work through the editing.

Code:
 this is a first draft. this notice will be removed after this has been looked over by not just me. comments welcome, will be come a part of the wiki after some inspection


FAQ

This is a FAQ (frequently Asked Questions) for OpenOffice.org X11 2.0RC3 (OO.oX11 2.0RC3). The official site for this program is: http://porting.openoffice.org/mac/2.0.0rc3.html

A living online version of this document can be found here:
http://neowiki.sixthcrusade.com/index.php/FAQ_for_OO.oX11_RC3

THIS PROGRAM IS STILL UNDER DEVELOPMENT

This is still beta software. RC in the title stands for 'release candidate'. That means that this software is not yet the full, polished version, but a stable, testable version. To help with testing, report issues you have with this program to dev@porting.openoffice.org.

If you need stable, there are two versions of OpenOffice.org that you can use. OpenOffice.org X11 1.1.2 (http://openoffice.org) and NeoOffice/j 1.1 (http://neooffice.org) are both based on OpenOffice.org 1.1, and are stable and ready for everyday use.

X11 IS REQUIRED TO RUN THIS PROGRAM

What is X11?

X11 is a windowing system for Unix or Linux based systems. Basically it provides the means to display a GUI rather than just simple command line information. Mac OS X does not use this for its GUI, but has the ability to run X11. More information can be found here: http://en.wikipedia.org/wiki/X11 and here: http://www.apple.com/macosx/features/x11/

Where do I get it?

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

What do I do with it?

X11 doesn’t do much by itself. What it does do is let you run programs (Linux or Unix based, mostly) that do not use the native OS X system. OpenOffice.org is an example of this, which runs on the Mac using X11. There are others, such as GIMP (a photoshop-esque program) and Scribus (a Quark-like program) which use this as well.

How to Install OpenOffice.org X11 2.0 RC3

Installation with version 2.0 is simpler now. Download the file from OpenOffice.org (http://porting.openoffice.org/mac/2.0.0rc3.html). Mount the .dmg file (by double clicking on it) and inside will be a .app file. Simply drag this to your Applications folder and OpenOffice.org is installed.

I Double Clicked the .app file, it bounced in the dock a few times and went away

This happens when X11 does not start. This can happen for two reasons. You do not have X11 installed, or the .app file is not functioning correctly.

X11 installed?
To check to see if X11 is installed, look in the Utilities folder inside of your Applications folder. If there is a program called X11, run it to make sure it works. You should see a window called Xterm pop up. If it is not there, you will need to install X11 (instructions for this found elsewhere in this FAQ).

Yes, X11 is installed.
X11 is installed, but still, only bouncing in the dock. This is not the intended behavior, and should be reported to dev@porting.openoffice.org. To get the program to run anyway, try starting X11 first, then double clicking the .app file. Also you can try 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

Ok, still nothing
If X11 is installed and the program does not run, please report this to dev@porting.openoffice.org. You should report your OS X version (10.3.6, for example), mention that you confirmed X11 installation (by running it and seeing the Xterm). They may ask for more information.

Why did my .app file get so big after I ran it for the first time?


Fonts. See, as an X11 program, OpenOffice.org does not have access to all of your system fonts. There is a program called Fondu which will translate those fonts into a form that can be used by X11. This program is built into the .app bundle that OpenOffice.org X11 2.0RC3 comes in. When you run this application, it will translate fonts via Fondu for you and store them in the .app bundle. If you have a lot of fonts, this will slow down boot up time for OpenOffice.org as well as make the bundle very large.

When I open the program, it is just a blank gray window

OpenOffice.org opens into just the program. To start a new document, click on the 'new' icon and select which type of document.

I liked "Start OpenOffice.org" how do I use that with this .app thing?

This answer from the NeoWiki, (http://neowiki.sixthcrusade.com/index.php/OpenOffice.org_Mac_OS_X_%28X11%29)

Unfortunately, the late Terry Teague's Start OpenOffice.org application does not include built-in support for the new OpenOffice.org 2.0. However, it is not too difficult to configure Start OpenOffice.org to launch the new version, but it may require a tiny bit of Terminal usage.

Opening the .sversionrc file

* Open the hidden .sversionrc file at the root of your home directory (this file will only exist if you've previously used OpenOffice.org 1.x.x)
1. Open Terminal (in /Applications/Utilities)

2. At the prompt, type open -a TextEdit .sversionrc and hit return.

* If you've not previously used OpenOffice.org 1.x.x
1. Open TextEdit and create a new document
2. Choose Make Plain Text from the Format menu
3. Save the (empty) file; navigate to your home folder, uncheck "Hide Extension", enter .sversionrc as the filename, and click Save. When the dialogue warns you about saving a "dot" file, choose the Use “.” button.

Edit the .sversionrc file and save

* Your file should look like this (the entry for OpenOffice.org 1.1.2 is not necessary if you do not have 1.1.2 installed):

[Versions]
OpenOffice.org 1.1.2=file:///Applications/OpenOffice.org1.1.2/
OpenOffice.org 2.0=file:///Applications/OpenOffice.org2.0.app/Contents/openoffice.org/

* Save the file (there should be no warnings this time)
Launch and Configure Start OpenOffice.org

* Launch Start OpenOffice.org
o If you've not run Start OpenOffice.org before, it may ask you to locate X11 (in /Applications/Utilities)
o If you have already used Start OpenOffice.org with 1.1.2, it will launch X11 and 1.1.2 * In the Start OpenOffice.org Preferences, make sure "OpenOffice.org 2.0RC3" is selected as your preferred version and click OK.
* Quit Start OpenOffice.org
o When restarting Start OpenOffice.org, it will now launch OpenOffice.org 2.0
o You can drag and drop documents onto its icon to open them
o You will need to manually assign Start OpenOffice.org to the new OpenDocument filetypes (see Setting the Default Application) in order to be able to open them via double-clicking

How do I back-up my preferences?

Preferences are stored in a hidden file in your user directory. To back them up, open up a terminal and type:

Code:
cd
cp -R .openoffice2.org openoffice2.org.backup


How do I uninstall this program?

Move the OpenOffice2.app to the trash can.
Empty the trash can.
This deletes the application but does not delete the user's preferences. To do this type in:

Code:
cd
rm -rf .openoffice2.org


This must be done for each user that setup OpenOffice 2.

Where do I find help?

For using the program: http://ooodocs.org is a good place to find general information about using OpenOffice.org programs.

Tips and Tricks to using OpenOffice.org on the Mac can be found on the NeoWiki, http://neowiki.sixthcrusade.com

A team of volunteers works at http://trinity.neooffice.org - however none of the developers of the X11 version do. See "How To report Bugs or software issues"

How to report bugs or software issues

Bugs and software issues should be reported to dev@porting.openoffice.org. This email list is where the developers and porters of the X11 version of OpenOffice.org live. Your input can help improve the work they do.

What does all those parts of the name of OpenOffice.org X11 2.0RC3 mean?

The main program is called OpenOffice.org. This refers to the suite of programs that include writer, calc and presentation. X11 refers to the platform. OpenOffice.org X11 is the version of OpenOffice.org for Mac OS X. It uses X11 to run. The end, 2.0RC3 is the version number. This is the third (3) release candidate (RC) of the 2.0 version of OpenOffice.org for X11.

Copyright

This document written by Jacob Daniel Haddon, and copywrited under a Creative Commons liscense. Portions pulled from the NeoWiki, http://neowiki.sixthcrusade.com as well as the Trinity forums. Please read here for more details: http://creativecommons.org/licenses/by-sa/2.5/

edit- Nov 16 2005 -edited uninstall and added backing up the user preferences.
edit- Nov 16 2005 -added new wiki links


Last edited by jakeOSX on Tue Nov 22, 2005 1:43 pm; edited 6 times in total
Back to top
pluby
The Architect
The Architect


Joined: Jun 16, 2003
Posts: 11949

PostPosted: Tue Nov 15, 2005 8:55 am    Post subject: Re: OO.oX11 RC3 FAQ

jakeOSX wrote:
This is still beta software. RC in the title stands for 'release candidate'. That means that this software is not yet the full, polished version, but a stable, testable version. To help with testing, report issues you have with this program to dev@porting.openoffice.org.


Don't you mean "but a unstable, testable version"?

Patrick
Back to top
jjmckenzie51
The Anomaly


Joined: Apr 01, 2005
Posts: 1055
Location: Southeastern Arizona

PostPosted: Tue Nov 15, 2005 9:03 am    Post subject: Re: OO.oX11 RC3 FAQ

pluby wrote:
jakeOSX wrote:
This is still beta software. RC in the title stands for 'release candidate'. That means that this software is not yet the full, polished version, but a stable, testable version. To help with testing, report issues you have with this program to dev@porting.openoffice.org.


Don't you mean "but a unstable, testable version"?


No, it appears to be stable. At least it does not eat your /Applications folder for lunch and then burp it back up somewhere else on your hard drive Very Happy

As far as it crashing at the most inopportune time, that is ala M$.

James
Back to top
jjmckenzie51
The Anomaly


Joined: Apr 01, 2005
Posts: 1055
Location: Southeastern Arizona

PostPosted: Tue Nov 15, 2005 9:07 am    Post subject: Re: OO.oX11 RC3 FAQ

[quote="jakeOSX"]
Code:
 this is a first draft. this notice will be removed after this has been looked over by not just me. comments welcome, will be come a part of the wiki after some inspection


FAQ

Looks good and I like the part about using StartOpenOffice.org....

However, would it not be better to bold the sections? It was a little confusing to use bolding in one place and then use bolding in another. Technically, I could not find anything incorrect, but you might want to point out the proper use of the Trinity forums and that RC3 messages should go into the Testing area rather than into the X11 Support area as they are testing an alpha/beta/gamma release.

James
Back to top
JKT
The Anomaly
(earlier version)


Joined: Sep 18, 2003
Posts: 434
Location: London, UK

PostPosted: Tue Nov 15, 2005 9:33 am    Post subject:

FWIW, in his response to my post at dev@porting.openoffice.org, Eric Bachard stated the following:

Quote:
> While here, I may as well submit my complaint about the auto-running of
> fondu when you launch OpenOffice.org 2.0 for X11.

For your information, fondu is not in 2.0 ... at least in rc3 Smile


This confused me as fondu definitely ran when I used the app for the first time. My guess is that, because I had previously installed OpenOffice.org 1.1.2 for X11, I had fondu already installed on my system and, although OpenOffice.org 2.0 rc3 doesn't include it, the script for running fondu is still present in the .app package and it used my 1.1.2 installed fondu to do its business.

You might want to clarify the situation with Eric for that particular section.

Also for the un-installing section, apart from the bit that doesn't fit (Finding Help) Wink you also need to include a section on how to remove the invisible .openoffice.org2 directory that is placed in your user folder.

That is, something like:
Code:
cd ~/
rm -rf .openoffice.org2

...I think Exclamation CLI experts, please review. Exclamation

_________________
PBG4, 1.5GHz, SuperDrive, 1GB RAM, 128MB VRAM, 5400rpm 80GB HD, MacOS X 10.4.5

Please visit The Land Gallery at http://www.thelandgallery.com for nature-inspired British Fine Art
Back to top
val1984
Oracle


Joined: May 30, 2005
Posts: 229
Location: France

PostPosted: Tue Nov 15, 2005 11:42 am    Post subject:

JKT wrote:
That is, something like:
Code:
cd ~/
rm -rf .openoffice.org2

...I think Exclamation CLI experts, please review. Exclamation

More simple :
Code:
cd
rm -rf .openoffice.org2


At least, people won't have to look for ~ Razz
Back to top
rays
The Anomaly
(earlier version)


Joined: Sep 23, 2004
Posts: 475
Location: Geneva, Switzerland

PostPosted: Tue Nov 15, 2005 12:17 pm    Post subject: Re: OO.oX11 RC3 FAQ

jakeOSX wrote:
You should see a window called Xterm pop up. If it is not there, you will need to install it (instructions for this found elsewhere in this FAQ).


This perhaps implies you need to install Xterm, not X11.

Suggest using "If Xterm does not appear, you will need to (re)install X11...."

_________________
Ray Saunders
World Scout Bureau
Back to top
jjmckenzie51
The Anomaly


Joined: Apr 01, 2005
Posts: 1055
Location: Southeastern Arizona

PostPosted: Tue Nov 15, 2005 1:07 pm    Post subject:

val1984 wrote:

More simple :
Code:
cd
rm -rf .openoffice.org2


At least, people won't have to look for ~ Razz


Val:

Definately much better. Typing in cd in a terminal session will take you to the user's home directory in most (if not all) Unix style operating systems.

However, I recommend backing up the .openoffice.org2 directory with the following:

Code:

mv .openoffice.org2 .openoffice.org2.old


James
Back to top
JKT
The Anomaly
(earlier version)


Joined: Sep 18, 2003
Posts: 434
Location: London, UK

PostPosted: Tue Nov 15, 2005 1:14 pm    Post subject:

Hi James, the point is to delete it during a (full) un-install of the app Wink

However, it might be an idea to also include a recommendation in the read me on how to backup the user folder too, so I would recommend:

Code:
cd

mv .openoffice.org2 openoffice.org2.backup


Which would make the folder visible to the user as well. (I take it that a -r isn't required for this mv command?)

_________________
PBG4, 1.5GHz, SuperDrive, 1GB RAM, 128MB VRAM, 5400rpm 80GB HD, MacOS X 10.4.5

Please visit The Land Gallery at http://www.thelandgallery.com for nature-inspired British Fine Art
Back to top
jjmckenzie51
The Anomaly


Joined: Apr 01, 2005
Posts: 1055
Location: Southeastern Arizona

PostPosted: Tue Nov 15, 2005 1:31 pm    Post subject:

JKT wrote:
Hi James, the point is to delete it during a (full) un-install of the app Wink


Ok, now I see your point. Thus the application deletion should read:

Move the OpenOffice2.app to the trash can.
Empty the trash can.
This deletes the application but does not delete the user's preferences. To do this type in:

cd
rm -rf .openoffice2.org

This must be done for each user that setup OpenOffice 2.

JKT wrote:

However, it might be an idea to also include a recommendation in the read me on how to backup the user folder too, so I would recommend:

Code:
cd

mv .openoffice.org2 openoffice.org2.backup


Which would make the folder visible to the user as well. (I take it that a -r isn't required for this mv command?)


Correct a -r is not required with the mv command. It is required with cp however. Thus if you wanted to backup the user's preferences to a .backup file it would look like this:

Code:

cd
cp -R .openoffice2.org openoffice2.org.backup


James
Back to top
JKT
The Anomaly
(earlier version)


Joined: Sep 18, 2003
Posts: 434
Location: London, UK

PostPosted: Tue Nov 15, 2005 1:41 pm    Post subject:

Thanks James. I knew there was a good reason that I keep away from Terminal for 99% of the time.
_________________
PBG4, 1.5GHz, SuperDrive, 1GB RAM, 128MB VRAM, 5400rpm 80GB HD, MacOS X 10.4.5

Please visit The Land Gallery at http://www.thelandgallery.com for nature-inspired British Fine Art
Back to top
jjmckenzie51
The Anomaly


Joined: Apr 01, 2005
Posts: 1055
Location: Southeastern Arizona

PostPosted: Tue Nov 15, 2005 8:35 pm    Post subject:

JKT wrote:
Thanks James. I knew there was a good reason that I keep away from Terminal for 99% of the time.


Actually, I don't tend to hang around terminal unless I'm running a build (which is quite often recently Smile ) or I have to troubleshoot something with my system. I tend to use the GUI for most things (and if I could figure out how to show those .openoffice files I'd use it more) and terminal only when I need it. Yes, top is one of my favorites along with ps -aux (run it and you will know why.)

James
Back to top
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Wed Nov 16, 2005 6:45 am    Post subject:

edited a few things based on the comments.

James, I tried to make the heading bold, with any subheadings not. Though there is a definate pain going from wordprocessor to forum post...

I'll see if I can get in touch Eric about the Fondu issue, as I want it to be correct =)

and Patrick, I am playing with the wording to see if i can convey the level of usablitily in RC3 better.
Back to top
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Tue Nov 22, 2005 1:49 pm    Post subject:

I PMed eric about the fondu parts and didn't get a response, anyone figure out how the fondu scripts work?
Back to top
Display posts from previous:   
   NeoOffice Forum Index -> OpenOffice.org MacOS X X11 Support All times are GMT - 7 Hours
Page 1 of 1

 
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

Powered by phpBB © 2001, 2005 phpBB Group

All logos and trademarks in this site are property of their respective owner. The comments are property of their posters, all the rest © Planamesa Inc.
NeoOffice is a registered trademark of Planamesa Inc. and may not be used without permission.
PHP-Nuke Copyright © 2005 by Francisco Burzi. This is free software, and you may redistribute it under the GPL. PHP-Nuke comes with absolutely no warranty, for details, see the license.