summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-11-26 21:40:11 +0000
committerKarl Berry <karl@freefriends.org>2019-11-26 21:40:11 +0000
commite785fd9e6ba510f4fcded804c4614e2a24e24c55 (patch)
tree8a2dbc08795bcdb0c022a44a06bd9ea5e2e779f3 /Master/texmf-dist/source
parent0209e5442903faee5ca69343e8ad8d35a2ac4cd4 (diff)
attachfile2 (26nov19)
git-svn-id: svn://tug.org/texlive/trunk@52929 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source')
-rw-r--r--Master/texmf-dist/source/latex/attachfile2/attachfile2.dtx95
1 files changed, 78 insertions, 17 deletions
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__
%</pdfatfi>
% \end{macrocode}
%
+% \begin{macrocode}
+%<*pdfatfiman>
+.TH pdfatfi 1 "2019-11-24"
+.SH NAME
+pdfatfi \- Help program for the LaTeX package attachfile2.
+.SH SYNOPSIS
+pdfatfi <command> [<options>] <file[.atfi]>]
+.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.
+%</pdfatfiman>
+% \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