Hudson Generic Changelog Annotator Plugin

This plugin allows the administrator to specify pairs of patterns and URLs, both globally and on a per-job level, to use for marking up changelog text. For example, if the pattern:

(ABC\d+)

is paired with the URL:

http://some.site.com/tool?query=$1

the text "Example ABC123." in a changelog entry would be replaced with:

Example <a href="http://some.site.com/tool?query=ABC123">ABC123</a>.

Pattern format and URL replacement:

• Patterns are standard Java regular expressions.
  • Note that backslashes do not need to be escaped in patterns - \d+ works,
    d+ does not.
• $1, $2, etc... can be used in the URL. They will be replaced by the first, second, etc. grouping in the pattern.
  • Note that the displayed text will not change - it will only be wrapped with the link.

Configuration

• To define pattern/URL pairs globally:
  • Go to Manage Hudson->Configure Server.
  • Click Add in the "Global Change Log Annotations" section, near the bottom of the page.
  • Enter the pattern and URL.
  • Add additional pattern/URL pairs if desired.
  • Check or uncheck box to apply global patterns to all projects, or only when projects "opt-in".
  • Save your changes.
• To define pattern/URL pairs for a single job, or to override globally defined pattern/URL pairs for a single job:
  • Go to the Configuration page for your job.
  • Find the "Change log annotations" checkbox in the top section.
  • Mark the checkbox, if it is not already checked.
  • Check or uncheck box to apply global patterns for this project.
  • If you want to add individual patterns for just this job, then Click Add in the "Pattern/URL pairs" section, and enter the pattern and URL.
  • Add additional pattern/URL pairs as desired.
  • Save your changes.

Change Log

Version 1.3 (May 6, 2010)

• Avoid NPE and missing changelogs in jobs that used HGCA before version 1.2 (JENKINS-6367)

Version 1.2 (Apr 5, 2010)

• Added option to apply global patterns to all projects.
• Documented NUM and ANYWORD tokens that were already present in previous releases.

Version 1.1 (Dec 29, 2009)

• Update uses of deprecated APIs
• Remove debug output

Version 1.0 (Mar 17, 2009)

• Initial checkin and release.