Test repository to check push and ssh key
Find a file
David Tardon cc63f2e9b2 move shell to cross_tail_build
Change-Id: I52ddd365f24589ca73a4671eca84b146df82dcb1
2012-05-29 07:34:39 +02:00
accessibility normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
afms
android android: add possibility to add application specific fonts to fontconfig 2012-05-28 14:51:20 +01:00
animations fdo#48253 Expand SAL_STATIC_CAST and SAL_CONST_CAST 2012-05-04 15:52:57 +02:00
apache-commons
apple_remote Improve 2012-05-08 09:34:27 +03:00
autodoc removed unused const char[] 2012-05-24 22:29:38 +09:00
avmedia dxguid.lib not needed here 2012-05-14 17:00:12 +02:00
basctl status bar: Standardize the size of modification status to '9' everywhere. 2012-05-28 09:49:14 +02:00
basebmp put debugDump behind #if OSL_DEBUG_LEVEL > 2 2012-05-11 22:48:49 +02:00
basegfx remove unneeded include of boost/bind.hpp 2012-05-16 15:05:36 +01:00
basic add missing licence ( populated from TEMPLATE.SOURCECODE.HEADER ) 2012-05-14 15:41:07 +01:00
bean fdo#49580: Fix bean after gbuild'ification 2012-05-07 17:03:00 +02:00
beanshell
berkeleydb
bin lo-commit-stat: use utf8 to be able to query a dash in the bug title 2012-05-21 16:57:08 +02:00
binaryurp Better fix for ThreadPool/ORequestThread life cycle 2012-05-23 10:10:51 +02:00
boost Be sure all boost headers are copied to output directory 2012-05-24 10:55:28 +02:00
bridges removed unused const rtl::OUString 2012-05-18 22:56:54 +09:00
cairo default unix in general to system libxml2/libxslt like MacOSX 2012-05-14 14:34:10 +01:00
canvas Some cppcheck cleaning 2012-05-28 20:50:31 +02:00
chart2 status bar: Standardize the size of modification status to '9' everywhere. 2012-05-28 09:49:14 +02:00
cli_ure
clucene CLucene contribs-lib artifacts were missing during system wide installation 2012-05-28 09:57:24 +03:00
codemaker codemaker: write version 49 (1.5) class files 2012-05-21 18:48:04 +02:00
comphelper merge the 5 ConstAsciiString duplicate classes together 2012-05-17 14:03:26 +01:00
configmgr
connectivity remove unused sources 2012-05-29 07:24:52 +02:00
cosv
cppcanvas targetted string re-work 2012-05-22 18:21:18 +01:00
cppu Better fix for ThreadPool/ORequestThread life cycle 2012-05-23 10:10:51 +02:00
cppuhelper removed dead code 2012-05-29 00:11:30 +09:00
cppunit
cpputools Better fix for ThreadPool/ORequestThread life cycle 2012-05-23 10:10:51 +02:00
crashrep
cross_tail_build move shell to cross_tail_build 2012-05-29 07:34:39 +02:00
cross_toolset move shell to cross_tail_build 2012-05-29 07:34:39 +02:00
ct2n
cui resize options dialog to fit to increased tab height 2012-05-26 07:49:43 +02:00
curl EasyHack fdo#42783: get rid of CPU define/build system variable 2012-05-09 16:31:31 +02:00
dbaccess remove unused makefile 2012-05-29 07:24:43 +02:00
desktop rename functions for consistency with the rest of gbuild 2012-05-29 07:33:59 +02:00
distro-configs Revert "Don't bundle stdelibs on Linux by default" 2012-05-11 12:58:41 +02:00
dmake
drawinglayer targetted string re-work 2012-05-22 18:24:33 +01:00
dtrans targetted string re-work 2012-05-28 11:47:45 -05:00
editeng fdo#40874: make recorded border macros run: 2012-05-21 18:20:38 +02:00
embeddedobj normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
embedserv
epm
eventattacher
expat expat: upgrade to 2.1.0 release 2012-04-30 14:00:34 +02:00
extensions use gb_WinResTarget_use_custom_headers 2012-05-29 07:34:06 +02:00
external Revert "remove redundant test for presence of dlls" 2012-05-28 06:19:23 +02:00
extras put white next to black in the color palette drop-down 2012-05-28 12:30:09 +01:00
fileaccess
filter fix horizontal rule width in .doc documents (bnc#757118) 2012-05-28 18:06:15 +02:00
fontconfig
forms Removed unused SfxMedium::bDirect 2012-05-24 11:38:12 +02:00
formula remove unneeded include of boost/bind.hpp 2012-05-16 15:05:36 +01:00
fpicker rename functions for consistency with the rest of gbuild 2012-05-29 07:33:59 +02:00
framework language status bar control: Don't set radio buttons for some entries. 2012-05-25 12:19:24 +02:00
freetype
gdk-pixbuf
gettext
git-hooks fix issue with repeated I in case of amend commit 2012-05-14 02:37:52 -05:00
glib
graphite
guw
hsqldb
hunspell
hwpfilter
hyphen
i18npool targetted string re-work 2012-05-28 11:47:45 -05:00
i18nutil reduce a gadzillion make_pairs executions to simple array of pod 2012-05-16 15:05:36 +01:00
icc
icon-themes status bar: Get rid of STD/BLK/..., and introduce a menu for that instead. 2012-05-25 10:07:34 +02:00
icu Move the RPATH enforcement to icu4c-rpath.patch and skip that for Android 2012-05-17 00:07:13 +03:00
idl
idlc removed unused temporary rtl::OUString 2012-05-23 01:06:54 +09:00
instsetoo_native fdo#50162 merge rtlbootstrap.mk into configure.in 2012-05-24 07:22:03 +02:00
io deliver component desc. xml, if used 2012-05-29 07:25:03 +02:00
ios
javaunohelper
jfreereport remove trailing space 2012-05-29 07:24:57 +02:00
jpeg fdo#47035: Fix saving of jpeg files on Mac/PPC 2012-05-19 14:05:10 +02:00
jurt normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
jvmaccess
jvmfwk removed unused const rtl::OUString 2012-05-17 22:44:43 +09:00
l10ntools move idxdict out of dictionaries 2012-05-20 16:28:55 +02:00
languagetool
lcms2
libcdr
libcmis
libcroco
libexttextcat bump libexttextcat 2012-05-28 13:03:02 +01:00
libgsf
libpng
librsvg
libvisio Resolves: fdo#50178 Reading Visio file causes crash 2012-05-24 20:36:21 +02:00
libwpd
libwpg
libwps Fix libwps debug build 2012-05-14 08:48:24 +02:00
libxml2 Don't build against the debugging MSVC runtime in a dbgutil build either 2012-05-08 17:17:59 +03:00
libxmlsec
libxslt Don't build against the debugging MSVC runtime in a dbgutil build either 2012-05-08 17:17:59 +03:00
lingucomponent this is supposed to just be the number of bytes 2012-05-28 13:03:01 +01:00
linguistic fdo#35270 - enable caching of grammar checker properties 2012-05-14 14:44:20 +01:00
lotuswordpro Removed unused SfxMedium::bDirect 2012-05-24 11:38:12 +02:00
lpsolve Revert "Update lpsolve to 5.5.2.0. Resolves bug fdo#39496." 2012-05-14 21:49:37 +02:00
m4 fdo#47584 add yet another MinGW dll filename pattern 2012-05-01 17:27:15 +02:00
MathMLDTD
mdds
Mesa
migrationanalysis
more_fonts
moz
mysqlc
mysqlcppconn
mythes
neon
nlpsolver
np_sdk
nss EasyHack fdo#42783: get rid of CPU define/build system variable 2012-05-09 16:31:31 +02:00
o3tl
odk only add -manifest:no for msc--mingw's ldd chokes on it 2012-05-20 14:18:46 +02:00
offapi Renamed FILE to DOCINFO_TITLE, which is more appropriate for this field. 2012-05-14 12:09:57 -04:00
officecfg allow to set extra (global) schema root 2012-05-29 07:24:55 +02:00
oovbaapi
oox hack the same meaning for o:hr handling like MSO uses 2012-05-28 18:06:14 +02:00
openssl
package check key size 2012-05-28 15:35:25 +01:00
packimages normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
padmin
pango
postgresql Revert "Fix Windows debug build." 2012-05-04 08:47:35 +02:00
postprocess move scp2 to tail_build 2012-05-29 07:34:29 +02:00
psprint_config
python do not concatenate empty line in python/makefile.mk 2012-05-23 15:33:46 +02:00
pyuno removed unused temporary rtl::OUString 2012-05-23 01:06:54 +09:00
qadevOOo Removed writer_Text type; combined it with generic_Text. 2012-05-25 02:04:19 -04:00
rdbmaker ignore type parameters when processing dependencies 2012-05-29 07:25:03 +02:00
readlicense_oo
redland lib was renamed, but dylib_file hint for older XCode was missed. 2012-05-04 21:06:47 +02:00
regexp
registry Don't bother with the static lib and the exes for non-desktop OSes 2012-05-07 10:58:42 +03:00
remotebridges gbuildize remotebridges 2012-05-26 16:15:07 +02:00
reportbuilder remove unused source 2012-05-29 07:25:01 +02:00
reportdesign merge the 5 ConstAsciiString duplicate classes together 2012-05-17 14:03:26 +01:00
rhino
ridljar normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
rsc WaE: return value of fwrite unchecked 2012-05-25 09:26:14 +01:00
sal fdo#50162 merge rtlbootstrap.mk into configure.in 2012-05-24 07:22:03 +02:00
salhelper fdo#42865: privatized unique empty string symbol: 2012-05-18 16:33:19 +02:00
sane
sax stop parsing on encountering internal entities in fastparser.cxx 2012-05-25 13:24:50 +02:00
saxon
sc WaE: converting to non-pointer type 'long long int' from NULL 2012-05-29 07:34:09 +02:00
scaddins
sccomp
scp2 remove unused source files 2012-05-29 07:34:27 +02:00
scripting removed unused const rtl::OUString 2012-05-17 22:44:43 +09:00
sd status bar: Standardize the size of modification status to '9' everywhere. 2012-05-28 09:49:14 +02:00
sdext fdo#50162 merge rtlbootstrap.mk into configure.in 2012-05-24 07:22:03 +02:00
setup_native TDE integration 2012-05-14 20:09:41 -05:00
sfx2 Whatever an inimanager was, it has been dead for a decade 2012-05-28 16:02:36 +03:00
shell WaE: declaration of 'index' shadows a global declaration 2012-05-29 07:34:07 +02:00
slideshow group external headers together 2012-05-29 07:24:43 +02:00
smoketest normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
solenv handle silent mode 2012-05-29 07:34:23 +02:00
soltools Some cppcheck cleaning 2012-05-20 15:25:37 +02:00
sot Revert "Make SotStorage and SotStorageStream dtors public" 2012-05-25 16:47:23 +02:00
starmath only need to include ostream here, iostream sucks in global ctors 2012-05-28 13:03:01 +01:00
stax
stlport
stoc deliver component desc. xml, if used 2012-05-29 07:25:03 +02:00
store add gb_STDLIBS 2012-05-07 07:08:16 +02:00
svl make sure that rsc headers are available 2012-05-29 07:25:02 +02:00
svtools add a little devtool to list the languages supported for spellchecking 2012-05-25 11:29:57 +01:00
svx status bar: Get rid of STD/BLK/..., and introduce a menu for that instead. 2012-05-25 10:07:34 +02:00
sw testcase for bnc#757118 2012-05-28 18:06:15 +02:00
swext normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
sysui targeted string re-work 2012-05-28 11:47:45 -05:00
tail_build oovbaapi is already in tail_build 2012-05-29 07:34:38 +02:00
test WaE: make test msvc2008 warnings free 2012-05-18 14:17:29 +01:00
testtools WaE: pesky aliasing warning with gcc 4.7.0 2012-05-25 09:26:13 +01:00
tomcat
toolkit targeted string re-work 2012-05-28 18:09:26 -05:00
tools we really should not have any FASTBOOL left, remove the typedef 2012-05-28 11:47:44 -05:00
twain
ucb removed dead code 2012-05-29 00:11:30 +09:00
ucbhelper fdo#48253 Expand SAL_STATIC_CAST and SAL_CONST_CAST 2012-05-04 15:52:57 +02:00
udkapi
udm
unixODBC improve odbc headers handling 2012-05-29 07:24:42 +02:00
UnoControls fdo#48253 Expand SAL_STATIC_CAST and SAL_CONST_CAST 2012-05-04 15:52:57 +02:00
unodevtools
unoil normalize variable names in gbuild user makefiles 2012-05-10 10:47:44 +02:00
unotest unotest: missing include guard in macros_test.hxx 2012-05-09 15:37:17 +02:00
unotools removed unused const char[] 2012-05-24 22:29:38 +09:00
unoxml
ure gbuildize remotebridges 2012-05-26 16:15:07 +02:00
uui removed unused temporary rtl::OUString 2012-05-23 01:06:54 +09:00
vbahelper Fix Prefer prefix ++/-- operators for non-primitive types 2012-05-19 15:10:13 +02:00
vcl rename functions for consistency with the rest of gbuild 2012-05-29 07:33:59 +02:00
vigra
wizards Renamed writer_web_HTML to generic_HTML. 2012-05-22 14:32:53 -04:00
writerfilter removed dead code 2012-05-29 00:11:30 +09:00
writerperfect Trying to wrap the tools references inside a struct 2012-05-25 16:47:23 +02:00
x11_extensions gbuildize x11_extensions 2012-05-20 16:28:54 +02:00
xmerge Fix typos 2012-05-28 14:51:14 +02:00
xml2cmp Some cppcheck cleaning 2012-05-20 15:25:37 +02:00
xmlhelp reduce static_initialization_and_destruction chain 2012-05-16 12:04:10 +01:00
xmloff support remaining data bar attributes in odf import/export 2012-05-26 02:08:19 +02:00
xmlreader
xmlscript removed unused temporary rtl::OUString 2012-05-21 22:08:17 +09:00
xmlsecurity more robust nss initialization, related fdo#45171 2012-05-04 15:13:53 +02:00
xpdf
xsltml
zlib bump zlib to 1.2.7 2012-05-14 14:34:10 +01:00
.gitattributes
.gitignore
.src_root
autogen.sh autogen.sh: append aclocal arguments to ACLOCAL_FLAGS unconditionally 2012-05-17 11:04:56 +02:00
bootstrap
config.guess
config.sub
config_host.mk.in export ALL_LANGS 2012-05-29 07:34:13 +02:00
configure.in do not allow both kde and tde at the same time 2012-05-29 07:34:11 +02:00
COPYING
COPYING.LGPL
COPYING.MPL
download
g
install-sh
Library_merged.mk
Makefile update autogen.lastrun dummy rule 2012-05-28 12:13:19 -04:00
Makefile.post
Makefile.top gbuildize scp2 2012-05-29 07:34:18 +02:00
Module_cross_tail_build.mk move shell to cross_tail_build 2012-05-29 07:34:39 +02:00
Module_tail_build.mk move shell to tail_build 2012-05-29 07:34:32 +02:00
ooo.lst.in bump libexttextcat 2012-05-28 13:03:02 +01:00
oowintool copy msms only for ver 9.0, MSVC 2010 doesn't have them 2012-05-23 11:20:43 +02:00
post_download.in
README.Android Now with in-process redirection, the adb shell setprop thing is not needed 2012-05-17 16:32:32 +03:00
README.cross Update README.cross to match reality better 2012-05-18 09:38:00 +03:00
Repository.mk gbuildize shell 2012-05-29 07:33:44 +02:00
RepositoryExternal.mk gbuildize shell 2012-05-29 07:33:44 +02:00
RepositoryFixes.mk register reg and store the same way as jvmfwk 2012-05-06 11:42:38 +02:00
RepositoryModule_ooo.mk gbuildize reportbuilder 2012-05-29 07:25:00 +02:00
TEMPLATE.SOURCECODE.HEADER
unusedcode.easy Drop unused function "findByTable" 2012-05-25 07:45:19 +02:00
unusedcode.README Fix typo 2012-05-02 11:07:42 +02:00

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

Cross-compilation work has been done, to various degrees, for four
platforms: Windows, iOS, Android and PowerPC Mac OS X.


General
-------

In GNU Autoconf terminology, "build" is the platform on which you are
running a build of 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, many details needed to be handled. 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). Apparently, 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 we have not attempted to try to keep it working;
in fact we 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.

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. For instance 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. It often seems a bit randomish, with copy-pasting having been
preferred to factoring out differences.

