From 1d29cc334a5a588ee0a0678be215be65df74d6aa Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Sat, 28 Dec 2019 03:00:29 +0000
Subject: CTAN sync 201912280300

---
 macros/latex/contrib/diffcoeff/diffcoeff.tex | 139 ++++++++++++++++++---------
 1 file changed, 93 insertions(+), 46 deletions(-)

(limited to 'macros/latex/contrib/diffcoeff/diffcoeff.tex')

diff --git a/macros/latex/contrib/diffcoeff/diffcoeff.tex b/macros/latex/contrib/diffcoeff/diffcoeff.tex
index 258f3a71d9..9ade962edd 100644
--- a/macros/latex/contrib/diffcoeff/diffcoeff.tex
+++ b/macros/latex/contrib/diffcoeff/diffcoeff.tex
@@ -1,4 +1,4 @@
-%% LyX 2.3.2-2 created this file.  For more info, see http://www.lyx.org/.
+%% LyX 2.3.3 created this file.  For more info, see http://www.lyx.org/.
 %% Do not edit unless you really know what you are doing.
 \documentclass[english]{article}
 \usepackage{lmodern}
@@ -6,6 +6,7 @@
 \renewcommand{\ttdefault}{lmtt}
 \usepackage[T1]{fontenc}
 \usepackage[latin9]{inputenc}
+\synctex=-1
 \usepackage{color}
 \usepackage{babel}
 \usepackage{wrapfig}
@@ -52,7 +53,7 @@
  a \LaTeX{} package to ease\texttt{ }the~\\
  writing of differential coefficients \\
  in all their variety\\
- Version 3.1}
+ Version 3.2}
 \author{Andrew Parsloe\\
 {\small{}(ajparsloe@gmail.com)}}
 \maketitle
@@ -144,6 +145,11 @@ should occur in these other contexts.\footnote{This rather obvious lack in versi
 error in version 3).
 \item Version 3 also provides some simple spacing commands that can be useful
 for tweaking standard spacing.
+\item Version 3.2 fixes a bug in which an ordinary derivative as the differentiand
+of a partial derivative displayed as a partial derivative. It now displays,
+as it should, as an ordinary derivative. 
+\item In version 3.2, the differential command \texttt{\textbackslash dl} now
+also allows negative spacing before it.
 \end{enumerate}
 
 \subsubsection*{Note on terminology}
