Developers Guide Pierre d'Herbemont What you have to know to hack on Darwine. How to help the project

Accessing the CVS repository

Two CVS Repositories are in use. The WineHQ's cvs holds the Wine sources, and the Darwine's OpenDarwin.org cvs holds everything else: the website (in darwine/www), WineHelper (in darwine/WineHelper), and some custom Qemu work (in darwine/related/qemu).

Accessing the WineHQ's CVS Repository See the recommendations on the WineHQ to checkout wine's source code. Accessing the Darwine@OpenDarwin's CVS Repository

  • via CVSWeb
  • via Anonymous CVS cvs -d:pserver:anonymous@ anoncvs.opendarwin.org:/Volumes/src/cvs/od checkout projects/darwine
OpenDarwin.org provides also information on how to retrieve the OpenDarwin.org repository.

Building the source code Building Wine

First get Wine sources from the WineHQ.

Then cd wine/dir if you use a bash shell: export MACOSX_DEPLOYMENT_TARGET=10.2 else if you use a tcsh shell: setenv MACOSX_DEPLOYMENT_TARGET 10.2 and ./configure && make

Building WineHelper

First checkout WineHelper from the darwine repository on cvs.opendarwin.org.

Open the Xcode project in the WineHelper folder and choose Build

 Building QEMU with darwin-user

First checkout WineHelper from the darwine repository on cvs.opendarwin.org.

Then cd qemu/dir if you use a bash shell: ./configure --target-list=i386-darwin-user ppc-darwin-user
make

to test it make a simple hello world: #include <stdio.h>
int main()
{
printf("hello World!");
}
 Build it the following way: gcc -arch ppc -seg1addr 0x500000 helloworld.c -o helloworld-ppc You have to relocate it to 0x500000 because qemu uses the default base address for itself, and an executable relocation is not supported by dyld.
(for now ppc-darwin-user works better than i386-darwin-user)
then ./ppc-darwin-user/qemu-ppc helloworld-ppc

To try the i386-darwin-user, you'll need a cross compiling toolchain, and the i386 libraries and dynamic linker (dyld) needed for execution. You can download the binaries on Kevin Van Vechten's homepage.

Contributing Sending Patch Patches against the Darwine's CVS Repository

First create your patch by : cd darwine_cvs_folder
cvs update -dP
cvs diff -u the_file_or_folder/to/diff Then send it to the darwine-devel mailing-list. Add to the email's subject the keyword [Patch]. And describe the change you've done, the more extensively as possible.

Patches against the WineHQ's CVS Repository

We use the WineHQ's cvs repository for the Wine sources. Thus modifications to Wine has to be send to the WineHQ. Read the winehq recommendations for Submitting Patches. Then generate a patch. Send it to the wine-patches mailing- according to the previous recommendations. You should also CC the email to the darwine-devel mailing-list.