From e785fd9e6ba510f4fcded804c4614e2a24e24c55 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 26 Nov 2019 21:40:11 +0000 Subject: attachfile2 (26nov19) git-svn-id: svn://tug.org/texlive/trunk@52929 c570f23f-e606-0410-a88d-b1316a301751 --- .../source/latex/attachfile2/attachfile2.dtx | 95 ++++++++++++++++++---- 1 file changed, 78 insertions(+), 17 deletions(-) (limited to 'Master/texmf-dist/source') diff --git a/Master/texmf-dist/source/latex/attachfile2/attachfile2.dtx b/Master/texmf-dist/source/latex/attachfile2/attachfile2.dtx index 0b5922b976e..2f4aefb8dd1 100644 --- a/Master/texmf-dist/source/latex/attachfile2/attachfile2.dtx +++ b/Master/texmf-dist/source/latex/attachfile2/attachfile2.dtx @@ -1,7 +1,7 @@ % \iffalse meta-comment % % File: attachfile2.dtx -% Version: 2019/11/24 v2.10 +% Version: 2019/11/26 v2.11 % Info: Attach files into PDF % % Copyright (C) @@ -27,9 +27,9 @@ % % This work consists of the main source file attachfile2.dtx % and the derived files -% attachfile2.sty, attachfile2.pdf, attachfile2.ins, attachfile2.drv, +% attachfile2.sty, attachfile2.pdf, % atfi-dvips.def, atfi-pdftex.def, atfi-dvipdfmx.def, atfi-luatex.def -% pdfatfi.pl. +% pdfatfi.pl pdfatfi.1. % % Distribution: % CTAN:macros/latex/contrib/attachfile2/attachfile2.dtx @@ -69,6 +69,7 @@ % TDS:tex/latex/attachfile2/atfi-luatex.def % TDS:scripts/attachfile2/pdfatfi.pl (exec flag) % TDS:doc/latex/attachfile2/attachfile2.pdf +% TDS:doc/man/man1/pdfatfi.1 % TDS:source/latex/attachfile2/attachfile2.dtx % %<*ignore> @@ -86,7 +87,7 @@ \input docstrip.tex \Msg{************************************************************************} \Msg{* Installation} -\Msg{* Package: attachfile2 2019/11/24 v2.10 Attach files into PDF (HO)} +\Msg{* Package: attachfile2 2019/11/26 v2.11 Attach files into PDF (HO)} \Msg{************************************************************************} \keepsilent @@ -98,7 +99,7 @@ This is a generated file. Project: attachfile2 -Version: 2019/11/24 v2.10 +Version: 2019/11/26 v2.11 Copyright (C) 2005-2010, 2012 Heiko Oberdiek @@ -123,9 +124,9 @@ https://github.com/ho-tex/attachfile2/issues This work consists of the main source file attachfile2.dtx and the derived files - attachfile2.sty, attachfile2.pdf, attachfile2.ins, attachfile2.drv, + attachfile2.sty, attachfile2.pdf, atfi-dvips.def, atfi-pdftex.def, atfi-dvipdfmx.def, atfi-luatex.def - pdfatfi.pl. + pdfatfi.pl, pdfatfi.1. \endpreamble \let\MetaPrefix\DoubleperCent @@ -141,6 +142,8 @@ and the derived files \file{atfi-dvipdfmx.def}{\from{attachfile2.dtx}{dvipdfmx}}% \nopreamble \nopostamble + \usedir{doc/man/man1/}% + \file{pdfatfi.1}{\from{attachfile2.dtx}{pdfatfiman}}% \usedir{scripts/attachfile2}% \csname execfiletrue\endcsname \file{pdfatfi.pl}{\from{attachfile2.dtx}{pdfatfi}}% @@ -177,7 +180,7 @@ and the derived files %<*driver> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{attachfile2.drv}% - [2019/11/24 v2.10 Attach files into PDF (HO)]% + [2019/11/26 v2.11 Attach files into PDF (HO)]% \documentclass{ltxdoc} \usepackage{holtxdoc}[2011/11/22] \begin{document} @@ -206,7 +209,7 @@ and the derived files % \GetFileInfo{attachfile2.drv} % % \title{The \xpackage{attachfile2} package} -% \date{2019/11/24 v2.10} +% \date{2019/11/26 v2.11} % \author{Heiko Oberdiek\thanks % {Please report any issues at \url{https://github.com/ho-tex/attachfile2/issues}}} % @@ -434,7 +437,7 @@ and the derived files %<*package> \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{attachfile2}% - [2019/11/24 v2.10 Attach files into PDF (HO)]% + [2019/11/26 v2.11 Attach files into PDF (HO)]% % \end{macrocode} % % \subsubsection{Loading of packages} @@ -1623,7 +1626,7 @@ and the derived files %<*pdftex> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{atfi-pdftex.def}% - [2019/11/24 v2.10 attachfile2 driver for pdfTeX (HO)]% + [2019/11/26 v2.11 attachfile2 driver for pdfTeX (HO)]% % \end{macrocode} % % \paragraph{Macros for graphics data} @@ -1807,7 +1810,7 @@ and the derived files %<*luatex> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{atfi-luatex.def}% - [2019/11/24 v2.10 attachfile2 driver for luaTeX (HO)]% + [2019/11/26 v2.11 attachfile2 driver for luaTeX (HO)]% \protected\def\atfi@literal {\pdfextension literal} \def\atfi@GSAVE{q } \def\atfi@GRESTORE{Q } @@ -1941,7 +1944,7 @@ and the derived files %<*dvips> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{atfi-dvips.def}% - [2019/11/24 v2.10 attachfile2 driver for dvips (HO)]% + [2019/11/26 v2.11 attachfile2 driver for dvips (HO)]% % \end{macrocode} % % \paragraph{Macros for graphics data} @@ -2516,7 +2519,7 @@ and the derived files %<*dvipdfmx> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{atfi-dvipdfmx.def}% - [2019/11/24 v2.10 attachfile2 driver for dvipdfmx/XeTeX (HO)]% + [2019/11/26 v2.11 attachfile2 driver for dvipdfmx/XeTeX (HO)]% % \end{macrocode} % % \paragraph{Macros for graphics data} @@ -2788,7 +2791,7 @@ my $prj = 'pdfatfi'; my $file = "$prj.pl"; my $program = uc($&) if $file =~ /^\w+/; my $version = "2.9"; -my $date = "2019/11/24"; +my $date = "2019/11/26"; my $author = "Heiko Oberdiek"; my $copyright = "Copyright (c) 2005-2010, 2012 by $author."; # @@ -2978,6 +2981,60 @@ __END__ % % \end{macrocode} % +% \begin{macrocode} +%<*pdfatfiman> +.TH pdfatfi 1 "2019-11-24" +.SH NAME +pdfatfi \- Help program for the LaTeX package attachfile2. +.SH SYNOPSIS +pdfatfi [] ] +.SH DESCRIPTION +Helper program for the LaTeX package attachfile2. + +This package also tries to get and add meta information data, +such as file size, file date, checksum, .... + +The script pdfatfi.pl is provided for use with old versions of +pdfTeX and XeTeX that do not provide access +to file metadata. + +The use of the Perl script is not mandatory. This data can be shown +by PDF viewers, but they are not a requirement of the PDF specification. + +Package attachfile2 and the Perl script communicate +via an auxiliary file with file extension .atfi. The script +is used between two LaTeX runs and updates the auxiliary file. + +.nf +latex test +pdfatfi test +latex test +dvips test +ps2pdf test.ps test.pdf +.fi + +.SH OPTIONS +Various options are supported +.IP --help +Show help text. +.IP --version +Print version number +.IP --(no)quiet +Suppress/don't suppress messages +.IP --(no)verbose +Verbose (not verbose) printing. +.IP --(no)debug +Debug infomation printed (not printed) +.SH BUGS +Please log issues on the GitHub homepage: +.br +https://github.com/ho-tex/attachfile2/issues. +.SH AUTHOR +Heiko Oberdiek (ho-tex@tug.org) +.SH SEE ALSO +See attachfile2.pdf for more details. +% +% \end{macrocode} % % \section{Installation} % @@ -3113,8 +3170,8 @@ __END__ % \subsection{Refresh file name databases} % % If your \TeX~distribution -% (\teTeX, \mikTeX, \dots) relies on file name databases, you must refresh -% these. For example, \teTeX\ users run \verb|texhash| or +% (\TeX\,Live, \mikTeX, \dots) relies on file name databases, you must refresh +% these. For example, \TeX\,Live\ users run \verb|texhash| or % \verb|mktexlsr|. % % \subsection{Script installation} @@ -3288,6 +3345,10 @@ __END__ % \item % use \CTANpkg{iftex} not \CTANpkg{ifpdf}, \CTANpkg{ifxetex}, \CTANpkg{ifluatex}. % \end{Version} +% \begin{Version}{2019/11/26 v2.11} +% \item +% Add man file for \verb|pdfatfi|. +% \end{Version} % \end{History} % % \PrintIndex -- cgit v1.2.3