fink 2.1.1 (27feb08)

git-svn-id: svn://tug.org/texlive/trunk@6764 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 30 insertions, 5 deletions

diff --git a/Master/texmf-dist/source/latex/fink/fink.dtx b/Master/texmf-dist/source/latex/fink/fink.dtx
index eec06bcd5b1..2032dbddd1c 100644
--- a/Master/texmf-dist/source/latex/fink/fink.dtx
+++ b/Master/texmf-dist/source/latex/fink/fink.dtx
@@ -63,9 +63,10 @@
 %%   Grave accent  \`     Left brace    \{     Vertical bar  \|
 %%   Right brace   \}     Tilde         \~}
 %
-% \newcommand\version{2.1}
-% \newcommand\releasedate{2007/11/14}
-% \newcommand\packagecopyright{Copyright \copyright{} 1999, 2000, 2001, 2002, 2007 Didier Verna}
+% \newcommand\version{2.1.1}
+% \newcommand\releasedate{2008/02/27}
+% \newcommand\packagecopyright{Copyright \copyright{} 1999, 2000, 2001, 2002,
+%   2007, 2008 Didier Verna}
 % \newcommand\auctex{AUC-\TeX}
 % \MakeShortVerb{\|}
 % \date{\today}
@@ -146,8 +147,32 @@
 % syntax (one would have to parse the characters one by one, and I'm not ready
 % to do so\ldots). \fink{} currently does not follow auxiliary files either.
 %
+% \section{Hints, Tricks, Tips}
+%
+% \subsection{File names with special characters}
+% Here, ``special'' is to be taken in the \LaTeX{} sense, for instance, a
+% directory or file name containing an underscore. If this situation occurs,
+% you're likely to face problems with \fink{} macros because they don't try to
+% properly escape those characters. So for instance, an underscore alone will
+% make \LaTeX{} think that you forgot the math mode |$| sign before it. There
+% are actually two problems that you may encounter:
+% \begin{description}
+% \item[Characters not displayed properly] Try to change your font encoding by
+%   putting this in your document's preamble: |\usepackage[T1]{fontenc}|.
+% \item[Compilation breakage] The |url| package might be of some help here.
+%   Put |\usepackage{url}| in your document's preamble first. Then (assuming
+%   that |\finkfile| is the culprit), instead of using |\finkfile| directly,
+%   use this instead: |\expandafter\url\expandafter{\finkfile}|. You might
+%   also want to play with |\urlstyle| to have your file name displayed in
+%   the font you prefer.
+% \end{description}
+%
 % \section{Changes}
 % \begin{itemize}
+% \item[v2.1.1] Fix trailing whitespace in |\fink@restore|, reported by
+%   Maverick Woo\\
+%   Added some hints about filenames with special characters, suggested by
+%   David P. Goodall
 % \item[v2.1] Fix bug preventing expansion in math mode, reported by Alain
 %   Schremmer, fixed by Morten Hoegholm before I could even raise my little
 %   finger.
@@ -166,7 +191,7 @@
 % \section{The Code}
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{fink}[2007/11/14 v2.1
+\ProvidesPackage{fink}[2008/02/27 v2.1.1
                        Keep track of the current filename]
 
 \RequirePackage{kvoptions}
@@ -284,7 +309,7 @@
     \xdef\finkdir{\filename@area}%
     \xdef\finkbase{\filename@base}%
     \xdef\finkext{\filename@ext}%
-    \xdef\finkfile{\fink@file{\finkbase}{\finkext}}
+    \xdef\finkfile{\fink@file{\finkbase}{\finkext}}%
     \xdef\finkpath{\finkdir\finkfile}%
   \endgroup}