attachfile 1.3a (15aug08)

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

2 files changed, 44 insertions, 28 deletions

diff --git a/Master/texmf-dist/source/latex/attachfile/attachfile.dtx b/Master/texmf-dist/source/latex/attachfile/attachfile.dtx
index adfcbfd844a..6a12f8fd749 100644
--- a/Master/texmf-dist/source/latex/attachfile/attachfile.dtx
+++ b/Master/texmf-dist/source/latex/attachfile/attachfile.dtx
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright (C) 2007 by Scott Pakin <scott+af@pakin.org>
+% Copyright (C) 2008 by Scott Pakin <scott+af@pakin.org>
 % -------------------------------------------------------
 %
 % This file may be distributed and/or modified under the conditions of
@@ -22,7 +22,7 @@
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package>\ProvidesPackage{attachfile}
 %<*package>
-    [2007/01/15 v1.3 PDF 1.3+ file attachment]
+    [2008/08/15 v1.3a PDF 1.3+ file attachment]
 %</package>
 %
 %<*driver>
@@ -88,7 +88,7 @@
 %   pdftitle={The attachfile package},
 %   pdfauthor={Scott Pakin <scott+af@pakin.org>},
 %   pdfsubject={LaTeX file attachment package},
-%   pdfkeywords={attachments,annotations,PDF,LaTeX,package,automatic,files}
+%   pdfkeywords={attachments; annotations; PDF; LaTeX; package; automatic; files}
 % }
 %
 % ^^A  Help prevent weird line breaks in URLs
@@ -770,42 +770,52 @@
 % Note that there are a few caveats you should be aware of:
 %
 % \begin{enumerate}
+%   \item \pkgname{attachfile} requires \pdflatex{} version~0.14 or
+%   later.  (Version~0.14 was released circa~1999 so it's unlikely that
+%   you're running an older version than that.)  While there are many
+%   other ways to produce \acronym{PDF} files from \latex{} source,
+%   \pkgname{attachfile}~\fileversion{} supports only \pdflatex, and
+%   only versions~0.14+.
+%
 %   \item \pkgname{attachfile} will not run unless the following \latex\
 %   packages are installed: \pkgname{calc}, \pkgname{keyval},
-%   \pkgname{color}, \pkgname{hyperref}, and \pkgname{ifpdf}.
+%   \pkgname{color}, \pkgname{hyperref}, and \pkgname{ifpdf}.  (Most
+%   \tex\ distributions include all of these.)
 %
 %   \item File attachments are a \acronym{PDF}~1.3 feature.  They will
-%   not be visible in \acronym{PDF} viewers that do support
+%   not be visible in \acronym{PDF} viewers that don't support
 %   \acronym{PDF}~1.3.  (Version~4.0 of \adobeacrobat is the first
 %   version of that program which does.)
 %
 %   \item Even some viewers that purportedly support \acronym{PDF}~1.3
-%   don't support file attachments.  As far as I can tell, older versions
-%   of \adobeacrobatreader (the free, view-only version of \adobeacrobat)
-%   doesn't seem to support \emph{any} annotations except text
-%   annotations.
+%   don't support file attachments.  As far as I can tell, very old
+%   versions of \adobeacrobatreader (the free, view-only version of
+%   \adobeacrobat) doesn't seem to support \emph{any} annotations except
+%   text annotations.
 %
 %   \item Even some viewers that do support \acronym{PDF}~1.3 and file
 %   attachments don't support them under all circumstances.  For
-%   instance, the Windows\smallreg\ version of \adobeacrobat, when
-%   functioning as a Web-browser plug-in, gives an error
+%   instance, some  Windows\smallreg\ versions of \adobeacrobat, when
+%   functioning as a Web-browser plug-in, give an error
 %   message\footnote{``Launching embedded files from within a browser
 %   environment is not allowed''.} when a file attachment icon is
 %   activated.
 %
 %   \item Even in circumstances where file attachments are supported,
-%   the support may be flawed.  For example, the Windows\smallreg\
-%   version of \adobeacrobat changes a custom icon to the default icon
+%   the support may be flawed.  For example, some Windows\smallreg\
+%   versions of \adobeacrobat change a custom icon to the default icon
 %   when it's selected.
-% \end{enumerate}
 %
-% \noindent
-% In addition, \pkgname{attachfile} requires \pdflatex{} version~0.14 or
-% later.  While there are many other ways to produce \acronym{PDF} files
-% from \latex{} source, \pkgname{attachfile}~\fileversion{} supports
-% only \pdflatex, and only versions~0.14+.
-%
-% \bigskip
+%   Also, while file-attachment icons with custom appearances printed
+%   fine in older versions of \adobeacrobat, \adobe introduced a bug
+%   circa \adobeacrobat~6.0 that prevents \pkgname{attachfile}'s icons
+%   from printing.  Unfortunately, because \adobeacrobat lacks
+%   \pkgname{attachfile}'s ability to create custom appearances for
+%   file-attachment icons it's unlikely that this bug will ever get
+%   fixed.  Nevertheless, please consider sending a bug report to \adobe
+%   to let them know that you'd like to be able to print file-attachment
+%   icons with custom appearances.
+% \end{enumerate}
 %
 % Even given all of those caveats, file attachments can be a useful way
 % to pass additional information along with a \acronym{PDF} file.  The
@@ -894,12 +904,18 @@
 % in Section~\ref{sec:dummy-commands}, we replace all of the core
 % \pkgname{attachfile} macros with dummy versions so \latex\ can at
 % least run to completion.
+% \changes{v1.3a}{2008/08/15}{Corrected the formatting of the ``not
+%   \string\pdflatex'' warning message}
 %    \begin{macrocode}
-\RequirePackage{ifpdf} \ifpdf \else
-\PackageWarningNoLine{attachfile}{% attachfile works _only_ with
-pdfLaTeX and _only_ in\MessageBreak PDF-generating mode.  For this
-run, placeholders will\MessageBreak be substituted for all attachfile
-commands.}  \fi
+\RequirePackage{ifpdf}
+\ifpdf
+\else
+  \PackageWarningNoLine{attachfile}{%
+    attachfile works _only_ with pdfLaTeX and _only_ in\MessageBreak
+    PDF-generating mode.  For this run, placeholders will\MessageBreak
+    be substituted for all attachfile commands.%
+  }
+\fi
 %    \end{macrocode}
 %
 %
diff --git a/Master/texmf-dist/source/latex/attachfile/attachfile.ins b/Master/texmf-dist/source/latex/attachfile/attachfile.ins
index 10b0c6709c5..61b6bef9e98 100644
--- a/Master/texmf-dist/source/latex/attachfile/attachfile.ins
+++ b/Master/texmf-dist/source/latex/attachfile/attachfile.ins
@@ -3,7 +3,7 @@
 %% driver files from the doc files in this package when run through
 %% LaTeX or TeX.
 %%
-%% Copyright (C) 2007 Scott Pakin <scott+af@pakin.org>
+%% Copyright (C) 2008 Scott Pakin <scott+af@pakin.org>
 %% -------------------------------------------------------
 %% 
 %% This package may be distributed and/or modified under the
@@ -28,7 +28,7 @@
 
 This is a generated file.
 
-Copyright (C) 2007 Scott Pakin <scott+af@pakin.org>
+Copyright (C) 2008 Scott Pakin <scott+af@pakin.org>
 -------------------------------------------------------
 
 This package may be distributed and/or modified under the