{{GRF_TITLE}}
-----------------------------------

Contents:

1 About
2 Requirements
3 Installation
  3.1 Parameter settings
4 Usage
  4.1 List of vehicles
5 License
6 Credits
7 Building from source
  7.1 Obtaining the source
  7.2 Dependencies
  7.3 Makefile targets
  7.4 Speed issues



-------
1 About
-------

Dutch Trains is New Graphics Set which adds a great number of both 
historical and current Dutch trains to OpenTTD.

{{GRF_TITLE}}
Filename: {{FILENAME}}
MD5Hash:  {{GRF_MD5}}
Version:  {{REPO_REVISION}}
GRF ID:   {{GRF_ID}}





--------------
2 Requirements
--------------

You need a recent version of OpenTTD to be able to use all features of 
the Dutch Tram Set. A recent version of OpenTTD can be obtained from 
http://www.openttd.org/.

If you play TTDPatch, you can get an older version of this set that 
works in TTDPatch from here: 
http://users2.tt-forums.net/dutchset/downloads.php



--------------
3 Installation
--------------

By far the easiest way to install is to aquire the Dutch Trains 
via the ingame Content Download feature. How to do this is explained at
http://wiki.openttd.org/Online_content.

If you somehow cannot use the Content Download feature, you need to copy
the Dutch Trains .grf file to the OpenTTD data directory. The OpenTTD 
readme explains where you can find this directory.

The final step is to activate the Dutch Trains.
This is done via the NewGRF Settings window, which is explained here:
http://wiki.openttd.org/NewGRF.
Now you can use the Dutch Trains in your new games.


3.1 Parameter Settings
----------------------




-------
4 Usage
-------




4.1 List of vehicles
--------------------




---------
5 License
---------

Dutch Trains - Trains of The Netherlands for OpenTTD
Copyright (C) 2003-2011 Dutch Trainset Team

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.



---------
6 Credits
---------

Dutch Trainset Team:
--------------------
* Hyronymus
* Purno
* Bastiaan
Graphics by: 
* Bastiaan, 
* DanMacK, 
* Purno, 
* Snail, 
* Wile E. Coyote 
* and others
Coded by:
* FooBar

Makefile system:
----------------
Ingo von Borstel (planetmaker)

Special Thanks to:
------------------
* NML developers
* AndersI and jvassie
* Everybody involved with the development of Dutch Trainset v1.0
* #openttdcoop DevZone for providing the repository, bug tracker, 
  nightly builds and much more!



----------------------
7 Building from source
----------------------

Usually there's not much which needs to be changed when you obtain the
source. Your friends will usually be
    make
	make install
Both will build the grf from source, the latter will also try to copy
the grf into your grf folder so that it is available for testing and
use straight away.


7.1 Obtaining the source
------------------------

The source code can be obtained from the #openttdcoop DevZone at
    http://dev.openttdcoop.org/projects/dutchtramset
or via mercurial checkout
    hg clone http://hg.openttdcoop.org/dutchtramset


7.2 Dependencies
----------------

Requirements for running the Makefile successfully:
	NML
	gcc
	md5sum (or md5 on Mac)
	make
    mercurial (recommended)
    python (recommended)

If you want to bundle the grf, you'll need additionally
	tar
	zip
	bzip2
	unix2dos (optional)

Windows only:
On Windows systems this means that you'll need to install MinGW and MSys
in order to obtain a posix compatible environment. Then the makefile can
be called the very same way as it is on linux and mac systems.
MinGW/MSys contain the above mentioned programmes (except NML of course) 
and can be obtained from http://www.mingw.org/ That site also features 
an excellent walk-through on how to install it.0

If you use for OpenTTD data folder a non-default path or Windows with a
non-English localization make sure to copy Makefile.local.sample to
Makefile.local and edit the line with
	INSTALLDIR =
accordingly so that it shows the full path to your OpenTTD data
directory.


7.3 Makefile targets
--------------------

A brief overview over all Makefile targets is given here:

all:
	This is the default target, if also no parameter is given to
	make. It will simply build the grf file, if it needs building

depend:
	Re-run the dependency check. Usually not manually needed.

docs:
	Build the documentation files

bundle:
	This target will create a directory called "<name>-nightly" and
	copy the grf file there and the documentation files, readme.txt,
	changelog.txt and license.txt

bundle_zip
	This will zip the bundle directory into one zip for distribution

bundle_tar
	This will tar the bundle directory into a tar archive for
	distribution or upload to bananas

bundle_src
	Creates a source bundle

install:
	This will create a tar archive (like bundle_tar) and copy it
	into the INSTALLDIR as specified in Makefile.local (or the
	default dir, if that isn't defined). Don't rely on a good
	detection of the default installation directory. It's
	especially bound to fail on windows machines.

distclean:
	This phony target cleans everything from a source bundle which
	wasn't shipped.

clean:
	This phony target will delete all files which this Makefile will
	create

mrproper:
	This phony target will delete also all directories created by
	different Makefile targets

remake:
	It's a shortcut for first cleaning the dir and then making the
	grf anew.

addcheck:
	Check whether there are some files required but not part of the
	repository.

check:
	Check the md5sum of the built newgrf against the supplied md5sum
	(Intended to be used when building from tar balls)


7.4 Speed issues
----------------

A note concerning the speed of the makefile:
It seems that the required tools using MinGW and / or msys are thoroughly
slow on Windows. A few example run times for OpenGFX, same processor type
(both core 2 duo, 2.26GHz for the windows machine, 2.0 GHz for the OSX
machine). Note that the values given are the 'real' time. Even though
this varies more and is dependent on the processor load, that's what you
have to wait for; the 'user' times are quite low on the Windows machine
(~16s), but that by no means reflects the build time. Times are from
OpenGFX r539 with makefile r199.

DEP_CHECK_TYPE         Windows               bash native
                 native       in VM            (OSX)
none            1m23.360s      -             0m32.781s
mdep            1m54.484s   0m30.164s        0m33.807s
normal          2m37.857s      -             0m36.528s