Test repository to check push and ssh key
Find a file
2012-01-06 15:04:29 +01:00
accessibility fix gbuildified accessibilty on windows 2011-12-24 10:32:03 -05:00
afms
android Need the basebmp library 2012-01-05 17:53:01 +02:00
animations Link most libs and executables with gb_STDLIBS as presumably is intended 2011-12-20 01:12:23 +02:00
apache-commons
apple_remote
autodoc gcc-trunk: fix error: unable to find string literal operator 'operator"" FOO' 2011-12-16 21:20:08 +01:00
avmedia Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
basctl Removed unnecessary tools includes. 2012-01-05 15:36:41 +01:00
basebmp unusedcode: remove various unused classes 2011-12-22 15:33:50 +01:00
basegfx unusedcode: remove Plotter 2012-01-06 11:29:45 +01:00
basic make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
bean Link most libs and executables with gb_STDLIBS as presumably is intended 2011-12-20 01:12:23 +02:00
beanshell
berkeleydb
bin lo-pack-sources: do not duplicate the generated files in the archive dir 2011-12-19 18:06:11 +01:00
binaryurp Link most libs and executables with gb_STDLIBS as presumably is intended 2011-12-20 01:12:23 +02:00
boost
bridges WaE and build errors with OSL_DEBUG_LEVEL == 2 2012-01-05 09:18:15 +00:00
cairo Resolves: fdo#44219 RHEL-4 buildbox doesn't have FT_Library_SetLcdFilter 2012-01-06 09:52:42 +00:00
canvas canvas: work around NOMINMAX windows breakage 2012-01-04 18:39:53 +01:00
chart2 Removed unnecessary tools includes. 2012-01-05 15:31:29 +01:00
cli_ure function component_canUnload is exported 2011-12-27 15:44:42 +01:00
codemaker Leak comprehensive type descriptions to avoid problems at exit. 2012-01-03 13:52:16 +01:00
comphelper Fix for fdo43460 Part VII getLength() to isEmpty() 2012-01-05 22:05:44 -02:00
configmgr Fix for fdo43460 Part VIII getLength() to isEmpty() 2011-12-17 10:05:35 +04:00
connectivity generic unix .mozilla dir is under home dir, not xdg-config-dir 2012-01-06 10:25:42 +00:00
cosv
cppcanvas make VectorOfOutDevStates a class and refactor this a little 2012-01-05 09:18:17 +00:00
cppu typo in OSL_DEBUG_LEVEL > 1 code 2012-01-06 09:52:42 +00:00
cppuhelper Switch from autodoc to doxygen for SDK C++ documentation. 2012-01-05 19:43:14 +01:00
cppunit
cpputools Fix for fdo43460 Part X getLength() to isEmpty() 2011-12-17 17:15:53 +04:00
crashrep enhance VersionInfo resource of Windows excutables 2011-12-10 22:25:28 +01:00
cross_toolset/prj
ct2n
cui Removed unnecessary tools includes. 2012-01-05 15:38:11 +01:00
curl Code modules no longer depend on stlport. 2011-12-16 17:45:10 +01:00
dbaccess make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
default_images EasyHack fdo#42454, remove code associated with unused icons 2011-12-29 20:13:55 +01:00
desktop Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
distro-configs Online update: Enable online update even for the Linux release builds. 2012-01-02 21:06:23 +01:00
dmake childs -> children 2011-12-08 11:32:41 +02:00
drawinglayer Fix for fdo43460 Part XIV getLength() to isEmpty() 2011-12-23 22:04:44 +04:00
dtrans Fix for fdo43460 Part XIV getLength() to isEmpty() 2011-12-23 22:04:44 +04:00
editeng make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
embeddedobj Fix for fdo43460 Part XV getLength() to isEmpty() 2011-12-22 14:26:46 +00:00
embedserv catch exception by constant reference 2011-12-10 22:16:07 +09:00
epm
eventattacher Link most libs and executables with gb_STDLIBS as presumably is intended 2011-12-20 01:12:23 +02:00
expat
extensions Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
external
extras Fix for bug fdo#44110, New Math symbols issues in Windows 2012-01-05 22:05:45 -02:00
fileaccess Fix for fdo43460 Part XVII getLength() to isEmpty() 2011-12-26 14:05:06 +04:00
filter Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
fontconfig Don't use soname, Android doesn't support that 2012-01-05 17:53:02 +02:00
forms Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
formula Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
fpicker workaround for LO namespace pollution breaking KDE4 fpicker build 2012-01-06 10:57:57 +01:00
framework Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
freetype Don't use soname, Android doesn't support that 2012-01-05 17:53:02 +02:00
gdk-pixbuf
gettext
git-hooks
glib
graphite
guw
hsqldb
hunspell
hwpfilter pesky dependencies 2012-01-05 09:18:20 +00:00
hyphen fdo43931 (fix for double hyphens) 2011-12-27 14:16:15 +01:00
i18npool added Kyrgyz (China) [ky-CN] to language list 2012-01-04 14:41:48 +01:00
i18nutil callcatcher: remove some unused code 2011-12-21 09:30:20 +00:00
icc
icon-themes Media toolbar icons & Strike-through icon (Tango) 2012-01-06 13:18:28 +01:00
icu oops use == not = in dmake conditional 2012-01-02 09:43:27 -06:00
idl make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
idlc Fix for fdo43460 Part XXI getLength() to isEmpty() 2011-12-30 11:52:45 +01:00
instsetoo_native add version suffix (beta1) to about dialog 2011-12-16 14:29:13 +01:00
io Fix for fdo43460 Part XXI getLength() to isEmpty() 2011-12-30 11:52:45 +01:00
javaunohelper chmod -x on java files 2012-01-05 14:09:38 +01:00
jfreereport
jpeg
jurt
jvmaccess Fix for fdo43460 Part XXI getLength() to isEmpty() 2011-12-30 11:52:45 +01:00
jvmfwk Fix for fdo43460 Part XXII getLength() to isEmpty() 2012-01-05 15:07:34 +01:00
l10ntools Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
languagetool
libcdr Fix build with internal zlib 2011-12-08 23:52:26 +02:00
libcmis in modules, when we have a env we are in stage gbuild 2011-12-07 15:53:06 +01:00
libcroco
libexttextcat
libgsf
libpng
librsvg
libvisio
libwpd
libwpg
libwps
libxml2
libxmlsec
libxslt
lingucomponent Fix for fdo43460 Part XXII getLength() to isEmpty() 2012-01-05 15:07:34 +01:00
linguistic getPropertyMap can return a reference instead of a pointer 2012-01-05 22:41:56 +00:00
lotuswordpro Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
lpsolve
lucene
m4/mac
MathMLDTD in modules, when we have a env we are in stage gbuild 2011-12-07 15:53:06 +01:00
mdds
Mesa in modules, when we have a env we are in stage gbuild 2011-12-07 15:53:06 +01:00
migrationanalysis The common_build stuff is surely obsolete 2011-12-11 02:58:01 +02:00
more_fonts . is not a valid TARFILE_ROOTDIR 2011-12-14 15:11:31 +01:00
moz childs -> children 2011-12-08 11:32:41 +02:00
mysqlc Fix for fdo43460 Part XXV getLength() to isEmpty() 2012-01-02 19:17:17 +01:00
mysqlcppconn Revert "mysqlcppconn: force recompilation when switching between different bindings" 2011-12-09 01:17:19 +01:00
mythes update delivering the correct version 2011-12-21 15:20:03 +00:00
neon
nlpsolver build and pack NLPSolver help localizations 2012-01-04 22:24:11 +01:00
np_sdk
nss compile nss against the Mac OSX SDK 2012-01-04 23:46:43 +01:00
o3tl Link most libs and executables with gb_STDLIBS as presumably is intended 2011-12-20 01:12:23 +02:00
odk Switch from autodoc to doxygen for SDK C++ documentation. 2012-01-05 19:43:14 +01:00
offapi idl fix package names 2012-01-05 14:09:37 +01:00
officecfg Use default UI_SANS (dropping Culmus fonts), but keep Tahoma first (for Windows) 2011-12-27 02:57:27 +02:00
oovbaapi in modules, when we have a env we are in stage gbuild 2011-12-07 15:53:06 +01:00
oox add a comphelper::string::getTokenCount 2012-01-05 09:18:19 +00:00
openssl
package Fix for fdo43460 Part XXVI getLength() to isEmpty() 2012-01-02 19:17:17 +01:00
packimages Rename folder ooo_custom_images to icon-themes 2011-12-27 13:41:53 +01:00
padmin Removed unnecessary tools includes. 2012-01-05 15:36:41 +01:00
pango
postgresql Introduce optional krb5&gssapi support for internal PostgreSQL 2011-12-15 18:40:59 +01:00
postprocess fpicker: convert to gbuild 2011-12-27 13:03:37 +01:00
psprint_config in modules, when we have a env we are in stage gbuild 2011-12-07 15:53:06 +01:00
python Linux LD_LIBRARY_PATH is missing as well. 2012-01-02 10:04:57 +01:00
pyuno Fix for fdo43460 Part XXVII getLength() to isEmpty() 2012-01-02 19:17:17 +01:00
qadevOOo fix ScDatabaseRangeObj test, fdo#43312 2011-12-27 07:56:06 +01:00
rdbmaker Fix for fdo43460 Part XXVII getLength() to isEmpty() 2012-01-02 19:17:17 +01:00
readlicense_oo
redland
regexp Fix for fdo43460 Part XXVII getLength() to isEmpty() 2012-01-02 19:17:17 +01:00
registry Switch from autodoc to doxygen for SDK C++ documentation. 2012-01-05 19:43:14 +01:00
remotebridges function component_canUnload is exported 2011-12-27 15:44:42 +01:00
reportbuilder The common_build stuff is surely obsolete 2011-12-11 02:58:01 +02:00
reportdesign Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
rhino
ridljar
rsc Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
sal Final disentanglement between sal and sal_textenc. 2012-01-06 15:00:44 +01:00
salhelper Switch from autodoc to doxygen for SDK C++ documentation. 2012-01-05 19:43:14 +01:00
sane in modules, when we have a env we are in stage gbuild 2011-12-07 15:53:06 +01:00
sax Fix for fdo43460 Part XXIX getLength() to isEmpty() 2012-01-05 22:05:45 -02:00
saxon
sc make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
scaddins Fix for fdo43460 Part XXIX getLength() to isEmpty() 2012-01-05 22:05:45 -02:00
sccomp Fix for fdo43460 Part XXIX getLength() to isEmpty() 2012-01-05 22:05:45 -02:00
scp2 added Kyrgyz (China) [ky-CN] to language list 2012-01-04 14:41:48 +01:00
scripting Fix for fdo43460 Part XXIX getLength() to isEmpty() 2012-01-05 22:05:45 -02:00
sd Removed unnecessary tools includes. 2012-01-05 15:38:58 +01:00
sdext Removed unnecessary tools includes. 2012-01-05 15:36:41 +01:00
setup_native added Kyrgyz (China) [ky-CN] to language list 2012-01-04 14:41:48 +01:00
sfx2 make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
shell catch exception by constant reference 2011-12-26 03:38:50 +09:00
slideshow regenerate list under OSL_DEBUG_LEVEL=2 2012-01-05 09:18:14 +00:00
smoketest The common_build stuff is surely obsolete 2011-12-11 02:58:01 +02:00
smoketestoo_native install-gdb-printers for --disable-linkoo 2011-12-09 23:37:05 +01:00
solenv gbuild: fix extension localization on Windows 2012-01-06 15:04:29 +01:00
soltools catch exception by constant reference 2011-12-26 03:38:50 +09:00
sot gbuild: define NOMINMAX in windows.mk 2012-01-04 12:39:53 +01:00
splitbuild
starmath symbolic names instead of hex values for math symbols where possible 2012-01-06 12:46:22 +01:00
stax
stlport
stoc Get rid of manual ref counting. 2012-01-02 18:01:42 +01:00
store osl_unmapFile can't work for files bundled inside the .apk on Android 2011-12-21 14:08:48 +02:00
svl make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
svtools make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
svx make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
sw make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
swext build and pack MediaWiki extension's help localizations 2012-01-05 08:24:18 +01:00
sysui avoid the hardcoded 3.4 version 2011-12-20 19:47:58 +01:00
tail_build build qadevOOo only if OOO_JUNIT_JAR are set (add BUILD_TYPE) 2011-12-30 16:40:35 +01:00
test shrink the unit test template directory to save some duplication 2011-12-14 12:46:28 +00:00
testtools Removed extra semicolons 2011-12-15 16:38:50 +00:00
tomcat
toolkit Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
tools make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
twain Add TWAIN License text 2011-12-20 01:12:24 +02:00
ucb Remove nonsense line (causing debug-mode glibc to report an error). 2011-12-16 15:00:12 +01:00
ucbhelper Removed extra semicolons 2011-12-15 16:38:50 +00:00
udkapi minor idl fixes 2012-01-05 11:51:44 +00:00
udm
unixODBC in modules, when we have a env we are in stage gbuild 2011-12-07 15:53:06 +01:00
UnoControls gbuildize UnoControls 2011-12-25 20:37:10 +01:00
unodevtools
unoil
unotest build qadevOOo only if OOO_JUNIT_JAR are set (add BUILD_TYPE) 2011-12-30 16:40:35 +01:00
unotools Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
unoxml unordf: tweak SPARQL unit test: 2011-12-20 18:31:57 +01:00
ure gbuildize ure 2011-12-26 17:40:26 +01:00
uui Removed unnecessary tools includes. 2012-01-05 15:31:29 +01:00
vbahelper Removed unnecessary tools includes. 2012-01-05 15:36:41 +01:00
vcl make ReadUniOrByteString return a string 2012-01-06 09:52:42 +00:00
vigra
wizards fix syntactic error 2011-12-16 06:53:23 +01:00
writerfilter fdo#44053 fix RTF import of implicit horizontal table cell merges 2012-01-06 00:50:32 +01:00
writerperfect add mode-lines to some new files 2012-01-05 09:18:16 +00:00
x11_extensions
xmerge Less succes, more success 2011-12-08 09:06:09 +01:00
xml2cmp Removed extra semicolons 2011-12-15 16:38:50 +00:00
xmlhelp I don't see NO_BSYMBOLIC being used anywhere 2011-12-11 02:57:59 +02:00
xmloff fdo#43862: reintroduce fo:margin-* on top of fo:margin for backward compat 2012-01-06 10:34:01 +01:00
xmlreader Temporary hack around cppu_detail_getCppuType variants violating ODR. 2012-01-02 15:33:14 +01:00
xmlscript regpathhelper: unused, so we've got to have two of them 2011-12-14 09:52:49 +00:00
xmlsecurity Removed unnecessary tools includes. 2012-01-05 15:38:51 +01:00
xpdf
xsltml
zlib
.gitattributes
.gitignore prep work to eliminated Env.*.sh, introduce config_{host,build}.mk 2011-12-24 21:42:08 -06:00
.src_root
autogen.sh
bootstrap prep work to eliminated Env.*.sh, introduce config_{host,build}.mk 2011-12-24 21:42:08 -06:00
build_env.in
config.guess
config.sub
config_host.mk.in Switch from autodoc to doxygen for SDK C++ documentation. 2012-01-05 19:43:14 +01:00
configure.in Switch from autodoc to doxygen for SDK C++ documentation. 2012-01-05 19:43:14 +01:00
COPYING
COPYING.LGPL
COPYING.MPL
download prep work to eliminated Env.*.sh, introduce config_{host,build}.mk 2011-12-24 21:42:08 -06:00
g
install-sh
Library_merged.mk
Makefile kill gb_MINISOLARENV in favor of stages 2011-12-07 15:53:04 +01:00
Module_tail_build.mk move UnoControls to tail_build 2011-12-25 20:39:49 +01:00
ooo.lst.in bump hyphen to 2.8.3 2011-12-22 10:47:26 +00:00
oowintool
post_download.in
README.Android Minor edits 2012-01-04 00:11:35 +02:00
README.cross More Android notes 2012-01-03 13:50:17 +02:00
Repository.mk fpicker: convert to gbuild 2011-12-27 13:03:37 +01:00
RepositoryExternal.mk register hunspell as static library 2011-12-27 00:31:47 +01:00
RepositoryFixes.mk Repository: fix Windows name for internal libexttextcat 2011-12-24 16:10:44 +01:00
RepositoryModule_ooo.mk build qadevOOo only if SOLAR_JAVA and OOO_JUNIT_JAR are set 2011-12-30 16:03:44 +01:00
set_soenv.in migrate JAVALIB out of set_soenv.in 2012-01-02 20:53:05 -06:00
TEMPLATE.SOURCECODE.HEADER Bump year. 2012-01-05 11:59:11 +01:00
unusedcode.easy unusedcode: remove Plotter 2012-01-06 11:29:45 +01:00

