Purpose of this document
------------------------
This document provides instructions on how to obtain and install a copy of
dgsmonX. The instructions are given both for the binary and for the source
distribution of dgsmonX. In the case of the source distribution, this includes
instructions on how to build the project with Xcode.


Binary installation
--------------------
If you don't want to build dgsmonX from source by yourself, just follow these
steps:

- Download the installation disk image (.dmg file) of the version of dgsmonX
  that you wish to install from the download section of the dgsmonX homepage
  http://www.herzbube.ch/dgsmonx
- Open the disk image by double-clicking it in the Finder
- In the Finder, drag the application icon to any location on one of your
  volumes
- That's all, folks :-)

If you want to completely remove dgsmonX from your system, simply delete the
application and the associated preferences file
~/Library/Preferences/ch.herzbube.dgsmonX.plist
(the tilde sign "~" stands for your user home directory).


Source installation
-------------------
Get the tar ball containing the sources of the version of dgsmonX you wish to
build from the download section of the dgsmonX homepage. The tar ball will
expand into its own sub-directory. The source files are located in the Sources
sub-directory (duh!).

To be able to build dgsmonX, you need Xcode 4 or newer installed. To build
dgsmonX, first launch Xcode by double-clicking on the .xcodeproj file in the
Finder. The name of the target that you are interested in is "dgsmonX". You may
choose between one of the build-styles "Debug" and "Release". Unless you want
to do some programming and test your changes, you should choose the "Release"
build style. Now you can choose "Build", or "Run" from the Product menu.

dgsmonX should build without errors. If it doesn't, please let me know so that
I may correct the error in the project settings for future releases. After the
build has finished, the application can be found in the "Derived Data" folder.
Where exactly this folder is located depends on how you have set up Xcode. To
find out the location, open the preferences window in Xcode, then navigate to
the "Locations" tab.
