openmicroscopy/ome-documentation — pull request #192 by sbesson (2012-12-21 09:35:16+00:00)
Title: Extlinks review (rebased onto develop)

This is the same as gh-187 but rebased onto develop.

----

This PR reviews many extinks used across the OMERO docs

- **Source code**: the fork of the source code linked by the `:source:` and `:sourcedir:` aliases can now be specified by *SOURCE_USER* while the branch still uses *SOURCE_BRANCH*. This improvement will later on be used in combination with daily pushes to snoopycrimecop/openmicroscopy. Can be tested with:

````
SOURCE_USER=username SOURCE_BRANCH=branchname make clean html
````
- **Jenkins**: jenkins links have been reviewed and clean. Three general extlinks can now be used `:jenkins:`, `:jenkinsjob:` and `:jenkinsview:`. Two aliases are defined for the main OMERO job `:omerojob:` and `:javadoc:` for the generated Javadoc. All hard-coded *OMERO-trunk* have been removed and the name of the main OMERO job can be set with the *JENKINS_JOB* environment variable. Can be tested with:
````
JENKINS_JOB=OMERO-4.4 make clean html
````

- **Mailing-list**: mailing-list links have been reviewed. The ``mailinglist`` alias still points at the main page. Two aliases ``ome-users`` and ``ome-devel`` have been created to point at specific discussion threads.

- **README**: updated with 3 paragraphs explaining how to use Github, Jenkins and mailing-list aliases.

- An extlink has been defined for ZeroC links and all links have been reviewed (# 9964)The following
```
git grep zeroc\.com
```
should return no entry

- Multiple root variables have been defined before the extlinks dictionary to facilitate maintenance