standardize doc arguments; fix a few typos

l3pdfannot.dtx

@@ -411,7 +411,7 @@
 % \begin{function}[added = 2021-03-02]
 %   { \pdfannot_widget_box:nnn }
 %   \begin{syntax}
-%     \cs{pdfannot_widget_box:nnn}  \Arg{width} \Arg{height} \Arg{depth}
+%     \cs{pdfannot_widget_box:nnn} \Arg{width} \Arg{height} \Arg{depth}
 %   \end{syntax}
 %   This creates an \texttt{/Type/Annot} object with the given dimensions.
 %   The annotation doesn't occupy space.

l3pdfdict.dtx

@@ -93,8 +93,8 @@
 % \begin{function}[added = 2020-06-16,updated = 2020-12-03]
 %   {\pdfdict_set_eq:nn,\pdfdict_gset_eq:nn}
 %   \begin{syntax}
-%     \cs{pdfdict_set_eq:nn}  \Arg{local dictionary name_1} \Arg{dictionary name_2}\\
-%     \cs{pdfdict_gset_eq:nn} \Arg{global dictionary name_1}\Arg{dictionary name_2}
+%     \cs{pdfdict_set_eq:nn}  \Arg{local dictionary name_1}  \Arg{dictionary name_2}\\
+%     \cs{pdfdict_gset_eq:nn} \Arg{global dictionary name_1} \Arg{dictionary name_2}
 %   \end{syntax}
 % This functions copy \meta{dictionary name_2} into
 % \meta{local/global dictionary name_1} locally or globally. If the
@@ -103,7 +103,10 @@
 % \end{function}
 %
 % \begin{function}[added = 2020-04-06]
-%   {\pdfdict_put:nnn, \pdfdict_gput:nnn,\pdfdict_gput:nee}
+%   {
+%     \pdfdict_put:nnn,\pdfdict_put:nne,\pdfdict_put:nee,
+%     \pdfdict_gput:nnn,\pdfdict_gput:nne,\pdfdict_gput:nee
+%   }
 %   \begin{syntax}
 %     \cs{pdfdict_put:nnn}  \Arg{local dictionary}  \Arg{name} \Arg{value} \\
 %     \cs{pdfdict_gput:nnn} \Arg{global dictionary} \Arg{name} \Arg{value}
@@ -174,13 +177,13 @@
 % \begin{function}[added = 2020-07-06]
 %   {\pdfdict_get:nnN }
 %   \begin{syntax}
-%     \cs{pdfdict_get:nnN} \Arg{dictionary}  \Arg{name} \meta{tl var}
+%     \cs{pdfdict_get:nnN} \Arg{dictionary} \Arg{name} \meta{tl var}
 %   \end{syntax}
 %   Recovers the \meta{value} stored by \cs{pdfdict_put:nnn} or
 %   \cs{pdfdict_gput:nnn}
 %   for \meta{name} and places this in the \meta{token list
 %   variable}. If \meta{name} is not found
-%   then the \meta{token list variable} is set
+%   then the \meta{tl var} is set
 %   to the special marker \cs{q_no_value}. \meta{name} is first converted
 %   with \cs{str_convert_pdfname:n}.  The \meta{token list
 %   variable} is set within the current \TeX{} group.

l3pdffield-action.dtx

@@ -235,15 +235,15 @@
 % \subsection{Commands}
 % \begin{function}{\pdffield_reset_new:nn}
 % \begin{syntax}
-% \cs{pdffield_reset_new:nn}\Arg{name}\Arg{key val list}
+% \cs{pdffield_reset_new:nn} \Arg{name} \Arg{key val list}
 % \end{syntax}
 % This defines an new reset action with the name \meta{name}.
 % The keys are described below.
 % \end{function}
 %
 % \begin{function}{\pdffield_submit_new:nnn}
 % \begin{syntax}
-% \cs{pdffield_submit_new:nn}\Arg{name}\Arg{key val list}\Arg{URL}
+% \cs{pdffield_submit_new:nn} \Arg{name} \Arg{key val list} \Arg{URL}
 % \end{syntax}
 % This defines an submit action with the name \meta{name}.
 % The keys are described below. \meta{URL} should be given verbatim.

l3pdffield-checkbox.dtx

@@ -95,7 +95,7 @@
 % \subsection{Commands}
 % \begin{function}{\pdffield_checkbox:n}
 % \begin{syntax}
-%  \cs{pdffield_checkbox:n}\Arg{key val list}
+%  \cs{pdffield_checkbox:n} \Arg{key val list}
 % \end{syntax}
 % This creates a checkbox to check and uncheck. The list of allowed keys is described below.
 % The \meta{key val list} should at least set the name, without it the default name
@@ -131,7 +131,7 @@
 %
 % \begin{function}{preset-checkbox}
 %  \begin{syntax}
-%   |preset-checkbox| = \Arg{key-val-list}
+%   |preset-checkbox| = \Arg{key val list}
 %  \end{syntax}
 % This allows to set default keys for a checkbox.
 % \end{function}

l3pdffield-choice.dtx

