summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorReinhard Kotucha <reinhard.kotucha@web.de>2007-01-18 17:52:20 +0000
committerReinhard Kotucha <reinhard.kotucha@web.de>2007-01-18 17:52:20 +0000
commitc7325bb63f72cb535e7666100d0fd6dfd9a08555 (patch)
tree36e38e0cc48103913212d0272a01577290ef4d54 /Master
parentbbabf27bc97393c29e22a907758e1284ec24f777 (diff)
Update attachfile.
git-svn-id: svn://tug.org/texlive/trunk@3569 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/latex/attachfile/README10
-rw-r--r--Master/texmf-dist/doc/latex/attachfile/attachfile.pdfbin292584 -> 292339 bytes
-rw-r--r--Master/texmf-dist/source/latex/attachfile/attachfile.dtx323
-rw-r--r--Master/texmf-dist/source/latex/attachfile/attachfile.ins16
-rw-r--r--Master/texmf-dist/tex/latex/attachfile/attachfile.sty77
-rw-r--r--Master/texmf-dist/tpm/attachfile.tpm8
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
Binary files differ
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>