Cross-compiling LibreOffice
===========================

Notes on cross-compiling LibreOffice, originally written by Tor
Lillqvist <tlillqvist@novell.com> <tml@iki.fi> in May, 2011, for later
history see git log.

My cross-compilation experimentation is going on for four platforms:
Windows, iOS, Android and PowerPC Mac OS X. I work on the master
branch of LibreOffice. Some other people have talked about setting up
a separate branch for Android work, or even separate clones at
github. I am not interested in that.

Cross-compilation of LibreOffice completely is not possible yet. Much
work has been done, "baby steps" for some platforms, much more for
others, but a lot remains. For iOS and Android this work is highly
experimental and done mostly in my own spare time just for the hacking
pleasure. No promise, explicit or implied, is given that it will ever
be finished.

Searching for information about cross-compilation of OpenOffice.org
(the predecessor of LibreOffice) you will find information about what
actually was not cross-compilation, but using QEMU.


General
-------

In GNU Autoconf terminology, "build" is the platform on which you are
running a build on some software and "host" is the platform on which
the software you are building will run. Only in the specific case of
building compilers and other programming tools is the term "target"
used to indicate the platform for which the tools your are building
will produce code. As LibreOffice is not a compiler, the "target" term
should not be used in the context of cross-compilation.

(For a case where all three of "build", "host" and "target" are
different: consider a gcc cross-compiler running on Windows, producing
code for Android, where the cross-compiler itself was built on
Linux. (This is a real case.) An interesting tidbit is that such
configurations are called "Canadian Cross".)