@@ -161,11 +167,11 @@ of derivatives `disporting every which way'.
 Multi-character variables of differentiation un-parenthesized:
 
 \begin{equation}
-\diffp{\frac{\psi}{\Theta}}{\frac{1}{\Theta}},\quad\diffp{E/T}{1/T},\quad\diffp{\ln f}{\ln x_{0}},\quad\diffp\psi{a_{i},\frac{1}{\Theta}},\quad\diffp{\mathcal{L}}{\eta_{,i}^{(r)}}\label{eq:eg1}
+\diffp{\frac{\psi}{\Theta}}{\frac{1}{\Theta}},\quad\diffp{E/T}{1/T},\quad\diffp{\ln f}{\ln x_{0}},\quad\diffp\psi{a_{i},\frac{1}{\Theta}},\quad\diffp{\mathcal{L}}{\eta_{,i}^{(r)}}.\label{eq:eg1}
 \end{equation}
 Multi-character variables of differentiation parenthesized: 
 \begin{equation}
-\diffp H{\displaystyle \diffp S{q_{k}}[]},\quad\diffp\varepsilon{(1/\Theta)},\label{eq:eg2}
+\diffp H{\displaystyle \diffp S{q_{k}}[]},\quad\diffp\varepsilon{(1/\Theta)}.\label{eq:eg2}
 \end{equation}
 Higher-order derivatives where the parentheses do not or do include the
 operator: 
@@ -553,6 +559,24 @@ this. Thus, to express a relation in thermodynamics,
 \noindent where the starring automatically takes care of the parentheses
 and subscripts.
 
+\subsection{Iterated derivatives}
+
+Derivatives can be the differentiands of derivatives, as seen above when
+writing Lagrange's equations,
+\begin{example}
+\textbackslash diffp L\{q\_k\}-\textbackslash diff{*}\{\textbackslash diffp
+L\{\textbackslash dot\{q\}\_k\}{[}{]}\}t = 0 $\Longrightarrow\quad{\displaystyle \diffp L{q_{k}}-\diff*{\diffp L{\dot{q}_{k}}[]}t}=0.$
+\end{example}
+
+\noindent However, in versions of \texttt{diffcoeff} before version 3.2,
+an ordinary derivative within a partial derivative rendered as a partial
+derivative. That is now corrected, the ordinary derivative rendering correctly:
+\begin{example}
+\textbackslash diffp{*}\{\textbackslash diff\{x\textasciicircum\textbackslash mu\}\{\textbackslash lambda\}\}\{x\textasciicircum\textbackslash sigma\}
+$\Longrightarrow\quad{\displaystyle \diffp*{\diff{x^{\mu}}{\lambda}}{x^{\sigma}}}$
+\end{example}
+
+
 \subsection{Mixed partial derivatives}
 
 The new thing with partial derivatives, not present with ordinary derivatives,
@@ -714,8 +738,8 @@ to the $\partial$ symbol in the numerator.
 In tensor calculus the differentiations are almost always in terms of super-
 or subscripted coordinates. In many other contexts this is the case too
 -- the reciprocal of the temperature in thermodynamics or generalized
-cooredinates in analytical mechanics. This is why a comma list is used
-in \texttt{diffcoeff} for specifying variables of differentiation for mixed
+coordinates in analytical mechanics. This is why a comma list is used in
+\texttt{diffcoeff} for specifying variables of differentiation for mixed
 partial derivatives. Although it would be nice to write the minimal \texttt{\{xy\}}
 rather than \texttt{\{x,y}\} when two variables $x$ and $y$ are involved,
 the extra writing is trivial and the comma list allows a simpler handling
@@ -879,36 +903,6 @@ which as far as I know has no meaning.
 
 \section{Changing defaults; variant forms\label{sec:Changing-defaults}}
 
-\begin{wraptable}[22]{o}{0.5\columnwidth}%
-\vspace{-4.5ex}
- \caption{{\small{}Defaults (ordinary derivatives})\label{tab:Ordinary-derivatives}}
-
-\abovetopsep=.5ex{}%
-\begin{tabular}{lr}
-\toprule 
-{\small{}key}  & {\small{}default}\tabularnewline
-\midrule 
-{\small{}op-symbol }  & \texttt{\small{}d}\tabularnewline
-{\small{}op-symbol-alt}  & \texttt{\small{}= op-symbol}\tabularnewline
-{\small{}op-order-sep }  & \texttt{\small{}1 mu}\tabularnewline
-{\small{}{*}-op-left }  & \texttt{\small{}false}\tabularnewline
-{\small{}{*}-italic-nudge}  & \texttt{\small{}3 mu}\tabularnewline
-{\small{}{*}/-op-wrap}  & \texttt{\small{}true}\tabularnewline
-{\small{}long-var-wrap }  & \texttt{\small{}d(v)}\tabularnewline
-{\small{}denom-term-sep}  & \texttt{\small{}2 mu}\tabularnewline
-{\small{}/-denom-term-sep }  & \texttt{\small{}1 mu}\tabularnewline
-term-sep-adjust  & \texttt{-1 mu}\tabularnewline
-{\small{}left-delim}  & \texttt{\small{}\textbackslash left .}\tabularnewline
-{\small{}right-delim}  & \texttt{\small{}\textbackslash right |}\tabularnewline
-{\small{}elbowroom}  & \texttt{\small{}0 mu}\tabularnewline
-{\small{}subscr-nudge }  & \texttt{\small{}0 mu}\tabularnewline
-{\small{}/-left-delim}  & \texttt{\small{}(}\tabularnewline
-{\small{}/-right-delim }  & \texttt{\small{})}\tabularnewline
-{\small{}/-elbowroom}  & \texttt{\small{}0 mu}\tabularnewline
-{\small{}/-subscr-nudge }  & \texttt{\small{}0 mu}\tabularnewline
-\bottomrule
-\end{tabular}\end{wraptable}%
-
 To write the range of different examples displayed in the Rogues' Gallery
 (Section~\ref{sec:Rogues'-gallery}) I have had to make extensive use
 of forms of derivative other than the default. \texttt{Diffcoeff} is built
@@ -937,6 +931,36 @@ Keys with an opening slash, /, apply only to the slash form of the derivative;
 keys with an opening asterisk, {*}, apply only when the differentiand is
 appended.
 
+\begin{wraptable}[22]{o}{0.5\columnwidth}%
+\noindent \begin{centering}
+\vspace{-4.5ex}
+ \caption{{\small{}Defaults (ordinary derivatives})\label{tab:Ordinary-derivatives}}
+\par\end{centering}
+\noindent \centering{}\abovetopsep=.5ex{}%
+\begin{tabular}{lr}
+\toprule 
+{\small{}key} & {\small{}default}\tabularnewline
+\midrule 
+{\small{}op-symbol} & \texttt{\small{}d}\tabularnewline
+{\small{}op-symbol-alt} & \texttt{\small{}= op-symbol}\tabularnewline
+{\small{}op-order-sep} & \texttt{\small{}1 mu}\tabularnewline
+{\small{}{*}-op-left} & \texttt{\small{}false}\tabularnewline
+{\small{}{*}-italic-nudge} & \texttt{\small{}3 mu}\tabularnewline
+{\small{}{*}/-op-wrap} & \texttt{\small{}true}\tabularnewline
+{\small{}long-var-wrap} & \texttt{\small{}d(v)}\tabularnewline
+{\small{}denom-term-sep} & \texttt{\small{}2 mu}\tabularnewline
+{\small{}/-denom-term-sep} & \texttt{\small{}1 mu}\tabularnewline
+term-sep-adjust & \texttt{-1 mu}\tabularnewline
+{\small{}left-delim} & \texttt{\small{}\textbackslash left .}\tabularnewline
+{\small{}right-delim} & \texttt{\small{}\textbackslash right |}\tabularnewline
+{\small{}elbowroom} & \texttt{\small{}0 mu}\tabularnewline
+{\small{}subscr-nudge} & \texttt{\small{}0 mu}\tabularnewline
+{\small{}/-left-delim} & \texttt{\small{}(}\tabularnewline
+{\small{}/-right-delim} & \texttt{\small{})}\tabularnewline
+{\small{}/-elbowroom} & \texttt{\small{}0 mu}\tabularnewline
+{\small{}/-subscr-nudge} & \texttt{\small{}0 mu}\tabularnewline
+\bottomrule
+\end{tabular}\end{wraptable}%
 Note that these settings are, in general, font dependent. The values given
 are (in the author's opinion) appropriate for the default \LaTeX{} math
 fonts. There are also likely to be variations required for whether a derivative
@@ -954,6 +978,10 @@ default = \texttt{d}
 denominator while \textbf{op-symbol} is used in the numerator; e.g. for
 $\diff.nabla.{v^{i}}t$, \texttt{op-symbol = \textbackslash nabla} and
 \texttt{op-symbol-alt = d}; otherwise (and usually) defaults to \textbf{op-symbol}
+\end{description}
+~\vspace{-5ex}
+
+\begin{description}
 \item [{op-order-sep}] extra horizontal space added between the op-symbol and
 the superscripted order of differentiation in higher order derivatives;
 compare $d^{2}$ with $d^{\mkern1mu 2}$, $\partial^{2}$ with $\partial^{\mkern1mu 2}$
@@ -1251,7 +1279,7 @@ I have attached a name, \texttt{padrift},\texttt{ }to this setting,
 it qualifies -- is it perhaps a typo? -- and `adrift in a sea of whitespace'.
 This is to be compared with the default
 \begin{example}
