Fix references to examples in api documentation

The documentation displayed references to examples in the main docs but not in
the corresponding api reference docs.  The build had these warnings..

: WARNING: Include file u'/Users/khaido/workspace/jenkins-job-builder/doc/source/api/
../../tests/properties/fixtures/batch-task.yaml' not found or reading it failed

As pointed out by Darragh[1] the problem was that literalinclude needs a leading '/' to
correctly reference both docs.

[1] https://review.openstack.org/#/c/48783/15/jenkins_jobs/local_yaml.py

Change-Id: Ib1f8ccca40af1ee54c2bd00b2b42ba39e3c0c8e5
Fix multibyte character problem

Fixed problem that causes a UnicodeEncodeError when use multi-byte characters in the job.yml.

Change-Id: Ie715c827a794e73fae11cdca079ea80cfb8c280d
Add local-branch option

Change-Id: I5883992afc0875e2f464ff3f576b067f7d5b4ce8
make job creation consistent

Defining a project (in yaml) without setting any other parameters should
generate a basic jenkins job (in xml).  While this works for freestyle jobs,
jjb will throw an error for maven and flow projects.  The behavior should be
consistent across all types of projects.  This patch just makes it so
that the behavior is consistent.

Change-Id: If7b749dae7631e8714a9416dfbd82d2443c0302c
tests: Allow to test project parameters

So far it wasn't possible to test the prameters of the
project itself. While If7b749dae7631e8714a9416dfbd82d2443c0302c
already made the job creation consistent this goes one step further
and creates the root_xml using the project's root_xml method.

Change-Id: Ieba4203d3d23ad68df5a1246e90ea8c03ddd54d4
project_maven: Don't require artifact-id and group-id

Jenkins will determine the values from the pom automatically so there's
no need to require them.

Change-Id: Ic1c9c26a05e335fd78a92fe4316ecc88b3f209b9
Add support for credentials-id in git repositories.

Original change by Soren Hansen <Soren.Hansen@ril.com>

Change-Id: I2ad6d5b7d8a5cc89596c41463dc7906780b61515
Added rbenv wrapper

Change-Id: Iefab7b71b96998789a66b3e1ea03f28fbfc38391
Merge "Added rbenv wrapper"
Add support for Test Stability with Junit

Adds test-stability option to junit test result
publisher, requires Test stability plugin to be installed.

https://wiki.jenkins-ci.org/display/JENKINS/Test+stability+plugin

Change-Id: Idd7ef1bdeaf9e6fd8881bab5729950dc717ce9f3
Add tests for YamlParser and patch 2.6 minidom

Test full build job XML produced by the YamlParser object which exposed
differences in how the XML was being written on python 2.6 versus newer
versions of python.

Differences were whitespace only, but made testing and validating the
xml outputted across multiple versions of python difficult.

Code now patches the python 2.6 writexml method on the Element class in
the xml.dom.minidom module, with a version of the method taken from
python 2.7.5.

Removed the now obsolete regex that was reformatting the output on
python 2.6.

Change-Id: I26c100b6adfbcb9b197bb06cd162855adaaf24c5
Merge "make job creation consistent"
Merge "tests: Allow to test project parameters"
Merge "project_maven: Don't require artifact-id and group-id"
Merge "Add support for credentials-id in git repositories."
project_maven: allow to set private repository

The values map to these GUI choices

 * default            -> Default
 * local-to-executor  -> Local to the executor
 * local-to-workspace -> Local to the workspace

This is on the project level what the similar option is on the builder
level.

Change-Id: I90ee3385ee12a46b5ab1eb26e3af1bdbfc36946a
Merge "Add tests for YamlParser and patch 2.6 minidom"
Merge "Add support for Test Stability with Junit"
Merge "Fix references to examples in api documentation"
Zuul trigger no more send GERRIT_* env variable

Recent version of Zuul no more pass GERRIT_* parameters to job. So I
guess we can stop configuring jenkins jobs to use them.

jenkins_jobs/openstack/common/setup.py stills reference GERRIT_REFNAME.
It seems that file got imported from another repository but I have not
found the original repository :(

Change-Id: Ia97319f96a00394b3321a484310975a10f574f13