Even though the LibreOffice build mechanism is highly unorthodox, the
configure script takes the normal --build and --host options like any
GNU Autoconf -based configure script. To cross-compile, you basically
need just to specify a suitable --host option and things should work
out nicely. In practise, some more details might be needed. See
examples below.


What is so hard, then?
----------------------

Despite the fact that the configure script takes normal --build and
--host options, that is just the beginning. In practise a lot of work
was necessary to separate tests for "host" and "build" platforms in
the configure script. See the git log for details. And the reasonably
"standard" configure.in is just the top level; when we get down to the
actual makefilery used to build the bits of LibreOffice, it gets much
worse.


Windows
-------

There is some support in LibreOffice already (from OpenOffice.org) for
building it locally on Windows with the GNU tool-chain (MinGW). But as
far as I know, that work has never attempted cross-compilation.

This OOo-originated MinGW support attempts to support both running
Cygwin gcc in its -mno-cygwin mode, and a native MinGW compiler. The
-mno-cygwin mechanism in the Cygwin gcc is rapidly being obsoleted, if
it isn't already, and I have not attempted to try to keep it working;
in fact I have activly cleaned out mechanisms related to this. Ditto
for native MinGW. If one compiles natively on Windows, just use
Microsoft's compiler. OOo/LO has been built for Windows all the time
using that.