-\noindent \textbackslash diffpFx{[}y{]} $\Longrightarrow{\displaystyle \diffp Fx[y]}$
+\noindent \textbackslash diffp Fx{[}y{]} $\Longrightarrow{\displaystyle \diffp Fx[y]}$
 \end{example}
 
 \noindent where the subscript is tucked in close to the right parenthesis
@@ -1545,10 +1573,11 @@ present document, the default form is math-italic and so
 \end{example}
 
 \noindent It is also possible\footnote{\noindent From version 3.1 of \texttt{diffcoeff}; version 3.0 of the package
-produced a \LaTeX{} error.} to use the command before \texttt{\textbackslash vec\{x\}} or \texttt{\textbackslash mathbf\{x\}}:
+produced a \LaTeX{} error.} to use the command before, for instance, \texttt{\textbackslash vec\{x\}}
+or \texttt{\textbackslash mathbf\{x\}}:
 \begin{example}
-\textbackslash dl \textbackslash vec\{x\} $\Longrightarrow\dl\vec{{x}},$
-~~~~\textbackslash dl \textbackslash mathbf\{x\} $\Longrightarrow\dl\mathbf{x}.$
+\textbackslash dl \textbackslash vec\{x\} $\Longrightarrow\dl\vec{x}$~~~~\textbackslash dl
+\textbackslash mathbf\{x\} $\Longrightarrow\dl0\mathbf{x}.$
 \end{example}
 
 
