summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx')
-rw-r--r--Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx125
1 files changed, 90 insertions, 35 deletions
diff --git a/Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx b/Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx
index f7fad293898..85d77f3634a 100644
--- a/Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx
+++ b/Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx
@@ -1,11 +1,12 @@
% \iffalse meta-comment
-%
+%
% File: attachfile2.dtx
-% Version: 2010/09/27 v2.6
-%
-% Copyright (C) 2005-2010 by
+% Version: 2012/04/18 v2.7
+% Info: Attach files into PDF
+%
+% Copyright (C) 2005-2010, 2012 by
% Heiko Oberdiek <heiko.oberdiek at googlemail.com>
-%
+%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either
% version 1.3c of this license or (at your option) any later
@@ -15,21 +16,21 @@
% http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of
% LaTeX version 2005/12/01 or later.
-%
+%
% This work has the LPPL maintenance status "maintained".
-%
+%
% This Current Maintainer of this work is Heiko Oberdiek.
-%
+%
% This work consists of the main source file attachfile2.dtx
% and the derived files
% attachfile2.sty, attachfile2.pdf, attachfile2.ins, attachfile2.drv,
% atfi-dvips.def, atfi-pdftex.def, atfi-dvipdfmx.def,
% pdfatfi.pl.
-%
+%
% Distribution:
% CTAN:macros/latex/contrib/oberdiek/attachfile2.dtx
% CTAN:macros/latex/contrib/oberdiek/attachfile2.pdf
-%
+%
% Unpacking:
% (a) If attachfile2.ins is present:
% tex attachfile2.ins
@@ -38,7 +39,7 @@
% (c) If you insist on using LaTeX
% latex \let\install=y\input{attachfile2.dtx}
% (quote the arguments according to the demands of your shell)
-%
+%
% Documentation:
% (a) If attachfile2.drv is present:
% latex attachfile2.drv
@@ -48,14 +49,14 @@
% if available. Here you can specify further options, e.g.
% use A4 as paper format:
% \PassOptionsToClass{a4paper}{article}
-%
+%
% Programm calls to get the documentation (example):
% pdflatex attachfile2.dtx
% makeindex -s gind.ist attachfile2.idx
% pdflatex attachfile2.dtx
% makeindex -s gind.ist attachfile2.idx
% pdflatex attachfile2.dtx
-%
+%
% Installation:
% TDS:tex/latex/oberdiek/attachfile2.sty
% TDS:tex/latex/oberdiek/atfi-dvips.def
@@ -80,7 +81,7 @@
\input docstrip.tex
\Msg{************************************************************************}
\Msg{* Installation}
-\Msg{* Package: attachfile2 2010/09/27 v2.6 attach files into PDF (HO)}
+\Msg{* Package: attachfile2 2012/04/18 v2.7 Attach files into PDF (HO)}
\Msg{************************************************************************}
\keepsilent
@@ -92,9 +93,9 @@
This is a generated file.
Project: attachfile2
-Version: 2010/09/27 v2.6
+Version: 2012/04/18 v2.7
-Copyright (C) 2005-2010 by
+Copyright (C) 2005-2010, 2012 by
Heiko Oberdiek <heiko.oberdiek at googlemail.com>
This work may be distributed and/or modified under the
@@ -133,6 +134,8 @@ and the derived files
\usedir{scripts/oberdiek}%
\csname execfiletrue\endcsname
\file{pdfatfi.pl}{\from{attachfile2.dtx}{pdfatfi}}%
+ \usedir{source/latex/oberdiek/catalogue}%
+ \file{attachfile2.xml}{\from{attachfile2.dtx}{catalogue}}%
}
\catcode32=13\relax% active space
@@ -164,9 +167,9 @@ and the derived files
%<*driver>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{attachfile2.drv}%
- [2010/09/27 v2.6 attach files into PDF (HO)]%
+ [2012/04/18 v2.7 Attach files into PDF (HO)]%
\documentclass{ltxdoc}
-\usepackage{holtxdoc}[2011/02/04]
+\usepackage{holtxdoc}[2011/11/22]
\begin{document}
\DocInput{attachfile2.dtx}%
\end{document}
@@ -194,7 +197,7 @@ and the derived files
% \GetFileInfo{attachfile2.drv}
%
% \title{The \xpackage{attachfile2} package}
-% \date{2010/09/27 v2.6}
+% \date{2012/04/18 v2.7}
% \author{Heiko Oberdiek\\\xemail{heiko.oberdiek at googlemail.com}}
%
% \maketitle
@@ -421,7 +424,7 @@ and the derived files
%<*package>
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{attachfile2}%
- [2010/09/27 v2.6 attach files into PDF (HO)]%
+ [2012/04/18 v2.7 Attach files into PDF (HO)]%
% \end{macrocode}
%
% \subsubsection{Loading of packages}
@@ -1604,7 +1607,7 @@ and the derived files
%<*pdftex>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{atfi-pdftex.def}%
- [2010/09/27 v2.6 attachfile2 driver for pdfTeX (HO)]%
+ [2012/04/18 v2.7 attachfile2 driver for pdfTeX (HO)]%
% \end{macrocode}
%
% \paragraph{\LuaTeX}
@@ -1826,7 +1829,7 @@ and the derived files
%<*dvips>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{atfi-dvips.def}%
- [2010/09/27 v2.6 attachfile2 driver for dvips (HO)]%
+ [2012/04/18 v2.7 attachfile2 driver for dvips (HO)]%
% \end{macrocode}
%
% \paragraph{Macros for graphics data}
@@ -2401,7 +2404,7 @@ and the derived files
%<*dvipdfmx>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{atfi-dvipdfmx.def}%
- [2010/09/27 v2.6 attachfile2 driver for dvipdfmx/XeTeX (HO)]%
+ [2012/04/18 v2.7 attachfile2 driver for dvipdfmx/XeTeX (HO)]%
% \end{macrocode}
%
% \paragraph{Macros for graphics data}
@@ -2645,7 +2648,7 @@ $^W=1; # turn warning on
#
# pdfatfi.pl
#
-# Copyright (C) 2005-2010 Heiko Oberdiek.
+# Copyright (C) 2005-2010, 2012 Heiko Oberdiek.
#
# This work may be distributed and/or modified under the
# conditions of the LaTeX Project Public License, either
@@ -2667,17 +2670,19 @@ $^W=1; # turn warning on
# This file "pdfatfi.pl" may be renamed to "pdfatfi"
# for installation purposes.
#
-my $file = "pdfatfi.pl";
+my $prj = 'pdfatfi';
+my $file = "$prj.pl";
my $program = uc($&) if $file =~ /^\w+/;
-my $version = "2.6";
-my $date = "2010/09/27";
+my $version = "2.7";
+my $date = "2012/04/18";
my $author = "Heiko Oberdiek";
-my $copyright = "Copyright (c) 2005-2010 by $author.";
+my $copyright = "Copyright (c) 2005-2010, 2012 by $author.";
#
# History:
# 2005/05/21 v1.0: First release.
# 2006/08/16 v2.2: Included in DTX file of attachfile2.dtx.
# 2010/09/27 v2.6: Keys ModDateTZ and CreationDateTZ added.
+# 2012/04/18 v2.7: Option --version added.
#
use POSIX qw(strftime); # %z is used (GNU)
@@ -2698,12 +2703,14 @@ $::opt_help = 0;
$::opt_quiet = 0;
$::opt_debug = 0;
$::opt_verbose = 0;
+$::opt_version = 0;
my $usage = <<"END_OF_USAGE";
${title}Syntax: \L$program\E [options] <file[.atfi]>
Function: Help program for LaTeX package "attachfile2".
Options: (defaults:)
--help print usage
+ --version print version number
--(no)quiet suppress messages ($bool[$::opt_quiet])
--(no)verbose verbose printing ($bool[$::opt_verbose])
--(no)debug debug informations ($bool[$::opt_debug])
@@ -2714,11 +2721,16 @@ my @OrgArgv = @ARGV;
use Getopt::Long;
GetOptions(
"help!",
+ "version!",
"quiet!",
"debug!",
"verbose!",
) or die $usage;
!$::opt_help or die $usage;
+if ($::opt_version) {
+ print "$prj $date v$version\n";
+ exit(0);
+}
@ARGV == 1 or die "$usage$Error Missing jobname!\n";
$::opt_quiet = 0 if $::opt_verbose;
@@ -3002,7 +3014,6 @@ __END__
%\end{verbatim}
% \end{quote}
%
-
%
% \subsection{Some details for the interested}
%
@@ -3051,33 +3062,73 @@ __END__
%\end{verbatim}
% \end{quote}
%
+% \section{Catalogue}
+%
+% The following XML file can be used as source for the
+% \href{http://mirror.ctan.org/help/Catalogue/catalogue.html}{\TeX\ Catalogue}.
+% The elements \texttt{caption} and \texttt{description} are imported
+% from the original XML file from the Catalogue.
+% The name of the XML file in the Catalogue is \xfile{attachfile2.xml}.
+% \begin{macrocode}
+%<*catalogue>
+<?xml version='1.0' encoding='us-ascii'?>
+<!DOCTYPE entry SYSTEM 'catalogue.dtd'>
+<entry datestamp='$Date$' modifier='$Author$' id='attachfile2'>
+ <name>attachfile2</name>
+ <caption>Attach files into PDF.</caption>
+ <authorref id='auth:oberdiek'/>
+ <copyright owner='Heiko Oberdiek' year='2005-2010,2012'/>
+ <license type='lppl1.3'/>
+ <version number='2.7'/>
+ <description>
+ This package can be used to attach files to a PDF document.
+ It is a further development of Scott Pakin&#x2019;s package
+ <xref refid='attachfile'>attachfile</xref> for
+ <xref refid='pdftex'>pdfTeX</xref>. Apart from bug fixes,
+ this package adds support for dvips,
+ some new options, and gets and writes meta information data about
+ the attached files.
+ <p/>
+ The package is part of the <xref refid='oberdiek'>oberdiek</xref>
+ bundle.
+ </description>
+ <documentation details='Package documentation'
+ href='ctan:/macros/latex/contrib/oberdiek/attachfile2.pdf'/>
+ <ctan file='true' path='/macros/latex/contrib/oberdiek/attachfile2.dtx'/>
+ <miktex location='oberdiek'/>
+ <texlive location='oberdiek'/>
+ <install path='/macros/latex/contrib/oberdiek/oberdiek.tds.zip'/>
+</entry>
+%</catalogue>
+% \end{macrocode}
+%
% \begin{thebibliography}{9}
% \bibitem{attachfile}
% Scott Pakin: \textit{The \xpackage{attachfile} package};
% 2005/02/20 v1.2;
% \CTAN{macros/latex/contrib/attachfile/}.
-%
+%
% \bibitem{embedfile}
% Heiko Oberdiek: \textit{The \xpackage{embedfile} package};
% 2006/08/16 v1.0;
% \CTAN{macros/latex/contrib/oberdiek/embedfile.pdf}.
-%
+%
% \bibitem{pdfspec}
% Adobe Systems Incorporated:
% \href{http://partners.adobe.com/public/developer/en/pdf/PDFReference16.pdf}%
% {\textit{PDF Reference, Fifth Edition, Version 1.6}},%
% November 2004;
% \url{http://partners.adobe.com/public/developer/pdf/index_reference.html}.
-%
+%
% \bibitem{mime}
% Network Working Group: RFC 2046, \textit{Multipurpose Internet Mail Extensions (MIME) Part Two:
% Media Types}, November 1996; \url{http://www.rfc-editor.org/}.
-%
+%
% \bibitem{types}
% IANA (Internet Assigned Numbers Authority):
% \textit{MIME Media Types}, May 2006;
% \url{http://www.iana.org/assignments/media-types/}.
-%
+%
% \end{thebibliography}
%
% \begin{History}
@@ -3150,10 +3201,14 @@ __END__
% Bug fix: \cs{textattachfile} now adds an entry into
% the \xext{atfi} file.
% \item
-% Program pdfatfi.pl sets modification and creation time with
+% Program \xfile{pdfatfi.pl} sets modification and creation time with
% time zone, because the time zone offset might differ with
% the file date.
% \end{Version}
+% \begin{Version}{2012/04/18 v2.7}
+% \item
+% Program \xfile{pdfatfi.pl}: Option \xoption{version} added.
+% \end{Version}
% \end{History}
%
% \PrintIndex