@@ -113,7 +113,7 @@
 % \subsection{Commands}
 % \begin{function}{\pdffield_choice:n}
 % \begin{syntax}
-%  \cs{pdffield_choice:n}\Arg{key val list}
+%  \cs{pdffield_choice:n} \Arg{key val list}
 % \end{syntax}
 % This creates a choice field.
 % The list of allowed keys is described below.
@@ -149,7 +149,7 @@
 %
 % \begin{function}{preset-choice}
 %  \begin{syntax}
-%   |preset-choice| = \Arg{key-val-list}
+%   |preset-choice| = \Arg{key val list}
 %  \end{syntax}
 % This allows to set default keys for a choice field.
 % \end{function}

l3pdffield-pushbutton.dtx

@@ -104,7 +104,7 @@
 % \subsection{Commands}
 % \begin{function}{\pdffield_pushbutton:n}
 % \begin{syntax}
-%  \cs{pdffield_pushbutton:n}\Arg{key val list}
+%  \cs{pdffield_pushbutton:n} \Arg{key val list}
 % \end{syntax}
 % This creates a pushbutton. Unlike radio buttons and checkboxes pushbuttons
 % don't change their state and they don't store or represent a value.
@@ -178,7 +178,7 @@
 %
 % \begin{function}{preset-pushbutton}
 %  \begin{syntax}
-%   |preset-pushbutton| = \Arg{key-val-list}
+%   |preset-pushbutton| = \Arg{key val list}
 %  \end{syntax}
 % This allows to set default keys for a pushbutton.
 % \end{function}

l3pdffield-radiobutton.dtx

@@ -293,7 +293,7 @@
 % \subsection{Commands}
 % \begin{function}{\pdffield_radio:n}
 % \begin{syntax}
-%  \cs{pdffield_radio:n}\Arg{key val list}
+%  \cs{pdffield_radio:n} \Arg{key val list}
 % \end{syntax}
 % This creates a radio button to check and uncheck.
 % The list of allowed keys is described below.
@@ -335,7 +335,7 @@
 %
 % \begin{function}{preset-radiobutton}
 %  \begin{syntax}
-%   |preset-radiobutton| = \Arg{key-val-list}
+%   |preset-radiobutton| = \Arg{key val list}
 %  \end{syntax}
 % This allows to set default keys for a radio button.
 % \end{function}

l3pdffield-textfield.dtx

@@ -164,7 +164,7 @@
 % \subsection{Commands}
 % \begin{function}{\pdffield_textfield:n}
 % \begin{syntax}
-%  \cs{pdffield_textfield:n}\Arg{key val list}
+%  \cs{pdffield_textfield:n} \Arg{key val list}
 % \end{syntax}
 % This creates a textfield. The list of allowed keys is described below.
 % The \meta{key val list} should at least set the name, without it the default name
@@ -205,7 +205,7 @@
 %
 % \begin{function}{preset-textfield}
 %  \begin{syntax}
-%   |preset-textfield| = \Arg{key-val-list}
+%   |preset-textfield| = \Arg{key val list}
 %  \end{syntax}
 % This allows to set default keys for a textfield.
 % \end{function}

l3pdffield.dtx

@@ -261,9 +261,9 @@
 %
 %
 % \section{Commands}
-% \begin{function}{\pdffield_field:nn,\pdffield_field:Vn}
+% \begin{function}{\pdffield_field:nn}
 % \begin{syntax}
-%  \cs{pdffield_field:nn}\Arg{key val list}\Arg{field ID}
+%  \cs{pdffield_field:nn} \Arg{key val list} \Arg{field ID}
 % \end{syntax}
 % This creates a new field. \meta{field ID} will be used to create and
 % reference the needed objects but it is not the direct object name, so
@@ -294,9 +294,9 @@
 %
 % \end{function}
 %
-% \begin{function}{\pdffield_annot:n,\pdffield_annot:V}
+% \begin{function}{\pdffield_annot:n}
 % \begin{syntax}
-%  \cs{pdffield_annot:n}\Arg{key val list}
+%  \cs{pdffield_annot:n} \Arg{key val list}
 % \end{syntax}
 % This creates a new field annotation.
 % It is a widget annotation box created with \cs{pdfannot_widget_box:nnn}, and
@@ -317,7 +317,7 @@
 
 % \begin{function}{\pdffield_appearance:nn}
 % \begin{syntax}
-%  \cs{pdffield_appearance:nn}\Arg{name}\Arg{content}
+%  \cs{pdffield_appearance:nn} \Arg{name} \Arg{content}
 % \end{syntax}
 % This is a small wrapper around \cs{pdfxform_new:nnn} (which could be used too)
 % to create an appearance. To avoid name clashes \meta{name} should start with
@@ -326,18 +326,18 @@
 %
 % \begin{function}{\pdffield_setup:n}
 % \begin{syntax}
-%  \cs{pdffield_setup:n}\Arg{key-val}
+%  \cs{pdffield_setup:n} \Arg{key val list}
 % \end{syntax}
 % This command allows to preset some field settings.
 % \end{function}
 % It knows currently two keys:
 %
 % \begin{function}{create-style}
 % \begin{syntax}
