delimseasy (5feb16)

git-svn-id: svn://tug.org/texlive/trunk@39589 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 208 insertions, 90 deletions

diff --git a/Master/texmf-dist/doc/latex/delimseasy/README.txt b/Master/texmf-dist/doc/latex/delimseasy/README.txt
index de58124ee1e..5580c527219 100644
--- a/Master/texmf-dist/doc/latex/delimseasy/README.txt
+++ b/Master/texmf-dist/doc/latex/delimseasy/README.txt
@@ -1,9 +1,15 @@
-Delimseasy  1.0
+Delimseasy  2.0
 ===============
 
+Changes to the package since Version 1.0:
+   Added more delimeters (notably for binomial coefficients)
+   Added delimiters for Valentine's Day
+   Added a "D" version for those who like LaTeX's \left...\right construct but are tired of typing and editing those pairs.
+   Revised Manual
+
 This package contains the following files:
 
-README - this document
+README2.0 - this document
 
 delimseasyMan.pdf - the pdf version of the manual
 
diff --git a/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf
index 29c876b0b58..6f9d3c61a4d 100644
--- a/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf
+++ b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf
diff --git a/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.tex b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.tex
index a007211556a..bf179c64ade 100644
--- a/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.tex
+++ b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.tex
@@ -1,34 +1,54 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
-%  Manual for the package delimseasy.sty
+%  Manual for the package delimseasy1.01.sty
+%
+% Revison history (Manual):
+%  2016/02/01
+%    added \thanks line for copyright notice
+%    added \valentine and \diamondsgbf
+%    added \L..., \R..., \BL..., \BR... as one-sided
+%      commands
+%   Revised \S3 to reflect addition of \llgg and 
+%    \valentine commands.
 %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \documentclass{amsart}
 \usepackage{verbatim}
-\usepackage{delimseasy}
+\usepackage{delimseasy2.0}
  %
  \setcounter{tocdepth}{3}
  \title[delimseasy]{Package delimseasy}
  \author[Graham]{Colin C. Graham}
  \address{PO Box 2031\\Haines Junction YT Canada Y0B 1L0\\\texttt{
- ccgraham@alum.mit.edu}}
+ ccgraham@alum.mit.edu}\hfill\break
+ \thanks{This material is subject to the LaTeX Project Public License 1.3. See
+http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the
+details of that license.}}
+% Encapsulated \thanks in \address so the list of delimiters appears on page 1.
+%
+%
+
 \begin{document}
 
+\begin{abstract}  Provides commands to give consistent, easy-to-remember, way to edit and  control the size  and blackness
+ of delimiters: append 1-4 ``b''s to command for larger sizes; prepend ``B'' for boldface; prepend ``D'' for the
+ \LaTeX\ default. These commands reduce the likelihood 
+ of incomplete delimeter pairs and typically use fewer characters than the \LaTeX\ default. 
+ \end{abstract}
+ 
 \maketitle
-\vskip-.35in 
+ 
 \centerline{\texttt{ccgraham@alum.mit.edu}}
 
-\bigskip
-\centerline{Version 1.0 -- 2015 December 2}
 
-\begin{abstract}  Provides commands to give consistent, easy-to-remember, easy to edit way to control the size  and blackness
- of delimiters: append 1-4 ``b''s to command for larger sizes; prepend ``B'' for boldface. These commands reduce the likelihood 
- of incomplete delimeter pairs and typically use fewer characters than the \LaTeX\ default.
- \end{abstract}
+\centerline{Version 2.0 -- 2016 February 1}
+
+
 {\smaller
 \tableofcontents}
 
-\vskip-.7truein
+\vspace{-.75in}
+
 \section{Installation and the basic delimiters}
 Put \texttt{delimseasy.sty} in a convenient folder and
 add
@@ -39,47 +59,59 @@ or add a \texttt{PATH} to the \texttt{$\backslash$usepackage} parameter, so you
 \newline
 \texttt{$\backslash$usepackage\{C:/user/YOU/Documents/WHEREYOUPUTIT/delimseasy\}}.
 
