GOM : Module
module
A module is a collection of projects that are physically stored in a single repository.
| Attribute | Description | Required? |
|---|---|---|
| name | The name of the module. | Yes |
| tag | Override the cvs tag to be used. | No |
| debug | Set to "true" to turn on module debugging. | No |
| groupId | mvn groupId for artifacts built by the projects contained in this module. | No, defaults to the module's name |
url
This is the homepage for the collection of projects contained in this module. This element is optional, but if present, will be referenced in the generated web pages containing build results.
Note: give the way that Gump uses href to specify definitions which are to be inlined, the design of this element is rather unfortunate. Perhaps it should be replaced with a <home-page> element.
| Attribute | Description | Required? |
|---|---|---|
| href | URL of home page | Yes |
| srcdir | The directory (relative to the workspace's basedir) which the checked out sources are to be copied for build purposes. | No. Defaults to the name of the module. |
description
If present, will contain information added to the title in web pages containing build results.
cvs
References the repository in which this project resides. May also contain various overrides.
Note: as the long term plans is to make Gump handle many different types of repository types, the name of this element should ultimately change
| Attribute | Description | Required? |
|---|---|---|
| repository | The name of the repository in which this module resides. | Yes |
| host-prefix | Additional information which will be added in the front of the host name. Useful for repositories like sorceforge which define a separate virtual host for every project | No |
| dir | The subdirectory in which the cvs module is present. Useful for repositories like developerworks which organize related modules into directories. | No |
| module | An override for the name of the cvs module. | No. Defaults to the name of the module. |
| tag | Specify the cvs tag desired. | No. Effectively defaults to HEAD. |
| compress | Set the compression level. Some CVS client/server combinations will not work with compression. | No. Defaults to the compress value for the repository |
svn
References a Subversion repository in which this project resides.
| Attribute | Description | Required? |
|---|---|---|
| url | The url of the repository in which this module resides. | Yes |
For example:
<svn url="http://svn.collab.net/repos/svn/trunk" />
p4
References a Perforce repository in which this project resides.
| Attribute | Description | Required? |
|---|---|---|
| repository | The name of the repository in which this module resides. | Yes |
For example:
<p4 repository="my-p4-repository"/>
project
A definition of a project which is physically contained in this module.
redistributable
If present, indicates that outputs of builds from this module are redistributable. Defaults to the redistributable value for the repository.
by Sam Ruby