From bb97cf106fffc0bda79b5e7f336a4ff4839a16ce Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 25 Mar 2017 20:53:44 +0000 Subject: oscola (25mar17) git-svn-id: svn://tug.org/texlive/trunk@43599 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/oscola/README | 74 ----------- Master/texmf-dist/doc/latex/oscola/README.md | 69 +++++++++++ .../doc/latex/oscola/oscola-examples.bib | 3 +- Master/texmf-dist/doc/latex/oscola/oscola.pdf | Bin 875993 -> 603655 bytes Master/texmf-dist/doc/latex/oscola/oscola.tex | 136 +++++++++++++-------- 5 files changed, 155 insertions(+), 127 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/oscola/README create mode 100644 Master/texmf-dist/doc/latex/oscola/README.md (limited to 'Master/texmf-dist/doc/latex/oscola') diff --git a/Master/texmf-dist/doc/latex/oscola/README b/Master/texmf-dist/doc/latex/oscola/README deleted file mode 100644 index d6dcee72003..00000000000 --- a/Master/texmf-dist/doc/latex/oscola/README +++ /dev/null @@ -1,74 +0,0 @@ -SUMMARY -======= - -The Oscola package works (only!) with Biblatex (v 2.0 or later) and -Biber (v 1.0 or later). It aims to implement, almost completely, the -OSCOLA style of legal citation, according to the 4th edition. For -further information about coverage see the documentation. - -FILES AND LICENCE -================= - -The package consists of three principal files (oscola.bbx, oscola.cbx -and english-oscola.lbx) which should be placed, documentation -(oscola.pdf), and a very short index style file -(oscola.ist). Those files are copyright (c) Paul Stanley 2012-13. - -This work may be distributed and/or modified under the -conditions of the LaTeX Project Public License, either version 1.3 -of this license or (at your option) any later version. - -The latest version of the license is in - http://www.latex-project.org/lppl.txt -and version 1.3 or later is part of all distributions of LaTeX -version 2005/12/01 or later. - -This work has the LPPL maintenance status 'maintained'. The current -maintainer of this work is Paul Stanley (pstanley@essexcourt.net) - -The documentation consists of oscola.pdf and -oscola-examples.bib. Those files are distributed under the Creative -Commons Attribution 3.0-Unported License (CC BY 3.0). A copy of that -license is available at - http://creativecommons.org/licenses/by/3.0/deed.en_GB - -The LaTeX source of oscola.pdf is available upon request -from the author, or from https://github.com/PaulStanley/oscola-biblatex. -It is also licensed under CC BY 3.0. - -All bug reports, questions, or suggestions should be sent to the -maintainer, whose email is pstanley@essexcourt.net. - -INSTALLATION -============ - -I find the TDS difficult, but I think the correct installation (under -the local tree) is as follows: - -oscola.bbx: With the bibliography style files in - ...tex/latex/biblatex/bbx -oscola.cbx: With the citation style files in - .../tex/latex/biblatex/cbx -english-oscola.lbx: With the language definition files in - .../tex/latex/biblatex/lbx -oscola.pdf: With documentation in a suitable directory - under .../doc/latex -oscola.ist: With the index style files in - .../makeindex/latex -oscola-examples.bib: With the sample bibliography files in a suitable - directory under .../bibtex/bib - -VERSION HISTORY -=============== - -August 2012 Version 1 Original release - -May 2013 Version 1.2 Various bugfixes, and implementation - of citation scheme for UN documents - -October 2013 Version 1.3 Corrected spacing bug - -May 2014 Version 1.4 Various bugs have been fixed, an additional - index has been installed, and there have - been minor improvements to the documentation - diff --git a/Master/texmf-dist/doc/latex/oscola/README.md b/Master/texmf-dist/doc/latex/oscola/README.md new file mode 100644 index 00000000000..28d053c6a28 --- /dev/null +++ b/Master/texmf-dist/doc/latex/oscola/README.md @@ -0,0 +1,69 @@ +# Summary + +The Oscola package works (only!) with Biblatex (v 2.0 or later) and +Biber (v 1.0 or later). It aims to implement, almost completely, the +OSCOLA style of legal citation, according to the +[4th edition](https://www.law.ox.ac.uk/sites/files/oxlaw/oscola_4th_edn_hart_2012.pdf). For +further information about coverage see the documentation. + +# Files and licence + +## The package + +The package consists of four principal files (`oscola.bbx`, `oscola.cbx`, +`english-oscola.lbx`, and `british-oscola.lbx`) and a very short index +style file, `oscola.ist`. Those files are copyright (c) Paul Stanley +2012-17. + +This work may be distributed and/or modified under the conditions of +the LaTeX Project Public License, either version 1.3 of this license +or (at your option) any later version. + +The latest version of the license is in [available online](http://www.latex-project.org/lppl.txt) +and version 1.3 or later is part of all distributions of LaTeX version 2005/12/01 or later. + +This work has the LPPL maintenance status 'maintained'. The current +maintainer of this work is Paul Stanley (pstanley@essexcourt.net). + +## The documentation + +The documentation consists of `oscola.tex`, `oscola.pdf` and +`oscola-examples.bib`. Those files are distributed under the Creative +Commons Attribution 3.0-Unported License (CC BY 3.0). A copy of that +license is available [online](http://creativecommons.org/licenses/by/3.0/deed.en_GB). + +## Bug reports + +All bug reports, questions, or suggestions should be sent to the +maintainer, whose email is pstanley@essexcourt.net. + +# Installation + +I find the TDS difficult. TeXlive, whose maintainers apparently don't, +currently installs as follows: + +* `oscola.bbx`: in the package directory `...tex/latex/oscola` +* `oscola.cbx`: in the package directory `.../tex/latex/oscola` +* `english-oscola.lbx`: in the package directory `.../tex/latex/oscola` +* `british-oscola.lbx`: in the package directory `.../tex/latex/oscola` +* `oscola.pdf` and `oscola.tex`: with documentation under `.../doc/latex/oscola` +* `oscola.ist`: with the index style files in `.../makeindex/oscola` + +# Version history + +August 2012 Version 1 Original release + +May 2013 Version 1.2 Various bugfixes, and implementation + of citation scheme for UN documents + +October 2013 Version 1.3 Corrected spacing bug + +May 2014 Version 1.4 Various bugs have been fixed, an additional + index has been installed, and there have + been minor improvements to the documentation + +March 2017 Version 1.5 The package has been updated to take + account of changes in Biblatex; various bugs + have been fixed; experimental support has + been added for the use of ECLI numbers + in EU cases. diff --git a/Master/texmf-dist/doc/latex/oscola/oscola-examples.bib b/Master/texmf-dist/doc/latex/oscola/oscola-examples.bib index d58df0e9523..f25b19625a4 100644 --- a/Master/texmf-dist/doc/latex/oscola/oscola-examples.bib +++ b/Master/texmf-dist/doc/latex/oscola/oscola-examples.bib @@ -245,7 +245,7 @@ location = {London}, } @jurisdiction{adbhu, - keywords = {eu}, + keywords = {eu}, title = {Procureur de la R\'epublique v ADBHU}, shorttitle = {ADBHU}, number = {240/83}, @@ -253,6 +253,7 @@ date = {1985}, reporter = {ECR}, pages = {531}, + ecli = {EU:C:1985:59}, } @jurisdiction{C430/93, diff --git a/Master/texmf-dist/doc/latex/oscola/oscola.pdf b/Master/texmf-dist/doc/latex/oscola/oscola.pdf index 8bb16f11d8b..f2853a1f716 100644 Binary files a/Master/texmf-dist/doc/latex/oscola/oscola.pdf and b/Master/texmf-dist/doc/latex/oscola/oscola.pdf differ diff --git a/Master/texmf-dist/doc/latex/oscola/oscola.tex b/Master/texmf-dist/doc/latex/oscola/oscola.tex index d31c2a4abcd..280268b86a4 100644 --- a/Master/texmf-dist/doc/latex/oscola/oscola.tex +++ b/Master/texmf-dist/doc/latex/oscola/oscola.tex @@ -1,14 +1,17 @@ -% This file documents the biblatex-oscola package. It is (c) Paul Stanley 2014 +% This file documents the biblatex-oscola package. It is (c) Paul Stanley 2014-2017 % and licensed under the Creative Commons Attribution 3.0-Unported License (CC BY 3.0). A copy of that % license is available at % http://creativecommons.org/licenses/by/3.0/deed.en_GB % -% The documentation makes use of fonts that are commercially available, but may -% be modified so that it does not do so. -% To compile: run LaTeX, Biber, LaTeX, LaTeX, splitindex -- -s oscola.ist, makeindex oscola-documentation-general, LaTeX, LaTeX +% To compile: run +% LaTeX +% Biber +% LaTeX , LaTeX +% splitindex -- -s oscola.ist +% makeindex oscola-general +% LaTeX , LaTeX % % - \documentclass[a4paper, 11pt, DIV=1, @@ -16,8 +19,8 @@ {scrartcl} % SET VERSION NUMBER AND RELEASE DATE -\def\releasedate{22 May 2014} -\def\versionnumber{1.4} +\def\releasedate{1 April 2017} +\def\versionnumber{1.5} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \usepackage{geometry} @@ -36,6 +39,7 @@ \usepackage[style=oscola, indexing=cite, backend=biber, + ecli=yes, babel=hyphen]{biblatex} \usepackage[splitindex, @@ -63,18 +67,14 @@ \renewcommand{\linespread}{1.2} -% HYPER REF - -\usepackage{hyperref} - - % Various commands and environments specific to this document \newcommand{\oscola}{\textsc{bl-oscola}} \newcommand{\biblatex}{\textsc{biblatex}} \newcommand{\oscolashort}{\textsc{oscola}\nocite{oscola}} \newcounter{egcounter}\setcounter{egcounter}{0} - +% TYPOGRAPHY +\usepackage{scrpage2} \usepackage[dvipsnames]{xcolor} % This code from Juanjo's answer at http://www.latex-community.org @@ -101,6 +101,11 @@ \newcommand{\egcite}[1]{{\texttt{\textbackslash cite#1}}} \newcommand\angledtext[1]{$\langle$\textit{#1}\/$\rangle$} +% HYPER REF + +\usepackage[final=true,colorlinks=true]{hyperref} + + % BIBLIOGRAPHIC RESOURCES \addbibresource{oscola-examples.bib} @@ -109,9 +114,8 @@ \hyphenation{nieu-wen-huis} \hyphenation{sti-cht-ing} -% TYPOGRAPHY -\usepackage{scrpage2} +% Some basic typographical settings \deffootnote{1em}{1em}{\thefootnotemark\ } \setcounter{secnumdepth}{-1} \frenchspacing @@ -192,6 +196,8 @@ \tableofcontents +\clearpage + \section{Scope} \index[general]{scope of package|(}The \oscola\ style for \biblatex\ @@ -225,7 +231,7 @@ to grapple with all the complexities, and might not be sufficient for a work with \emph{extensive} citation of public international law materials. -\textsc{Bl-oscola}\index[general]{scope of package!historical cases} +This style\index[general]{scope of package!historical cases} does not include citation forms for Yearbook or historical cases\footcite[20--21]{oscola} (other than the \enquote{plain vanilla} of the nominate reports and the English Reports). Nor does the package @@ -249,13 +255,13 @@ To summarise:\index[general]{scope of package} the US, Australia, Canada and New Zealand, but not for citing legislation or `official' materials. \item The \oscola\ style provides basic facilities for citing public - international law treaties and case law, and at least many UN documents, but does not cover - everything that the 3rd edition of \oscola\ specifies in relation to - such materials. + international law treaties and case law, and at least many UN + documents, but does not cover everything that the 3rd edition of + \oscola\ specifies in relation to such materials. \end{itemize} -I hope that the coverage is sufficient for most UK legal work; I believe -that only specialists in public international law or legal history are -likely to find it significantly deficient. +I hope that the coverage is sufficient for most UK legal work; I +believe that only specialists in public international law or legal +history are likely to find it significantly deficient. \subsection{Language} @@ -278,9 +284,11 @@ together with the current \biblatex\ maintainers Audrey Boruvka and Joseph Wright -- without whom this would be impossible. Many members of the community at \TeX-StackExchange\footnote{\url{tex.stackexchange.com}} have helped -too. I've borrowed from more people than I can remember. Daniel -H\"ogger identified various important bugs, and suggested -improvements, particularly in relation to international law materials. Thanks to everyone. +too, at first by answering my questions, and later by asking (and and +sometimes answering) their own. I've borrowed from more people than I +can remember. Daniel H\"ogger identified various important bugs, and +suggested improvements, particularly in relation to international law +materials. Thanks to everyone. \subsection{An apology} @@ -378,12 +386,9 @@ automatic tables of cases and legislation, you will also need: \index[general]{english-oscola.ist@\texttt{english-oscola.ist}} I would suggest installation in your (local) \TeX\ directory as follows: \begin{description} -\item[oscola.bbx] With the bibliography style files in \texttt{.../\allowbreak tex/\allowbreak latex/\linebreak biblatex/\allowbreak bbx}. -\item[oscola.cbx] With the citation style files in \texttt{.../tex/latex/\linebreak biblatex/cbx}. -\item[english-oscola.lbx] With the language definition files in \texttt{.../tex/latex/\linebreak biblatex/lbx}. -\item[oscola.pdf] With documentation in a suitable directory under\linebreak \texttt{.../doc/latex}. -\item[oscola.ist] With the index style files in \verb|.../makeindex/latex|. -\item[oscola-examples.bib] With the sample bibliography files in a suitable directory under \verb|.../bibtex/bib|. +\item The operational files (that is \verb|oscola.bbx|, \verb|oscola.cbx|, \verb|english-oscola.lbx| and \verb|british-oscola.lbx| go with \LaTeX\ macros under \verb|.../tex/latex/oscola|. +\item The index style file \verb|oscola.idx| goes with other such files under \verb|.../makeindex/oscola|. +\item The documentation files (\verb|oscola.tex| and \verb|oscola.pdf| go under \verb|.../doc/latex/oscola|. \end{description} \section{Basic Use} @@ -460,6 +465,16 @@ of `ibid' in successive citations. To my eye that looks odd. The option \texttt{caseshorthands=italic} will see to it that shorthand names for cases, like their short titles, will be printed in italic type. +\item[ecli]\index[general]{ECLI numbers} + \index[general]{options!ecli@\texttt{ecli}} This option controls + whether the EU's recently introduced ECLI numbers get + printed. Options are: \verb|yes| (the default), which means they are + printed when available in addition to the official report, + \verb|no|, in which case they are never printed, or \verb|only|, in + which case only ECLI numbers are used, with no printed report, in + the current style of the CJEU itself (not yet officially accepted by + the standard). Note that if the case is otherwise unreported, ECLI + numbers will always be used if available. \item[ibidstyle]\index[general]{customization!ibid} \index[general]{ibid!capitalization} \index[general]{options!ibidstyle@\texttt{ibidstyle}} @@ -846,6 +861,7 @@ any other kind of work, \oscola\ tries to write a suitable piece of information in an external file which will, with the help of another \index[general]{Imakeidx!recommended} \index[general]{Splitindex!recommended} +\index[general]{memoir!incompatibility} package (\textsc{imakeidx} is the one I recommend) and an external program or programs (I recommend \textsc{splitindex})\footnote{Why \textsc{imakeidx} and \textsc{splitindex}? I like \textsc{splitindex} @@ -853,7 +869,9 @@ because otherwise you are likely to be bitten by the fact that \LaTeX\ can only write a number of auxiliary files. I like \textsc{imakeidx} because it provides a convenient method of using \textsc{splitindex}. You cannot, in fact, use \textsc{splitindex} -directly with \oscola.} produce the necessary tables. +directly with \oscola.} produce the necessary tables. If you are using the +\textsc{memoir} class, you \emph{must} load \textsc{imakeidx}, to avoid some +fundamental problems. The complication is in the word `tries'. The difficulty is that it's not obvious how many indexes you want. \textsc{Oscola} leaves you @@ -1074,7 +1092,10 @@ two ways of doing this: \item If you are using \textsc{splitindex}, run it with the option \verb|-m|, and then process each of the resulting sub-indices that you want formatted with leaders with the option \verb|-s oscola|. -\item Alternatively, run \textsc{splitindex} with the option \verb|-- -s oscola|, which will run \textsc{makeindex} on each file with the requisite style. +\item Alternatively, run \textsc{splitindex} with the option \verb|-- -s oscola|, which will run \textsc{makeindex} on each file with the requisite style. In that case your \verb|.tex| source base name comes first, so that the overall command is +\begin{verbatim} +splitindex [BASENAME] -- -s oscola +\end{verbatim} \end{itemize} The only real annoyance is when you have multiple indexes and want @@ -1898,7 +1919,9 @@ fields described in relation to English cases, but \index[general]{bibfile@\texttt{.bib} file!number field@\texttt{number field}} \index[general]{cases!European Union!case number@\texttt{case number}} Enter the case number (or numbers) in the - \texttt{number} field. Do not include `Case' or `Joined Cases' in the number field. + \texttt{number} field. Do not include `Case' or `Joined Cases' in the number field. This + is the number given to the case by the court registry -- not the ECLI number given + to the reported decision. \item[type] If your case is an ordinary one (ie, `Case' or `Joined Cases') you need enter nothing here. If you need to specify something unusual (like \texttt{Opinion}) to precede the case @@ -1910,6 +1933,10 @@ fields described in relation to English cases, but some other full report) you can include a citation to the Official Journal. Follow the advice set out in relation to Commission decisions, below. +\item[ecli]\index[general]{ECLI number} + The ECLI number for the case report. Note that whether the + number is used depends on the setting of the option \verb|ecli| to + \verb|yes| (the default), \verb|no|, or \verb|only|. \item[pagination] You can, if you like, specify \texttt{paragraph}; but if nothing is entered, paragraph will be assumed. \end{description} @@ -1948,6 +1975,7 @@ variety of simple reported cases. date = {1985}, journaltitle = {ECR}, pages = {531}, + ecli = {EU:C:1985:59}, } \end{verbatim} \end{bibexample} @@ -2943,8 +2971,8 @@ some special indexing. For instance: \begin{bibexample}[spbill4] \begin{verbatim} @misc{spbill4, - title = {SP Bill 4 Abolition of Feudal Tenure etc (Scotland) - Bill [as introduced] Session 1}, + title = {SP Bill 4 Abolition of Feudal Tenure etc + (Scotland) Bill [as introduced] Session 1}, date = {1999}, } \end{verbatim} @@ -3378,8 +3406,8 @@ will be printed, without any narrative. @legal{aaland, title = {Convention Relating to the Non-Fortification and Neutralisation of the Aaland Islands}, - parties = {{Aaaland Islands} and Germany and Denmark and Estonia - and Finland and France}, + parties = {{Aaaland Islands} and Germany and Denmark + and Estonia and Finland and France}, lista = {opened=1921-10-02 and inforce=1922-12-06}, pagination = {article}, volume = {9}, @@ -3427,11 +3455,12 @@ The `note' form can be used where it is necessary to give additional information volume = {213}, reporter = {U.N.T.S.}, pages = {221}, - note = {as amended by Protocol No 14bis to the Convention - for the Protection of Human Rights and - Fundamental Freedoms - (opened for signature 27 May 2009, entered into force - 1 September 2009) CETS No 204}, + note = {as amended by Protocol No 14bis to the + Convention for the Protection of Human Rights + and Fundamental Freedoms + (opened for signature 27 May 2009, + entered into force1 September 2009) + CETS No 204}, shorthand = {ECHR}, entrysubtype = {piltreaty}, } @@ -4542,10 +4571,11 @@ The following are the examples from page 41 of \oscola. \begin{bibexample}[com895] \begin{verbatim} @report{com895, - title = {Proposal for a Council Decision on the conclusion, - on behalf of the European Community, of a Protocol - on the Implementation of the Alpine Convention in - the Field of Transport (Transport Protocol)}, + title = {Proposal for a Council Decision on the + conclusion, on behalf of the European Community, + of a Protocol on the Implementation of the Alpine + Convention in the Field of Transport + (Transport Protocol)}, institution = {Commission}, number = {COM (2008) 895 final}, entrysubtype = {comdoc} @@ -4571,9 +4601,10 @@ The following are the examples from page 41 of \oscola. \begin{bibexample}[com348] \begin{verbatim} @report{com348, - title = {Proposal for a Council Regulation on jurisdiction - and the recognition and enforcement of judgments - in civil and commercial matters}, + title = {Proposal for a Council Regulation on + jurisdiction and the recognition and + enforcement of judgments in civil and + commercial matters}, number = {COM (99) 348 final}, institution = {Commission}, entrysubtype = {comdoc}, @@ -4769,8 +4800,9 @@ consideration, and so a few examples should suffice. \begin{verbatim} @inproceedings{reliance, author = {McFarlane, Ben and Nolan, Donal}, - title = {Remedying Reliance: The Future Development of - Promissory and Proprietary Estoppel in English Law}, + title = {Remedying Reliance: The Future Development + of Promissory and Proprietary Estoppel in + English Law}, eventtitle = {Obligations III conference}, location = {Brisbane}, eventdate = {2006-07-01}, -- cgit v1.2.3