diff options
Diffstat (limited to 'Master/texmf-dist')
| -rw-r--r-- | Master/texmf-dist/doc/latex/attachfile/README | 10 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/attachfile/attachfile.pdf | bin | 292584 -> 292339 bytes | |||
| -rw-r--r-- | Master/texmf-dist/source/latex/attachfile/attachfile.dtx | 323 | ||||
| -rw-r--r-- | Master/texmf-dist/source/latex/attachfile/attachfile.ins | 16 | ||||
| -rw-r--r-- | Master/texmf-dist/tex/latex/attachfile/attachfile.sty | 77 | ||||
| -rw-r--r-- | Master/texmf-dist/tpm/attachfile.tpm | 8 |
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 Binary files differindex 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> |