In my opinion, the only case where it makes sense to use MinGW is for
cross-compilation. There is just too much crack on Windows anyway, and
it is a semi-miracle (well, make that the result of years of work)
that the MSVC build under Cygwin works as nicely as it does.

MinGW is available as cross-build toolchains pre-packaged in more or
less official packages for many Linux distros including Debian, Fedora,
openSUSE and SLE. Personally I use the mingw32 packages in the Open
Build Service, running on openSUSE:

http://download.opensuse.org/repositories/windows:/mingw:/win32/

For example, you can install it like this:

zypper ar http://download.opensuse.org/repositories/windows:/mingw:/win32/<your_os>/windows:mingw:win32.repo

where <your_os> is one of SLE_11, SLE_11_SP1, openSUSE_11.3, openSUSE_11.4 or
openSUSE_Factory.

zypper in mingw32-cross-gcc mingw32-cross-gcc-c++ mingw32-python-devel \
    mingw32-libexpat-devel mingw32-libexpat mingw32-boost-devel \
    mingw32-libhyphen-devel mingw32-libhyphen mingw32-hyphen-en \
    mingw32-liblpsolve mingw32-liblpsolve-devel \
    mingw32-libxml2-devel mingw32-libxslt-devel mingw32-libicu \
    mingw32-libicu-devel mingw32-libgraphite2 mingw32-libgraphite2-devel \
    mingw32-libcairo2 mingw32-cairo-devel mingw32-librsvg mingw32-librsvg-devel \
    mingw32-hunspell mingw32-hunspell-devel mingw32-libcurl \
    mingw32-libcurl-devel mingw32-libneon mingw32-libneon-devel \
    mingw32-libopenssl mingw32-libopenssl-devel mingw32-libexttextcat \
    mingw32-libexttextcat-devel mingw32-libdb mingw32-libdb-devel \
    mingw32-cross-pkg-config mingw32-pkg-config mingw32-libcppunit \
    mingw32-libcppunit-devel mingw32-libredland mingw32-libredland-devel \
    mingw32-libmythes mingw32-libmythes-devel