@@ -1576,6 +1605,8 @@ offers a slightly shorter way of writing \texttt{\textbackslash partial}
 is because of the convenience offered by the second option to the \texttt{\textbackslash dl}
 command.
 
+\subsubsection{Spacing}
+
 This second option inserts spacing before the `d'. If \texttt{\textbackslash dl}
 is followed by a digit (0, 1, 2, ..., 9) it will insert a horizontal space
 of that number of mu before the `d'; (\texttt{\textbackslash dl0x} has
@@ -1598,18 +1629,32 @@ the total differential expression, since the differentials are already
 distinct from the preceding fraction forms $\diff.ptxt.Px$ etc., and \texttt{\textbackslash dl2x}
 when writing $\int\sin x\dl2x$.
 
-As remarked above, the \texttt{\textbackslash dl.p.} alternative to \texttt{\textbackslash partial
-}is unlikely to be of use except for a document, like the present one,
-illustrating various points of usage. Thus, to illustrate spacing in the
-denominator of a mixed partial derivative, I have earlier used \texttt{\textbackslash dl.p.x\textbackslash dl.p.2y\textbackslash dl.p.2z},
+Note that only \emph{one} digit can be used. If two are used, as here,
+\begin{example}
+\textbackslash dl20x $\Longrightarrow\dl20x$
+\end{example}
+
+\noindent the effect is unlikely to be what is wanted.
+
+From version 3.2 of \texttt{diffcoeff} it is possible to also add \emph{negative}
+space before the differential, which might be useful in special contexts,
+perhaps to construct a symbol:
+\begin{example}
+/\textbackslash dl-9x $\Longrightarrow/\dl-9x.$
+\end{example}
+
+\noindent For negative space before the differential, add a minus sign
+before the (single) digit.
+
+The spacing digit option \emph{follows} the dot-delimited name option.
+For example, to illustrate spacing in the denominator of a mixed partial
+derivative, I have earlier used \texttt{\textbackslash dl.p.x\textbackslash dl.p.2y\textbackslash dl.p.2z},
 and the variation to that spacing when a higher-order differentiation occurs:
 \begin{example}
 \textbackslash dl.p.x\textasciicircum 2\textbackslash dl.p.1y\textbackslash dl.p.2z
 $\Longrightarrow\dl.p.x^{2}\dl.p.1y\dl.p.2z.$
 \end{example}
 
-\noindent Note here that the spacing digit option \emph{follows} the dot-delimited
-name option.
 
 \section{Rationale}
 
@@ -1765,6 +1810,8 @@ name option.
 \item [{\texttt{\textbackslash dl}}] options: 
 \begin{enumerate}
 \item .\emph{name}. (as for \texttt{\textbackslash diff}) 
+\item \emph{minus sign} (optional, use only if negative spacing before the `d'
+is wanted)
 \item \emph{digit} (insert spacing of this number of mu before the `d') 
 \end{enumerate}
 \item [{\texttt{\textbackslash negmu}}] insert a $-1$ mu space 
-- 
cgit v1.2.3

