diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/oberdiek/attachfile2.dtx | 125 |
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’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 |