There might be more that are missing, please read carefully what autogen.sh
tells you, and either remove one of the --with-system-*, or install the
missing dependency.

It also looks like graphite2.pc needs tweaking in order to work right; but
that's likely to be fixed in the openSUSE project.

It is somewhat unclear how well thought-out the conditionals and code
for MinGW inside the OOo-originated code in LibreOffice actually
are. What I have noticed of it seems a bit randomish, with
copy-pasting having been preferred to factoring out differences.

Most of the configuration settings are maintained in the LibreOfficeMinGW
distro-config, so in your autogen.lastrun, you can use:

CC=ccache i686-w64-mingw32-gcc
CXX=ccache i686-w64-mingw32-g++
CC_FOR_BUILD=ccache gcc
CXX_FOR_BUILD=ccache g++
--with-distro=LibreOfficeMinGW

Alternatively, you can use something like the following; but the preferred way
is to keep LibreOfficeMinGW distro up-to-date.

CC=ccache i686-w64-mingw32-gcc
CXX=ccache i686-w64-mingw32-g++
CC_FOR_BUILD=ccache gcc
CXX_FOR_BUILD=ccache g++
--build=x86_64-unknown-linux-gnu
--host=i686-w64-mingw32
--with-distro=LibreOfficeWin32
--disable-activex
--disable-binfilter
--disable-build-mozilla
--disable-directx
--disable-ext-nlpsolver
--disable-ext-pdfimport
--disable-ext-presenter-console
--disable-ext-presenter-minimizer
--disable-ext-report-builder
--disable-ext-scripting-beanshell
--disable-ext-scripting-javascript
--disable-ext-wiki-publisher
--disable-ext-wiki-publisher
--disable-mozilla
--disable-nss-module
--disable-zenity
--enable-python=system
--with-external-tar=/mnt/hemulen/ooo/git/master/src
--with-num-cpus=1
--with-max-jobs=1
--with-system-altlinuxhyph
--with-system-boost
--with-system-cairo
--with-system-cppunit
--with-system-curl
--with-system-db
--with-system-expat
--with-system-gettext
--with-system-hunspell
--with-system-icu
--with-system-libpng
--with-system-libwpd
--with-system-libwpg
--with-system-libwps
--with-system-libxml
--with-system-lpsolve
--with-system-mythes
--with-system-neon
--with-system-openssl
--with-system-redland
--with-vendor=no
--without-help
--without-helppack-integration
--without-myspell-dicts