-%  |create-style| = \Arg{name}\Arg{key-val}
+%  |create-style| = \Arg{name}\Arg{key val list}
 % \end{syntax}
 % This defines a style which can then be used with the |style| key.
-% \Arg{key-val} can be an arbitrary collection of the keys of the module.
+% \Arg{key val list} can be an arbitrary collection of the keys of the module.
 % \end{function}
 %
 % \begin{function}{style}
@@ -349,21 +349,21 @@
 %
 % \begin{function}{preset-checkbox}
 % \begin{syntax}
-% |preset-checkbox|=\Arg{key-val}
+% |preset-checkbox| = \Arg{key val list}
 % \end{syntax}
 % This allows to set default keys for a checkbox.
 % \end{function}
 %
 % \begin{function}{preset-radio}
 % \begin{syntax}
-% |preset-radio|=\Arg{key-val}
+% |preset-radio| = \Arg{key val list}
 % \end{syntax}
 % This allows to set default keys for a radio button.
 % \end{function}
 %
 % \begin{function}{preset-textfield}
 % \begin{syntax}
-% |preset-textfield|=\Arg{key-val}
+% |preset-textfield| = \Arg{key val list}
 % \end{syntax}
 % This allows to set default keys for a text field.
 % \end{function}
@@ -372,8 +372,8 @@
 %
 % \begin{function}{value,default}
 % \begin{syntax}
-% |value|  =\Arg{value}\\
-% |default|=\Arg{value}
+% |value| = \Arg{value}\\
+% |default| = \Arg{value}
 % \end{syntax}
 % These two keys pass the value to a handler which can be redefined.
 % Their exact behaviour depends on field type. Please check their documentation.

l3pdffile.dtx

@@ -264,7 +264,7 @@
 % \end{table}
 % \begin{function}{\pdffile_embed_file:nnn}
 %   \begin{syntax}
-%     \cs{pdffile_embed_file:nnn} \Arg{source filename} \Arg{target filename} \Arg{object name }
+%     \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}.
@@ -308,7 +308,7 @@
 % \begin{function}{\pdffile_embed_stream:nnn,\pdffile_embed_stream:nnN}
 %   \begin{syntax}
 %     \cs{pdffile_embed_stream:nnn} \Arg{content} \Arg{target filename} \Arg{object name}\\
-%     \cs{pdffile_embed_stream:nnN} \Arg{content} \Arg{target filename} \Arg{tl var}
+%     \cs{pdffile_embed_stream:nnN} \Arg{content} \Arg{target filename} \meta{tl var}
 %   \end{syntax}
 %   This commands embeds the \meta{content} in the PDF in a stream objects and
 %   creates either a |/Filespec| dictionary object named \meta{object name}, or stores
@@ -334,7 +334,7 @@
 %
 % \begin{function}{\pdffile_filespec:nnn,\pdffile_filespec:nne}
 %   \begin{syntax}
-%     \cs{ pdffile_filespec:nnn }\Arg{object name}\Arg{file name}{stream object reference}
+%     \cs{ pdffile_filespec:nnn }\Arg{object name} \Arg{file name} \Arg{stream object reference}
 %   \end{syntax}
 %  The previous commands are fine if stream and filespec dictionary can be created together.
 %  But there are cases where the |filespec| dictionary should be referenced when the
@@ -377,11 +377,11 @@
 % as |.pdf| increase the first integer.
 %
 % |\pdffile_filespec:nnn| does \emph{not} increase the integers,
-% if this command is used it lies in the responsability of the
+% if this command is used it lies in the responsibility of the
 % author to adjust the integers.
 %
-% The integers are public so that user
-% can query and adjust the values, e.g. in tests for a standard compliancy.
+% The integers are public so that users
+% can query and adjust the values, e.g. in tests for standard compliance.
 % \end{variable}
 %
 % \begin{variable}{\l_pdffile_source_name_str}
@@ -526,11 +526,11 @@
 % as |.pdf| increase the first integer.
 %
 % |\pdffile_filespec:nnn| does \emph{not} increase the integers,
-% if this command is used it lies in the responsability of the
+% if this command is used it lies in the responsibility of the
 % author to adjust the integers.
 %
-% The integers are public so that user
-% can query and adjust the values, e.g. in tests for a standard compliancy.
+% The integers are public so that users
+% can query and adjust the values, e.g. in tests for standard compliance.
 %    \begin{macrocode}
 \int_new:N\g_pdffile_embed_pdfa_int
 \int_new:N\g_pdffile_embed_nonpdfa_int

l3pdfmanagement.dtx

@@ -180,7 +180,7 @@
 % \begin{function}[added = 2020-04-08]
 %   {\pdfmanagement_show:n }
 %   \begin{syntax}
-%     \cs{pdfmanagement_show:n}  \Arg{resource path}
+%     \cs{pdfmanagement_show:n} \Arg{resource path}
 %   \end{syntax}
 %   This shows the content of the dictionary targeted by
 %   \Arg{resource path} in the log and on the terminal if possible.