Merge branch 'master' into fix-natorf

Author: oetiker

.github/workflows/CI.yml

@@ -19,15 +19,15 @@ jobs:
       should_skip: ${{ steps.skip_check.outputs.should_skip }}
     steps:
       - id: skip_check
-        uses: fkirc/skip-duplicate-actions@v4
+        uses: fkirc/skip-duplicate-actions@v5
         with:
           cancel_others: 'true'
           paths: '["src/**", "Makefile", "fixdate.pl"]'
 
   check:
     name: Check LaTeX
     needs: skip_check
-    if: ${{ needs.skip_check.outputs.should_skip != 'true' }}
+    if: ${{ needs.skip_check.outputs.should_skip != true }}
     runs-on: ubuntu-latest
     container: ghcr.io/xu-cheng/texlive-small:latest
 
@@ -40,7 +40,7 @@ jobs:
           tlmgr install latexindent
 
       - name: Checkout the repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Run ChkTeX
         run: |
@@ -56,7 +56,7 @@ jobs:
   build_latex:
     name: Build LaTeX
     needs: skip_check
-    if: ${{ needs.skip_check.outputs.should_skip != 'true' }}
+    if: ${{ needs.skip_check.outputs.should_skip != true }}
     runs-on: ubuntu-latest
     container: ghcr.io/xu-cheng/texlive-full:latest
 
@@ -70,7 +70,7 @@ jobs:
           apk add py3-pygments
 
       - name: Checkout the repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: recursive
 

src/basics.tex

@@ -689,33 +689,33 @@ \section{Packages}\index{package} While writing your document, you will
   \caption{Examples of \LaTeX{} packages.}\label{packages}
   \begin{tabular}{@{}lp{9cm}@{}}
     \toprule
-    Package            & Description                                          \\
+    Package            & Description                                         \\
     \midrule
     \pai*{amsmath}     & Provides additional commands for typesetting
     mathematical symbols, and environments for aligning equations. Described
-    in \autoref{chap:math}.                                                   \\
+    in \autoref{chap:math}.                                                  \\
 
     \pai*{polyglossia} & Makes it easy to write \LaTeX{} documents in
     languages other than English, or even in multiple languages.
-    Described in \autoref{sec:polyglossia}.                                   \\
+    Described in \autoref{sec:polyglossia}.                                  \\
 
     \pai*{booktabs}    & Provides commands for producing beautifully
     formatted tables for your document. Described in
-    \autoref{sec:tables}.                                                     \\
+    \autoref{sec:tables}.                                                    \\
 
     \pai*{biblatex}    & Provides commands for automatically specifying and
     producing a bibliography for your document. Described in
-    \autoref{chap:bibliography}.                                              \\
+    \autoref{chap:bibliography}.                                             \\
 
     \pai*{makeidx}     & Provides commands for producing indexes. Described
-    in \autoref{sec:indexing}.                                                \\
+    in \autoref{sec:indexing}.                                               \\
 
     \pai*{fancyhdr}    & Lets you easily customise page headers and footers.
-    Described in \autoref{sec:fancy}.                                         \\
+    Described in \autoref{sec:fancy}.                                        \\
 
     \pai*{beamer}      & Provides a document class that changes output to
     produce presentations and provides command to typeset slides.
-    Described in \autoref{sec:beamer}.                                        \\
+    Described in \autoref{sec:beamer}.                                       \\
     \bottomrule
   \end{tabular}
 \end{table}

src/bibliography.tex

@@ -479,8 +479,9 @@ \subsection{Citing commands}
 \end{example}
 
 Another set of commands allows us to extract specific information from
-the bibliographic entry, and use the information directly in the text. This is includes commands such as \csi{citeauthor},
-\csi{citetitle}, \csi{citeyear}, \csi{citedate}, \csi{citeurl}.
+the bibliographic entry, and use the information directly in the text. This
+includes commands such as \csi{citeauthor}, \csi{citetitle}, \csi{citeyear},
+\csi{citedate}, \csi{citeurl}.
 
 \begin{example}[standalone,
   biber,
@@ -553,20 +554,28 @@ \subsection{Citing commands}
 
 \subsection{More about entries}
 
-\hologo{biber} uses ``and'' as a separator in author entries. To prevent
-this behaviour, enclose ``and'' in curly brackets
+\hologo{biber} uses \enquote{and} as a separator in certain entries. To prevent
+this behaviour, enclose \enquote{and} in curly brackets
 \begin{minted}{bibtex}
 @book{kru,
-  author = {Kruger {and} sons}
+  publisher = {Kruger {and} sons}
 }
 \end{minted}
 The same trick may be useful when \hologo{biber} changes capitalisation, even
-though it shouldn't.
+though it shouldn't. On top of this \hologo{biber} splits author entries into
+smaller bits which are then used elsewhere. So in \autoref{lst:bibfile} the
+name Jane Diviner is split into the first name Jane and the surname Diviner.
+When you don't want this, enclose the entire name in braces
+\begin{minted}{bibtex}
+@book{kru,
+  author = {{Kruger brothers}}
+}
+\end{minted}
 
 When writing about certain subject it often happens that the same author or
 publishing company released several books. In order to reuse the information in
-several entries in the \eei{.bib} file, a special entry \cargv{xdata} is available. It may be used
-like this
+several entries in the \eei{.bib} file, a special entry \cargv{xdata} is
+available. It may be used like this
 
 \begin{example}[standalone,
   biber,
@@ -578,8 +587,8 @@ \subsection{More about entries}
 \begin{filecontents}{example2.bib} 
 %!hideend
 @xdata{krugers,
-  author    = {Kruger {and} sons},
-  publisher = {Krugers Inc.},
+  author    = {{Kruger brothers}},
+  publisher = {Kruger {and} sons},
   location  = {Paris}
 }
 
@@ -604,3 +613,4 @@ \subsection{More about entries}
 \printbibliography
 \end{document}
 \end{example}
+