Submitting a patch

If you make changes to Apache UIMA, and would like to contribute this to the project, you should open a JIRA issue and discuss the changes with the developer community. If there is agreement, create a patch and attach it to the JIRA issue. To create a patch, use the Eclipse Team -> Create Patch command select the project in the Package Explorer, right click it to find the Team menu in the context menu). Or, use the command line and execute the svn diff command. This creates a patch that can easily be uploaded to a JIRA issue. A good name for the patch includes the JIRA issue name, e.g. UIMA-104.patch. If there are several patches for the same JIRA issue, you might include a short identifying description, or your initials, e.g. UIMA-104.clr.patch % svn diff > UIMA-104.clr.patch

Committing changes to subversion

To commit changes to the subversion repository, you must be an Apache UIMA committer. See get involved for information on how to become a committer and how to set up your password once you become a committer. Once your password is set, you can commit from Eclipse using the Team -> commit context menu. You can do this on an individual file, a set of files or directories (multi-select), or on whole project(s). You can also commit from the command line like this: $> svn commit --username your-username \ Authentication realm: <https://svn.apache.org:443> \ ASF Committers Password for 'your-username': your-password You can also pass your password on the command line directly, but this is a security problem on multiuser unix computers (the command line arguments are available via the ps command). Here is the command if you are Windows or a single user unix computer: $> svn commit --username your-username \ --password your-password Remember to replace 'your-username' and 'your-password' with your actual username and password on svn.apache.org. Please also add to your commit statement an appropriate message that explains the changes you did. You can add a message when adding --message to your commit statement: $> svn commit --username your-username \ --password your-password --message your-message Please always enter the JIRA issue key or keys (if more than one issue) and optionally, the JIRA issue link to the commit message. The issue key (e.g., UIMA-555) is important so that the JIRA SVN plugin can detect the changes automatically. Only specifying the issue link does not work correctly, for details please see the JIRA issue https://jira.atlassian.com/browse/SVN-37.