Once you have compiled it, you may want to try to run it:

$ cd /tmp
$ tar xf <your-build-dir>/instsetoo_native/wntgcci.pro/LibreOffice_Dev/archive/install/en-US/LibO-Dev_OOO350m1_Win_x86_install-arc_en-US.tar.gz
$ cd LibO-Dev_OOO350m1_Win_x86_install-arc_en-US/LibO-dev\ 3.5/program
$ wine soffice.exe

NB. it is important to unpack somewhere low in the hierarchy structure (like
in /tmp as advised above), otherwise you'll get BerkeleyDB errors on startup.

And if you are brave enough, you can even debug it.  First you have to add the
URE dll's to the wine's PATH using 'wine regedit' - see
http://www.winehq.org/docs/wineusr-guide/environment-variables, and add
Z:\tmp\LibO-Dev_OOO350m1_Win_x86_install-arc_en-US\LibO-dev 3.5\URE\bin
to "Path" in My Computer->HKEY_CURRENT_USER->Environment.

Then run linkoo, so that when you rebuild something, you can directly see the
changes the next time you run it:

solenv/bin/linkoo '/tmp/LibO-Dev_OOO350m1_Win_x86_install-arc_en-US/LibO-dev 3.5' <your_clone_dir>

And start debugging:

$ winedbg soffice.bin

Would be great to be able to use winedbg --gdb, but it was crashing here :-( -
but maybe you'll be more lucky.

TODO:

- installation
  - so far the make_installer.pl calls makecab.exe, uuidgen.exe, and
    others; would be best to avoid that if at all possible (using a free
    cab implementation, part of Wine or something)
  - MSI generation
  - if at all possible, the make dev-install installation (with links
    back to the build) should be done so that it would be directly
    executable via wine after doing make dev-install :-)

- runtime
  - no idea if the entire thing works after the installation at all; I
    suppose there will be runtime problems to look at too

- cleanup
  - enable & fix pieces that are currently disabled
    - --without-myspell-dicts
    - --disable-directx
    - --disable-activex
    - --disable-mozilla
  - much of the stuff currently relies on --with-system-*, and
    consequently on the mingw32-* openSUSE packages; might be good to be
    able to build with as few dependencies as possible - but that is low
    prio I think

- profiling
  - when all the above is sorted out, we should look at the speed of
    this vs. the speed of the MSVC version


iOS
---

iOS is the operating system of Apple's mobile devices. Clearly for a
device like the iPad it would be totally unacceptable to run a normal
LibreOffice application with a overlapping windows and mouse-oriented
GUI widgets. No work has been done (at least publicly) to design a
touch GUI for LibreOffice, so the work on cross-compiling LibreOffice
for iOS is extremely experimental, and of course partly pointless;)
But it is interesting and fun nonetheless.

Obviously it will make sense to build only a part of LibreOffice's
code for iOS. Most likely all GUI-oriented code should be left out,
and some iOS app that eventually wants to use the remaining bits will
handle all its GUI in a platform-dependent manner. How well it will be
possible to do such a split remains to be seen. As I said, this is
highly experimental and just in its baby steps phase.

Technically, one important special aspect of iOS is that apps are not
allowed to load own dynamic libraries. (System libraries are used in
the form of dynamic libraries, just like on Mac OS X, of which iOS is a
variant.) So all the libraries in LibreOffice that normally are shared
libraries (DLLs on Windows, shared objects (.so) on Linux, dynamic
libraries on Mac OS X (.dylib)) need to be built as static archives
instead. Obviously this will have some interesting consequences for
how UNO is implemented and used. None of that has been spared much
thought yet.