Most of the configuration settings are maintained in the
distro-configs/LibreOfficeMinGW.conf file, 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 the LibreOfficeMinGW.conf file 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-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, for instance
using Wine:

$ cd /tmp
$ tar xf <your-build-dir>/instsetoo_native/wntgcci.pro/LibreOffice_Dev/archive/install/en-US/LibO-Dev_3.6.0alpha0_Win_x86_install-arc_en-US.tar.gz
$ cd LibO-Dev_3.6.0alpha0_Win_x86_install-arc_en-US/LOdev\ 3.6/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_3.6.0alpha0_Win_x86_install-arc_en-US\LOdev 3.6\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_3.6.0alpha0_Win_x86_install-arc_en-US/LOdev 3.6' <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.

Tricks of some use with winedbg:
--------------------------------

To examine OUStrings, you might want to use the following trick (prints 50
unicode characters of rLibName OUString - the +10 is where the buffer starts):

Wine-dbg>x /50u rLibName->pData+10
0x0909b6c8: vnd.sun.star.expand:$LO_LIB_DIR/abplo.dll

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

- 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) by others to
design a touch GUI for LibreOffice, so that is something that needs to
be done.

Obviously it will make sense to use only a part of LibreOffice's code
for iOS. Most likely lots of the GUI-oriented code should be left out,
and some iOS app(s) 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.

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.

