summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/svn-multi
diff options
context:
space:
mode:
authorDr. Clea F. Rees <cfrees@imapmail.org>2009-03-01 20:31:44 +0000
committerDr. Clea F. Rees <cfrees@imapmail.org>2009-03-01 20:31:44 +0000
commit98b2e0029dce671be04c9bd02fa94109e0c67ad1 (patch)
treea06138d56d54921d2dffdaa0071131ea9129e166 /Master/texmf-dist/source/latex/svn-multi
parent6ed4b79b8c635fe33641578f412d5d907fe5d573 (diff)
svn-multi new version
git-svn-id: svn://tug.org/texlive/trunk@12276 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/svn-multi')
-rw-r--r--Master/texmf-dist/source/latex/svn-multi/Makefile3
-rw-r--r--Master/texmf-dist/source/latex/svn-multi/svn-multi.dtx130
2 files changed, 110 insertions, 23 deletions
diff --git a/Master/texmf-dist/source/latex/svn-multi/Makefile b/Master/texmf-dist/source/latex/svn-multi/Makefile
index 9938f54c67a..b56abaede2e 100644
--- a/Master/texmf-dist/source/latex/svn-multi/Makefile
+++ b/Master/texmf-dist/source/latex/svn-multi/Makefile
@@ -72,7 +72,8 @@ tests: package
> /dev/null
${TESTS}: % : ${TESTDIR}/%.tex package
- @if (pdflatex ${TESTARGS} $<) && (pdflatex ${TESTARGS} $<); \
+ @-pdflatex -interaction=nonstopmode ${TESTARGS} $< 1>/dev/null 2>/dev/null
+ @if (pdflatex ${TESTARGS} $<); \
then echo -e "${GREEN}$@ succeeded${WHITE}" >&2; \
else echo -e "${RED}$@ failed!!!!!!${WHITE}" >&2; fi
diff --git a/Master/texmf-dist/source/latex/svn-multi/svn-multi.dtx b/Master/texmf-dist/source/latex/svn-multi/svn-multi.dtx
index 54f85f7700e..1fdab21e102 100644
--- a/Master/texmf-dist/source/latex/svn-multi/svn-multi.dtx
+++ b/Master/texmf-dist/source/latex/svn-multi/svn-multi.dtx
@@ -27,12 +27,12 @@
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{svn-multi}
%<*package|driver>
- [2008/12/03 v1.3b SVN Keywords for multi-file LaTeX documents]
+ [2009/02/27 v1.4 SVN Keywords for multi-file LaTeX documents]
%</package|driver>
%<wrapper>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<wrapper>\ProvidesPackage{svnkw}
-%<wrapper> [2007/07/10 v1.3a Backward compatibility wrapper for svn-multi]
-%<wrapper>\RequirePackage{svn-multi}[2007/07/10]
+%<wrapper> [2009/02/27 v1.4 Backward compatibility wrapper for svn-multi]
+%<wrapper>\RequirePackage{svn-multi}[2009/02/27]
%
%<*driver>
\documentclass{ltxdoc}
@@ -95,7 +95,7 @@
%<*package>
% \fi
%
-% \CheckSum{564}
+% \CheckSum{617}
%
% {\makeatother
% \CharacterTable
@@ -130,6 +130,8 @@
% \changes{v1.3b}{2008/12/03}{Changed the way catcodes are modified to be compatible
% with the french option of the babel package or other packages which modify the
% list of special characters.}
+% \changes{v1.4}{2009/02/27}{Added support for timezones with non-zero minute
+% part, \eg +0530.}
%
% \GetFileInfo{svn-multi.sty}
%
@@ -166,7 +168,7 @@
% maintainer suggested a more descriptive name and put the package in the
% |svn-multi|\footnote{CTAN:
% \url{http://www.ctan.org/tex-archive/macros/latex/contrib/svn-multi/}}
-% directory. In this version the style file is renamed to |svn-multi|, but a
+% directory. Therefore the style file got renamed to |svn-multi|, but a
% |svnkw| dummy style file is still provided for backward compatibility.
%
% \section{Introduction}
@@ -340,8 +342,8 @@
% \DescribeMacro{\svnfilemonth}
% \DescribeMacro{\svnfileday}
% \DescribeMacro{\svnfilehour}
-% Whenever the date information is read, \ie by \cs{svnidlong}, \cs{svnid},
-% |\svnkwsave{Date}| or |\svnkwsave{LastChangedDate}|, the following macros are
+% Whenever the date information is read, \ie by |\svnkwsave{LastChangedDate}|
+% |\svnkwsave{Date}|, \cs{svnidlong} or \cs{svnid}, the following macros are
% set to the appropriate date parts for the current file (the |\svnfile...|
% versions) and for the whole document.
%
@@ -349,6 +351,8 @@
% \DescribeMacro{\svnfileminute}
% \DescribeMacro{\svnfilesecond}
% \DescribeMacro{\svnfiletimezone}
+% \DescribeMacro{\svnfiletimezonehour}
+% \DescribeMacro{\svnfiletimezoneminute}
% Please note that the hour and timezone are dependend on the keyword which
% defines the date informations. The hour will be in UTC aka Zulu-time, \ie
% timezone +0000, when the date comes from the |Id| keyword.
@@ -366,17 +370,37 @@
% \DescribeMacro{\svnminute}
% \DescribeMacro{\svnsecond}
% \DescribeMacro{\svntimezone}
-% Please also note that the timezone macros only hold the sign and the first
-% two digits of the timezone. This is needed to define \cs{svnpdfdate}. The last
-% two digits are always `00' anyway. If you need full ISO timezone write
-% |\svnfiletimezone00| or |\svntimezone00|.
+% \DescribeMacro{\svntimezonehour}
+% \DescribeMacro{\svntimezoneminute}
+% Starting with v1.4 of |svn-multi| the timezone macros return the full
+% timezone, \ie sign, hour and minute part, \eg |+0100|, not only the sign and
+% hour. The new macros % |\svntimezonehour|/|\svnfiletimezonehour| and
+% |\svntimezoneminute|/\linebreak[3]|\svnfiletimezoneminute| can be used to access only the
+% hour including sign or the minute part, respectively.
%
-% \vspace{7ex}
+% Older versions of this manual assumed the minute part as always |00| and
+% suggested to add it manually if needed: |\svnfiletimezone00| or |\svntimezone00|.
+% In order not to ``break'' documents which followed this suggestion this two
+% macros now remove a trailing |00| if present.
+% However, this can be a problem when they are used inside an argument of
+% another macro. One solution for this is to redefine them without the |00|
+% removal part:\\
+% \begingroup\small
+% |\renewcommand{\svntimezone}{\svntimezonehour\svntimezoneminute}|\\
+% |\renewcommand{\svnfiletimezone}{\svnfiletimezonehour\svnfiletimezoneminute}|
+% \endgroup\par
+% To revert to the old (pre-v1.4) definition use:\\
+% \begingroup\small
+% |\renewcommand{\svntimezone}{\svntimezonehour}|\\
+% |\renewcommand{\svnfiletimezone}{\svnfiletimezonehour}|
+% \endgroup
+% \vspace{1ex}
%
% \DescribeMacro{\svnpdfdate}
% Returns the last changed date of the whole document in a format needed for
-% |\pdfinfo|. Can be used like this:
-% |\pdfinfo{ /CreationDate (D:\svnpdfdate) }|, to set the PDF creation date to
+% |\pdfinfo|. Can be used like this:\\
+% \hbox{}\hfill|\pdfinfo{ /CreationDate (D:\svnpdfdate) }|\hfill\hbox{}\\
+% to set the PDF creation date to
% the last changed date if you use |pdflatex| to compile your \LaTeX{} document.
%
% \subsection{Using full author names}
@@ -434,7 +458,21 @@
% Please note that you can't use |hyperref|s |\nolinkurl| because it won't
% expand \cs{svnkw}.
%
-%
+% \section{Further Reading}
+% The \textsf{svn-multi} package and its usage got discussed in the following
+% articles:
+%
+% \begin{itemize}
+% \item[{[1]}] Martin Scharrer, ``Version Control of LaTeX Documents with
+% svn-multi'', The Prac\TeX\ Journal, (3), 2007.
+% URL: \url{http://www.tug.org/pracjourn/2007-3/scharrer/}
+% \item[{[2]}] Mark Eli Kalderon, ``LaTeX and Subversion'',
+% The Prac\TeX\ Journal, (3), 2007.
+% URL: \url{http://www.tug.org/pracjourn/2007-3/kalderon-svnmulti/}
+% \item[{[3]}] Uwe Ziegenhagen , ``LaTeX Document Management with Subversion'',
+% The Prac\TeX\ Journal, (3), 2007.
+% URL: \url{http://www.tug.org/pracjourn/2007-3/ziegenhagen/}
+% \end{itemize}
%
% \StopEventually{}
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -471,10 +509,45 @@
\def\svnhour{0} \def\svnfilehour{0} \def\@svn@hour{0}
\def\svnminute{0} \def\svnfileminute{0} \def\@svn@minute{0}
\def\svnsecond{0} \def\svnfilesecond{0} \def\@svn@second{0}
-\def\svntimezone{0} \def\svnfiletimezone{0} \def\@svn@timezone{0}
+\def\svntimezonehour{+00} \def\svnfiletimezonehour{+00} \def\@svn@timezonehour{+00}
+\def\svntimezoneminute{00} \def\svnfiletimezoneminute{00} \def\@svn@timezoneminute{00}
\def\svnmainurl{NOT SET}\def\svnmainfilename{NOT SET}
% \end{macrocode}
%
+% \subsection{Timezone macros}
+% \begin{macro}{\svnfiletimezone}
+% \begin{macro}{\svntimezone}
+% This macros return the global and local time zones. Since v1.4 the minute part
+% is returned as well and the macro removes manually added |00| after it to
+% support older documents.
+% \changes{v1.4}{2009/02/27}{Return now full timezone (hour + minute part).
+% Manually added 00 minutes are removed.}
+% \begin{macrocode}
+\def\svntimezone{\svntimezonehour\svntimezoneminute\svn@gobblezeros}
+\def\svnfiletimezone{\svnfiletimezonehour\svnfiletimezoneminute\svn@gobblezeros}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+
+% \begin{macro}{\svn@gobblezeros}
+% \begin{macro}{\svn@gobblezeros@}
+% This two cascaded macros remove a trailing |00| and are used by
+% |\svnfiletimezone| and |\svntimezone|.
+% \begin{macrocode}
+\def\svn@gobblezeros{%
+\futurelet\svn@nextchar\svn@gobblezeros@
+}
+\def\svn@gobblezeros@{%
+\let\@tempa=\relax
+\def\@tempb{0}%
+\ifx0\svn@nextchar
+\let\@tempa=\@gobbletwo
+\fi
+\@tempa
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
% \subsection{Id macros}
% \subsubsection{Normal Id}
@@ -539,7 +612,8 @@
\xdef\@svn@hour{\svnfilehour}%
\xdef\@svn@minute{\svnfileminute}%
\xdef\@svn@second{\svnfilesecond}%
-\xdef\@svn@timezone{\svnfiletimezone}%
+\xdef\@svn@timezonehour{\svnfiletimezonehour}%
+\xdef\@svn@timezoneminute{\svnfiletimezoneminute}%
\else\fi
\fi
}
@@ -863,7 +937,8 @@
\gdef\svnfilehour{#4}%
\gdef\svnfileminute{#5}%
\gdef\svnfilesecond{#6#7}%
-\gdef\svnfiletimezone{+00}% #8 always 'Z' for Zulu-time (UTC)
+\gdef\svnfiletimezonehour{+00}%
+\gdef\svnfiletimezoneminute{00}% #8 always 'Z' for Zulu-time (UTC)
}
% \end{macrocode}
% \end{macro}
@@ -873,14 +948,24 @@
% \begin{macrocode}
\def\@svn@scanlongdate#1{\expandafter\@svn@scanlongdate@#1\relax}
%
-\def\@svn@scanlongdate@#1-#2-#3 #4:#5:#6 #700 #8\relax{%
+\def\@svn@scanlongdate@#1-#2-#3 #4:#5:#6 #7 #8\relax{%
\gdef\svnfileyear{#1}%
\gdef\svnfilemonth{#2}%
\gdef\svnfileday{#3}%
\gdef\svnfilehour{#4}%
\gdef\svnfileminute{#5}%
\gdef\svnfilesecond{#6}%
-\gdef\svnfiletimezone{#7}%
+\@svn@parsetimezone#7\relax%
+}
+% \end{macrocode}
+% \end{macro}
+
+% \begin{macro}{\@svn@parsetimezone}
+% Scans timezone and splits hour and minute part.
+% \begin{macrocode}
+\def\@svn@parsetimezone#1#2#3#4#5\relax{%
+\gdef\svnfiletimezonehour{#1#2#3}%
+\gdef\svnfiletimezoneminute{#4#5}%
}
% \end{macrocode}
% \end{macro}
@@ -889,7 +974,7 @@
% Returns date in a format needed for |\pdfinfo|.
% \begin{macrocode}
\def\svnpdfdate{\svnyear\svnmonth\svnday
-\svnhour\svnminute\svnsecond\svntimezone'00'}
+\svnhour\svnminute\svnsecond\svntimezonehour'\svntimezoneminute'}
% \end{macrocode}
% \end{macro}
@@ -1034,7 +1119,8 @@
\noexpand\def\noexpand\svnhour{\@svn@hour}^^J%
\noexpand\def\noexpand\svnminute{\@svn@minute}^^J%
\noexpand\def\noexpand\svnsecond{\@svn@second}^^J%
- \noexpand\def\noexpand\svntimezone{\@svn@timezone}^^J%
+ \noexpand\def\noexpand\svntimezonehour{\@svn@timezonehour}^^J%
+ \noexpand\def\noexpand\svntimezoneminute{\@svn@timezoneminute}^^J%
}
\immediate\closeout\svn@write%
\fi\fi\fi\fi\fi%