summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/fink/fink.dtx
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-02-28 00:35:08 +0000
committerKarl Berry <karl@freefriends.org>2008-02-28 00:35:08 +0000
commitb22361dd13e4f864ffe71141f6ffdf03943c1238 (patch)
tree6a6be51e03617ab4738d53d080f2d4b88f0a3dc3 /Master/texmf-dist/source/latex/fink/fink.dtx
parenteebe94bbe54820089c464b5d6066c1daafd310f0 (diff)
fink 2.1.1 (27feb08)
git-svn-id: svn://tug.org/texlive/trunk@6764 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/fink/fink.dtx')
-rw-r--r--Master/texmf-dist/source/latex/fink/fink.dtx35
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}