Here is an autogen.lastrun for iOS (device) using Xcode 4.3 and clang,
and Xcode 3 for the build platform parts:
CXX=ccache /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang++ -arch armv7 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS5.0.sdk
CC=ccache /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -arch armv7 -isysroot /Applications/Xcode.app/Contents/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-system-nss
--without-help
--without-helppack-integration
--without-myspell-dicts

The --with-system-nss doesn't mean that any Mozilla NSS would be used,
it's just a trick to bypass some tests in the configure script.

For the iOS simulator, using Xcode 4.3 and clang both for the host and
build platform:

CXX=ccache /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang++ -arch i386 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator5.1.sdk
CC=ccache /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -arch i386 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator5.1.sdk
CC_FOR_BUILD=ccache clang -arch i386 -mmacosx-version-min=10.6
CXX_FOR_BUILD=ccache clang++ -arch i386 -mmacosx-version-min=10.6
--enable-werror
--with-build-platform-configure-options=--with-macosx-version-min-required=10.6 --with-macosx-sdk=10.6
--with-distro=LibreOfficeiOS
--with-system-nss
--without-help
--without-helppack-integration
--without-myspell-dicts

Note that you will have to install autoconf and automake yourself
before running autogen.sh. They are no longer included in Xcode 4.3
(not even in the add-on "command line tools").


