Merge branch 'fix-natorf' of github.com:oetiker/lshort 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: |
@@ -58,7 +58,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
 
@@ -72,7 +72,7 @@ jobs:
           apk add py3-pygments
 
       - name: Checkout the repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: recursive
 

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}
+