CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/svn-multi

README
--------------------------------------------------------------
 svn-multi (was svnkw)
--------------------------------------------------------------

This package lets you typeset keywords of the version
control system Subversion inside your LaTeX files anywhere
you like. Unlike the very similar package 'svn' the usage of
multiple files for one LaTeX document is well supported.

Copyright (C) 2006-2010 Martin Scharrer
E-mail: martin@scharrer-online.de
WWW: http://latex.scharrer-online.de/svn-multi/

This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3c
of this license or (at your option) any later version.
The latest version of this license is in
  http://www.latex-project.org/lppl.txt
and version 1.3c or later is part of all distributions of LaTeX
version 2008/05/04 or later.

This work has the LPPL maintenance status `maintained'.

The Current Maintainer of this work is Martin Scharrer.

This work consists of the files svn-multi.dtx, svn-multi-pl.dtx, svn-multi.ins
and the derived files svn-multi.sty, svnkw.sty and svn-multi.pl.


Tiny example:
~~~~~~~~~~~~~
Put the following Subversion keyword at the start of all your LaTeX files of
your document:

\svnidlong
{$HeadURL$}
{$LastChangedDate$}
{$LastChangedRevision$}
{$LastChangedBy$}

or

\svnid{$Id$}

or both.
Attach the subversion property svn:keyword with a value of 
'URL Date Revision Author', 'Id' or both, respectively, to all LaTeX files.
Subversion will expand this keywords the next time the files are committed and
then the SVN information can be typeset using
    \svnauthor, \svnrev, \svndate, \svnhour, ...
which will hold the information of the latest comitted file
anywhere in your multi-file LaTeX document.

Also per-file macros exist:
    \svnfileauthor, \svnfilerev, ...
which hold the keyword values of the current file.


INSTALL:
~~~~~~~~
From the .dtx file (if you don't get the .sty files directly):
==================
Unpack the zip file and run 'make'.
You also can do it manually:
  [pdf]latex svn-multi.ins      # for the style file and perl script
  [pdf]latex svn-multi.dtx      # for the documentation
2x[pdf]latex example-main       # for the example

For the large keyword group example document:
  [pdf]latex group-example
  perl svn-multi.pl group-example
2x[pdf]latex group-example

Place the two .sty files
  svn-multi.sty         # Package
  svnkw.sty             # Wrapper for backward compatibility
into your TEXMF tree, e.g. in
  $TEXMF/tex/latex/svn-multi

Make the perl script svn-multi.pl executable:
  chmod +x svn-multi.pl
and place it in an directory in your $PATH, e.g. under Unix/Linux in
  /usr/bin/svn-multi.pl          or
  /usr/local/bin/svn-multi.pl    or
  $HOME/bin/svn-multi.pl
Consider to rename or link it to 'svn-multi'.

Download the contents of this package in one zip archive (436.2k).

svn-multi – Subversion keywords in multi-file documents

This package lets you typeset keywords of the version control system Subversion inside your files anywhere you like. Unlike the otherwise similar package svn the use of multiple files for one document is well supported.

The package uses the author’s filehook and currfile packages.

The package interacts with an external Perl script, to retrieve information necessary for the required output.

Packagesvn-multi
Home pagehttps://github.com/MartinScharrer/svn-multi
Bug trackerhttps://github.com/MartinScharrer/svn-multi/issues
Repositoryhttps://github.com/MartinScharrer/svn-multi.git
Version2.4d
LicensesThe Project Public License
Copyright2006–2009 Martin Scharrer
MaintainerMartin Scharrer
TDS archivesvn-multi.tds.zip
Contained inTeX Live as svn-multi
MiKTeX as svn-multi
TopicsDocument Management
Version control
See alsosvn
svninfo
...
Guest Book Sitemap Contact Contact Author