summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-10-06 20:00:59 +0000
committerKarl Berry <karl@freefriends.org>2022-10-06 20:00:59 +0000
commitab0876c08a10ca48db6d8521a54a04c6489ea948 (patch)
tree4a42694b9a5085b55c2eb6517642b9b4a036d2e8 /Master
parent42e149ae691b09e3d12d3cc32e7e1ad17fa835f8 (diff)
coolfn (6oct22)
git-svn-id: svn://tug.org/texlive/trunk@64639 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/latex/coolfn/README15
-rw-r--r--Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdfbin0 -> 67039 bytes
-rw-r--r--Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex179
-rw-r--r--Master/texmf-dist/tex/latex/coolfn/coolfn.sty100
-rwxr-xr-xMaster/tlpkg/bin/tlpkg-ctan-check2
-rw-r--r--Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc1
-rw-r--r--Master/tlpkg/tlpsrc/coolfn.tlpsrc0
7 files changed, 296 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/latex/coolfn/README b/Master/texmf-dist/doc/latex/coolfn/README
new file mode 100644
index 00000000000..9b6beb43e29
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coolfn/README
@@ -0,0 +1,15 @@
+coolfn - a package for cool footnotes
+
+version: 1.0.0
+
+This package provides formatting for footnotes in long legal documents, using hanging indents to make them look nicer
+
+This work may be distributed and/or modified under the conditions of the
+LaTeX Project Public License (LPPL), version 1.3 or later.
+
+
+For suggestions, feature requests, and bug reports, please use the project's
+GitHub site: https://github.com/ezgranet/coolfn
+
+Version history:
+06/10/2022 Package creation \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf b/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf
new file mode 100644
index 00000000000..768c97fe7d4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex b/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex
new file mode 100644
index 00000000000..2d72b17ec81
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex
@@ -0,0 +1,179 @@
+\documentclass[12pt]{article}
+\usepackage{coolfn}
+\usepackage{textcsc}
+\usepackage{xcolor}
+\usepackage{fontspec}\definecolor{darkspringgreen}{rgb}{0.09, 0.45, 0.27}
+\usepackage{titlesec}
+\titleformat{\subsection}
+ {\bfseries}{\thesection.\thesubsection}{1em}{\normalfont\bfseries}
+\usepackage[hidelinks]{hyperref}
+\usepackage{hologo}
+\usepackage[british]{babel}
+\usepackage[useregional]{datetime2}
+\DTMlangsetup[en-GB]{ord=omit}
+\definecolor{LightGray}{gray}{0.9}
+%\usepackage{mathpazo}
+\IfFontExistsTF{Palatine Parliamentary}{%
+\setromanfont[SmallCapsFeatures={LetterSpace=10},
+RawFeature={+calt,+hlig,+liga,+dlig,+onum,+pnum},
+BoldFont={Palatine Parliamentary Bold},
+ItalicFont={Palatine Parliamentary Italic}
+]{Palatine Parliamentary Regular}
+}{\setromanfont[RawFeature={+onum,+pnum}]{TeX Gyre PagellaX}}
+\setmonofont[Scale=.9,BoldFont=Source Code Pro Bold]{Source Code Pro}
+
+\usepackage{minted}
+\date{6 October 2022\\\smallskip\ttfamily Version \coolfnversionnumber}
+\author{Elijah Z Granet\thanks{e-mail: \href{mailto:ezg21@cantab.ac.uk}{\ttfamily ezg21@cantab.ac.uk}}}
+
+\title{\texttt{coolfn}:\\A package for a cool way to typeset footnotes}
+\begin{document}
+\maketitle
+\tableofcontents
+\clearpage
+\section{Overview}
+Legal writing, for better or for worse,\footnote{Almost certainly for the worse, except in the very rare situations where the author is capable of mastering the art of distinctive discursive footnote writing. Far more authors think that they can pull off this delicate technique than \textit{actually} are capable of doing so. } often involves very long and discursive footnotes replete with a series of often doubtfully relevant citations (perhaps with blockquotes of even more doubtful relevance).\footnote{Here, it is apt to note, as Parke \textcsc{B} said in Parke B in \textit{Mirehouse v Rennel} (1833) 1 Cl \& F 527, 546, that:
+\begin{quote}
+Our common law system consists in the applying to new combinations of circumstances those rules of law which we derive from legal principles and judicial precedents; and for the sake of attaining uniformity, consistency and certainty, we must apply those rules, where they are not plainly unreasonable or inconvenient, to all cases which arise; and we are not at liberty to reject them, and to abandon all analogy to them, in those to which they have not yet been judicially applied, because we think that the rules are not as convenient and reasonable as we ourselves could have devised.\end{quote}} Consequently, the formatting of footnotes for clear numbering, delineation of internal quotations and paragraphs, and clarity takes on a great importance.
+
+This is a subjective question, on which the typographic authorities offer many suggestions. This package simply provides a way of formatting long footnotes the author thinks is, for lack of a better word, cool. It uses a clear column of numbers separated from the footnote, of sufficient width to accommodate triple digit footnote numbers. A hanging indent emphasises the footnote as the sideways mirror of the text, reflecting the paragraph but in a different way.\footnote{Think of the classic mirroring of the main text having the case name and the footnote the legal citation.} There is no footnote rule and a very slight increase in the parskip to help the eye distinguish multi-paragraph footnotes.\footnote{Which are usually a bad idea, but should at least look nice if they must be used.}
+\section{Usage}
+The package has no options, and the only configurable length is the \\\mintinline{latex}{\fnindent}, which sets the indent for the hanging footnotes, and also defines the relationship of the footnote number and main footnote blocks. By default, this is set to 1 \textcsc{M}, but can be easily changed by using the simple inbuilt \LaTeX renewal macro. For example:
+\begin{quote}
+ \mintinline{latex}{\renewcommand{\fnindent}{1.25em}}.
+\end{quote}
+\section{Development}
+Bugs, feature requests, \textit{etc}, should be submitted to the project's official Githup page: (\url{https://github.com/ezgranet/coolfn/}).
+
+\section{Licence}
+ This project is licensed under the Latex Public Project Licence version 1.3\textit{c}. This documentation is copyright of the author but licensed under \textcsc{CC-BY-SA} 3.0.
+
+\clearpage
+\section{Implementation}
+\begin{minted}[
+framesep=2mm,
+baselinestretch=1.2,
+bgcolor=LightGray,
+fontsize=\footnotesize,
+breaklines,
+firstnumber=last
+]
+{latex}
+
+\def\coolfnversionnumber{1.0.0}
+\ProvidesPackage{coolfn}
+[2022/10/06\coolfnversionnumber\
+ A cool way to format footnotes]
+% 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 this 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 Elijah Z Granet
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% FOOTNOTES
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% from https://tex.stackexchange.com/questions/305033/is-there-a-latex-package-that-defines-an-environment-for-parskip-like-capabiliti
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% multi paragraph footnotes
+% are inherently pretty bad
+% but they happen in law
+% so might as well deal with them? so a slight spacing to compensate
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newenvironment{Parskip}{%
+ \par
+ \parskip=0.25\baselineskip \advance\parskip by 0pt plus 1pt
+ \parindent=\z@
+ \def\@listI{\leftmargin\leftmargini
+ \topsep\z@ \parsep\parskip \itemsep\z@}
+ \let\@listi\@listI
+ \@listi
+ \def\@listii{\leftmargin\leftmarginii
+ \labelwidth\leftmarginii\advance\labelwidth-\labelsep
+ \topsep\z@ \parsep\parskip \itemsep\z@}
+ \def\@listiii{\leftmargin\leftmarginiii
+ \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
+ \topsep\z@ \parsep\parskip \itemsep\z@}
+ \partopsep=\z@
+}{\par}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newcommand{\fnindent}{1em}
+\usepackage{calc}% for maths
+\newlength{\lengtha}
+\setlength{\lengtha}{\textwidth}
+\newlength{\lengthb}%maths again
+\newlength{\lengthc}
+\setlength{\lengthc}{\fnindent}
+\setlength{\lengthb}{1.75\lengthc}%parblock
+\makeatletter
+\@ifclassloaded{memoir}{}{\usepackage{hanging}}
+\makeatother
+ % for hanging paragraphs
+\renewcommand\footnoterule{}
+% ^ no one wants a rule sep for FN!
+\AtBeginDocument{\flushbottom}
+%^just to be safe
+\makeatletter
+\long\def\@makefntext#1{\leavevmode
+ \@makefnmark\nobreak
+ #1%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% the magic
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+ \renewcommand{\@makefntext}[1]{%
+\begin{minipage}[t]{\lengthb}%
+\noindent\normalfont%
+\@thefnmark%
+\end{minipage}%
+\begin{minipage}[t]{\lengtha-\lengthb}%
+\begin{Parskip}\begin{hangparas}{\lengthc}{1}
+\noindent#1\end{hangparas}\end{Parskip}%
+\end{minipage}%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\end{minted}
+
+
+
+
+
+
+
+
+\section{Version History}
+\subsection{\texttt{1.0.0}}
+
+\ttfamily 6 October 2022: Package creation
+
+
+\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/tex/latex/coolfn/coolfn.sty b/Master/texmf-dist/tex/latex/coolfn/coolfn.sty
new file mode 100644
index 00000000000..af3ee854a20
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/coolfn/coolfn.sty
@@ -0,0 +1,100 @@
+\def\coolfnversionnumber{1.0.0}
+\ProvidesPackage{coolfn}
+[2022/10/06\coolfnversionnumber\
+ A cool way to format footnotes]
+% 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 this 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 Elijah Z Granet
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% FOOTNOTES
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% from https://tex.stackexchange.com/questions/305033/is-there-a-latex-package-that-defines-an-environment-for-parskip-like-capabiliti
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% multi paragraph footnotes
+% are inherently pretty bad
+% but they happen in law
+% so might as well deal with them? so a slight spacing to compensate
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newenvironment{Parskip}{%
+ \par
+ \parskip=0.25\baselineskip \advance\parskip by 0pt plus 1pt
+ \parindent=\z@
+ \def\@listI{\leftmargin\leftmargini
+ \topsep\z@ \parsep\parskip \itemsep\z@}
+ \let\@listi\@listI
+ \@listi
+ \def\@listii{\leftmargin\leftmarginii
+ \labelwidth\leftmarginii\advance\labelwidth-\labelsep
+ \topsep\z@ \parsep\parskip \itemsep\z@}
+ \def\@listiii{\leftmargin\leftmarginiii
+ \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
+ \topsep\z@ \parsep\parskip \itemsep\z@}
+ \partopsep=\z@
+}{\par}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newcommand{\fnindent}{1em}
+\usepackage{calc}% for maths
+\newlength{\lengtha}
+\setlength{\lengtha}{\textwidth}
+\newlength{\lengthb}%maths again
+\newlength{\lengthc}
+\setlength{\lengthc}{\fnindent}
+\setlength{\lengthb}{1.75\lengthc}%parblock
+\makeatletter
+\@ifclassloaded{memoir}{}{\usepackage{hanging}}
+\makeatother
+ % for hanging paragraphs
+\renewcommand\footnoterule{}
+% ^ no one wants a rule sep for FN!
+\AtBeginDocument{\flushbottom}
+%^just to be safe
+\makeatletter
+\long\def\@makefntext#1{\leavevmode
+ \@makefnmark\nobreak
+ #1%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% the magic
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+ \renewcommand{\@makefntext}[1]{%
+\begin{minipage}[t]{\lengthb}%
+\noindent\normalfont%
+\@thefnmark%
+\end{minipage}%
+\begin{minipage}[t]{\lengtha-\lengthb}%
+\begin{Parskip}\begin{hangparas}{\lengthc}{1}
+\noindent#1\end{hangparas}\end{Parskip}%
+\end{minipage}%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 27730ecfef4..347a81440eb 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -216,7 +216,7 @@ my @TLP_working = qw(
context-visualcounter
continue contour contracard conv-xkv convbkmk
cooking cooking-units cookingsymbols
- cool coollist coolstr coolthms cooltooltips coop-writing
+ cool coolfn coollist coolstr coolthms cooltooltips coop-writing
coordsys copyedit copyrightbox cormorantgaramond correctmathalign coseoul
countriesofeurope counttexruns courier courier-scaled courierten
courseoutline coursepaper
diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
index 7ec12a86026..403e45c4f4e 100644
--- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
@@ -245,6 +245,7 @@ depend conv-xkv
depend cooking
depend cooking-units
depend cool
+depend coolfn
depend coollist
depend coolstr
depend coolthms
diff --git a/Master/tlpkg/tlpsrc/coolfn.tlpsrc b/Master/tlpkg/tlpsrc/coolfn.tlpsrc
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/coolfn.tlpsrc