README

Getting Started
===============

0. Ask Chuck Norris for permission

1. Get a login to http://github.com/

2. Fork http://github.com/davedf/cuke4ninja you will now have a url like 

	http://github.com/your-login-name/cuke4ninja

3. Clone your fork to create a local repository

	git clone https://your-login-name@github.com/your-login-name/cuke4ninja.git

4. Add davedf's branch as a remote (this will be the effective trunk)

	git remote add davedf git://github.com/davedf/cuke4ninja.git

5. Watch davedf's branch on http://github.com/davedf/cuke4ninja
	This means you will get pull requests

6. get Xalan http://xml.apache.org/xalan-j/downloads.html

7. get XEP (personal edition) http://www.renderx.com

8. copy resources/environment.template to resources/environment.local to set XEP and XALAN paths

9. get docbook-xsl from http://sourceforge.net/projects/docbook/files/, unpack it to resources/xsl (so that there is a folder resources/xsl/fo) 

10. run checksetup.sh in the resources folder to check your configuration

11. go to ../plainbook

12. run make docbook

13. open docbook.pdf


When you get a pull request
===========================

1. check the status of your clone
	git status

2. add/or checkout until your clone is clean

3. pull changes from davedf's branch

git pull davedf master

4. push the changes to your fork on github

git push origin master


When you want to get your changes back to GitHub
================================================

1. get the current status

git status

2. add any new files to the change list

git add file-name ...

3. Add any changed files to the change list and commit

git add file-name
...
git commit -m"message"

or

commit -a -m"message"

to commit all changed files

4. push the changes to your fork on github

git push origin master

If you want the changes to be pulled, send a pull request on github

Chuck Norris does not need to request a pull, you already have his changes, as he types