The Apple tool-chain for iOS cross-building is available only for
Mac OS X, so that is where I have been doing it.

Here is my autogen.lastrun for iOS (device):
CXX=ccache /Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/g++ -arch armv7 -isysroot /Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS5.0.sdk
CC=ccache /Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/gcc -arch armv7 -isysroot /Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS5.0.sdk
CC_FOR_BUILD=ccache /Xcode3/usr/bin/gcc-4.0 -mmacosx-version-min=10.4
CXX_FOR_BUILD=ccache /Xcode3/usr/bin/g++-4.0 -mmacosx-version-min=10.4
--with-distro=LibreOfficeiOS
--with-external-tar=/Volumes/ooo/git/master/src
--with-num-cpus=1
--with-max-jobs=1
--without-help
--without-helppack-integration
--without-myspell-dicts

And here for the iOS simulator:
CXX=ccache /Developer/Platforms/iPhoneSimulator.platform/Developer/usr/bin/g++ -arch i386 -isysroot /Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator5.0.sdk
CC=ccache /Developer/Platforms/iPhoneSimulator.platform/Developer/usr/bin/gcc -arch i386 -isysroot /Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator5.0.sdk
CC_FOR_BUILD=ccache /Xcode3/usr/bin/gcc-4.0 -mmacosx-version-min=10.4
CXX_FOR_BUILD=ccache /Xcode3/usr/bin/g++-4.0 -mmacosx-version-min=10.4
--with-distro=LibreOfficeiOS
--with-external-tar=/Volumes/ooo/git/master/src
--with-num-cpus=1
--with-max-jobs=1
--enable-debug
--without-help
--without-helppack-integration
--without-myspell-dicts

It seems that with the latest iOS SDK one has to do:
sudo ln -s i686-apple-darwin10 /Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator4.3.sdk/usr/include/c++/4.2.1/i686-apple-darwin11
or g++ won't find its headers like <bits/c++config.h>

Android
-------

I don't know much about Android, but from a technical point of view it
is a kind of Linux, of course. As far as I know it is allowed for an
Android app to use shared objects, but if it isn't, then just the same
approach as used on iOS will need to be used.

As for the GUI, the same holds as said above for iOS.

I have done my Android cross-compilation work on Linux (openSUSE in
particular) and Mac OS X. The Android cross-buld tool-chain (the
"Native Development Kit", or NDK) is available for Linux, Mac OS X and
Windows. (Trying to cross-compile from Windows will probably drive you
insane.)

Here is my autogen.lastrun for Android, when cross-compiling from Mac OS X:

SYSBASE=/Users/tml/android-ndk-r7/platforms/android-9/arch-arm
CC=ccache /Users/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/darwin-x86/bin/arm-linux-androideabi-gcc -march=armv7-a -mfloat-abi=softfp -mthumb -mfpu=neon -Wl,--fix-cortex-a8 --sysroot /Users/tml/android-ndk-r7/platforms/android-9/arch-arm -L/Users/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/libs/armeabi-v7a
CXX=ccache /Users/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/darwin-x86/bin/arm-linux-androideabi-g++ -march=armv7-a -mfloat-abi=softfp -mthumb -mfpu=neon -Wl,--fix-cortex-a8 --sysroot /Users/tml/android-ndk-r7/platforms/android-9/arch-arm -I /Users/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/include -I/Users/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/libs/armeabi-v7a/include -L/Users/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/libs/armeabi-v7a -fexceptions -frtti
AR=/Users/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/darwin-x86/bin/arm-linux-androideabi-ar
NM=/Users/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/darwin-x86/bin/arm-linux-androideabi-nm
OBJDUMP=/Users/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/darwin-x86/bin/arm-linux-androideabi-objdump
RANLIB=/Users/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/darwin-x86/bin/arm-linux-androideabi-ranlib
STRIP=/Users/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/darwin-x86/bin/arm-linux-androideabi-strip
CC_FOR_BUILD=ccache /Xcode3/usr/bin/gcc-4.0 -mmacosx-version-min=10.4
CXX_FOR_BUILD=ccache /Xcode3/usr/bin/g++-4.0 -mmacosx-version-min=10.4
--build=x86_64-apple-darwin11
--disable-zenity
--enable-werror
--with-distro=LibreOfficeAndroid
--with-external-tar=/Volumes/ooo/git/master/src
--disable-python
--without-helppack-integration
--without-myspell-dicts
--with-java

And here is my autogen.lastrun for Android when cross-compiling from Linux:

