Sversion 1.1 (Apr 07, 2010)

Derives a revision number for incorporation into Latex documentation. The script may be run with several command-line options

For additional information about this project, please visit the project page .

Available downloads

sversion

For All platforms (9.6 kB)

Release Notes

Command-line switches:

sversion [-h|--help] 
sversion -v <version> -r <revision> -f <version file> -t <latex version file> 

• -h or --help requests help to be displayed including the version of the script
  
• -v or --ver specifies a version number to be used rather than read from an input file version.txt; if no version number can be computed a default value of 0.0 will be used
  
• -r or --rev specifies a subversion revision number to used rather than acquired from the subversion repository
  
• -f or --file specifies a filename to be used to read the version number from, this can include a path; defaults to sversion.txt
• -t or --texfile specifies a filename to be used to save the Latex cammands to, this can include a path; defaults to sversion.tex. This is the name that should be A include in Latex documents.

This script queries a subversion repository to acquire revision details. This data is saved to a simple file which constructs a number of variables which are then available to any Latex document which includes the command file. These variables include:

• \svnversion the current version of a project; this is defined in a simple text file or can be provided via a command-line switch
  
• \svnrevision the full version number of the project incluuding the most recent revision committed; this is taken either directly from the project’s subversion repository or provided as a runtime option
  
• \svndate the date of the last commit; taken from the subversion repository
  
• \svnauthor the author responsible for the last commit; taken from the subversion repository

The variables will be available to a Latex document when a command similar to

\include{sversion}

is included in the document preamble (where sversion refers to a file name of sversion.tex)

Files

sversion.txt - an input file containing leading version numbers and sversion.tex a file which can be included in a Latex document to provide the subversion variables. Both files can be over-ridden using command-line switches

Change log

see initial specification