Prepare for release

Author: alex-ball

README.md

@@ -63,11 +63,12 @@ for CSL styles.
     followed by a comma, while a type is typically singular and followed by a
     space.
 
-  - Record a standard as a `report`, with the identifier included at the
-    beginning of the `title`.
+  - Record a standard as a `standard` or, failing that, `report`. Include the
+    identifier at the beginning of the `title`.
 
   - For unpublished materials, use the closest applicable entry type and put
-    ‘Unpublished’ under `annote`.
+    ‘Unpublished’ under `annote`. The `pamphlet` type is useful for many
+    materials of this sort.
 
   - With a `graphic`, you can specify `archive` and `archive-place`, as in the
     Bowden bicycle example.
@@ -89,10 +90,13 @@ for CSL styles.
 
   - When citing social media posts, there is no standard way of including the
     author's social media handle. As a workaround, you can include it as the
-    `dropping-particle` component, but you must supply the surrounding square
+    `dropping-particle` name part, but you must supply the surrounding square
     brackets as part of the value. This works best with personal accounts;
-    with corporate accounts you would have to use `family` instead of `literal`
-    for the real name, and you get a stray comma between the name and handle.
+    with corporate accounts you would have to use the `family` name part
+    instead of `literal`, and you get a stray comma between the name and
+    handle. Alternatively, you could include the handle as part of the
+    `literal` name part, but depending on your software you might not be able
+    to work around including it in your citations as well.
 
   - When citing works in non-English languages, use `original-title` for the
     English translation of the non-English title. This reverses the intended
@@ -104,8 +108,10 @@ for CSL styles.
     reference and as the `suffix` for later (natural order) names. Provide
     transliterated titles directly within the respective `title` field.
 
-  - Use the `legislation` type for Acts of Parliament, Statutory Instruments and
-    EU Directives. With Acts, use `chapter-number` for the chapter and, for
+  - Use the `legislation` type for primary legislation such as Acts of
+    Parliament and EU Directives. For secondary legislation such as Statutory
+    Instruments, use the `regulation` type if available, otherwise
+    `legislation`. With Acts, use `chapter-number` for the chapter and, for
     statutes before 1963, use `collection-title` for the series. With
     directives, use `container-title` for the journal (OJ), `collection-title`
     for the series, `volume` for the volume and `page` for the starting page.

biblatex/README.md

@@ -96,7 +96,7 @@ documentation.
 
 ## Licence
 
-Copyright 2016-2021 University of Bath.
+Copyright 2016-2022 University of Bath.
 
 This work consists of the documented LaTeX file biblatex-bath.dtx and a Makefile.
 

biblatex/biblatex-bath.dtx

@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %<*internal|bbx|cbx|dbx|lbx|lbx-gb>
-\def\Version{2021/02/25 v4.0}
+\def\Version{2022/03/04 v5.0}
 %</internal|bbx|cbx|dbx|lbx|lbx-gb>
 %<*internal>
 \iffalse
@@ -63,7 +63,7 @@ See:     http://www.latex-project.org/lppl.txt
 \endpreamble
 \postamble
 
-Copyright (C) 2016-2021 by University of Bath
+Copyright (C) 2016-2022 by University of Bath
 \endpostamble
 
 \usedir{tex/latex/\jobname}
@@ -2372,7 +2372,7 @@ Commission case number, \texttt{number} for the formal decision number, and give
 %<readme>## Licence
 %<readme>
 %<*driver|readme>
-Copyright 2016-2021 University of Bath.
+Copyright 2016-2022 University of Bath.
 
 This work consists of the documented LaTeX file biblatex-bath.dtx and a Makefile.
 

bst/README.md

@@ -98,7 +98,7 @@ documentation.
 
 ## Licence
 
-Copyright 2016-2021 University of Bath.
+Copyright 2016-2022 University of Bath.
 
 This work consists of the documented LaTeX file bath-bst.dtx and a Makefile.
 

bst/bath-bst.dtx

@@ -39,7 +39,7 @@ See:     http://www.latex-project.org/lppl.txt
 \endpreamble
 \postamble
 
-Copyright (C) 2016-2021 by University of Bath
+Copyright (C) 2016-2022 by University of Bath
 \endpostamble
 
 \usedir{bibtex/bst/\jobname}
@@ -74,7 +74,7 @@ Copyright (C) 2016-2021 by University of Bath
 \ProvidesFile{bath-bst.dtx}
 %</driver>
 %<*driver|tex1>