SYSBASE=/home/tml/android-ndk-r7/platforms/android-9/arch-arm
CC=ccache /home/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-gcc -march=armv7-a -mfloat-abi=softfp -mthumb -mfpu=neon -Wl,--fix-cortex-a8 --sysroot /home/tml/android-ndk-r7/platforms/android-9/arch-arm -L/home/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/libs/armeabi-v7a
CXX=ccache /home/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-g++ -march=armv7-a -mfloat-abi=softfp -mthumb -mfpu=neon -Wl,--fix-cortex-a8 --sysroot /home/tml/android-ndk-r7/platforms/android-9/arch-arm -I /home/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/include -I/home/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/libs/armeabi-v7a/include -L/home/tml/android-ndk-r7/sources/cxx-stl/gnu-libstdc++/libs/armeabi-v7a -fexceptions -frtti
AR=/home/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-ar
NM=/home/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-nm
OBJDUMP=/home/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-objdump
RANLIB=/home/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-ranlib
STRIP=/home/tml/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-strip
CC_FOR_BUILD=ccache gcc
CXX_FOR_BUILD=ccache g++
--build=x86_64-unknown-linux-gnu
--disable-zenity
--with-distro=LibreOfficeAndroid
--with-external-tar=/mnt/hemulen/ooo/git/master/src
--disable-python
--with-num-cpus=1
--with-max-jobs=1
--without-helppack-integration
--without-myspell-dicts

There is no interactive end-user "app" you could run yet that would
use LibreOffice code, but you can build some non-interactive unit
tests and run them on the emulator (or, presumably,
on a device, although I haven't tested that as I don't have any
Android device...)  The simple unit tests will succeed, the complex
one still fails. 

These unit tests *are* proper "apps" from Android'd point of view, but
they don't have any GUI and thus don't take part in the normal Android
message passing and Android thinks they are stuck and offers to kill
them...

The activity used for these apps is in android/Bootstrap. See
README.Android.

To build the complex unit test (for Calc functionality; invokes the
"ucalc" unit test code from sc) source the environment (. Env.Host.sh)
and cd to android/qa/sc and run a "make". The Makefile here is
completely manually written, this stuff is so experimental it doesn't
make sense yet to try to integrate with the normal gbuild
mechanism.

Then to run the unit test, do "make install" followed by "make
run". You most likely want to have an "adb logcat" running in another
window, and you probably also want to have set the stdout and stderr
of app processes to be redirected to logcat ("adb shell stop; adb
shell setprop log.redirect-stdio true; adb shell start").

Unfortunately you might notice that the command line passed to "adb
shell am start" is too long (actually, not "command line" as such, but
the length of the so-called "extra" arguments passed to the action, or
something like that, see Android bug
http://code.google.com/p/android/issues/detail?id=23351 , so you need
to shorten it somehow... for instance by creating a symlink to
/data/data/org.libreoffice.android.qa.sc in /system: "adb remount; adb
shell ln -s /data/data/org.libreoffice.android.qa.sc /system/sc" and
then use that shorter path /system/sc snippet in all places instead of
the longer /data/data/org.libreoffice.android.qa.sc on the "adb shell
am start" command line.

To debug, do manually what "make run" would do, adding args "-e
lo-main-delay 20" to the command line, and when the app has started,
run ndk-gdb. Unfortunately the gdb in NDK r7 is broken, use the one in
the NDK build with newer versions of gcc and gdb from
http://code.google.com/p/mingw-and-ndk/ instead.

Running strace on the unit test in progress is often useful to find
out what is going wrong. Pass something like -e lo-strace '-tt -f -e
trace=file,process,network -o /system/sc/strace.out' to the am start
command line.


PowerPC Mac OS X
----------------

Cross-compiling for PowerPC Mac OS X from Intel Mac OS X will probably
be easy. The APIs available should after all be closely identical to
those on Intel Mac OS X, and LibreOffice builds fine natively on
PowerPC Mac already. I have just started experimenting with it. My
autogen.lastrun looks like this:

CC=ccache /Xcode3/usr/bin/gcc-4.0 -arch ppc
CXX=ccache /Xcode3/usr/bin/g++-4.0 -arch ppc
CC_FOR_BUILD=ccache /Xcode3/usr/bin/gcc-4.0
CXX_FOR_BUILD=ccache /Xcode3/usr/bin/g++-4.0
--build=i386-apple-darwin10.7.0
--host=powerpc-apple-darwin10
--disable-mozilla
--disable-build-mozilla
--with-external-tar=/Volumes/ooo/git/master/src



That's all, thank you, and have a nice day. People with commit access,
feel free to edit this document, and add yourself below. Sorry for
writing now initially from such a personal point of view.

--Tor Lillqvist <tlillqvist@novell.com>, <tml@iki.fi>