summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/diffcoeff/diffcoeff.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/diffcoeff/diffcoeff.tex')
-rw-r--r--macros/latex/contrib/diffcoeff/diffcoeff.tex85
1 files changed, 56 insertions, 29 deletions
diff --git a/macros/latex/contrib/diffcoeff/diffcoeff.tex b/macros/latex/contrib/diffcoeff/diffcoeff.tex
index 77521ccd0a..320960b2ed 100644
--- a/macros/latex/contrib/diffcoeff/diffcoeff.tex
+++ b/macros/latex/contrib/diffcoeff/diffcoeff.tex
@@ -1,4 +1,4 @@
-%% LyX 2.4.0-alpha3 created this file. For more info, see https://www.lyx.org/.
+%% LyX 2.4.0-beta2 created this file. For more info, see https://www.lyx.org/.
%% Do not edit unless you really know what you are doing.
\documentclass[english]{report}
\usepackage{lmodern}
@@ -22,7 +22,7 @@
\usepackage{amssymb}
\usepackage{stmaryrd}
\usepackage{esint}
-\usepackage[unicode=true,pdfusetitle,
+\usepackage[pdfusetitle,
bookmarks=true,bookmarksnumbered=true,bookmarksopen=true,bookmarksopenlevel=2,
breaklinks=true,pdfborder={0 0 1},backref=section,colorlinks=true,pdfpagemode=FullScreen]
{hyperref}
@@ -113,12 +113,12 @@
\title{\texttt{diffcoeff}~\\
a \LaTeX{} package to ease\texttt{ }the~\\
writing of differential coefficients \\
- Version 5.1}
+ Version 5.2}
\author{Andrew Parsloe\\
{\small (ajparsloe@gmail.com)}}
\maketitle
\begin{abstract}
-\noindent \verb`diffcoeff` is a \LaTeX{} package to ease the writing
+\noindent\verb`diffcoeff` is a \LaTeX{} package to ease the writing
of ordinary, partial and other derivatives of arbitrary algebraic
or numeric order. For mixed partial derivatives, the total order of
differentiation is calculated by the package. Optional arguments allow
@@ -266,7 +266,7 @@ $\Longrightarrow$ \[ \ln \mleft(\frac xy\mright),\quad\sin\mleft(x^2\mright). \]
\end{shaded}%
\end{minipage}
-\noindent %
+\noindent{}%
\noindent\begin{minipage}[t]{1\columnwidth}%
\begin{shaded}%
If you put \verb`\mleftright` in the preamble, which is what the
@@ -437,6 +437,11 @@ derivative).
derivatives, variable or variables held constant; \emph{no space}
before the left square bracket; see §\ref{subsec:Point-of-evaluation}.
\end{itemize}
+Both mandatory arguments may be empty, but require empty brace pairs
+to indicate as much. (Omitting the differentiand makes sense for all
+forms of derivative, \verb`\difx`, \verb`\difxp`, but omitting the
+variable or variables of differentiation is sensible only for the
+compact forms, \verb`\difc`, \verb`\difcp` -- see §\ref{subsec:Compact=002013form-derivatives}.)
\section{General use}
@@ -680,7 +685,7 @@ in which a derivative forms the differentiand of another . Thus
\noindent This result is more elegant to my eye than what results
when removing the asterisk,
\begin{centred}
-\noindent \verb`\[ \diff[2]yx = \diff{\diff yx}x \]` $\Longrightarrow$
+\noindent\verb`\[ \diff[2]yx = \diff{\diff yx}x \]` $\Longrightarrow$
\[ \diff[2]yx=\diff{\diff yx}x ,\]
\end{centred}
\noindent although whether the \emph{meaning} is clearer is moot.
@@ -797,7 +802,7 @@ no subscript. This fact can be exploited. Thus, for a particle of
mass $m$ moving along a line, distance $x$ at time $t$, the kinetic
energy is:
\begin{centred}
-\noindent \verb`$ \tfrac 12 m \difs xt[]^2 $` $\Longrightarrow$
+\noindent\verb`$ \tfrac 12 m \difs xt[]^2 $` $\Longrightarrow$
$\tfrac{1}{2}m\difs xt[]^{2}$.
\end{centred}
Or, again exploiting the parentheses resulting from an empty trailing
@@ -846,7 +851,7 @@ command:
\mleftright
\[ \diffp L{q_k}-\diff**t{ \!\diffp L{\dot{q}_k}[] } = 0 \]
\end{verbatim}
-\noindent $\Longrightarrow$ \mleftright\[\diffp L{q_k}-\diff**t{\!\diffp L{\dot{q}_k}[]} = 0. \]
+\noindent$\Longrightarrow$ \mleftright\[\diffp L{q_k}-\diff**t{\!\diffp L{\dot{q}_k}[]} = 0. \]
\noindent The problem is that in addition to the space around \verb`\left`,
\verb`\right` pairs (which is reduced by issuing the command \verb`\mleftright`),
@@ -931,7 +936,7 @@ Or again,
\subsubsection{Order-override command: \texttt{\textbackslash difoverride}}
-\noindent \label{subsec:Order-override-command}$m+k+km+1$ factorizes
+\noindent\label{subsec:Order-override-command}$m+k+km+1$ factorizes
to $(k+1)(m+1)$ and you may prefer to express the total order of
differentiation in this form. \verb`diffcoeff` is not a computer
algebra system and does not do such factorizations but the \verb`\difoverride`
@@ -1162,7 +1167,7 @@ in $x$ means forming the product
Forming the \emph{second} derivative of $\ln\sin x$ will now involve
forming, among other quantities,
\begin{centred}
-\noindent \verb`\[\diff[2]{\ln\sin x}{\sin x}\]` $\Longrightarrow$
+\noindent\verb`\[\diff[2]{\ln\sin x}{\sin x}\]` $\Longrightarrow$
\[\diff[2]{\ln\sin x}{\sin x}\]
\end{centred}
\noindent Parentheses have been inserted automatically by \verb`diffcoeff`
@@ -1211,7 +1216,7 @@ say:
\begin{centred}
\verb`\[ \diffp[2]q{\frac 1\Theta} \]` $\Longrightarrow$ \[ \diffp[2]q{\frac 1\Theta}.\]
\end{centred}
-\noindent As noted, when differentiating to first order, parenthesising
+\noindent As noted, when differentiating to first order, parenthesising
is up to the user:
\begin{centred}
\verb`\[ \diffp q{(\frac 1\Theta),V} \]` $\Longrightarrow$ \[ \diffp q{(\frac 1\Theta),V}. \]
@@ -1313,7 +1318,7 @@ environments
\item \emph{ordinary slash}-fraction derivatives in \emph{text}-style environments
\item \emph{ordinary compact}-form derivatives in \emph{text}-style environments
\end{enumerate}
-\noindent %
+\noindent{}%
\noindent\begin{minipage}[t]{1\columnwidth}%
\begin{shaded}%
\noindent Users of version 4 of \texttt{diffcoeff} will notice similarities
@@ -1717,7 +1722,7 @@ the definition of the variant with the statement,
put the status and configurability of partial derivatives on the same
footing as ordinary derivatives.
-\noindent %
+\noindent{}%
\noindent\begin{minipage}[t]{1\columnwidth}%
\begin{shaded}%
The command \verb`\difdef` in version 5 of \verb`diffcoeff` takes
@@ -1766,7 +1771,7 @@ it in the \verb`texmf` tree, preferably not the one created by your
Provided your \TeX{} distribution knows about your personal \verb`texmf`
tree and the files it contains, then a \verb`.def` file placed within
it will be accessible to all documents.
-\noindent \begin{center}
+\begin{center}
\noindent\begin{minipage}[t]{1\columnwidth}%
\begin{shaded}%
@@ -1802,12 +1807,12 @@ will apply there.\end{shaded}%
In earlier versions of \verb`diffcoeff`, if there was no explicit
\verb`def-file=<filename>` package option statement, then a file
\verb`diffcoeff.def` was searched for and if found loaded. This is
-no longer the case. Version 5 of file of \verb`diffcoeff` searches
-for a \verb`.def` \emph{only if it is explicitly named} in a package
-option statement. (This decision was made at least in part to avoid
-conflict with a \verb`diffcoeff.def` file from an earlier version
-of \verb`diffcoeff` tucked away in some non-obvious place and producing
-obscure errors in the current version 5.) \end{shaded}%
+no longer the case. Version 5 of \verb`diffcoeff` searches for a
+\verb`.def` \emph{only if it is explicitly named} in a package option
+statement. (This decision was made at least in part to avoid conflict
+with a \verb`diffcoeff.def` file from an earlier version of \verb`diffcoeff`
+tucked away in some non-obvious place and producing obscure errors
+in the current version 5.) \end{shaded}%
\end{minipage}
\par\end{center}
@@ -1889,7 +1894,7 @@ equations are rendered (just right to my eye!)
\subsubsection{Editing variant forms}
-\noindent %
+\noindent{}%
\noindent\begin{minipage}[t]{1\columnwidth}%
\begin{shaded}%
@@ -2099,14 +2104,24 @@ They provide good visual contrast with the parentheses of $F(x,y)$.
\subsubsection{Compact--form derivatives}
-Two styles are available for compact-form derivatives, derivative
-style \verb`style=_`, and differential style \verb`style=dl`. The
-first is the default style; the orders of differentiation are applied
-to the operator symbol, in this example \verb`\partial`:
+\label{subsec:Compact=002013form-derivatives}Two styles are available
+for compact-form derivatives, derivative style, \verb`style=_`, and
+differential style, \verb`style=dl`. The first is the default style;
+the orders of differentiation are applied to the operator symbol,
+in this example \verb`\partial`:
+\begin{centred}
+\verb`$ \difcp[3,2]f{x,y,z} $` $\Longrightarrow$ $ \difcp[3,2]{f}{x,y,z} $
+\end{centred}
+What happens if no differentiation variable is specified, only an
+empty brace pair?
\begin{centred}
-\verb`$ \difcp[3,2]{f}{x,y,z} $` $\Longrightarrow$ $ \difcp[3,2]{f}{x,y,z} $
+\verb`$ \difc[3]f{} $` $\Longrightarrow$ $ \difc[3]f{} $
\end{centred}
-But suppose we define a variant form (as is done in \verb`diffcoeff5.def`):
+Note that this is the behaviour from version 5.2 of \verb`diffcoeff`.
+In version 5.1, a brace pair alone would halt compilation; a \emph{nested
+}brace pair, \verb`{{}}`, was required.
+
+Suppose now we define a variant form (as is done in \verb`diffcoeff5.def`),
\begin{verbatim}
\difdef { cp } { dl } { style = dl }
\end{verbatim}
@@ -2118,7 +2133,9 @@ an empty argument in its place:
In this \verb`dl` style, the orders of differentiation are applied
to the \emph{variables}. This allows discussion of, for example, the
denominator of a mixed partial derivative -- perhaps a remark about
-minutiae of spacing.
+minutiae of spacing. (See §\ref{sec:Differentials} on differentials
+which perhaps more conveniently similarly allow the writing of, for
+example, $\dl[3]x$.)
\subsubsection{D, \textbackslash delta, \textbackslash Delta derivatives}
@@ -2154,7 +2171,7 @@ $ \difs.gd.yx $, or \verb`$ \difs.gD.yx $` $\Longrightarrow$ $ \difs.gD.st$
\noindent for the total derivative of $\rho$ (perhaps in fluid dynamics),
or
\begin{centred}
-\noindent \verb`$ \difc.bD.[2]y{x\,}+2\difc.bD.y{x\,}-4=0 $` $\Longrightarrow$
+\noindent\verb`$ \difc.bD.[2]y{x\,}+2\difc.bD.y{x\,}-4=0 $` $\Longrightarrow$
$ \difc.bD.[2]y{x\,}+2\difc.bD.y{x\,}-4=0 $
\end{centred}
for an example in the study of differential equations.
@@ -2381,6 +2398,8 @@ producing a variant form of the differential (see below §\ref{subsec:Line-elemen
\verb`$ c^2\dl.-.{t,x,y,z}^2 $` $\Longrightarrow$ $ c^2\dl.-.{t,x,y,z}^2 $.
\end{centred}
+(If what you want is not $\dl[2]x$ but $\difc[2]f{}$, with the superscript
+attached to the \verb`d`, see §\ref{subsec:Compact=002013form-derivatives}.)
\subsection{Template \texttt{DIFL}}
@@ -3240,6 +3259,14 @@ conflict message;
\item makes some corresponding tweaks to documentation (including this version
5 history).
\end{enumerate}
+\item Version 5.2 (2023-01-24)
+\begin{enumerate}
+\item Simplifies the treatment of the empty argument of an absent differentiation
+variable;
+\item initializes (clears) two sequence variables that otherwise caused
+error when \verb`scrbook` class was used;
+\item amends documentation.
+\end{enumerate}
\end{enumerate}
\end{document}