-    [2021/02/25 v4.0 Harvard referencing style as recommended by the University of Bath Library]
+    [2022/03/04 v5.0 Harvard referencing style as recommended by the University of Bath Library]
 
 \documentclass[10pt,a4paper]{article}
 \usepackage[british]{babel}
@@ -642,7 +642,9 @@ structures may also change without warning.
 \item
   In the 2021 revision of the style, the titles of broadcast media (TV, radio)
   became upright, with series information for titled episodes being italic.
-%<driver>  To get this new formatting, you must use the \texttt{type} field as shown.
+%<*driver> 
+  To get this new formatting, you must use the \texttt{type} field as shown.
+%</driver> 
 %<tex1>  If you have been using \texttt{booklet} for such entries, you should now use \texttt{misc} instead.
 \item
   Series names (except those in \texttt{legislation} and \texttt{jurisdiction}
@@ -953,7 +955,9 @@ URLs with Bib\TeX\, but you must not escape it inside a URL with
 %</driver>
 \item
 Internally, \texttt{inreference} is an alias for \texttt{incollection}.
-%<driver>Use \texttt{inreference} if you need compatibility with \textsf{biblatex-bath}.
+%<*driver>
+Use \texttt{inreference} if you need compatibility with \textsf{biblatex-bath}.
+%</driver>
 \item
 The style ensures the \texttt{booktitle} is used in title citation commands.
 \end{info}
@@ -1536,7 +1540,9 @@ As in the standard Bib\TeX\ styles, \texttt{conference} is a legacy (and highly
 
 \begin{info}\item
 Internally, \texttt{thesis} is an alias for \texttt{phdthesis}.
-%<driver>If you need compatibility with \textsf{biblatex-bath} and don't want to display a thesis type, use \texttt{thesis}.
+%<*driver>
+If you need compatibility with \textsf{biblatex-bath} and don't want to display a thesis type, use \texttt{thesis}.
+%</driver>
 \end{info}
 
 \subsubsection*{Report, working paper, or research briefing}
@@ -2856,21 +2862,6 @@ Use the \texttt{titleaddon} field to supply the English translation of the title
 
 \subsubsection*{Work in a non-Roman alphabet}
 
-\begin{tips}\item
-The following example tricks Bib\TeX\ into treating the original rendering of
-the author's name as the `von' part of a Roman-alphabet name. This requires the
-use of a command that simply gobbles its argument, which you have to define
-yourself:
-
-\begin{tcblisting}{listing only}
-\newcommand*{\noop}[1]{}
-\end{tcblisting}
-
-For the trick to work, the argument you give to \lstinline[style=dtxlatex]|\noop|
-must be lowercase, but otherwise it can be anything you like.
-%<driver>The trick is not portable to \textsf{biblatex-bath}.
-\end{tips}
-
 \newcommand*{\noop}[1]{}
 \begin{bibexbox}(hacked)<RX>{hua1999qys1}
   Hua, L. 華林甫, 1999. Qingdai yilai Sanxia diqu shuihan zaihai de chubu yanjiu 清代以來三峽地區水旱災害的初步硏 [A preliminary study of floods and droughts in the Three Gorges region since the Qing dynasty]. \emph{Zhongguo shehui kexue \textup{中國社會科學}}, 1, pp.168--79.
@@ -2913,6 +2904,21 @@ must be lowercase, but otherwise it can be anything you like.
 \end{bibexbox}
 
 \begin{tips}\item
+The above example tricks Bib\TeX\ into treating the original rendering of
+the author's name as the `von' part of a Roman-alphabet name. This requires the
+use of a command that simply gobbles its argument, which you have to define
+yourself:
+
+\begin{tcblisting}{listing only}
+\newcommand*{\noop}[1]{}
+\end{tcblisting}
+
+For the trick to work, the argument you give to \lstinline[style=dtxlatex]|\noop|
+must be lowercase, but otherwise it can be anything you like.
+%<*driver>
+The trick is not portable to \textsf{biblatex-bath}.
+%</driver>
+\item
 If the name is due to appear initial first (e.g.~after `In:'), you can append
 the non-Roman characters to the author's surname; to do this, use inverted name
 order as you would for English double-barrelled names without hyphens, e.g.\@
@@ -3533,7 +3539,7 @@ Commission case number, \texttt{number} for the formal decision number, and give
 %<readme>## Licence
 %<readme>
 %<*driver|readme>
-Copyright 2016-2021 University of Bath.
+Copyright 2016-2022 University of Bath.
 
 This work consists of the documented LaTeX file bath-bst.dtx and a Makefile.
 

csl/bath-csl-test.yaml

@@ -507,7 +507,7 @@ references:
   number: no. 8
 
 - id: bs5605:1990
-  type: report
+  type: standard
   title: '<span class="nocase">BS 5605:1990 Recommendations</span> for citing and referencing published material'
   publisher: BSI
   publisher-place: London
@@ -517,7 +517,7 @@ references:
   - year: '1990'
 
 - id: astm.d1655
-  type: report
+  type: standard
   author:
   - literal: ASTM
   issued:
@@ -548,7 +548,7 @@ references:
   annote: Unpublished
 
 - id: hadley2015bir
-  type: report
+  type: pamphlet
   author:
   - family: Hadley
     given: S.
@@ -1049,7 +1049,7 @@ references:
   number: '66'
 
 - id: gb.hmr2012
-  type: legislation
+  type: regulation
   issued:
   - year: '2012'
   accessed:

csl/harvard-university-of-bath.csl

@@ -11,14 +11,14 @@
       <name>Alex Ball</name>
       <email>ab318@bath.ac.uk</email>
     </author>
-    <author>
+    <contributor>
       <name>Rob Fuller</name>
       <email>rob.fuller1@gmail.com</email>
-    </author>
+    </contributor>
     <category citation-format="author-date"/>
     <category field="generic-base"/>
     <summary>Adaptation of Harvard referencing style used at the University of Bath.</summary>
-    <updated>2021-10-05T08:20:00+00:00</updated>
+    <updated>2022-03-04T14:00:00+00:00</updated>
     <rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
   </info>
   <locale xml:lang="en">
@@ -142,10 +142,10 @@
   <macro name="title">
     <group delimiter=" ">
       <choose>
-        <if type="bill book dataset entry graphic legal_case map motion_picture musical_score patent report software song speech webpage thesis" match="any">
+        <if type="bill book dataset entry graphic legal_case map motion_picture musical_score patent report software song speech standard webpage thesis" match="any">
           <text variable="title" font-style="italic"/>
         </if>
-        <else-if type="legislation legal_case post" match="any">
+        <else-if type="legislation pamphlet post regulation" match="any">
           <choose>
             <if variable="container-title">
               <text variable="title"/>
@@ -165,8 +165,9 @@
         <text variable="version"/>
       </group>
       <choose>
-        <if type="thesis motion_picture broadcast" match="any"/>
+        <if type="broadcast motion_picture thesis" match="any"/>
         <else-if type="report" variable="number"/>
+        <else-if type="standard" variable="number"/>
         <else-if type="patent" variable="number"/>
         <else-if type="bill" variable="number"/>
         <else>
@@ -217,10 +218,10 @@
       <else>
         <group delimiter=" ">
           <choose>
-            <if type="bill dataset graphic legal_case map motion_picture musical_score patent report software song speech webpage thesis" match="any">
+            <if type="bill dataset graphic legal_case map motion_picture musical_score patent report software song speech standard webpage thesis" match="any">
               <text variable="title" font-style="italic"/>
             </if>
-            <else-if type="legislation regulation legal_case" match="any">
+            <else-if type="legislation pamphlet post regulation" match="any">
               <choose>
                 <if variable="container-title">
                   <text variable="title"/>
@@ -260,10 +261,10 @@
   </macro>
   <macro name="title-short">
     <choose>
-      <if type="bill dataset graphic map motion_picture musical_score patent report song webpage thesis" match="any">
+      <if type="bill dataset graphic legal_case map motion_picture musical_score patent report software song speech standard webpage thesis" match="any">
         <text variable="title" form="short" font-style="italic"/>
       </if>
-      <else-if type="legislation legal_case" match="any">
+      <else-if type="legislation pamphlet post regulation" match="any">
         <choose>
           <if variable="container-title">
             <text variable="title" form="short"/>
@@ -395,7 +396,7 @@
     </sort>
     <layout>
       <choose>
-        <if type="legislation">
+        <if type="legislation regulation" match="any">
           <group suffix=".">
             <group delimiter=" ">
               <text macro="author"/>
@@ -528,7 +529,7 @@
         </else>
       </choose>
       <choose>
-        <if type="legislation legal_case" match="any"/>
+        <if type="legal_case legislation regulation" match="any"/>
         <else-if type="book motion_picture musical_score song speech" match="any">
           <group prefix=" " suffix="." delimiter=" ">
             <text macro="title"/>
@@ -598,7 +599,7 @@
             </group>
           </group>
         </else-if>
-        <else-if type="bill report webpage" match="any">
+        <else-if type="bill report standard webpage" match="any">
           <group prefix=" " suffix="." delimiter=". ">
             <text macro="title"/>
             <text macro="edition"/>