diff options
author | Norbert Preining <norbert@preining.info> | 2023-03-09 03:03:31 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2023-03-09 03:03:31 +0000 |
commit | 716c428e47ad2e893c0f970b9fa866d2a88f00e4 (patch) | |
tree | d9b683b0eefb5503c3ec99d4be99d0cfefd4daf2 /macros/latex/contrib/biblatex-ms/doc/biblatex-ms.tex | |
parent | a0867c71356c67c442bdebc0de39b7996f847bf7 (diff) |
CTAN sync 202303090303
Diffstat (limited to 'macros/latex/contrib/biblatex-ms/doc/biblatex-ms.tex')
-rw-r--r-- | macros/latex/contrib/biblatex-ms/doc/biblatex-ms.tex | 30 |
1 files changed, 17 insertions, 13 deletions
diff --git a/macros/latex/contrib/biblatex-ms/doc/biblatex-ms.tex b/macros/latex/contrib/biblatex-ms/doc/biblatex-ms.tex index 586aea9add..c3ff6b9e2d 100644 --- a/macros/latex/contrib/biblatex-ms/doc/biblatex-ms.tex +++ b/macros/latex/contrib/biblatex-ms/doc/biblatex-ms.tex @@ -425,6 +425,7 @@ compatibility matrix for the recent versions. \sffamily\bfseries\spotcolor Biber version & \sffamily\bfseries\spotcolor \biblatex\ version\\ \midrule +2.19 & 3.19\\ 2.18 & 3.18\\ 2.17 & 3.17\\ 2.16 & 3.16\\ @@ -2697,7 +2698,7 @@ The option is intended mainly for backwards compatibility, because earlier versi \boolitem[true]{dashed} -This option controls whether recurrent the same author\slash editor list in the bibliography are replaced by a dash (\cmd{bibnamdeash}, see \secref{use:fmt:fmt}). If the option is enabled, subsequent mentions of the same name list at the beginning of an entry are replaced by a dash provided the entry is not the first on the current page. If the option is disabled, name lists are never replaced by a dash. +This option controls whether recurrent the same author\slash editor list in the bibliography are replaced by a dash (\cmd{bibnamedash}, see \secref{use:fmt:fmt}). If the option is enabled, subsequent mentions of the same name list at the beginning of an entry are replaced by a dash provided the entry is not the first on the current page. If the option is disabled, name lists are never replaced by a dash. \end{optionlist} @@ -4397,7 +4398,7 @@ The \opt{refcontext} environment cannot be nested and \biblatex will generate an \cmditem{newrefcontext}[key=value, \dots]{name} -This command is similar to the \env{refcontext} environment except that it is a stand"=alone command rather than an environment. It automatically ends any previous reference context section begun with \cmd{newrefcontext} (if any) and immediately starts a new one. Note that the context section started by the last \cmd{newrefcontext} command in the document will extend to the very end of the document. Use \cmd{endrefcontext} if you want to terminate it earlier. +This command is similar to the \env{refcontext} environment except that it is a stand"=alone command rather than an environment. It automatically ends any previous reference context section begun with \cmd{newrefcontext} (if any) and immediately starts a new one. Note that the context section started by the last \cmd{newrefcontext} command in the document will extend to the end of the current refsection. Use \cmd{endrefcontext} if you want to terminate it earlier. \cmditem{localrefcontext}[key=value, \dots]{name} @@ -8612,6 +8613,11 @@ limiting source maps to specific refsections only (see \opt{refsection} option to the \cmd{map} command above). \begin{itemize} +\item If \texttt{final} is \texttt{true} for a step then no more steps + after this one are run within the current map for the current entry if + the conditions for the step so far are not satisfied. Examples are given in + the descriptions for specific steps as to what this means for their + particular semantics. \item If \texttt{entrynew} is set, a new entry is created with the entry key \texttt{entrynewkey} and the entry type given in the option \texttt{entrynewtype}. This entry is only in-scope during the processing of the current entry and can be referenced by \texttt{entrytarget}. In \texttt{entrynewkey}, you may use standard Perl regular expression @@ -8664,15 +8670,7 @@ option to the \cmd{map} command above). \texttt{match} regular expression (logic is reversed if you use \texttt{notmatch} and case-insensitive if you use the versions ending in <i>)\footnote{Regular expressions are full Perl 5.16 regular expressions. This means you may need to deal with special characters, see examples.}. You may use capture parenthesis as usual and refer to these (\$1\ldots\$9) in later \texttt{fieldvalue} specifications. This allows you to pull out parts of some fields and put these parts in other fields. \item Perform a regular expression match and replace on the value of the \texttt{fieldsource} \prm{entryfield} if \texttt{match} and \texttt{replace} are defined. \item If \texttt{matches} is defined, it should be a comma-separated list of literal strings which are replaced by corresponding locations in a comma-separated list provided in \texttt{replace}. The lists must have the same number of elements or the step will be skipped. \texttt{matchesi} is the same but case-insensitive. -\item If \texttt{fieldset} is defined, then its value is \prm{entryfield} - which will be set to a value specified by further options. If - \texttt{overwrite} is false for this step and the field to set already - exists then the map step is ignored. If \texttt{final} is also true for - this step, then processing of the parent map stops at this point. If - \texttt{append} is true, then the value to set is appended to the current - value of \prm{entryfield}. \texttt{appendstrict} only appends to - \prm{entryfield} if \prm{entryfield} is not empty. The value to set is - specified by a mandatory one and only one of the following options: +\item If \texttt{fieldset} is defined, then its value is \prm{entryfield} which will be set to a value specified by further options. If \texttt{overwrite} is false for this step and the field to set already exists then the map step is ignored. If \texttt{final} is also true when \texttt{overwrite} is false for this step, then processing of the parent map stops at this point. If \texttt{append} is true, then the value to set is appended to the current value of \prm{entryfield}. \texttt{appendstrict} only appends to \prm{entryfield} if \prm{entryfield} is not empty. The value to set is specified by a mandatory one and only one of the following options: \begin{itemize} \item\ \texttt{fieldvalue} --- The \texttt{fieldset} \prm{entryfield} is set to the \texttt{fieldvalue} \prm{string} \item\ \texttt{null} --- The \texttt{fieldset} \prm{entryfield} is ignored, as if it did not exist in the datasource @@ -10774,11 +10772,11 @@ Restores a \prm{literal list} (optionally a multiscript list of \prm{msform}/\pr Restores a \prm{name list} (optionally a multiscript name of \prm{msform}/\prm{mslang}) from a \prm{macro} defined with \cmd{savename} before. The list is restored within a local scope. -\cmditem[msform][mslang]{clearfield}{field} +\cmditem{clearfield}[msform][mslang]{field} Clears the \prm{field} (optionally a multiscript field of \prm{msform}/\prm{mslang} of which both or neither optional arguments must be provided) within a local scope. A field cleared this way is treated as undefined by subsequent data commands. When no optional \prm{msform}/\prm{mslang} arguments are provided, clears all alternates of a multiscript field. -\cmditem[msform][mslang]{clearlist}{literal list} +\cmditem{clearlist}[msform][mslang]{literal list} Clears the \prm{literal list} (optionally a multiscript list of \prm{msform}/\prm{mslang} of which both or neither optional arguments must be provided) within a local scope. A list cleared this way is treated as undefined by subsequent data commands. When no optional \prm{msform}/\prm{mslang} arguments are provided, clears all alternates of a multiscript list. Clearing only one alternate of a multiscript list does not clear the associated counters for the list. @@ -13724,6 +13722,10 @@ As \cmd{currentmslangs} but for entryfield \prm{entryfield}. It is intended for Appends the \prm{code} to an internal hook executed at the beginning of every reference section. The \prm{code} is executed just after setting the reference section number. This command may only be used in the preamble. +\cmditem{AtNextRefsection}{code} + +Appends the \prm{code} to an internal hook executed at the beginning of the next reference section. The \prm{code} is executed just after setting the reference section number. + \cmditem{AtBeginBibliography}{code} Appends the \prm{code} to an internal hook executed at the beginning of the bibliography. The \prm{code} is executed at the beginning of the list of references, immediately after the \prm{begin code} of \cmd{defbibenvironment}. This command may only be used in the preamble. @@ -15491,6 +15493,8 @@ This revision history is a list of changes relevant to users of this package. Ch \item Multiscript support\see{use:multiscript} \end{release} \begin{release}{3.19}{2022} +\begin{release}{3.19}{2023-03-05} +\item Added \cmd{AtNextRefsection}\see{aut:fmt:hok} \item Added \cmd{DeclareExtradateContext} option\see{aut:ctm:fld} \item Modified warning for using bibtex backend \item Enhanced \bibfield{extradate} tracking to fallback on \bibfield{labeltitle} when there is no author |