From 5f119d1b3f347f6e95f7065495cfe442c189db57 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 5 Feb 2016 23:34:02 +0000 Subject: delimseasy (5feb16) git-svn-id: svn://tug.org/texlive/trunk@39589 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/delimseasy/README.txt | 10 +- .../doc/latex/delimseasy/delimseasyMan.pdf | Bin 203460 -> 228076 bytes .../doc/latex/delimseasy/delimseasyMan.tex | 288 ++++++++++++++------- 3 files changed, 208 insertions(+), 90 deletions(-) (limited to 'Master/texmf-dist/doc') 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 Binary files a/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf and b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf differ 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} -- cgit v1.2.3