summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/oscola
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-03-25 20:53:44 +0000
committerKarl Berry <karl@freefriends.org>2017-03-25 20:53:44 +0000
commitbb97cf106fffc0bda79b5e7f336a4ff4839a16ce (patch)
tree2ad411b63990921df66dd4033cb7f2f779a5ba82 /Master/texmf-dist/doc/latex/oscola
parenta79dbfe42116cdc40c6e2ff7cf46b97075a04585 (diff)
oscola (25mar17)
git-svn-id: svn://tug.org/texlive/trunk@43599 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/oscola')
-rw-r--r--Master/texmf-dist/doc/latex/oscola/README74
-rw-r--r--Master/texmf-dist/doc/latex/oscola/README.md69
-rw-r--r--Master/texmf-dist/doc/latex/oscola/oscola-examples.bib3
-rw-r--r--Master/texmf-dist/doc/latex/oscola/oscola.pdfbin875993 -> 603655 bytes
-rw-r--r--Master/texmf-dist/doc/latex/oscola/oscola.tex136
5 files changed, 155 insertions, 127 deletions
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
--- a/Master/texmf-dist/doc/latex/oscola/oscola.pdf
+++ b/Master/texmf-dist/doc/latex/oscola/oscola.pdf
Binary files 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 <oscola>
+% Biber <oscola>
+% LaTeX <oscola> , LaTeX <oscola>
+% splitindex <oscola> -- -s oscola.ist
+% makeindex oscola-general
+% LaTeX <oscola>, LaTeX <oscola>
%
%
-
\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},