From 383dbd6f3840cd8096d08072dbc9d973d2710d4b Mon Sep 17 00:00:00 2001
From: rnhmjoj <rnhmjoj@inventati.org>
Date: Wed, 27 May 2020 17:47:20 +0200
Subject: [PATCH] notes: fix some issues with the bibliography

- Use an independent CSL, so building the document doesn't need internet

- Use title case in the bibtex database and shield proper nouns with
  brackets, as required by the spec
---
 notes/docs/bibliography.bib |  84 ++++++++++----------
 notes/docs/bibliography.csl | 151 ++++++++++++++++++++++++++++++++++--
 notes/makefile              |   2 +-
 notes/sections/8.md         |   2 +-
 4 files changed, 188 insertions(+), 51 deletions(-)

diff --git a/notes/docs/bibliography.bib b/notes/docs/bibliography.bib
index 56ae8b8..67a8e9a 100644
--- a/notes/docs/bibliography.bib
+++ b/notes/docs/bibliography.bib
@@ -1,17 +1,17 @@
 @article{cock41,
-  title={The distribution of a product from several sources to numerous localities},
+  title={The Distribution of a Product from Several Sources to Numerous Localities},
   author={Hitchcock, Frank L},
   journal={Journal of mathematics and physics},
   volume={20},
   number={1-4},
-  pages={224--230},
+  pages={224 -- 230},
   year={1941},
   publisher={Wiley Online Library}
 }
 
 @article{ramdas17,
-  title={On wasserstein two-sample testing and related families of nonparametric
-         tests},
+  title={On {Wasserstein} Two-sample Testing and Related Families of Nonparametric
+         Tests},
   author={Ramdas, Aaditya and Trillos, Nicolas Garcia and Cuturi, Marco},
   journal={Entropy},
   volume={19},
@@ -22,35 +22,28 @@
 }
 
 @article{marsaglia03,
-  title={Evaluating Kolmogorov’s distribution},
+  title={Evaluating {Kolmogorov}’s distribution},
   author={Marsaglia, George and Tsang, Wai Wan and Wang, Jingbo and others},
   journal={Journal of Statistical Software},
   volume={8},
   number={18},
-  pages={1--4},
+  pages={1 -- 4},
   year={2003}
 }
 
 @article{robertson74,
-  title={An iterative procedure for estimating the mode},
+  title={An Iterative Procedure for Estimating the Mode},
   author={Robertson, Tim and Cryer, Jonathan D},
   journal={Journal of the American Statistical Association},
   volume={69},
   number={348},
-  pages={1012--1016},
+  pages={1012 -- 1016},
   year={1974},
   publisher={Taylor \& Francis Group}
 }
 