Android
-------

From a technical point of view the core Android OS is Linux, but
everything else is different. Unlike iOS, an Android app can use
shared objects just fine, so that aspect of UNO doesn't need special
handling. Except that there is a silly low limit in the Android
dynamic linker on the number of libraries you can dlopen. Note that
this is a limitation of user-level code, not the kernel. Here are
various ways around this problem that are being examined.

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

Android cross-compilation work has been done 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 and Mac OS
X. Sure, for Windows, too, but trying to cross-compile LO from Windows
will probably drive you insane.

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

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-android-ndk=/Users/tml/android-ndk-r7b
--with-android-sdk=/Users/tml/android-sdk-macosx
--build=x86_64-apple-darwin11
--disable-zenity
--enable-werror
--with-distro=LibreOfficeAndroid
--disable-python
--without-helppack-integration
--without-myspell-dicts
--with-java

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

CC_FOR_BUILD=ccache gcc
CXX_FOR_BUILD=ccache g++
--with-android-ndk=/home/tml/android-ndk-r7b
--with-android-sdk=/home/tml/android-sdk-linux_x86
--with-ant-home=/opt/apache-ant-1.8.2
--build=x86_64-unknown-linux-gnu
--disable-zenity
--with-distro=LibreOfficeAndroid
--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 that hasn't been tested as nobody with an actual Android
device has worked on it yet...)  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 which invokes the
"ucalc" unit test code from sc, 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.

Note that lately (as of May 2012) the android/qa/sc test has not been
maintained, and might not build cleanly.

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.

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 and r8 is a bit broken, you can use
the one in a 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.

The Android test app which has been exercised lately is in
android/experimental/DocumentLoader.


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. Only a little experimenting has been done with
it. An 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