[DERBY-4851] Parameterize documentation sources so that release-time variables (like copyright year and release id) can be plugged in when we build a release

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 10.7.1.1
• Component/s: Documentation
• Assignee: Richard N. Hillegas
• Reporter: Richard N. Hillegas
• Created: 14/Oct/10 18:18
• Updated: 12/Jan/11 18:27
• Resolved: 02/Nov/10 14:09

Description

Right now there are a number of strings which have to be updated in the user guides every time that we cut a branch or generate a release candidate. We should parameterize these strings so that the build script can fill them in. Probably we will have to use the ant substitution task for this because there is no obvious way to do this via DITA.

These are the variables I am aware of. Please let me know if there are others:

Latest copyright year (currently 2010)
2 part version number (e.g., 10.7) (this is plugged into the ij script output, among other uses)
4 part version number (e.g. 10.7.1.0)
subversion revision number (e.g. 1000400)

Issue Links

• is related to: DERBY-4875 cross-manual xref problems after doc build change
• is related to: DERBY-4826 Documentation tasks for new minor release of Derby