[XERCESC-2136] Add support for versioning sources and documentation automatically

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.2.0
• Fix Version/s: 3.2.1
• Component/s: Build, Utilities
• Assignee: Roger Leigh
• Reporter: Roger Leigh
• Created: 13/Feb/18 21:34
• Updated: 01/Mar/18 01:17
• Resolved: 15/Feb/18 11:18

Description

Making a release requires a number of manual updates to various files including:

• configure.ac
• versions.incl
• xerces-c.spec
• src/xercesc/util/XercesVersion.hpp
• doc/style/dtd/entities.ent
• doc/source-repository.xml
• doc/Doxyfile

It would be more efficient to make the majority of these updates automatic.

 

I've worked on some simple updates to the autoconf and cmake builds to do the following:

• move library versioning into configure.ac (no separate updates to versions.incl)
• generate a Xerces_version_config.hpp header like the Xerces_autoconf_config.hpp header, for inclusion by XercesVersion.hpp
• generating entities.ent to automate docs version updates
• making source-repository.xml use version entities to eliminate manual updates
• generating Doxyfile to avoid manual version updates

 

This narrows down updates to two files:

• configure.ac
• xerces-c.spec

 

I'll attach a patch once I've done some more testing.