···99Darling uses many Git submodules, so a plain clone will not do.
10101111````
1212-git clone https://github.com/darlinghq/darling.git
1313-cd darling
1414-git submodule init
1515-git submodule update
1212+git clone -r https://github.com/darlinghq/darling.git
1613````
17141815Updating sources:
···25222623## Build Instructions
27242525+For complete instructions, visit [DarlingHQ.org](http://www.darlinghq.org/build-instructions).
2626+2827#### For running x86-64 OS X binaries
29283029<a href="http://teamcity.dolezel.info/viewType.html?buildTypeId=Darling_DebianStableX8664&guest=1">
···4544make install
4645````
47464848-Required dependencies on Debian (stable): cmake clang bison flex linux-headers-amd64 xz-utils libfuse-dev libxml2-dev libicu-dev libssl-dev libbz2-dev zlib1g-dev libudev-dev
4949-5047#### For running i386 OS X binaries
51485249<a href="http://teamcity.dolezel.info/viewType.html?buildTypeId=Darling_DebianStableX8664&guest=1">
···6259make install
6360````
64616565-Required additional dependencies on Debian (stable): libc6-dev-i386 libudev-dev:i386 lib32stdc++-4.9-dev
6666-6762Loading the kernel module:
6863````
6964modprobe darling-mach
···7772chmod a+rw /dev/mach
7873````
79748080-### Optional Features
8181-8282-Optionally, you can enable audio support with the ````-DFRAMEWORK_COREAUDIO=On````. This is still under development, so it probably only makes sense if you want to contribute.
8383-This switch enables both ALSA and PulseAudio support by default, you can disable either of them with ````-DENABLE_ALSA=OFF```` or ````-DENABLE_PULSEAUDIO=OFF```` respectively.
8484-8585-Required dependencies on Debian (stable):
8686-8787-* x86-64: libpulse-dev libasound2-dev libavresample-dev libavformat-dev libavcodec-dev
8888-* i386: libpulse-dev:i386 libasound2-dev:i386 libavresample-dev:i386 libavformat-dev:i386 libavcodec-dev:i386
8989-9090-Note that most of the above -dev packages conflict between x86-64 and i386, so if you build for both platforms, you have to reinstall the right -dev variants before every build. There should be no issues at runtime.
9191-9292-## Using Darling
9393-9494-Darling uses DPREFIXes, which are in essence similar to WINEPREFIXes. The are virtual chroot environment with an OS X-like filesystem hierarchy, where you can safely install and run software. Unless you set DPREFIX to your location, the default ````~/.darling```` is used.
9595-9696-The real root filesystem is available through ````/system-root```` and the ````/home```` directory is automatically symlinked, so you should feel at home right away.
9797-9898-At first use, initial prefix contents are downloaded from the Internet.
9999-10075### Hello world
1017610277Let's start with a Hello world:
···1108511186### Installing software
11287113113-You can install ````.pkg```` packages with the installer tool available inside shell. It is a somewhat limited cousin of OS X's installer:
8888+You can install `.pkg` packages with the installer tool available inside shell. It is a somewhat limited cousin of OS X's installer:
1148911590````
11691$ darling shell
11792Darling [~]$ installer -pkg mc-4.8.7-0.pkg -target /
11893````
11994120120-If you have previously downloaded the Midnight Commander package from [Rudix](http://rudix.org), you can now run ````mc```` to start MC for OS X. Note that not all Rudix packages may work under Darling, namely the Rudix Package Manager doesn't work, as Darling doesn't yet build its own Python runtime.
9595+If you have previously downloaded the Midnight Commander package from [Rudix](http://rudix.org), you can now run `mc` to start MC for OS X. For easier installation, install the Rudix Package Manager. Note that not all Rudix packages may work under Darling.
12196122122-You can uninstall and list packages with the ````uninstaller```` command.
9797+You can uninstall and list packages with the `uninstaller` command.
1239812499### Working with DMG images
125100126126-DMG images can be attached and deattached from inside ````darling shell```` with ````hdiutil````. This is how you can install Xcode along with its toolchain and SDKs (note that Xcode itself doesn't run yet):
101101+DMG images can be attached and deattached from inside `darling shell` with `hdiutil`. This is how you can install Xcode along with its toolchain and SDKs (note that Xcode itself doesn't run yet):
127102128103````
129104Darling [~]$ hdiutil attach Xcode_7.2.dmg