summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/bibcop/bibcop.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-12-19 03:03:02 +0000
committerNorbert Preining <norbert@preining.info>2022-12-19 03:03:02 +0000
commit8e3f2f40eaf97ca4b3f8023f4c58bdcd98f63e63 (patch)
treef79a719497b17b1d06c687e98364dc0e8695342a /macros/latex/contrib/bibcop/bibcop.dtx
parent81dce26929e98696f622283b42f25c643dcfe565 (diff)
CTAN sync 202212190303
Diffstat (limited to 'macros/latex/contrib/bibcop/bibcop.dtx')
-rw-r--r--macros/latex/contrib/bibcop/bibcop.dtx17
1 files changed, 16 insertions, 1 deletions
diff --git a/macros/latex/contrib/bibcop/bibcop.dtx b/macros/latex/contrib/bibcop/bibcop.dtx
index de48e128ef..ce2e070d3e 100644
--- a/macros/latex/contrib/bibcop/bibcop.dtx
+++ b/macros/latex/contrib/bibcop/bibcop.dtx
@@ -50,7 +50,7 @@
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\ProvidesPackage{bibcop}
%<*package>
-[2022-12-15 0.0.4 Style Checker of Bibliography Files]
+[2022-12-18 0.0.5 Style Checker of Bibliography Files]
%</package>
%<*driver>
\documentclass{ltxdoc}
@@ -108,6 +108,11 @@
% Some warnings may be printed in the \TeX{} log.
% Once the issues in the |main.bib| file are fixed, the warnings disappear.
+% Bibcop doesn't pay much attention the formatting of the |.bib| file. It doesn't emit
+% warnings if a comma is missed after the last tag in a \BibTeX{} entry or the tags
+% and their equation symbols are not aligned. Instead, Bibcop is focused on the content
+% of the tags and their possible inconsistencies.
+
% If the |.sty| file is used directly (without installing it into the \TeX{} tree),
% the |bibcop.pl| file must also be placed next to it --- it is the Perl script that does all the work
% of checking your |.bib| files. The |.sty| is just a simple wrapper around it.
@@ -205,6 +210,16 @@ author = {Knuth, Donald E. and others}
%</verb>
%\fi
% When first names are shortened to a single letter, it has to have a tailing dot.
+% A specially pronounced author may be wrapped it in curled brackets, to make Bibcop ignore it:
+%\iffalse
+%<*verb>
+%\fi
+\begin{verbatim}
+author = {{Some author} and {I}}
+\end{verbatim}
+%\iffalse
+%</verb>
+%\fi
% \DescribeMacro{shorts}
% It is not allowed to shorten any words aside from the |author| tag, for example this is illegal: