summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-03-08 03:00:59 +0000
committerNorbert Preining <norbert@preining.info>2021-03-08 03:00:59 +0000
commitd9784b9287b55be1161c5d383c2a7ebde45671ee (patch)
treebf57d07f605b6c53c124ce1f918014bb8dae108f /macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx
parent6c0a4c9f40ab21e9b7d888d6a13b76b9af2f6c5b (diff)
CTAN sync 202103080300
Diffstat (limited to 'macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx')
-rw-r--r--macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx64
1 files changed, 32 insertions, 32 deletions
diff --git a/macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx b/macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx
index c1a2a25591..4a65e09fd6 100644
--- a/macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx
+++ b/macros/latex/contrib/pdfmanagement-testphase/l3pdffile.dtx
@@ -53,7 +53,7 @@
% }^^A
% }
%
-% \date{Version 0.95a, released 2021-02-22}
+% \date{Version 0.95b, released 2021-03-07}
%
% \maketitle
% \begin{documentation}
@@ -70,7 +70,7 @@
% Case 1 (Links) are created with the \cs{pdfannot} commands.
% This module handles the two other cases. Actually from the view
% of the PDF format they are quite similar: Case 2 is case 3 without the stream
-% object and without the /EF entry in the /FileSpec dictionary (this points to the
+% object and without the /EF entry in the /Filespec dictionary (this points to the
% stream object of the file). Not embedding the file makes the PDF smaller. But it is
% also less portable: the files can only be found if they are in the right location
% relative to the PDF. The normal case is to embed the file.
@@ -78,7 +78,7 @@
% The tasks to embed and reference such a file are
% \begin{enumerate}
% \item Embed the file in a stream.
-% \item Create a FileSpec dictionary which references the stream object in the /EF
+% \item Create a Filespec dictionary which references the stream object in the /EF
% dictionary:
% \begin{verbatim}
% <<
@@ -94,7 +94,7 @@
% and name it \texttt{blub.tex}. The second name is then what the user will see
% in the attachment list or in the properties of an annotation.
%
-%\item Reference the FileSpec dictionary so that the user can access the file.
+%\item Reference the Filespec dictionary so that the user can access the file.
% This can be done in various way:
% \begin{enumerate}
% \item With an annotation (/Subtype/FileAttachment). This is done by
@@ -104,7 +104,7 @@
% \medskip
% \begin{tabular}{lll}
% key & value type & notes\\\hline
-% /FS & object reference &(FileSpec dictionary)\\
+% /FS & object reference &(Filespec dictionary)\\
% /Name & name & /Graph, /PushPin, /Paperclip, /Tag\\
% /Contents & text string & optional but recommended\\
% /F & integer & Flags\\
@@ -137,7 +137,7 @@
% /AF /NamedAF BDC
% /Properties <</NamedAF [12 0 R]
% \end{verbatim}
-% The related |/FileSpec| dictionary should contain an
+% The related |/Filespec| dictionary should contain an
% |/AFRelationship| key in this case (but it doesn't harm to add it by
% default anyway). The values of this key is describe in table~\ref{tab:AFrel}.
%
@@ -183,7 +183,7 @@
% \cs{pdf_object_new:nn}/\cs{pdf_object_write:nn} or primitive commands
% to create objects.
% The object number should be stored for the reference
-% in the |/FileSpec| dictionary.
+% in the |/Filespec| dictionary.
%
% \begin{verbatim}
% \pdf_object_unnamed_write:nx {fstream}
@@ -215,12 +215,12 @@
% see the pdf reference.
% \end{itemize}
%
-% \subsubsection{Task 2: Creating the \texttt{/FileSpec} dictionary}
-% The |/FileSpec| dictionary is a simple dictionary object, and can also
+% \subsubsection{Task 2: Creating the \texttt{/Filespec} dictionary}
+% The |/Filespec| dictionary is a simple dictionary object, and can also
% be created in various ways. If it refers to an embedded file it should
% reference it in the |/EF| key.
%
-% \subsubsection{Task 3: Referencing the \texttt{/FileSpec} dictionary}
+% \subsubsection{Task 3: Referencing the \texttt{/Filespec} dictionary}
%
% Using the dictionary reference in annotations and |/AF| keys is unproblematic.
%
@@ -233,9 +233,9 @@
% |\pdfmanagement_add:nnx{Catalog/Names}{EmbeddedFiles}{|\meta{objref}|}|
%
% \subsection{Commands and tools of these module}
-% \begin{function}{file, file/Params, file/streamParams,file/FileSpec}
+% \begin{function}{file, file/Params, file/streamParams,file/Filespec}
% The module predefines and uses a number of local dictionaries for the
-% components of the stream and the |/FileSpec| object. These dictionaries are
+% components of the stream and the |/Filespec| object. These dictionaries are
% then used by the \cs{pdffile_embed_XX}.
% The content of these dictionaries can be changed by users with the commands
% from the \pkg{l3pdfdict} module, but it should be done only locally
@@ -252,8 +252,8 @@
% l\_pdffile/Params& ModDate & |(\file_timestamp:n {\l_pdffile_source_name_str})|\\
% l\_pdffile/Params& CheckSum & |(\file_mdfive_hash:n{\l_pdffile_source_name_str})|\\
% l\_pdffile/streamParams& & a /ModDate entry with year/month/date (used with \cs{pdffile_embed_stream:nnn})\\
-% l\_pdffile/FileSpec & Type & /FileSpec\\
-% l\_pdffile/FileSpec & AFRelationship &Unspecified
+% l\_pdffile/Filespec & Type & /Filespec\\
+% l\_pdffile/Filespec & AFRelationship &Unspecified
% \end{tabular}
% \end{table}
% \begin{function}{\pdffile_embed_file:nnn}
@@ -261,12 +261,12 @@
% \cs{pdffile_embed_file:nnn} \Arg{source filename} \Arg{target filename} \Arg{object name }
% \end{syntax}
% This commands embeds the file \meta{source filename} in the PDF,
-% and creates a |/FileSpec| dictionary object named \meta{object name}.
+% and creates a |/Filespec| dictionary object named \meta{object name}.
% The object name must be unique.
% The command uses the content of the local
-% dictionaries |l_pdffile|, |l_pdffile/Params| and |l_pdffile/FileSpec|
+% dictionaries |l_pdffile|, |l_pdffile/Params| and |l_pdffile/Filespec|
% to setup the dictionary entries of the stream object and the
-% |/FileSpec| dictionary. The |/F| and |/UF| entry are filled
+% |/Filespec| dictionary. The |/F| and |/UF| entry are filled
% with \meta{target filename}.
%
% It is an error if both \meta{target filename} and \meta{source filename}
@@ -274,7 +274,7 @@
%
% If \meta{target filename} is empty \meta{source filename} is used instead.
%
-% If \meta{source filename} is empty, only a |/FileSpec| dictionary is
+% If \meta{source filename} is empty, only a |/Filespec| dictionary is
% created.
%
% If the |l_pdffile| dictionary doesn't contain a
@@ -303,11 +303,11 @@
% \cs{pdffile_embed_stream:nnn} \Arg{content} \Arg{target filename} \Arg{object name }
% \end{syntax}
% This commands embeds the \meta{content} in the PDF in a stream objects and
-% creates a |/FileSpec| dictionary object named \meta{object name}.
+% creates a |/Filespec| dictionary object named \meta{object name}.
% \meta{content} is wrapped in a \cs{exp_not:n}.
% The object name must be unique. The command uses the content of the local
-% dictionaries |l_pdffile|, |l_pdffile/streamParams| and |l_pdffile/FileSpec|
-% to setup the dictionary entries of the stream object and the /FileSpec dictionary.
+% dictionaries |l_pdffile|, |l_pdffile/streamParams| and |l_pdffile/Filespec|
+% to setup the dictionary entries of the stream object and the /Filespec dictionary.
% The /F and /UF entry are filled with \meta{target filename}.
% If \meta{target filename} is empty the fix name \texttt{stream.txt}
% is used instead.
@@ -353,12 +353,12 @@
% \begin{verbatim}
% \group_begin:
% %set the relationship:
-% \pdfdict_put:nnn {l_pdffile/FileSpec} {AFRelationship}{/Source}
+% \pdfdict_put:nnn {l_pdffile/Filespec} {AFRelationship}{/Source}
% %set the description key. The text must first be converted:
% \pdf_string_from_unicode:nnN {utf16/string}
% {this~is~an~odd~description~with~öäü}
% \l_tmpa_str
-% \pdfdict_put:nnx {l_pdffile/FileSpec} {Desc}{\l_tmpa_str}
+% \pdfdict_put:nnx {l_pdffile/Filespec} {Desc}{\l_tmpa_str}
% %embeds testinput.txt and calls it grüße.txt
% \pdffile_embed_file:nnn {testinput.txt}{grüße.txt}{file:example1}
% %reference it in the panel
@@ -376,7 +376,7 @@
%
% \begin{macrocode}
%<*header>
-\ProvidesExplPackage {l3pdffile} {2021-02-22} {0.95a}
+\ProvidesExplPackage {l3pdffile} {2021-03-07} {0.95b}
{embedding and referencing files in PDF---LaTeX PDF management testphase bundle}
\RequirePackage{l3pdftools} %temporarly!!
%</header>
@@ -402,7 +402,7 @@
\msg_new:nnn { pdffile } { target-name-missing }
{
- a~target~name~for~the~/FileSpec~dictionary~is~missing.
+ a~target~name~for~the~/Filespec~dictionary~is~missing.
}
\msg_new:nnn { pdffile } { object-exists }
@@ -492,10 +492,10 @@
\int_use:N\c_sys_day_int
)
}
-\pdfdict_new:n { l_pdffile/FileSpec }
-\pdfdict_put:nnn { l_pdffile/FileSpec }
- {Type} { /FileSpec }
-\pdfdict_put:nnn { l_pdffile/FileSpec }
+\pdfdict_new:n { l_pdffile/Filespec }
+\pdfdict_put:nnn { l_pdffile/Filespec }
+ {Type} { /Filespec }
+\pdfdict_put:nnn { l_pdffile/Filespec }
{AFRelationship} { /Unspecified }
% \end{macrocode}
@@ -621,11 +621,11 @@
\pdf_object_new:nn { #1 } {dict}
\group_begin:
\@@_filename_convert_to_print:nN { #2 } \l_@@_tmpa_str
- \pdfdict_put:nnx {l_pdffile/FileSpec}{F} { \l_@@_tmpa_str }
- \pdfdict_put:nnx {l_pdffile/FileSpec}{UF}{ \l_@@_tmpa_str }
+ \pdfdict_put:nnx {l_pdffile/Filespec}{F} { \l_@@_tmpa_str }
+ \pdfdict_put:nnx {l_pdffile/Filespec}{UF}{ \l_@@_tmpa_str }
\pdf_object_write:nx { #1 }
{
- \pdfdict_use:n { l_pdffile/FileSpec}
+ \pdfdict_use:n { l_pdffile/Filespec}
\tl_if_empty:nF { #3 }
{
/EF <</F~#3 /UF~#3>>