-@misc{GSL,
-  title={GNU Scientific Library Reference Manual (3rd Edition)},
-  author={M. Galassi et al},
-  ISBN={0954612078},
-  url={http://www.gnu.org/software/gsl/}
-}
-
 @book{silverman86,
-  title={Density estimation for statistics and data analysis},
+  title={Density Estimation for Statistics and Data Analysis},
   author={Silverman, Bernard W},
   volume={26},
   year={1986},
@@ -58,7 +51,7 @@
 }
 
 @book{davis59,
-  title={Leonhard Euler's Integral: A Historical Profile of the Gamma Function},
+  title={{Leonhard Euler}'s Integral: A Historical Profile of the Gamma Function},
   author={Davis, P. J.},
   year={1959},
   journal={American Mathematical Monthly},
@@ -67,7 +60,7 @@
 }
 
 @book{bak91,
-  title={Complex analysis},
+  title={Complex Analysis},
   author={Bak, Joseph and Newman, Donald J and Newman, Donald J},
   year={1991},
   publisher={Springer},
@@ -91,8 +84,8 @@
 }
 
 @misc{painless94,
-  title={An introduction to the conjugate gradient method without the
-         agonizing pain},
+  title={An Introduction to the Conjugate Gradient Method Without the
+         Agonizing Pain},
   author={Shewchuk, Jonathan Richard and others},
   year={1994},
   pages={42},
@@ -100,8 +93,8 @@
 }
 
 @article{Lou05,
-  title={A brief description of the levenberg-marquardt algorithm
-         implemened by levmar},
+  title={A Brief Description of the {Levenberg-Marquardt} Algorithm
+         Implemened by levmar},
   author={M. I. A. Lourakis},
   year={2005},
   journal={Matrix}
@@ -113,27 +106,27 @@
   author={Sayah, Toni},
   journal={Mathematics and Computers in Simulation},
   volume={157},
-  pages={143--158},
+  pages={143 -- 158},
   year={2019},
   publisher={Elsevier}
 }
 
 @article{ridder17,
-  title={Variance reduction},
+  title={Variance Reduction},
   author={Ridder, AAN and Botev, ZI},
   journal={Wiley StatsRef: Statistics Reference Online},
-  pages={1--6},
+  pages={1 -- 6},
   year={2017},
   publisher={Wiley}
 }
 
 @article{lepage78,
-  title={A new algorithm for adaptive multidimensional integration},
+  title={A New Algorithm for Adaptive Multidimensional Integration},
   author={Lepage, G Peter},
   journal={Journal of Computational Physics},
   volume={27},
   number={2},
-  pages={192--203},
+  pages={192 -- 203},
   year={1978},
   publisher={Elsevier}
 }
@@ -146,8 +139,8 @@
 }
 
 @article{lucy74,
-  title={An iterative technique for the rectification of observed
-         distributions},
+  title={An Iterative Technique for the Rectification of Observed
+         Distributions},
   author={Lucy, Leon B.},
   journal={The astronomical journal},
   volume={79},
@@ -164,15 +157,15 @@
 }
 
 @techreport{novikoff63,
-  title={On convergence proofs for perceptrons},
+  title={On Convergence Proofs for Perceptrons},
   author={Novikoff, Albert B},
   year={1963},
   institution={Stanford Researhc INST Menlo Park CA}
 }
 
 @incollection{brent00,
-  title={Some new algorithms for high-precision computation of Euler’s
-         constant},
+  title={Some New Algorithms for High-precision Computation of
+         {Euler}’s constant},
   author={Brent, Richard P and McMillan, Edwin M},
   booktitle={Pi: A Source Book},
   pages={448--455},
@@ -181,39 +174,48 @@
 }
 
 @article{corless96,
-  title={On the Lambert W function},
+  title={On the {Lambert} {W} function},
   author={Corless, Robert M and Gonnet, Gaston H and Hare, David EG and Jeffrey,
           David J and Knuth, Donald E},
   journal={Advances in Computational mathematics},
   volume={5},
   number={1},
-  pages={329--359},
+  pages={329 -- 359},
   year={1996},
   publisher={Springer}
 }
 
 @article{demailly17,
+  title={Precise Error Estimate of the {Brent-McMillan} algorithm for the
+  computation of {Euler}'s constant},
   author={Jean-Pierre Demailly},
-  title={Precise error estimate of the Brent-McMillan algorithm for the
-  computation of Euler's constant},
   year={2017}
 }
 
 @manual{mpmath13,
-  key={mpmath},
+  title={mpmath: a {P}ython library for arbitrary-precision floating-point
+         arithmetic (version 0.18)},
   author={Fredrik Johansson and others},
-  title={mpmath: a {P}ython library for arbitrary-precision floating-point arithmetic (version 0.18)},
+  key={mpmath},
   note={{\tt http://mpmath.org/}},
   month={December},
   year={2013},
 }
 
 @manual{gmp20,
-  key={gmp},
-  author={Torbjörn Granlund and the GMP development team},
-  title={GNU MP: The GNU Multiple Precision Arithmetic Library,
+  title={{GNU MP}: The {GNU} Multiple Precision Arithmetic Library,
          Edition 6.2.0 (version 0.18)},
+  author={Torbjörn Granlund and the GMP development team},
+  key={gmp},
   note={{\tt https://gmplib.org/}},
   month={January},
   year={2020},
 }
+
+@manual{gsl19,
+  title={{GNU} Scientific Library Reference Manual (3rd Edition)},
+  author={M. Galassi et al},
+  ISBN={0954612078},
+  url={http://www.gnu.org/software/gsl/},
+  year={2019}
+}
diff --git a/notes/docs/bibliography.csl b/notes/docs/bibliography.csl
index 86c3511..7c002ef 100644
--- a/notes/docs/bibliography.csl
+++ b/notes/docs/bibliography.csl
@@ -1,14 +1,149 @@
 <?xml version="1.0" encoding="utf-8"?>
-<style xmlns="http://purl.org/net/xbiblio/csl" version="1.0" default-locale="en-US">
-  <!-- Elsevier, generated from "elsevier" metadata at https://github.com/citation-style-language/journals -->
+<style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="sort-only" default-locale="en-US">
   <info>
-    <title>Chinese Journal of Physics</title>
-    <id>http://www.zotero.org/styles/chinese-journal-of-physics</id>
-    <link href="http://www.zotero.org/styles/chinese-journal-of-physics" rel="self"/>
-    <link href="http://www.zotero.org/styles/elsevier-with-titles" rel="independent-parent"/>
+    <title>Elsevier (numeric, with titles)</title>
+    <id>http://www.zotero.org/styles/elsevier-with-titles</id>
+    <link href="http://www.zotero.org/styles/elsevier-with-titles" rel="self"/>
+    <link href="http://www.zotero.org/styles/elsevier-without-titles" rel="template"/>
+    <link href="http://www.elsevier.com/journals/journal-of-hazardous-materials/0304-3894/guide-for-authors#68001" rel="documentation"/>
+    <author>
+      <name>Richard Karnesky</name>
+      <email>karnesky+zotero@gmail.com</email>
+      <uri>http://arc.nucapt.northwestern.edu/Richard_Karnesky</uri>
+    </author>
+    <contributor>
+      <name>Rintze Zelle</name>
+      <uri>http://twitter.com/rintzezelle</uri>
+    </contributor>
     <category citation-format="numeric"/>
-    <issn>0577-9073</issn>
-    <updated>2016-07-25T11:35:23+00:00</updated>
+    <category field="generic-base"/>
+    <summary>A style for many of Elsevier's journals that includes article titles in the reference list</summary>
+    <updated>2019-10-15T15:14:08+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>
+  <macro name="author">
+    <names variable="author">
+      <name initialize-with="." delimiter=", " delimiter-precedes-last="always"/>
+      <label form="short" prefix=", "/>
+      <substitute>
+        <names variable="editor"/>
+        <names variable="translator"/>
+      </substitute>
+    </names>
+  </macro>
+  <macro name="editor">
+    <names variable="editor">
+      <name initialize-with="." delimiter=", " delimiter-precedes-last="always"/>
+      <label form="short" prefix=" (" text-case="capitalize-first" suffix=")"/>
+    </names>
+  </macro>
+  <macro name="year-date">
+    <choose>
+      <if variable="issued">
+        <date variable="issued">
+          <date-part name="year"/>
+        </date>
+      </if>
+      <else>
+        <text term="no date" form="short"/>
+      </else>
+    </choose>
+  </macro>
+  <macro name="publisher">
+    <text variable="publisher" suffix=", "/>
+    <text variable="publisher-place" suffix=", "/>
+    <text macro="year-date"/>
+  </macro>
+  <macro name="edition">
+    <!--TODO: CSL should have low numeric be text (e.g. '3'->'third')-->
+    <choose>
+      <if is-numeric="edition">
+        <group delimiter=" ">
+          <number variable="edition" form="ordinal"/>
+          <text term="edition" form="short"/>
+        </group>
+      </if>
+      <else>
+        <text variable="edition"/>
+      </else>
+    </choose>
+  </macro>
+  <macro name="access">
+    <choose>
+      <if variable="URL">
+        <text variable="URL"/>
+        <group prefix=" (" suffix=")" delimiter=" ">
+          <text term="accessed"/>
+          <date variable="accessed" form="text"/>
+        </group>
+      </if>
+    </choose>
+  </macro>
+  <citation collapse="citation-number">
+    <sort>
+      <key variable="citation-number"/>
+    </sort>
+    <layout prefix="[" suffix="]" delimiter=",">
+      <text variable="citation-number"/>
+    </layout>
+  </citation>
+  <bibliography entry-spacing="0" second-field-align="flush">
+    <layout suffix=".">
+      <text variable="citation-number" prefix="[" suffix="]"/>
+      <text macro="author" suffix=", "/>
+      <choose>
+        <if type="bill book graphic legal_case legislation motion_picture report song" match="any">
+          <group delimiter=", ">
+            <text variable="title"/>
+            <text macro="edition"/>
+            <text macro="publisher"/>
+          </group>
+        </if>
+        <else-if type="chapter paper-conference" match="any">
+          <text variable="title" suffix=", "/>
+          <text term="in" suffix=": "/>
+          <text macro="editor" suffix=", "/>
+          <text variable="container-title" form="short" text-case="sentence" suffix=", "/>
+          <text macro="edition" suffix=", "/>
+          <text macro="publisher"/>
+          <group delimiter=" ">
+            <label variable="page" form="short" prefix=": "/>
+            <text variable="page"/>
+          </group>
+        </else-if>
+        <else-if type="patent">
+          <group delimiter=", ">
+            <text variable="title"/>
+            <text variable="number"/>
+            <text macro="year-date"/>
+          </group>
+        </else-if>
+        <else-if type="thesis">
+          <group delimiter=", ">
+            <text variable="title"/>
+            <text variable="genre"/>
+            <text variable="publisher"/>
+            <text macro="year-date"/>
+          </group>
+        </else-if>
+        <else>
+          <group delimiter=" ">
+            <text variable="title" suffix=","/>
+            <text variable="container-title" form="short" text-case="sentence" suffix="."/>
+            <text variable="volume"/>
+            <text macro="year-date" prefix="(" suffix=")"/>
+            <text variable="page" form="short"/>
+          </group>
+        </else>
+      </choose>
+      <choose>
+        <if variable="DOI">
+          <text variable="DOI" prefix=". https://doi.org/"/>
+        </if>
+        <else>
+          <text macro="access" prefix=". "/>
+        </else>
+      </choose>
+    </layout>
+  </bibliography>
 </style>
diff --git a/notes/makefile b/notes/makefile
index 04a475e..c076dbc 100644
--- a/notes/makefile
+++ b/notes/makefile
@@ -14,5 +14,5 @@ all: exercises.pdf
 clean:
 	rm exercises.pdf
 
-exercises.pdf: $(sections) images
+exercises.pdf: $(sections) images docs
 	$(call pandoc, $(sections), exercises)
diff --git a/notes/sections/8.md b/notes/sections/8.md
index c6ab410..d4521b0 100644
--- a/notes/sections/8.md
+++ b/notes/sections/8.md
@@ -1,4 +1,4 @@
 # Bibliography
 
 The usage and a brief description of the theory underneath all the GLS functions
-employed in this report were found in [@GSL].
+employed in this report were found in [@gsl19].