Update attachfile.

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

6 files changed, 317 insertions, 117 deletions

diff --git a/Master/texmf-dist/doc/latex/attachfile/README b/Master/texmf-dist/doc/latex/attachfile/README
index 9b1d9e97e0e..6f3cf1226bd 100644
--- a/Master/texmf-dist/doc/latex/attachfile/README
+++ b/Master/texmf-dist/doc/latex/attachfile/README
@@ -21,17 +21,17 @@ appearance in the enclosing document.
 Copyright and license
 ---------------------
 
-Copyright (C) 2006 Scott Pakin <scott+af@pakin.org>
+Copyright (C) 2007 Scott Pakin <scott+af@pakin.org>
 
 This package may be distributed and/or modified under the conditions
-of the LaTeX Project Public License, either version 1.3b of this
+of the LaTeX Project Public License, either version 1.3c of this
 license or (at your option) any later version.  The latest version of
 this license is in:
 
                 http://www.latex-project.org/lppl.txt
 
-and version 1.3b or later is part of all distributions of LaTeX
-version 2006/01/07 or later.
+and version 1.3c or later is part of all distributions of LaTeX
+version 2006/05/20 or later.
 
 
 Building attachfile
@@ -46,6 +46,6 @@ pdflatex attachfile.dtx  <== Merges index + change log into the documentation
 pdflatex attachfile.dtx  <== Produces final version of attachfile.pdf
 
 Note that attachfile comes with pre-built documentation (PDF format,
-U.S. letter-sized paper, 23 pages), so you really need to perform only
+U.S. letter-sized paper, 25 pages), so you really need to perform only
 the first step above unless you're unhappy with the documentation as
 provided.
diff --git a/Master/texmf-dist/doc/latex/attachfile/attachfile.pdf b/Master/texmf-dist/doc/latex/attachfile/attachfile.pdf
index 6d79e7229f7..06f78b4e1e5 100644
--- a/Master/texmf-dist/doc/latex/attachfile/attachfile.pdf
+++ b/Master/texmf-dist/doc/latex/attachfile/attachfile.pdf
diff --git a/Master/texmf-dist/source/latex/attachfile/attachfile.dtx b/Master/texmf-dist/source/latex/attachfile/attachfile.dtx
index 4616579450c..adfcbfd844a 100644
--- a/Master/texmf-dist/source/latex/attachfile/attachfile.dtx
+++ b/Master/texmf-dist/source/latex/attachfile/attachfile.dtx
@@ -1,17 +1,17 @@
 % \iffalse meta-comment
 %
-% Copyright (C) 2006 by Scott Pakin <scott+af@pakin.org>
+% Copyright (C) 2007 by Scott Pakin <scott+af@pakin.org>
 % -------------------------------------------------------
 %
 % This file may be distributed and/or modified under the conditions of
-% the LaTeX Project Public License, either version 1.3b of this license
+% the LaTeX Project Public License, either version 1.3c of this license
 % or (at your option) any later version.  The latest version of this
 % license is in:
 %
 %    http://www.latex-project.org/lppl.txt
 %
-% and version 1.3b or later is part of all distributions of LaTeX
-% version 2006/01/07 or later.
+% and version 1.3c or later is part of all distributions of LaTeX
+% version 2006/05/20 or later.
 %
 % \fi
 %
@@ -22,14 +22,14 @@
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package>\ProvidesPackage{attachfile}
 %<*package>
-    [2006/03/28 v1.2a PDF 1.3+ file attachment]
+    [2007/01/15 v1.3 PDF 1.3+ file attachment]
 %</package>
 %
 %<*driver>
 \documentclass{ltxdoc}
-\usepackage[hyperindex=false]{attachfile}
 \usepackage{color}
 \usepackage{xspace}
+\usepackage[hyperindex=false,bookmarksopen=true]{attachfile}
 \EnableCrossrefs
 \CodelineIndex
 \RecordChanges
@@ -41,7 +41,7 @@
 %</driver>
 % \fi
 %
-% \CheckSum{395}
+% \CheckSum{474}
 %
 % \CharacterTable
 %  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -64,6 +64,14 @@
 % \changes{v1.1a}{2005/02/18}{Corrected a few stupid bugs}
 % \changes{v1.2}{2005/02/20}{Modified so as to enable filenames to
 %   contain special characters, e.g., underscores}
