summaryrefslogtreecommitdiff
path: root/development/macosx/README_MACOSX
Side-by-side diff
Diffstat (limited to 'development/macosx/README_MACOSX') (more/less context) (ignore whitespace changes)
-rw-r--r--development/macosx/README_MACOSX30
1 files changed, 24 insertions, 6 deletions
diff --git a/development/macosx/README_MACOSX b/development/macosx/README_MACOSX
index 4cb5908..ac62046 100644
--- a/development/macosx/README_MACOSX
+++ b/development/macosx/README_MACOSX
@@ -1,44 +1,43 @@
Information about porting Opie to MacOS-X (eilers)
==================================================
Credits:
--------
Special thanks to Andreas Junghans (webmaster@lucid-cake.net) for its patches for qt-X11 (2.3.2),
QT/E (2.3.5) and qtopia (1.6.1).
Without them, I wouldn't be able to provide the port for OPIE to MacOS-X that fast..
Thanks to Juergen Graf to debug this very generic README !
Status:
-------
+This work is done, do provide a development platform for Apple-Users! Please do not expect that you
+could create a productive Opie system for the Mac with it !!
+
The basic system works quite well. But a lot of applications and plugins,
which are platform specific, need some work to be compileable.
What is ready:
libqpe
libopie1
-libopie2/opiedb
+libopie2
pim-applications (addressbook, todolist, datebook, today)
A lot of applications and plugins which are not platform specific.
-What will follow soon:
-
-libopie2 (libopiecore and libopiedb works already !)
-
ToDO:
-----
There are some functions in the sourcecode which are not yet ported to Mac. If the
MacOS environment should be used for real productive work, the following functions
must be implemented correctly:
libopie/pim/otimezone.cpp:
Accessing of "setenv(...)" on Mac caused bus-errors.
Workaround/Fix: Unknown
Current-State: setenv() was just commented out. Thus the related functions may behave wrong!
library/filemanager.cpp:
The sendfile() function is not available in MacOSX. Therefore a workaround must be implemented.
Workaround/Fix: Unknown. The function is available in the header files, but disabled by a
"#ifdef SENDFILE" .. and not implemented int the c-library.
If it will be supported, it should activate itself automatically by the "#ifdef"..
@@ -83,45 +82,64 @@ export QTDIR=`pwd`
export QPEDIR=$QTDIR
export DYLD_LIBRARY_PATH=$QTDIR/lib
./configure -platform darwin-generic-g++ -qconfig qpe -qvfb -depths 4,8,16,32
make
Now create a link for the uic of qt-2.3.2 into the bin-directory of qt/e 2.3.7 !
Otherwise OPIE will fail to compile !
Compile OPIE:
Set your environment
(You may use the script "set_vars.sh" to set your variables successfully !
BUT: You have to customize this script for YOUR needs !!)
Go into the basic directory of Opie
make menuconfig"
set "Build Parameters"->"Target Machine"->"Mac OS X (DARWIN)" to activate the platform specific changes.
save and exit the menuconfig app
-make
+make (ATTENTION: See Known Bugs below!!)
You will see that a lot of applications and plugins/applets will not compile
successfully, due to the fact that they are not ported to this platform.
You may disable them to be able to compile the rest.
Remember: A lot of configuration-settings are not tested and might fail to compile.
If you want to avoid misconfigurations, you may want to start with
the config-file in this directory. Just copy "config_macosx" to $OPIEDIR/.config
to get a working configuration to start with.
(The missing apps/plugins will be ported on demand.)
+Known Bugs (compilation problems):
+-----------
+The Apple-Linker does not load indirect linked libraries automatically ( if somebody
+has a solution here, please inform me !!), therefore I had to add "-lopiedb2" and "-lqpe"
+for applications/libraries who used libraries which are linked against them.
+A goot solution would be to add it in the project files of these application, but this would
+influence the linux-platform as well... :(
+As a first (but stupid) solution, I added this linker parameter to the global "include.pro"
+which adds them for everything.. Yes, also for libqpe etc..
+Therefore this project will not compile out of the box. You have to compile in a two-pass way:
+
+Pass 1: Find the line "LIBS += -lopiedb2 -lqpe" in the file include.pro and comment out it (put a "#"
+ in front of it)
+ Do a "make -k" to compile what is already compileable (some will not compile)
+Pass 2: Remove the comment from Pass1 and do a "make". The rest should compile now successfully.
+
+
+I know, this is a silly solution ! But I don't have anything better without influence the Linux build
+process too much .. I would be happy, if somebody could help me here !
SPECIAL INFORMATION FOR USERS OF PANTHER
----------------------------------------
I had a lot of problems compiling qt-2.3.2 and QT/E-2.3.7 on Panther. The
new release of the X-Server causes a lot of trouble..
To compile QT-2.3.2 successfully, you have to disable support of freetype fonts and you have
to use the patch in this directory, otherwise your wont't be able to compile !
Use the param "-no-xft" for the configure script to disable this function !
Information for Developers:
---------------------------
1. Platform specific code should be surrounded by
#ifdef Q_OS_MACX
MACOS-X CODE