summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/svn-multi/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-03-23 23:55:25 +0000
committerKarl Berry <karl@freefriends.org>2009-03-23 23:55:25 +0000
commitf3e4da8de0bec75f027ec22af12443c9cfa2a0f6 (patch)
tree379874ddfb450374aa4041d4cfe33ba339650cd6 /Master/texmf-dist/doc/latex/svn-multi/README
parent7c3f2bb14d2593c80109a9f0d28f3310dcb60c9b (diff)
svn-multi 2.0 (23mar09)
git-svn-id: svn://tug.org/texlive/trunk@12503 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/svn-multi/README')
-rw-r--r--Master/texmf-dist/doc/latex/svn-multi/README50
1 files changed, 37 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/latex/svn-multi/README b/Master/texmf-dist/doc/latex/svn-multi/README
index b2ccffbaab5..7b5ef2e18a5 100644
--- a/Master/texmf-dist/doc/latex/svn-multi/README
+++ b/Master/texmf-dist/doc/latex/svn-multi/README
@@ -1,6 +1,6 @@
--------------------------------------------------------------
svn-multi (was svnkw)
- version 1.5, Feb 28th, 2009
+ version 2.0, Mar 23rd, 2009
--------------------------------------------------------------
This package lets you typeset keywords of the version
@@ -13,30 +13,41 @@ E-mail: martin@scharrer-online.de
WWW: http://www.scharrer-online.de/latex/svn-multi/
This work may be distributed and/or modified under the
-conditions of the LaTeX Project Public License, either version 1.3
+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.3 or later is part of all distributions of LaTeX
-version 2005/12/01 or later.
+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 and svn-multi.ins
-and the derived files svn-multi.sty and svnkw.sty.
+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 in all your LaTeX files of
+Put the following Subversion keyword at the start of all your LaTeX files of
your document:
+\svnidlong
+{$HeadURL$}
+{$LastChangedDate$}
+{$LastChangedRevision$}
+{$LastChangedBy$}
+
+or
+
\svnid{$Id$}
-Subversion will expand it (set property svn:keyword to 'Id') and
-then you can typeset the SVN information using
+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.
@@ -52,13 +63,26 @@ 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
- [pdf]latex svn-multi.dtx # for the documentation
- [pdf]latex example-main.tex # for the example
+ [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
+ 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'.
+