summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/svn-multi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-07-16 15:58:40 +0000
committerKarl Berry <karl@freefriends.org>2007-07-16 15:58:40 +0000
commit0712d6aa258c39076a89220dd0d7284bf5f00091 (patch)
tree13feba27a6254b4de0a2463cda54c0c8756c01a4 /Master/texmf-dist/doc/latex/svn-multi
parentb9e50b271f760c6fb44b08e291c9b36730d6cbf7 (diff)
svn-multi 1.3a (11jul07)
git-svn-id: svn://tug.org/texlive/trunk@4604 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/svn-multi')
-rw-r--r--Master/texmf-dist/doc/latex/svn-multi/README64
-rw-r--r--Master/texmf-dist/doc/latex/svn-multi/example.pdfbin37257 -> 41256 bytes
-rw-r--r--Master/texmf-dist/doc/latex/svn-multi/example_chap1.tex32
-rw-r--r--Master/texmf-dist/doc/latex/svn-multi/example_main.tex20
-rw-r--r--Master/texmf-dist/doc/latex/svn-multi/svn-multi.pdfbin0 -> 281239 bytes
-rw-r--r--Master/texmf-dist/doc/latex/svn-multi/svnkw.pdfbin118018 -> 0 bytes
6 files changed, 106 insertions, 10 deletions
diff --git a/Master/texmf-dist/doc/latex/svn-multi/README b/Master/texmf-dist/doc/latex/svn-multi/README
new file mode 100644
index 00000000000..11fa5b30a08
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/svn-multi/README
@@ -0,0 +1,64 @@
+--------------------------------------------------------------
+ svn-multi (was svnkw)
+ version 1.3a, July 10th, 2007
+--------------------------------------------------------------
+
+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,2007 Martin Scharrer
+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
+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.
+
+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.
+
+
+Tiny example:
+~~~~~~~~~~~~~
+Put the following Subversion keyword in all your LaTeX files of
+your document:
+
+\svnid{$Id$}
+
+Subversion will expand it (set property svn:keyword to 'Id') and
+then you can typeset the SVN information 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
+ [pdf]latex svn-multi.dtx # for the documentation
+ [pdf]latex example-main.tex # for the 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
+
diff --git a/Master/texmf-dist/doc/latex/svn-multi/example.pdf b/Master/texmf-dist/doc/latex/svn-multi/example.pdf
index ffb2ac039de..870d6f8811f 100644
--- a/Master/texmf-dist/doc/latex/svn-multi/example.pdf
+++ b/Master/texmf-dist/doc/latex/svn-multi/example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/svn-multi/example_chap1.tex b/Master/texmf-dist/doc/latex/svn-multi/example_chap1.tex
index 9b06aed5c3e..6881ebe6ab6 100644
--- a/Master/texmf-dist/doc/latex/svn-multi/example_chap1.tex
+++ b/Master/texmf-dist/doc/latex/svn-multi/example_chap1.tex
@@ -7,25 +7,45 @@
\svnid{$Id: example_chap1.tex 14 2006-05-26 14:37:12Z johnd $}
\chapter{Example Chapter}
-Text ...
\section{Version}
\subsection*{This chapter}
% \url is needed because there is an underscore in the name
-% The package 'underscore' seems not to work properly, so the 'hyperref'
+% The package 'underscore' seems not to work properly, so the 'hyperref'
% package is used which is not the best solution. Avoid underscore in LaTeX filenames.
-Filename: \url{\svnkw{Filename}}\\
+Filename: \svnnolinkurl{\svnkw{Filename}}\\
URL: \url{\svnkw{HeadURL}}\\
% Something like \href{\svnkw{HeadURL}}{Download} works also!
-Last change:\\
+\textbf{Last change}\\
Revision: \svnfilerev\\
Date: \svnfiledate\\
+Year: \svnfileyear\\
+Time: \svnfilehour:\svnfileminute:\svnfilesecond\ \svnfiletimezone00\\
Author: \svnfileauthor\\
\subsection*{Whole document}
-Last change:\\
+Filename: \svnnolinkurl{\svnmainfilename}\\
+URL: \url{\svnmainurl}\\
+\textbf{Last change}\\
Revision: \svnrev\\
Date: \svndate\\
+Year: \svnyear\\
+Time: \svnhour:\svnminute:\svnsecond\ \svntimezone00\\
Author: \svnauthor\\
-
% [...]
+
+\section{Tests}
+\svnRegisterRevision{14}{Test}
+
+Registered author name: \svnFullAuthor{\svnfileauthor}\\
+Registered revision name: \svnFullRevision{\svnfilerev}\\
+Registered author name (*): \svnFullAuthor*{\svnfileauthor}\\
+Registered revision name (*): \svnFullRevision*{\svnfilerev}\\
+
+\subsubsection*{Behaviour if value is not registered:}
+Not registered user name: \svnFullAuthor{someusername}\\
+Not registered revision name: \svnFullRevision{12}\\
+Not registered user name (*): \svnFullAuthor*{someusername}\\
+Not registered revision name (*): \svnFullRevision*{12}\\
+
+
diff --git a/Master/texmf-dist/doc/latex/svn-multi/example_main.tex b/Master/texmf-dist/doc/latex/svn-multi/example_main.tex
index 9c82baab8cd..0ac69ca129b 100644
--- a/Master/texmf-dist/doc/latex/svn-multi/example_main.tex
+++ b/Master/texmf-dist/doc/latex/svn-multi/example_main.tex
@@ -1,5 +1,5 @@
\documentclass[12pt]{report}
-\usepackage{svnkw}
+\usepackage{svn-multi}
% Version control information:
\svnidlong
{$HeadURL: file://somewhere/example_main.tex $}
@@ -7,35 +7,47 @@
{$LastChangedRevision: 15 $}
{$LastChangedBy: maryd $}
\svnid{$Id: example_main.tex 15 2006-05-26 15:47:47Z maryd $}
-% Don't forget to set the svn property 'svn:keywords' to
+% Don't forget to set the svn property 'svn:keywords' to
% 'HeadURL LastChangedDate LastChangedRevision LastChangedBy' or
% 'Id' or both depending if you use \svnidlong and/or \svnid
\usepackage{hyperref}
+\usepackage{url}
\usepackage{fancyhdr}
\renewcommand{\headrulewidth}{0.4pt}
\renewcommand{\footrulewidth}{0.4pt}
\setlength{\headheight}{14.5pt}
% This will display the last changed revision of the current chapter.
-% Change \svnkw{LastChangedRevision} to \svnrev if you like to have the
+% Change \svnkw{LastChangedRevision} to \svnrev if you like to have the
% document revision.
-\newcommand{\svnfooter}{Last Changed Rev: \svnkw{LastChangedRevision}}
+\newcommand{\svnfooter}{Last Changed Rev: \svnkw{LastChangedRevision}}
+\pdfinfo{%
+ /CreationDate (D:\svnpdfdate)
+}
\svnRegisterAuthor{johnd}{John Doe}
\svnRegisterAuthor{maryd}{Mary Doe}
+\svnRegisterRevision{15}{Version~1}
+\listfiles
\begin{document}
\begin{titlepage}
\vspace{8ex}
{\huge Title\par}
+ \vspace{2ex}
+ {\large \noindent This is an example document for the \texttt{svn-multi} (aka
+ \texttt{svnkw}) package. Please also look at the LaTeX source code of this
+ document.}
\vfill
\flushleft\sffamily
Version control information:\\
Head URL: \url{\svnkw{HeadURL}}\\
+ Head URL: \svnnolinkurl{\svnkw{HeadURL}}\\
Last changed date: \svndate\\
Last changes revision: \svnrev\\
+ Version: \svnFullRevision*{\svnrev}\\
Last changed by: \svnFullAuthor*{\svnauthor}\\
\end{titlepage}
diff --git a/Master/texmf-dist/doc/latex/svn-multi/svn-multi.pdf b/Master/texmf-dist/doc/latex/svn-multi/svn-multi.pdf
new file mode 100644
index 00000000000..166ed038a6b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/svn-multi/svn-multi.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/svn-multi/svnkw.pdf b/Master/texmf-dist/doc/latex/svn-multi/svnkw.pdf
deleted file mode 100644
index c1ec176d251..00000000000
--- a/Master/texmf-dist/doc/latex/svn-multi/svnkw.pdf
+++ /dev/null
Binary files differ