-\medskip
-Here are the basic macros:
+%\medskip
+Here are the basic commands:
 \begin{equation*}
 \begin{matrix}
-\text{the macro}&	\quad\text{ typesets like }&\quad \text{common name}\\
-\backslash\texttt{prn[1]}  &\texttt{(\#1)}                                     &\text{round parens}\\
-\backslash\texttt{sqpr[1]} &\texttt{[\#1]}                                     &\text{square braces}\\
-\backslash\texttt{crl[1]}  &\{\texttt{\#1} \}                                  &\text{curly braces}\\
-\backslash\texttt{ceil[1]} &\backslash\texttt{lceil \#1} \backslash\texttt{rceil}&\text{ceiling}\\        
-\backslash\texttt{flr[1]}  &\backslash\texttt{lfloor \#1}\backslash\texttt{rfloor}&\text{floor}\\
-\backslash\texttt{ngl[1]}  &\backslash\texttt{langle \#1}\backslash\texttt{rangle}&\text{langle/rangle}\\
-\backslash\texttt{abs[1]}  &\backslash\texttt{vert \#1} \backslash\texttt{vert}  &\text{absolute value}\\
-\backslash\texttt{nrm[1]}  &\backslash\texttt{Vert \#1}  \backslash\texttt{Vert}    &\text{norm}\\
-\backslash\texttt{stgt[1]} &\texttt{< \#1>}                               & \text{lessthan greaterthan}
+\text{The command}&	\quad\text{ typesets as }&\quad \text{common name}\\
+\backslash\texttt{prn\{$\backslash$\#\}}  &\texttt{(\#1)}                                     &\text{round parens}\\
+\backslash\texttt{sqpr\{$\backslash$\#\}} &\texttt{[\#1]}                                     &\text{square braces}\\
+\backslash\texttt{crl\{$\backslash$\#\}}  &\{\texttt{\#1} \}                                  &\text{curly braces}\\
+\backslash\texttt{ceil\{$\backslash$\#\}} &\backslash\texttt{lceil \#1} \backslash\texttt{rceil}&\text{ceiling}\\        
+\backslash\texttt{flr\{$\backslash$\#\}}  &\backslash\texttt{lfloor \#1}\backslash\texttt{rfloor}&\text{floor}\\
+\backslash\texttt{ngl\{$\backslash$\#\}}  &\backslash\texttt{langle \#1}\backslash\texttt{rangle}&\text{langle/rangle}\\
+\backslash\texttt{abs\{$\backslash$\#\}}  &\backslash\texttt{vert \#1} \backslash\texttt{vert}  &\text{absolute value}\\
+\backslash\texttt{nrm\{$\backslash$\#\}}  &\backslash\texttt{Vert \#1}  \backslash\texttt{Vert}    &\text{norm}\\
+\backslash\texttt{stgt\{$\backslash$\#\}} &\stgt{\texttt{\#1}}& \text{lessthan greaterthan}
 \end{matrix}
 \end{equation*}
 
-\subsection{Adding ``b''s to change the size}
-Add one to four ``b''s to the end of a macro; each ``b'' raises size by one step. Example:
+\subsection{Adding ``b''s to change the size; ``D''s to use \LaTeX\ default}
+Add one to four ``b''s to the end of a command; each ``b'' raises size by one step. Example:
 \texttt{$\backslash$prnb$\{x\widehat\ 2-1\}$} gives $\prnb{x^2-1}$.
 
-\subsection{Adding ``l'' or ``r'' for one-sided delimiters}
-Prepend ``l'' (ell) or ``r'' to the front of the macro (after the backslash) for the single sided (\textbf{l}eft or \textbf{r}ight).  These macros take no parameter. Example: \texttt{$\backslash$lprnb}
-gives $\lprnb$.
+Save typing by prepending ``D'' to the start of a 
+command to use the \texttt{$\backslash$left$\dots\backslash$right}
+default sizing provided by \LaTeX. 
+Example: \texttt{$\backslash$Dprn$\{x\widehat\ 2-1\}$} gives
+ $\Dprn{x^2-1}$ while \texttt{$\backslash$Dprn$\{x-1\}$} gives $\Dprn{x-1}$. 
+
+\subsection{Adding ``L'' or ``R'' for one-sided delimiters}
+Prepend upper or lowercase ``L''  or upper or lowercase 
+``R'' to the front of the command (after the backslash) for the single 
+sided (\textbf{L}eft or \textbf{R}ight).  
+These commands take no parameter. Example: \texttt{$\backslash$Lprnb}
+gives $\Lprnb$. 
+
+There are no  one-sided versions of the \texttt{$\backslash$D...} commands.
 
 \subsection{Prepending a ``B'' for  boldface}
-Prepend a capital ``B'' to the front of the  macro for boldface (poor man's bold); if
-the macro is already a left or right, the ``B'' must preceed the ``l'' or ``r''. Needs a parameter if the
-non-bolded macro does. Example: \texttt{$\backslash$Blprnb} gives $\Blprnb$
+Prepend a capital ``B'' to the front of the  command for
+ boldface (poor man's bold); if
+the command is already a left or right, the ``B'' must 
+preceed the ``L'' or ``R''. Needs a parameter if the
+non-bolded command does. Example: \texttt{$\backslash$Blprnb} gives $\Blprnb$.
 
- \subsection{Warnings about paired delimeters}
- The paired delimeter macros take as a single parameter the expression to be inside of the pair. 
- Curley brackets around the expression will be essential here, as always in \LaTeX.
- See the examples below.
- 
- Paired delimiters cause an error if the alignment ampersand \& is used between them.
- The same issue arises with \texttt{$\backslash$left( --- \& -- $\backslash$right}), as you may have discovered.
- There may be other formatting characters which break paired delimeters; please let me know if you
- encounter an instance.
+This is not available for the $\backslash$\texttt{D\dots} commands.
+
+ \subsection{Ampersands (\&) not allowed inside paired delimeters} 
+ Paired delimiters cause an error if the alignment 
+ ampersand \& is used between them.
+ There may be other formatting characters which break 
+ paired delimeters; please let me know if you
+ encounter any.
  
- \subsubsection{Workarounds to the \& problem}
+ \textit{Workarounds}:
  \begin{enumerate}
  \item Rewrite. If you don't like the looks of
  \begin{align*}
@@ -87,96 +119,131 @@ non-bolded macro does. Example: \texttt{$\backslash$Blprnb} gives $\Blprnb$
  &\le\text{ another short one}\\
  &=\text{the final expression}
  \end{align*}
- perhaps you can break up the computations into smaller pieces so that you end with something like,
+ perhaps you can break up the computations into
+  smaller pieces so that you end with something like,
  `` putting (3.12)-(3.36) together we see that
  \[
- \int \text{A very very very very long  expression }\le \text{the final expression}.\text{''}
+ \int \text{A very very very very long  
+ expression }\le \text{the final expression}.\text{''}
  \]
  
- \item Use the left-right versions of the delimiters. They do not have the ampersand
-  problem that the two-sided versions and
- $\backslash$\texttt{left\dots$\backslash$right} do.
+ \item Use one-sided versions.
  
- \item Use $\backslash$\texttt{phantom}
+ \item Use $\backslash$\texttt{phantom}. For example,
   \begin{verbatim}
  &\int \text{A very very very very long  expression }
       \le \text{ a shorter one}\\
  &\phantom{\int \text{A very }}\le\text{the final expression}
   \end{verbatim}
-  to get
+  \vspace{-10pt}
+
+ gives
  \begin{align*}
  &\int \text{A very very very very long  expression }
       \le \text{ a shorter one}\\
  &\phantom{\int \text{A very }}\le\text{the final expression}
   \end{align*}
+  
  \end{enumerate}
-
-
+ 
 \section{Examples}
 \begin{enumerate}
 
 
-\item Here are two versions of the same display. The first uses $\backslash$\texttt{left $\backslash$right}; the
-second $\backslash$\texttt{sqprbbb}.
-I prefer the second one for being smaller, neater and using less typing. It's also much easier to change the size of the
- second (add or remove a \texttt{b}) than the first (replace \texttt{$\backslash$left[...$\backslash$right]} with
-  \texttt{$\backslash$bigg[...$\backslash$bigg]}).
+\item Here are two versions of the same displays. 
+The first pair uses $\backslash$\texttt{left $\backslash$right} (implemented through $\backslash$\texttt{Dsqpr}
+and $\backslash$\texttt{Dabs}); the
+second $\backslash$\texttt{sqprbbb} and $\backslash$\texttt{absbbb...}.
+I prefer the second pair for being using less vertical space and being more easily  resizable than the first.
  \[
- \left[ \sum_n\frac{x_n}{y_n}\right]^{1/2}\quad \sqprbbb{\sum_n\frac{x_n}{y_n}}^{1/2}
+ \left[ \sum_n\frac{x_n}{y_n}\right]^{1/2}
+ \quad  \Dabs{\int_a^b\prnbb{\frac{x+1}{x^2+5}}^p  dx}^{1/p}
+ \]
+ \[
+ \sqprbb{\sum_n\frac{x_n}{y_n}}^{1/2}\quad
+\absbbb{\int_a^b\prnbb{\frac{x+1}{x^2+5}}^p  dx}^{1/p}
  \]
- 
  \item Bold vs. default:
  \[
   \Bprnbb{\frac x{x^2+1}} \quad  \prnbb{\frac x{x^2+1}} \quad
   \Bcrlbb{\frac x{x^2+1}} \quad  \crlbb{\frac x{x^2+1}} 
- \]
+ \] 
+ \end{enumerate}
  
- \medbreak
- \item
- \begin{verbatim}\sqprbbb{\int_a^b\prnbb{\frac{x+1}{x^2+5}}^p  dx}^{1/p}
-\text{,\  }\nrmbbbb{\crlbbb{\crlbb{\crlb{\crl{x-y}}}}}\text{ and } 
-  \lcrlbbbb\lsqprbbb\labsbb\lprnb \lngl
-  \end{verbatim}
-  \vskip-.3in
-  gives
- \[
- \sqprbbb{\int_a^b\prnbb{\frac{x+1}{x^2+5}}^p  dx}^{1/p} \text{,\  }\nrmbbbb{\crlbbb{\crlbb{\crlb{\crl{x-y}}}}}\text{ and } 
-  \lcrlbbbb\lsqprbbb\labsbb\lprnb \lngl
- \]
 
- \end{enumerate}
  The \texttt{tex} source for this PDF contains more examples, commented out.
  
  \section{Further comments}
  \subsection{An alternate package, \textit{delim}}
  The package \textit{delim} by Stefan Majewsky 
- does things this one does, in a somewhat different way, and may be preferred by many \TeX\ users.
- You can find this package by browsing CTAN under ``D''.
+ does things this one does
+ and may be preferred by many \LaTeX\ users.
  
+ \subsection{Bionomial coefficients  and reversed delimiters}
+  
+ Binomial coefficients often display with overly large parens. Versions under your control
+ are supplied.
  
- \subsection{Reversed parens}
  At one time one saw open intervals expressed as
  \[
  \nrp{a,b} \quad\text{ or }\quad \rpqs{c,d}.
  \]
- This package provides paired delimeters at the 5 sizes, with and without bold face, for those two
- situations. The macros are \texttt{$\backslash$nrp} and \texttt{$\backslash$rpqs}, followed by one to four 
- ``b''s for  larger sizes and prepended by an optional  ``B'' for the bold face versions. No single sided 
- reversed macros are given.
- 
+ This package provides paired delimeters at the 5 sizes,
+  with and without bold face, for those two
+ situations.
+ \begin{equation*}
+ \begin{matrix}
+\text{The command}&	\quad\text{ typesets as }&\quad \text{common name}&\quad \text{Sizes/BF version}\\
+ \texttt{$\backslash$bnom$\{\#1\}\{\#2\}$}&\bnom{\#1}{\#2}&\text{binomial coefficient}&5/yes\\\\
+ \texttt{$\backslash$bnomsq$\{\#1\}\{\#2\}$}&\bnomsq{\#1}{\#2}&\text{binomial coefficient}&5/yes\\\\
+ \texttt{$\backslash$bnomcrl$\{\#1\}\{\#2\}$}&\bnomcrl{\#1}{\#2}&\text{binomial coefficient}&5/yes\\\\
+ \texttt{$\backslash$bnomngl$\{\#1\}\{\#2\}$}&\bnomngl{\#1}{\#2}&\text{binomial coefficient}&5/yes
+ \\
+ \texttt{$\backslash$nrp\{$\backslash$\#1\}} &\nrp{\texttt{\#1}}& \text{reversed parens}&5/yes\\
+\texttt{$\backslash$rpqs\{$\backslash$\#1\}} & \rpqs{\texttt{\#1}}&\text{reversed square braces}&5/yes
+ \end{matrix}
+ \end{equation*}
+
  
- \subsection{Adding other delimiters}
- Just copy the model here. In making the $\backslash$\texttt{B}... versions I have used 
+\subsection{More delimiters, including 2 for Valentine's Day}
+ \begin{equation*}
+ \begin{matrix}
+\text{The command}&	\quad\text{ typesets as }&\quad \text{common name}&\quad \text{Sizes/BF version}
+ \\
+\backslash\texttt{stgt\{$\backslash$\#1\}} &\texttt{< \#1>}     & \text{lessthan greaterthan}&5/yes\\
+\backslash\texttt{llgg\{$\backslash$\#1\}} &\texttt{$\ll$\#1$\gg$}&\text{muchless muchmore}&5/yes\\
+\backslash\texttt{valentine\{$\backslash$\#1\}}&\valentine{\texttt{\#1}} &\text{surrounded by love}&1/no\\
+\backslash\texttt{diamondsgbf\{$\backslash$\#1\}}&\diamondsgbf{\texttt{\#1}}& \text{buried in diamonds}&1/no
+ \end{matrix}
+ \end{equation*}
+
+ To make your own delimiter pairs, just adapt the models in the 
+ \texttt{sty} file. 
+ Note that the $\backslash$\texttt{B}... versions use
  $\backslash$\texttt{pmb} (poor man's bold)
- throughout because $\backslash$\texttt{boldsymbol}, though recommended (e.g., by Gr\"atzer)
- for many situations, 
- does not work for all delimiters, while poor man's bold does.
- 
+ throughout because $\backslash$\texttt{boldsymbol}
+ does not work for all delimiters, while  $\backslash$\texttt{pmb}
+ does. Some ``delimiters'' may not have 
+ $\backslash$\texttt{big}(ger) versions so you will have to improvise, as here for
+  $\ll\dots\gg$.
+The larger versions of  $\ll\dots\gg$  do not look great; they merely illustrate what can be naively
+ achieved.
  
+ The  two Valentine delimiters  must be in Math mode. If your beloved's name has spaces, 
+ you will need to protect
+ the space(s) by preceding each one with
+  a $\backslash$\texttt{backslash} since
+ Math mode ignores unprotected spaces. The Valentines commands can be nested at least once:
+ \[
+\valentine{\ \diamondsgbf{\ Kim\ }\ }\qquad {\diamondsgbf{\ \valentine{Leslie}\ }}
+\qquad\valentine{\valentine{\valentine{\ \valentine{ Deniz }\ }}}.
+\]
+ Adjusting the space in the various pairs with $\backslash{\ }$'s  may improve the look.
 \subsection{Easy to remember sizers}
 \texttt{delimseasy} includes 
 versions of \LaTeX's 
 built-ins:
+
 \[\begin{matrix}
 \text{New}&\text{\LaTeX\ built-in}\\
    &\texttt{$\backslash$big}\\
@@ -184,7 +251,18 @@ built-ins:
 \backslash\texttt{bigbb} &\texttt{$\backslash$bigg}\\
 \backslash\texttt{bigbbb}&\texttt{$\backslash$Bigg}
 \end{matrix}\]
- 
+\subsection{Revision history}
+2016/02/01. Added capital ``L'' and capital ``R'' option for
+single sided. Removed manual's references to ``l'' and ``r'' versions though
+they remain implemented for backward compatibility.
+
+Added ``D'' versions for those who prefer \LaTeX's choice for sizing.
+
+Added new delimiters: $\bnom{p+q}{q}$, $\llgg{\dots}$,  $\valentine{\dots}$ and $\diamondsgbf{\dots}$.
+
+Added this subsection and information about the new delimiters.
+
+Many minor stylistic changes to manual.
  \begin{comment}% testing, testing.........
  reverse parens
  \begin{align*}
@@ -266,6 +344,40 @@ built-ins:
 &\quad\Brnglbbbb{\Brnglbbb{\Brnglbb{\Brnglb{\Brngl{}}}}}\\
 \Brabsbbbb{\Brabsbbb{\Brabsbb{\Brabsb{\Brabs{}}}}}
 &\quad \Brnrmbbbb{\Brnrmbbb{\Brnrmbb{\Brnrmb{\Brnrm{}}}}}
+\\
+&\llgg{\llggb{\llggbb{X}}}%\llggbbb{\llggbbbb{X}}}}}\\
+&\Bllgg{\Bllggb{\Bllggbb{\Bllggbbb{\Bllggbbbb{X}}}}}
 \end{align*}
- \end{comment}
-\end{document}  for testing
+\[
+ \bnom{{x+y}}{x}\quad\bnomb{x+y}{x}\quad\bnombb{x+y}{x}\quad\bnombbb{x+y}{x}\quad\bnombbbb{x+y}{x}
+ \]
+ \[
+ \Bbnom{{x+y}}{x}\quad\Bbnomb{x+y}{x}\quad\Bbnombb{x+y}{x}\quad\Bbnombbb{x+y}{x}\quad\Bbnombbbb{x+y}{x}
+ \]
+ 
+ \[
+ \bnomsq{{x+y}}{x}\quad\bnomsqb{x+y}{x}\quad\bnomsqbb{x+y}{x}\quad\bnomsqbbb{x+y}{x}\quad\bnomsqbbbb{x+y}{x}
+ \]
+ \[
+ \Bbnomsq{{x+y}}{x}\quad\Bbnomsqb{x+y}{x}\quad\Bbnomsqbb{x+y}{x}\quad\Bbnomsqbbb{x+y}{x}\quad\Bbnomsqbbbb{x+y}{x}
+ \] 
+ \[
+ \bnomcrl{{x+y}}{x}\quad\bnomcrlb{x+y}{x}\quad\bnomcrlbb{x+y}{x}\quad\bnomcrlbbb{x+y}{x}\quad\bnomcrlbbbb{x+y}{x}
+ \]
+ \[
+ \Bbnomcrl{{x+y}}{x}\quad\Bbnomcrlb{x+y}{x}\quad\Bbnomcrlbb{x+y}{x}\quad\Bbnomcrlbbb{x+y}{x}\quad\Bbnomcrlbbbb{x+y}{x}
+ \]
+  \[
+ \bnomngl{{x+y}}{x}\quad\bnomnglb{x+y}{x}\quad\bnomnglbb{x+y}{x}\quad\bnomnglbbb{x+y}{x}\quad\bnomnglbbbb{x+y}{x}
+ \]
+ \[
+ \Bbnomngl{{x+y}}{x}\quad\Bbnomnglb{x+y}{x}\quad\Bbnomnglbb{x+y}{x}\quad\Bbnomnglbbb{x+y}{x}\quad\Bbnomnglbbbb{x+y}{x}
+ \]
+ \\[
+ \Dprn{\int}\quad\Dsqpr{\int}\quad\Dcrl{\int}\quad\Dngl{\int}
+ \]
+ \[
+ \Dceil{3}\quad\Dflr{pp}\quad\Dabs{\int}\quad\Dnrm{\int}\quad\Dstgt{kk}
+ \]
+ \end{comment} %end of testing
+\end{document}