OpenOffice Portable Launcher

============================
Copyright (C) 2004-2008 John T. Haller
Website: http://PortableApps.com/OpenOfficePortable
This software is OSI Certified Open Source Software.
OSI Certified is a certification mark of the Open Source Initiative.
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

ABOUT OPENOFFICE.ORG PORTABLE

=============================
The OpenOffice Portable Launcher allows you to run OpenOffice.org from a removab
le drive whose letter changes as you move it to another computer. The program c
an be entirely self-contained on the drive and then used on any Windows computer
.

LICENSE
=======
This code is released under the GPL. The full code is included with this packag
e as OpenOfficePortable.nsi.

INSTALLATION / DIRECTORY STRUCTURE

==================================
By default, the program expects one of these directory structures:
-\ <--- Directory with OpenOfficePortable.exe
+\App\
+\openoffice\
+\java\
+\Data\
+\settings\
OR
-\ <--- Directory with OpenOfficePortable.exe
+\PortableApps\
+\OpenOfficePortable\
+\App\
+\openoffice\
+\Data\
+\settings\
+\CommonFiles\
 +\Java\

It can be used in other directory configurations by including the OpenOfficePort

able.ini file in the same directory as OpenOfficePortable.exe and configuring it
as details in the INI file section below.

OPENOFFICEPORTABLE.INI CONFIGURATION
====================================
The OpenOffice Portable Launcher will look for an ini file called OpenOfficePort
able.ini within its directory (see the above section for more details on placeme
nt). If you are happy with the default options, it is not necessary, though. T
he INI file is formatted as follows:
[OpenOfficePortable]
OpenOfficeDirectory=App\openoffice
SettingsDirectory=Data\settings
OpenOfficeExecutable=soffice.exe
AdditionalParameters=
WaitForOpenOffice=false
RunDataLocally=false
DisableSplashScreen=false
PortableApps.comTemp=c:\temp\
PortableApps.comDocuments=Z:\Documents\

The OpenOfficeDirectory and SettingsDirectory entries should be set to the *rela

tive* path to the directories containing openoffice, etc. from the current direc
tory. All must be a subdirectory (or multiple subdirectories) of the directory
containing OpenOfficePortable.exe. The default entries for these are described
in the installation section above.
The OpenOfficeExecutable entry allows you to set the OpenOffice Portable Launche
r to use an alternate EXE call to launch OpenOffice. This is helpful if you are
using a machine that is set to deny soffice.exe from running. You'll need to r
ename the soffice.exe file and then enter the name you gave it on the OpenOffice
Executable= line of the INI.
The AdditionalParameters entry allows you to pass additional commandline paramet
er entries to soffice.exe. Whatever you enter here will be appended to the call
to soffce.exe.
The WaitForOpenOffice entry allows you to set the OpenOffice Portable Launcher t
o wait for OpenOffice to close before it closes. This option is mainly of use w
hen OpenOfficePortable.exe is called by another program that awaits it's conclus
ion to perform a task.
The RunDataLocally entry allows you to set OpenOffice Portable to be able to run
from a CDROM or other read-only medium. It should be set to true and run at le
ast once from a writeable medium to allow the launcher to properly configure ope
noffice to run read-only. It can then be burned to a CD.
The DisableSplashScreen entry allows you to disable the launcher's built in spla
sh screen.
The PortableApps.comTemp and the PortableApps.comDocuments entries allows you to
set the OpenOffice Portable Launcher to use alternate paths for the working dir
ectory and the temporary files. If the path to this folder is set to not existin
g places it will be ignored by the launcher.
PROGRAM HISTORY / ABOUT THE AUTHORS
===================================
This launcher is loosely based on the Firefox Portable launcher which contains i
deas from tracon and mai9 from the mozillaZine.org forums.