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 --- Master/texmf-dist/doc/latex/attachfile2/README.md | 13 ++- .../doc/latex/attachfile2/attachfile2.pdf | Bin 443676 -> 445753 bytes Master/texmf-dist/doc/man/man1/pdfatfi.1 | 50 +++++++++++ Master/texmf-dist/doc/man/man1/pdfatfi.man1.pdf | Bin 0 -> 13459 bytes Master/texmf-dist/scripts/attachfile2/pdfatfi.pl | 2 +- .../source/latex/attachfile2/attachfile2.dtx | 95 +++++++++++++++++---- .../tex/latex/attachfile2/atfi-dvipdfmx.def | 8 +- .../tex/latex/attachfile2/atfi-dvips.def | 8 +- .../tex/latex/attachfile2/atfi-luatex.def | 8 +- .../tex/latex/attachfile2/atfi-pdftex.def | 8 +- .../tex/latex/attachfile2/attachfile2.sty | 8 +- 11 files changed, 159 insertions(+), 41 deletions(-) create mode 100644 Master/texmf-dist/doc/man/man1/pdfatfi.1 create mode 100644 Master/texmf-dist/doc/man/man1/pdfatfi.man1.pdf (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/attachfile2/README.md b/Master/texmf-dist/doc/latex/attachfile2/README.md index d014b5549a9..54f26511219 100644 --- a/Master/texmf-dist/doc/latex/attachfile2/README.md +++ b/Master/texmf-dist/doc/latex/attachfile2/README.md @@ -1,11 +1,18 @@ # attachfile2 -attach files to PDF documents +Attach files to PDF documents +This package can be used to attach files to a PDF document. +It is a further development of Scott Pakin's package +attachfile for pdfTeX. Apart from bug fixes, +package attachfile2 adds support for dvips, +some new options, gets and writes meta information data about +the attached files. + See the embedfile package for a newer package supporting this feature. This package comes with a Perl script pdfatfi.pl -that should be installed somewhere in PATH as `pdfatfi', see also -package documentation. +that should be installed somewhere in PATH as `pdfatfi', +see also package documentation. diff --git a/Master/texmf-dist/doc/latex/attachfile2/attachfile2.pdf b/Master/texmf-dist/doc/latex/attachfile2/attachfile2.pdf index 193c7e67932..a0a5c5052df 100644 Binary files a/Master/texmf-dist/doc/latex/attachfile2/attachfile2.pdf and b/Master/texmf-dist/doc/latex/attachfile2/attachfile2.pdf differ diff --git a/Master/texmf-dist/doc/man/man1/pdfatfi.1 b/Master/texmf-dist/doc/man/man1/pdfatfi.1 new file mode 100644 index 00000000000..dcc885aad72 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/pdfatfi.1 @@ -0,0 +1,50 @@ +.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. diff --git a/Master/texmf-dist/doc/man/man1/pdfatfi.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfatfi.man1.pdf new file mode 100644 index 00000000000..c3585e0db89 Binary files /dev/null and b/Master/texmf-dist/doc/man/man1/pdfatfi.man1.pdf differ diff --git a/Master/texmf-dist/scripts/attachfile2/pdfatfi.pl b/Master/texmf-dist/scripts/attachfile2/pdfatfi.pl index f12381a6064..3264d6cf500 100644 --- a/Master/texmf-dist/scripts/attachfile2/pdfatfi.pl +++ b/Master/texmf-dist/scripts/attachfile2/pdfatfi.pl @@ -32,7 +32,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."; # 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 diff --git a/Master/texmf-dist/tex/latex/attachfile2/atfi-dvipdfmx.def b/Master/texmf-dist/tex/latex/attachfile2/atfi-dvipdfmx.def index 61f8220bb1a..63b56d485d3 100644 --- a/Master/texmf-dist/tex/latex/attachfile2/atfi-dvipdfmx.def +++ b/Master/texmf-dist/tex/latex/attachfile2/atfi-dvipdfmx.def @@ -9,7 +9,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 @@ -34,13 +34,13 @@ %% %% 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. %% \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)]% \def\atfi@special#1{% \special{pdf:#1}% } diff --git a/Master/texmf-dist/tex/latex/attachfile2/atfi-dvips.def b/Master/texmf-dist/tex/latex/attachfile2/atfi-dvips.def index 23b3c63376a..517e75036e7 100644 --- a/Master/texmf-dist/tex/latex/attachfile2/atfi-dvips.def +++ b/Master/texmf-dist/tex/latex/attachfile2/atfi-dvips.def @@ -9,7 +9,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 @@ -34,13 +34,13 @@ %% %% 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. %% \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)]% \def\atfi@literal#1{% \special{ps:atfi_dict begin{#1}atfi_?pdfmark end}% } diff --git a/Master/texmf-dist/tex/latex/attachfile2/atfi-luatex.def b/Master/texmf-dist/tex/latex/attachfile2/atfi-luatex.def index cd0e1602d9c..b656b948635 100644 --- a/Master/texmf-dist/tex/latex/attachfile2/atfi-luatex.def +++ b/Master/texmf-dist/tex/latex/attachfile2/atfi-luatex.def @@ -9,7 +9,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 @@ -34,13 +34,13 @@ %% %% 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. %% \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 } diff --git a/Master/texmf-dist/tex/latex/attachfile2/atfi-pdftex.def b/Master/texmf-dist/tex/latex/attachfile2/atfi-pdftex.def index 8a1d88be00f..716dc5aaee8 100644 --- a/Master/texmf-dist/tex/latex/attachfile2/atfi-pdftex.def +++ b/Master/texmf-dist/tex/latex/attachfile2/atfi-pdftex.def @@ -9,7 +9,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 @@ -34,13 +34,13 @@ %% %% 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. %% \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)]% \let\atfi@literal\pdfliteral \def\atfi@GSAVE{q } \def\atfi@GRESTORE{Q } diff --git a/Master/texmf-dist/tex/latex/attachfile2/attachfile2.sty b/Master/texmf-dist/tex/latex/attachfile2/attachfile2.sty index 93502eb2f25..af91f441111 100644 --- a/Master/texmf-dist/tex/latex/attachfile2/attachfile2.sty +++ b/Master/texmf-dist/tex/latex/attachfile2/attachfile2.sty @@ -9,7 +9,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 @@ -34,13 +34,13 @@ %% %% 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. %% \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{attachfile2}% - [2019/11/24 v2.10 Attach files into PDF (HO)]% + [2019/11/26 v2.11 Attach files into PDF (HO)]% \RequirePackage{iftex}[2019/11/07] \RequirePackage{keyval} \RequirePackage{color} -- cgit v1.2.3