summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-RCS.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-RCS.html')
-rw-r--r--Master/texmf-doc/doc/english/FAQ-en/html/FAQ-RCS.html62
1 files changed, 62 insertions, 0 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-RCS.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-RCS.html
new file mode 100644
index 00000000000..cb445fc0b8c
--- /dev/null
+++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-RCS.html
@@ -0,0 +1,62 @@
+<head>
+<title>UK TeX FAQ -- question label RCS</title>
+</head><body>
+<h3>Version control using RCS, CVS or <i>Subversion</i></h3>
+<p>If you use RCS, CVS or <i>Subversion</i> to maintain
+your (La)TeX documents under version control, you may need some
+mechanism for including the version details in your document, in such
+a way that they can be typeset (that is, rather than just hiding them
+inside a comment).
+<p>The most complete solution for RCS and CVS is to use the
+(LaTeX) package <i>rcs</i>, which allows you to parse and
+display the contents of RCS keyword fields in an extremely
+flexible way. The package <i>rcsinfo</i> is simpler, but does most
+of what you want, and some people prefer it; it is explicitly
+compatible with <i>LaTeX2HTML</i>.
+<p>If, however, you need a solution which works without using external
+packages, or which will work in plain TeX, then you can use the
+following minimal solution:
+<blockquote>
+<pre>
+\def\RCS$#1: #2 ${\expandafter\def\csname RCS#1\endcsname{#2}}
+\RCS$Revision: 1.299 $ % or any RCS keyword
+\RCS$Date: 2005/07/07 13:52:16 $
+...
+\date{Revision \RCSRevision, \RCSDate}
+</pre>
+
+</blockquote>
+<p>If you've entered the brave new world of <i>subversion</i>, the
+package <i>svn</i> may be for you. It has explicit cleverness
+about dealing with dates:
+<blockquote>
+<code>\</code><code>documentclass</code><code>{&lt;<i>foo</i>&gt;}</code><br>
+<code>...</code><br>
+<code>\</code><code>usepackage{svn}</code><br>
+<code>\</code><code>SVNdate</code><code> $Date$</code><br>
+<code>\</code><code>author{...}</code><br>
+<code>\</code><code>title{...}</code><br>
+<code>...</code><br>
+<code>\</code><code>begin{document}</code><br>
+<code>\</code><code>maketitle</code><br>
+<code>...</code><br>
+<code>\</code><code>end{document}</code>
+</blockquote>
+will (once <i>subversion</i> has committed a copy of the document)
+cause <code>\</code><code>maketitle</code> use the date that has been written into the
+<code>$Date$</code> keyword.
+<p>The alternative is the <i>svninfo</i> package, which has much the
+same mechanisms as does <i>svn</i> but with a rather different
+focus. <i>Svninfo</i> does the date trick that <i>svn</i>
+performs (controlled by a package option), and can set up page
+foot-lines using <a href="FAQ-fancyhdr.html">package <i>fancyhdr</i></a>.
+There isn't much to choose between the two packages: you should read
+the packages' documentation to see which you find best.
+<dl>
+<dt><tt><i>rcs.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/rcs.zip">macros/latex/contrib/rcs</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/rcs.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/rcs/">browse</a>)
+<dt><tt><i>rcsinfo.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/rcsinfo.zip">macros/latex/contrib/rcsinfo</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/rcsinfo.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/rcsinfo/">browse</a>)
+<dt><tt><i>svn.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/svn.zip">macros/latex/contrib/svn</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/svn.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/svn/">browse</a>)
+<dt><tt><i>svninfo.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/svninfo.zip">macros/latex/contrib/svninfo</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/svninfo.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/svninfo/">browse</a>)
+</dl>
+<p><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=RCS">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=RCS</a>
+</body>