+% \changes{v1.3}{2007/01/15}{Incorporated Ross Moore's patches for
+%   making \protect\pkgname{attachfile} robust to running
+%   \protect\pkgname{hyperref} with
+%   \protect\texttt{\protect\string\protect\Hy@unicodetrue} and for
+%   supporting the \protect\pdfname{Created},
+%   \protect\pdfname{Modified}, and \protect\pdfname{Size} keys in the
+%   \protect\pdfname{EmbeddedFile}'s \protect\pdfname{Params}
+%   dictionary}
 %
 % \GetFileInfo{attachfile.dtx}
 %
@@ -90,7 +98,7 @@
 % ^^A  Define some logical styles.
 % \newcommand{\menuname}[1]{\textit{#1}}
 % \newcommand{\pkgname}[1]{^^A
-%   \texttt{#1}\SortIndex{#1}{#1 (package)\encapchar usage}}
+%   \textsf{#1}\SortIndex{#1}{#1 (package)\encapchar usage}}
 % \newcommand{\pdfname}[1]{^^A
 %   \textsf{#1}\SortIndex{#1}{\textsf{#1}\encapchar usage}}
 % \newcommand{\acronym}[1]{^^A
@@ -130,9 +138,9 @@
 % ^^A  Output the name of an option, and also enter it into the index.
 % \newcommand{\indexedopt}[1]{^^A
 %   \gdef\prevopt{#1}^^A
-%   \texttt{\prevopt}%
+%   \texttt{\prevopt}^^A
 %   \index{options\levelchar\prevopt
-%          \actualchar\texttt{prevopt}^^A
+%          \actualchar\texttt{\prevopt}^^A
 %          \encapchar usage}^^A
 %   \index{\prevopt
 %          \actualchar\texttt{\prevopt} (option)^^A
@@ -240,7 +248,6 @@
 %   metadata.
 % \end{abstract}
 %
-% \tableofcontents
 %
 % \section{Introduction}
 %
@@ -273,7 +280,7 @@
 % \bigskip
 %
 % Okay, let's get down to business.  Here are some sample file
-% attachments, so you can see if your \acronym{PDF} viewer is able to
+% attachments so you can see if your \acronym{PDF} viewer is able to
 % handle them:
 %
 % \begingroup
@@ -286,13 +293,13 @@
 % }
 %
 % \begin{center}
-% \begin{tabular}{@{}lc@{\qquad(Should look like this:~}c@{)}}
+% \begin{tabular}{@{}lc@{\qquad(Should resemble this:~}c@{)}}
 %   Icon: &
-%   \attachfile{attachfile.bib} &
+%   \attachfile[size=1015,modified={D:20050104230918-07'00'}]{attachfile.bib} &
 %   \noattachfile \\
 %
 %   \latex\ text: &
-%   \textattachfile{attachfile.bib}{\texttt{attachfile.bib}} &
+%   \textattachfile[size=1015,modified={D:20050104230918-07'00'}]{attachfile.bib}{\texttt{attachfile.bib}} &
 %   \textcolor[rgb]{1,0,0}{\texttt{attachfile.bib}}
 % \end{tabular}
 % \end{center}
@@ -311,7 +318,7 @@
 % problems I encountered while testing \pkgname{attachfile}.
 %
 %
-% \section{User interface}
+% \section{Usage}
 %
 % Load \pkgname{attachfile} by putting a |\usepackage{attachfile}| in
 % your document's preamble.  \pkgname{attachfile} implicitly loads a
@@ -321,10 +328,10 @@
 % \pkgname{attachfile}~\fileversion{} does not have any of its own
 % package options; any options that get passed to \pkgname{attachfile}
 % are forwarded to \pkgname{hyperref}.  Because \pkgname{hyperref} works
-% best when loaded as one of the last packages in the document, the same
+% best when loaded as one of the last packages in the document the same
 % holds true for \pkgname{attachfile}.
 %
-% \subsection{Commands}
+% \section{Commands}
 % \label{sec:commands}
 %
 % The following are the commands that \pkgname{attachfile} makes
@@ -336,7 +343,7 @@
 %   |\attachfile| \oarg{options} \marg{filename}
 % \end{decl}
 % \DescribeMacro{\attachfile}
-% The |\attachfile| macro, has only one required argument: the name of
+% The |\attachfile| macro has only one required argument: the name of
 % the file to attach.  |\attachfile| will insert an icon at the current
 % point in the document to represent the attachment.  \meta{options} is
 % a list of optional parameters for describing the icon and other
@@ -432,18 +439,21 @@
 % \end{enumerate}
 % \end{describemacro}
 %
-% \subsection{Options}
+% \section{Options}
 % \label{sec:options}
 %
 % \pkgname{attachfile} gives the user a great deal of control over the
 % way files are attached to a document.  All the commands in
 % Section~\ref{sec:commands} accept the same set of options, which are
 % entered as comma-separated, \meta{key}|=|\meta{value} pairs.  Options
-% can be specified in any order.  Case is significant.  And only the
+% can be specified in any order.  Case is significant.  Only the
 % options you want to change need to be specified; the others will
 % retain their previous value (or the default, if no previous value was
 % specified).
 %
+% \subsection{List of available options}
+% \label{sec:option-list}
+%
 % The following are the options \pkgname{attachfile} accepts, in
 % alphabetical order.
 %
@@ -492,8 +502,8 @@
 % The metadata associated with a file attachment annotation includes the
 % name of the person who attached the file.  In \adobeacrobat, this
 % information is shown when one right-clicks on the file attachment icon
-% and selects \menuname{Properties}.  By default, no author is listed,
-% but specifying |author=|\meta{name} sets the author field to
+% and selects \menuname{Properties\dots}.  By default, no author is listed
+% but specifying \indexedopt{author}|=|\meta{name} sets the author field to
 % \meta{name}.
 % \end{describeopt}
 %
@@ -502,32 +512,40 @@
 %   |color=|\meta{red} \meta{green} \meta{blue}
 % \end{decl}
 % The icons inserted by |\attachfile| and the text inserted by
-% |\textattachfile| can be any color.  The |color| option sets this
+% |\textattachfile| can be any color.  The \indexedopt{color} option sets this
 % color.  Each of \meta{red}, \meta{green}, and \meta{blue} must be a
 % decimal number between 0~(darkest) and 1~(brightest).  The default is
 % |color=1 0.9255 0.7765|, which is a beige.
 % \end{describeopt}
 %
+% \begin{describeopt}{created}
+% \begin{decl}
+%   |created=|\meta{PDF date}
+% \end{decl}
+% Virtually all filesystems associate a file-creation timestamp with
+% each file.  Although \tex\ provides no portable mechanism for
+% determining the date and time a file was created the
+% \indexedopt{created} option lets you manually specify these
+% parameters for the reader's benefit.  See Section~\ref{sec:date-usage}
+% for more information about \pkgname{attachfile} dates.
+% \end{describeopt}
+%
 % \begin{describeopt}{date}
 % \begin{decl}
-%   |date=|\meta{text}
+%   |date=|\meta{PDF date}
 % \end{decl}
-% Every annotation in a \acronym{PDF} can have a timestamp indicating
-% when the annotation was last modified.  \pkgname{attachfile}
-% automatically adds a timestamp to file attachment annotations.  It
-% uses the time and date at which \latex\ started processing your job
-% and converts it to the form ``|D:|\textit{YYYYMMDDHHmmSS}'', which is
-% the format recommended by the \acronym{PDF} reference manual~\cite[p.\
-% 89]{PDFRef}, minus the Universal Time information.\footnote{In
-% addition, seconds are hardwired to zero, because \tex's
-% \texttt{\bslash time} command has only minute precision.}
-%
-% The |date| option lets you specify the modification date and time
-% explicitly.  Note, however, that although the \acronym{PDF} reference
-% manual clearly states that ``viewer applications should be prepared to
-% accept and display a string in any format''~\cite[p.\ 400]{PDFRef},
-% \adobeacrobat will ignore any timestamp that is not in the recommended
-% format and will instead show the current date and time.
+% Each annotation in a \acronym{PDF} file can have a timestamp
+% indicating when the annotation was last modified.
+% \pkgname{attachfile} automatically adds a timestamp to file attachment
+% annotations.  It uses the date and time at which \latex\ started
+% processing your job (to minute precision because that's what \tex's
+% \texttt{\string\time} command provides) and includes the timezone, if
+% specified (using the \indexedopt{timezone} option,
+% p.~\pageref{page:timezone}).  Although it's unlikely you'll need to
+% use it, the \indexedopt{date} option lets you override the
+% annotation's modification date and time with a date and time of your
+% choice.  See Section~\ref{sec:date-usage} for more information
+% about \pkgname{attachfile} dates.
 % \end{describeopt}
 %
 % \begin{describeopt}{description}
@@ -537,22 +555,11 @@
 % The metadata associated with a file attachment annotation can include
 % a brief description of the file.  In \adobeacrobat, this information
 % is shown when one right-clicks on the file attachment icon and selects
-% \menuname{Properties}.  Also, in later versions of \adobeacrobat, the
-% description field shows up as a tool~tip when the user mouses over the
-% attachment.  By default, no description is included, but specifying
-% |description=|\meta{text} sets the description field to \meta{text}.
-% \end{describeopt}
-%
-% \begin{describeopt}{subject}
-% \begin{decl}
-%   |subject=|\meta{text}
-% \end{decl}
-% The metadata associated with a file attachment annotation can include
-% a brief comment about the subject of the attachment.  In
-% \adobeacrobat, this information is shown when one right-clicks on the
-% file attachment icon and selects \menuname{Properties}.  By default,
-% no subject is included, but specifying |subject=|\meta{text} sets the
-% subject field to \meta{text}.
+% \menuname{Properties\dots}.  Also, in later versions of \adobeacrobat,
+% the description field shows up as a tool~tip when the user mouses over
+% the attachment.  By default, no description is included, but
+% specifying \indexedopt{description}|=|\meta{text} sets the description
+% field to \meta{text}.
 % \end{describeopt}
 %
 % \begin{describeopt}{icon}
@@ -602,6 +609,18 @@
 % there first to see what type to use for a given file.
 % \end{describeopt}
 %
+% \begin{describeopt}{modified}
+% \begin{decl}
+%   |modified=|\meta{PDF date}
+% \end{decl}
+% Virtually all filesystems associate a last-modification timestamp with
+% each file.  Although \tex\ provides no portable mechanism for
+% determining the date and time a file was last modified the
+% \indexedopt{modified} option lets you manually specify these
+% parameters for the reader's benefit.  See Section~\ref{sec:date-usage}
+% for more information about \pkgname{attachfile} dates.
+% \end{describeopt}
+%
 % \begin{describeopt}{print}
 % \begin{decl}
 %   |print=|\meta{boolean}
@@ -613,17 +632,41 @@
 % dialog}.
 % \end{describeopt}
 %
+% \begin{describeopt}{size}
+% \begin{decl}
+%   |size=|\meta{integer}
+% \end{decl}
+% The \indexedopt{size} option tells the \acronym{PDF} viewer that the
+% attached file is \meta{integer} bytes long.  \adobeacrobat displays
+% this size under the ``Size'' column in the
+% \Acrobatmenu{ShowHideAttachments}{Attachments pane} but does not
+% otherwise seem to use the \meta{integer} value.
+% \end{describeopt}
+%
+% \begin{describeopt}{subject}
+% \begin{decl}
+%   |subject=|\meta{text}
+% \end{decl}
+% The metadata associated with a file attachment annotation can include
+% a brief comment about the subject of the attachment.  In
+% \adobeacrobat, this information is shown when one right-clicks on the
+% file attachment icon and selects \menuname{Properties}.  By default,
+% no subject is included, but specifying \indexedopt{subject}|=|\meta{text}
+% sets the subject field to \meta{text}.
+% \end{describeopt}
+%
 % \begin{describeopt}{timezone}
+% \label{page:timezone}
 % \begin{decl}
 %   |timezone=|\meta{offset}
 % \end{decl}
 % Because \tex\ doesn't make the current timezone available,
 % \pkgname{attachfile} is unable to include timezone information when it
-% timestamps a file attachment.  The |timezone| option lets you manually
-% specify the timezone.  \meta{offset} is the offset from
+% timestamps a file attachment.  The \indexedopt{timezone} option lets you
+% manually specify the timezone.  \meta{offset} is the offset from
 % Universal\index{Universal Time|usage} Time (a.k.a.\ \acronym{GMT}) and
 % should be in the format specified in the \acronym{PDF} reference
-% manual~\cite{PDFRef}, namely:
+% manual~\cite[\textsection3.8.3, ``Dates'']{PDFRef}, namely:
 %
 % \begin{center}
 % \begin{tabular}{cp{0.66\textwidth}}
@@ -641,7 +684,8 @@
 % \end{center}
 %
 % \noindent
-% For example, U.S. Central Time would be specified with |timezone=-06'00'|.
+% For example, U.S. Central Time would be specified with
+% \indexedopt{timezone}|=-06'00'|.
 % \end{describeopt}
 %
 % \begin{describeopt}{zoom}
@@ -668,12 +712,15 @@
 %   \indexedopt{appearance}  & |true| \\
 %   \indexedopt{author}      & \emph{none} \\
 %   \indexedopt{color}       & |1 0.9255 0.7765| \\
+%   \indexedopt{created}     & \emph{none} \\
 %   \indexedopt{date}        & \emph{automatic} \\
 %   \indexedopt{description} & \emph{none} \\
-%   \indexedopt{subject}     & \emph{none} \\
 %   \indexedopt{icon}        & |PushPin| \\
 %   \indexedopt{mimetype}    & \emph{none} \\
+%   \indexedopt{modified}    & \emph{none} \\
 %   \indexedopt{print}       & |true| \\
+%   \indexedopt{size}        & \emph{none} \\
+%   \indexedopt{subject}     & \emph{none} \\
 %   \indexedopt{timezone}    & \emph{none} \\
 %   \indexedopt{zoom}        & |true| \\ \hline
 % \end{tabular}
@@ -681,6 +728,41 @@
 % \label{tbl:opt-defaults}
 % \end{table}
 %
+% \subsection{Date usage}
+% \label{sec:date-usage}
+%
+% Section~\ref{sec:option-list} presents three timestamp-related
+% options: \indexedopt{date}, \indexedopt{created}, and
+% \indexedopt{modified}.  The \indexedopt{date} option specifies the
+% annotation date---the date and time the given file was attached to the
+% \acronym{PDF} file---and should usually be left unspecified.  (It
+% defaults to the date and time at which \latex\ started processing your
+% job.)  The annotation date is displayed in \adobeacrobat by
+% right-clicking on the annotation, choosing \menuname{Properties\dots}\
+% from the menu, and clicking on the \menuname{General} tab.  The
+% \indexedopt{modified} option specifies the file's modification
+% date---the date and time the given file was last modified.
+% \adobeacrobat displays the modification date under the ``Modified''
+% column in the \Acrobatmenu{ShowHideAttachments}{Attachments pane} but
+% does not otherwise appear to use the modification date.  Finally, the
+% \indexedopt{created} option specifies the file's creation date---the
+% date and time the given file was first written to disk.  As of this
+% writing, \adobeacrobat does not appear to use or even display the
+% creation date; perhaps future versions or other \acronym{PDF} viewers
+% will.
+%
+% Dates should be specified in the form
+% ``|D:|\textit{YYYYMMDDHHmmSSOHH}|'|\textit{mm}|'|'' as described in
+% the \acronym{PDF} reference manual~\cite[\textsection3.8.3,
+% ``Dates'']{PDFRef}.  Note, however, that although the \acronym{PDF}
+% reference manual clearly states that ``viewer applications should be
+% prepared to accept and display a string in any
+% format''~\cite[Table~8.11, ``Entries common to all annotation
+% dictionaries'']{PDFRef}, \adobeacrobat will ignore any timestamp that
+% is not in the recommended format and will instead show ``00/00/00
+% 00:00:00'' for the annotation date or ``Unknown'' for the modification
+% date.
+%
 %
 % \section{Caveats}
 % \label{sec:caveats}
@@ -698,8 +780,8 @@
 %   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,
-%   \adobeacrobatreader (the free, view-only version of \adobeacrobat)
+%   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.
 %
@@ -813,14 +895,11 @@
 % \pkgname{attachfile} macros with dummy versions so \latex\ can at
 % least run to completion.
 %    \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}
 %
 %
@@ -996,12 +1075,20 @@
 % \begin{macro}{\atfi@embedfile}
 % Embed a file as a \acronym{PDF} \pdfname{EmbeddedFile} object and store its
 % object number in |atfi@embedfileobj|.
+% \changes{v1.3}{2007/01/15}{Included a \protect\pdfname{Params}
+%   dictionary describing the file's date, modification date, and size}
 %    \begin{macrocode}
 \newcounter{atfi@embedfileobj}
 \DeclareRobustCommand{\atfi@embedfile}[1]{%
   \immediate\pdfobj stream attr {
     /Type /EmbeddedFile
-    \atfi@mimetype
+    \atfi@mimetype\space
+    \atfi@dlsize\space
+    /Params <<
+      \atfi@credate\space
+      \atfi@moddate\space
+      \atfi@size\space
+    >>
   } file {#1}%
   \setcounter{atfi@embedfileobj}{\pdflastobj}%
 }
@@ -1088,10 +1175,17 @@
 % |\atfi@insert@file@annot| takes one argument, the name of the file
 % to attach.  This should be the same value that was passed to
 % |\atfi@embedfile|.
+% \changes{v1.3}{2007/01/15}{Made robust to running
+%   \protect\pkgname{hyperref} with
+%   \protect\texttt{\protect\string\protect\Hy@unicodetrue}}
 %    \begin{macrocode}
 \DeclareRobustCommand{\atfi@insert@file@annot}[1]{%
   \rule{0pt}{0pt}%
-  \atfi@pdfstringdef\atfi@file{#1}%
+  \bgroup\Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@file{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@file{\atfi@file}%
+    }\next
   \ifatfi@appearance
 %    \end{macrocode}
 % We currently use the same appearance for \textsf{N}ormal,
@@ -1104,6 +1198,8 @@
 % ^^A
 % \changes{v1.1}{2005/01/04}{Added explicit \protect\textsf{R}ollover
 %   and \protect\textsf{D}own appearances to work around browser bugs}
+% \changes{v1.3}{2007/01/15}{Modified to include the modification date
+%   in the \protect\pdfname{FileAttachment} dictionary}
 %    \begin{macrocode}
     \def\atfi@appearance@dict{%
       /AP <<
@@ -1117,13 +1213,14 @@
             height \atfi@appearanceheight
             depth \atfi@appearancedepth {
     /Subtype /FileAttachment
-    \atfi@icon\space
-    \atfi@color\space
+    \atfi@appearance@dict\space
     \atfi@author\space
+    \atfi@color\space
     \atfi@date\space
     \atfi@description\space
+    \atfi@icon\space
+    \atfi@moddate\space
     \atfi@subject\space
-    \atfi@appearance@dict\space
     /F \theatfi@flags\space
     /FS <<
       /Type /Filespec
@@ -1352,6 +1449,9 @@
 % I was too lazy to do the same for |\day|, |\month|, and |\year|, so
 % don't process your \latex\ document at midnight if you want to get a
 % correct datestamp.
+% \changes{v1.3}{2007/01/15}{Made robust to running
+%   \protect\pkgname{hyperref} with
+%   \protect\texttt{\protect\string\protect\Hy@unicodetrue}}
 %    \begin{macrocode}
 \edef\atfi@time{\time}
 \newcounter{atfi@hours}
@@ -1368,8 +1468,11 @@
       \atfi@timezone)%
 }
 \define@key{AtFi}{date}{%
-  \atfi@pdfstringdef\atfi@date{#1}%
-  \edef\atfi@date{/M (\atfi@date)}%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@date{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@date{/M (\atfi@date)}%
+    }\next
 }
 %    \end{macrocode}
 % \end{macro}
@@ -1395,7 +1498,6 @@
 % Store the annotation's subject.  \adobeacrobat shows this when you
 % right-click on the annotation and choose \menuname{Properties}.  It
 % also shows it in the Annotations tab once you ``Rescan Document''.
-% ^^A
 % \changes{v1.1}{2005/01/04}{Added support for specifying the subject of
 %   an annotation}
 %    \begin{macrocode}
@@ -1407,6 +1509,67 @@
 %    \end{macrocode}
 % \end{macro}
 %
+% \begin{macro}{\atfi@credate}
+% Store the annotation's creation date.  \adobeacrobat shows this when
+% you right-click on the annotation and choose \menuname{Properties}.
+% It also shows it in the Annotations tab once you ``Rescan Document''.
+% Note that creation date is a \acronym{PDF}~1.5 feature.
+% \changes{v1.3}{2007/01/15}{Added support for specifying the creation
+%   date of an annotation}
+%    \begin{macrocode}
+\def\atfi@credate{}
+\define@key{AtFi}{created}{%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@credate{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@credate{/CreationDate (\atfi@credate)}%
+    }\next
+}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\atfi@moddate}
+% Store the annotation's modification date.  \adobeacrobat shows this when
+% you right-click on the annotation and choose \menuname{Properties}.
+% It also shows it in the Annotations tab once you ``Rescan Document''.
+% Note that modification date is a \acronym{PDF}~1.5 feature.
+% \changes{v1.3}{2007/01/15}{Added support for specifying the modification
+%   date of an annotation}
+%    \begin{macrocode}
+\def\atfi@moddate{}
+\define@key{AtFi}{modified}{%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@moddate{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@moddate{/ModDate (\atfi@moddate)}%
+    }\next
+}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\atfi@size}
+% \begin{macro}{\atfi@dlsize}
+% Store the annotation's file size.  \adobeacrobat shows this when
+% you right-click on the annotation and choose \menuname{Properties}.
+% It also shows it in the Annotations tab once you ``Rescan Document''.
+% Note that file size is a \acronym{PDF}~1.5 feature.
+% \changes{v1.3}{2007/01/15}{Added support for specifying the file size
+%   of an annotation}
+%    \begin{macrocode}
+\def\atfi@size{}
+\def\atfi@dlsize{}
+\define@key{AtFi}{size}{%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@size{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@size{/Size \atfi@size}%
+      \def\noexpand\atfi@dlsize{/DL \atfi@size}%
+    }\next
+}
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
 % \begin{macro}{\ifatfi@print}
 % \begin{macro}{\atfi@printtrue}
 % \begin{macro}{\atfi@printfalse}
diff --git a/Master/texmf-dist/source/latex/attachfile/attachfile.ins b/Master/texmf-dist/source/latex/attachfile/attachfile.ins
index 2897bd14d31..10b0c6709c5 100644
--- a/Master/texmf-dist/source/latex/attachfile/attachfile.ins
+++ b/Master/texmf-dist/source/latex/attachfile/attachfile.ins
@@ -3,18 +3,18 @@
 %% driver files from the doc files in this package when run through
 %% LaTeX or TeX.
 %%
-%% Copyright (C) 2006 Scott Pakin <scott+af@pakin.org>
+%% Copyright (C) 2007 Scott Pakin <scott+af@pakin.org>
 %% -------------------------------------------------------
 %% 
 %% This package may be distributed and/or modified under the
 %% conditions of the LaTeX Project Public License, either
-%% version 1.3b of this license or (at your option) any later
+%% version 1.3c of this license or (at your option) any later
 %% version.  The latest version of this license is in:
 %%
 %%    http://www.latex-project.org/lppl.txt
 %%
-%% and version 1.3b or later is part of all distributions of
-%% LaTeX version 2006/01/07 or later.
+%% and version 1.3c or later is part of all distributions of
+%% LaTeX version 2006/05/20 or later.
 %%
 %% --------------- start of docstrip commands ------------------
 %%
@@ -28,18 +28,18 @@
 
 This is a generated file.
 
-Copyright (C) 2006 Scott Pakin <scott+af@pakin.org>
+Copyright (C) 2007 Scott Pakin <scott+af@pakin.org>
 -------------------------------------------------------
 
 This package may be distributed and/or modified under the
 conditions of the LaTeX Project Public License, either
-version 1.3b of this license or (at your option) any later
+version 1.3c of this license or (at your option) any later
 version.  The latest version of this license is in
 
    http://www.latex-project.org/lppl.txt
 
-and version 1.3b or later is part of all distributions of
-LaTeX version 2006/01/07 or later.
+and version 1.3c or later is part of all distributions of
+LaTeX version 2006/05/20 or later.
 
 \endpreamble
 
diff --git a/Master/texmf-dist/tex/latex/attachfile/attachfile.sty b/Master/texmf-dist/tex/latex/attachfile/attachfile.sty
index 7f4afbe4fab..cdeee8d0b07 100644
--- a/Master/texmf-dist/tex/latex/attachfile/attachfile.sty
+++ b/Master/texmf-dist/tex/latex/attachfile/attachfile.sty
@@ -8,30 +8,27 @@
 %% 
 %% This is a generated file.
 %% 
-%% Copyright (C) 2006 Scott Pakin <scott+af@pakin.org>
+%% Copyright (C) 2007 Scott Pakin <scott+af@pakin.org>
 %% -------------------------------------------------------
 %% 
 %% This package may be distributed and/or modified under the
 %% conditions of the LaTeX Project Public License, either
-%% version 1.3b of this license or (at your option) any later
+%% version 1.3c of this license or (at your option) any later
 %% version.  The latest version of this license is in
 %% 
 %%    http://www.latex-project.org/lppl.txt
 %% 
-%% and version 1.3b or later is part of all distributions of
-%% LaTeX version 2006/01/07 or later.
+%% and version 1.3c or later is part of all distributions of
+%% LaTeX version 2006/05/20 or later.
 %% 
 \NeedsTeXFormat{LaTeX2e}[1999/12/01]
 \ProvidesPackage{attachfile}
-    [2006/03/28 v1.2a PDF 1.3+ file attachment]
-\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
+    [2007/01/15 v1.3 PDF 1.3+ file attachment]
+\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{keyval}
 \RequirePackage{calc}
 \RequirePackage{color}
@@ -121,7 +118,13 @@
 \DeclareRobustCommand{\atfi@embedfile}[1]{%
   \immediate\pdfobj stream attr {
     /Type /EmbeddedFile
-    \atfi@mimetype
+    \atfi@mimetype\space
+    \atfi@dlsize\space
+    /Params <<
+      \atfi@credate\space
+      \atfi@moddate\space
+      \atfi@size\space
+    >>
   } file {#1}%
   \setcounter{atfi@embedfileobj}{\pdflastobj}%
 }
@@ -153,7 +156,11 @@
 }
 \DeclareRobustCommand{\atfi@insert@file@annot}[1]{%
   \rule{0pt}{0pt}%
-  \atfi@pdfstringdef\atfi@file{#1}%
+  \bgroup\Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@file{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@file{\atfi@file}%
+    }\next
   \ifatfi@appearance
     \def\atfi@appearance@dict{%
       /AP <<
@@ -167,13 +174,14 @@
             height \atfi@appearanceheight
             depth \atfi@appearancedepth {
     /Subtype /FileAttachment
-    \atfi@icon\space
-    \atfi@color\space
+    \atfi@appearance@dict\space
     \atfi@author\space
+    \atfi@color\space
     \atfi@date\space
     \atfi@description\space
+    \atfi@icon\space
+    \atfi@moddate\space
     \atfi@subject\space
-    \atfi@appearance@dict\space
     /F \theatfi@flags\space
     /FS <<
       /Type /Filespec
@@ -265,8 +273,11 @@
       \atfi@timezone)%
 }
 \define@key{AtFi}{date}{%
-  \atfi@pdfstringdef\atfi@date{#1}%
-  \edef\atfi@date{/M (\atfi@date)}%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@date{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@date{/M (\atfi@date)}%
+    }\next
 }
 \def\atfi@description{}
 \define@key{AtFi}{description}{%
@@ -278,6 +289,32 @@
   \atfi@pdfstringdef\atfi@subject{#1}%
   \edef\atfi@subject{/Subj (\atfi@subject)}%
 }
+\def\atfi@credate{}
+\define@key{AtFi}{created}{%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@credate{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@credate{/CreationDate (\atfi@credate)}%
+    }\next
+}
+\def\atfi@moddate{}
+\define@key{AtFi}{modified}{%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@moddate{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@moddate{/ModDate (\atfi@moddate)}%
+    }\next
+}
+\def\atfi@size{}
+\def\atfi@dlsize{}
+\define@key{AtFi}{size}{%
+  \bgroup \Hy@unicodefalse
+    \atfi@pdfstringdef\atfi@size{#1}%
+    \edef\next{\egroup
+      \def\noexpand\atfi@size{/Size \atfi@size}%
+      \def\noexpand\atfi@dlsize{/DL \atfi@size}%
+    }\next
+}
 \newif\ifatfi@print
 \atfi@printtrue
 \define@key{AtFi}{print}[true]{\csname atfi@print#1\endcsname}
diff --git a/Master/texmf-dist/tpm/attachfile.tpm b/Master/texmf-dist/tpm/attachfile.tpm
index decbeb80bad..4bf6abbcd47 100644
--- a/Master/texmf-dist/tpm/attachfile.tpm
+++ b/Master/texmf-dist/tpm/attachfile.tpm
@@ -3,7 +3,7 @@
   <rdf:Description about="http://texlive.dante.de/texlive/Package/attachfile.zip">
     <TPM:Name>attachfile</TPM:Name>
     <TPM:Type>Package</TPM:Type>
-    <TPM:Date>2006/10/12 01:55:05</TPM:Date>
+    <TPM:Date>2007/01/18 01:03:00</TPM:Date>
     <TPM:Version>1.0</TPM:Version>
     <TPM:Creator>rahtz</TPM:Creator>
     <TPM:Title>Attach arbitrary files to a PDF document</TPM:Title>
@@ -26,15 +26,15 @@ enclosing document.
     <TPM:Size>369358</TPM:Size>
     <TPM:License></TPM:License>
     <TPM:Build/>
-    <TPM:RunFiles size="12778">
+    <TPM:RunFiles size="13787">
 texmf-dist/tex/latex/attachfile/attachfile.sty
 texmf-dist/tpm/attachfile.tpm
     </TPM:RunFiles>
-    <TPM:DocFiles size="294549">
+    <TPM:DocFiles size="294304">
 texmf-dist/doc/latex/attachfile/README
 texmf-dist/doc/latex/attachfile/attachfile.pdf
     </TPM:DocFiles>
-    <TPM:SourceFiles size="62031">
+    <TPM:SourceFiles size="68960">
 texmf-dist/source/latex/attachfile/attachfile.dtx
 texmf-dist/source/latex/attachfile/attachfile.ins
     </TPM:SourceFiles>