From 105314726a04b25630bee45db0a8bb73b4c7e099 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maximilian=20Ke=C3=9Fler?= <git@maximilian-kessler.de>
Date: Sun, 30 Jan 2022 16:38:07 +0100
Subject: [PATCH] document mathfixes package

---
 doc/math/mathfixes/.latexmkrc    |  4 ++
 doc/math/mathfixes/Makefile      |  8 +++
 doc/math/mathfixes/mathfixes.tex | 93 ++++++++++++++++++++++++++++++++
 3 files changed, 105 insertions(+)
 create mode 100644 doc/math/mathfixes/.latexmkrc
 create mode 100644 doc/math/mathfixes/Makefile
 create mode 100644 doc/math/mathfixes/mathfixes.tex

diff --git a/doc/math/mathfixes/.latexmkrc b/doc/math/mathfixes/.latexmkrc
new file mode 100644
index 0000000..4c81cd6
--- /dev/null
+++ b/doc/math/mathfixes/.latexmkrc
@@ -0,0 +1,4 @@
+$makeindex = "makeindex -s gind.ist %O -o %D %S";
+$clean_ext .= ' glo';
+$clean_ext .= ' hd';
+$clean_ext .= ' ins';
diff --git a/doc/math/mathfixes/Makefile b/doc/math/mathfixes/Makefile
new file mode 100644
index 0000000..e174370
--- /dev/null
+++ b/doc/math/mathfixes/Makefile
@@ -0,0 +1,8 @@
+doc:
+	latexmk
+
+full:
+	latexmk -gg
+
+clean:
+	latexmk -C
diff --git a/doc/math/mathfixes/mathfixes.tex b/doc/math/mathfixes/mathfixes.tex
new file mode 100644
index 0000000..48fbc35
--- /dev/null
+++ b/doc/math/mathfixes/mathfixes.tex
@@ -0,0 +1,93 @@
+\documentclass[full]{l3doc}
+
+\usepackage{mkessler-mathfixes}
+
+\title{The \pkg{mkessler-mathfixes} package}
+\author{Maximilian Ke\ss ler}
+
+
+\NewDocumentCommand{\ShowMacro}{m}
+{
+  \cs{#1} &  $ \csname #1\endcsname $
+  \\
+}
+
+\begin{document}
+
+\maketitle
+
+\begin{documentation}
+
+\begin{abstract}
+  This package includes some hacky \LaTeX (re)-definitions to fix common
+  misbehavior of built-in macros.
+
+  For sure, this is personal view-dependent.
+  If you don't like these definitions, don't use this package.
+\end{abstract}
+  
+\section{Provided macros}
+\autoref{tab:label} shows the behavior of macros with the
+\pkg{mkessler-mathfixes} behavior.
+
+\begin{function}{\degree}
+  Prints a visual degree symbol, as in $37\degree$.
+\end{function}
+
+\begin{function}{\oldlim}
+  Behaves like the built-in \cs{lim} from \LaTeX.
+\end{function}
+
+\begin{function}{\lim}
+  Defined as \cs{oldlim}\cs{limits}, always puts the limits below the symbol,
+  also in inline math mode.
+\end{function}
+
+\begin{function}{\subset, \supset}
+  Redefined to \cs{subseteq} and \cs{supseteq} to avoid ambiguities.
+\end{function}
+
+\begin{function}{\oldphi, \uglyphi, \goldenratio}
+  Synonyms for the built-in \cs{phi} symbol.
+\end{function}
+
+\begin{function}{\phi, \varphi}
+  Synonyms for the built-in \cs{varphi} symbol.
+\end{function}
+
+\begin{function}{\oldespilon, \uglyepsilon}
+  Synonyms for the built-in \cs{epsilon} symbol.
+\end{function}
+
+\begin{function}{\epsilon, \varepsilon}
+  Synonyms for the built-in \cs{varepsilon} symbol.
+\end{function}
+
+\begin{table}[htpb]
+  \centering
+  \begin{tabular}{c | c}
+    Command & Shown by \LaTeX \\
+    \ShowMacro{degree}
+      \ShowMacro{subset}
+      \ShowMacro{supset}
+      \ShowMacro{oldphi}
+      \ShowMacro{uglyphi}
+      \ShowMacro{goldenratio}
+      \ShowMacro{phi}
+      \ShowMacro{varphi}
+      \ShowMacro{oldepsilon}
+      \ShowMacro{uglyepsilon}
+      \ShowMacro{epsilon}
+      \ShowMacro{varepsilon}
+    \texttt{\$\cs{oldlim}\_\{n \cs{to} \cs{infty}\}\$} & $\oldlim_{n \to \infty}$ \\
+    \texttt{\$\cs{lim}\_\{n \cs{to} \cs{infty}\}\$} & $\lim_{n \to \infty}$ \\
+  \end{tabular}
+  \caption{Symbols when loaded with the \pkg{mkessler-mathfixes} package.}
+  \label{tab:label}
+\end{table}
+
+\end{documentation}
+
+\PrintIndex
+
+\end{document}