From 971fb26171aa3b19cbf53faf423175477a818ea7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 4 Dec 2015 23:36:40 +0000 Subject: delimseasy (4dec15) git-svn-id: svn://tug.org/texlive/trunk@39015 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/delimseasy/README.txt | 24 ++ .../doc/latex/delimseasy/delimseasyMan.pdf | Bin 0 -> 203460 bytes .../doc/latex/delimseasy/delimseasyMan.tex | 271 +++++++++++++++++++++ 3 files changed, 295 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/delimseasy/README.txt create mode 100644 Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf create mode 100644 Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.tex (limited to 'Master/texmf-dist/doc/latex/delimseasy') diff --git a/Master/texmf-dist/doc/latex/delimseasy/README.txt b/Master/texmf-dist/doc/latex/delimseasy/README.txt new file mode 100644 index 00000000000..de58124ee1e --- /dev/null +++ b/Master/texmf-dist/doc/latex/delimseasy/README.txt @@ -0,0 +1,24 @@ +Delimseasy 1.0 +=============== + +This package contains the following files: + +README - this document + +delimseasyMan.pdf - the pdf version of the manual + +delimseasyMan.tex - LaTeX source of the preceding; includes examples that are commented out + +delimseasy.sty - the delims package + +delimseasy is a package to make it simple and fast to change the size of delimiters and their blackness. Further information is in delimseasyMan. + +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. + + +Colin C. Graham +ccgraham@alum.mit.edu +2015-12-02 + diff --git a/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf new file mode 100644 index 00000000000..29c876b0b58 Binary files /dev/null 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 new file mode 100644 index 00000000000..a007211556a --- /dev/null +++ b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.tex @@ -0,0 +1,271 @@ +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% Manual for the package delimseasy.sty +% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\documentclass{amsart} +\usepackage{verbatim} +\usepackage{delimseasy} + % + \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}} +\begin{document} + +\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} +{\smaller +\tableofcontents} + +\vskip-.7truein +\section{Installation and the basic delimiters} +Put \texttt{delimseasy.sty} in a convenient folder and +add +\texttt{$\backslash$usepackage\{delimseasy\}} + to your preamble. If \LaTeX \ can't find the \texttt{sty} file, + move it to the folder of your \texttt{tex} file +or add a \texttt{PATH} to the \texttt{$\backslash$usepackage} parameter, so you have (for example) +\newline +\texttt{$\backslash$usepackage\{C:/user/YOU/Documents/WHEREYOUPUTIT/delimseasy\}}. + +\medskip +Here are the basic macros: +\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} +\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: +\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$. + +\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$ + + \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. + + \subsubsection{Workarounds to the \& problem} + \begin{enumerate} + \item Rewrite. If you don't like the looks of + \begin{align*} + \int \text{A very very very very long expression }&\le \text{ a shorter one}\\ + &\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, + `` putting (3.12)-(3.36) together we see that + \[ + \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 $\backslash$\texttt{phantom} + \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 + \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]}). + \[ + \left[ \sum_n\frac{x_n}{y_n}\right]^{1/2}\quad \sqprbbb{\sum_n\frac{x_n}{y_n}}^{1/2} + \] + + \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}} + \] + + \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''. + + + \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. + + + \subsection{Adding other delimiters} + Just copy the model here. In making the $\backslash$\texttt{B}... versions I have used + $\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. + + +\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}\\ +\backslash\texttt{bigb} &\texttt{$\backslash$Big}\\ +\backslash\texttt{bigbb} &\texttt{$\backslash$bigg}\\ +\backslash\texttt{bigbbb}&\texttt{$\backslash$Bigg} +\end{matrix}\] + + \begin{comment}% testing, testing......... + reverse parens + \begin{align*} + \nrp{ + \nrpb{ + \nrpbb{ + \nrpbbb{ + \nrpbbbb{w}}}}} +%%%%%%%%%%%%% +% reverse bold paired square braces + \rpqs{ + \rpqsb{ + \rpqsbb{ + \rpqsbbb{ + \rpqsbbbb{z}}}}} +% +\end{align*} + % + + stgt's + \begin{align*} +& +\rstgt +\rstgtbb +\rstgtbbb +\rstgtbbbb +%% +\Brstgt +\Brstgtb +\Brstgtbb +\Brstgtbbb +\Brstgtbbbb\\ +& \stgt{\stgtb{\stgtbb{\stgtbbb{\stgtbbbb{w}}}}}\\ +&\Bstgt{\Bstgtb{\Bstgtbb{\Bstgtbbb{\Bstgtbbbb{w}}}}}\\ +& +\lstgt +\lstgtb +\lstgtbb +\lstgtbbb +\lstgtbbbb +%% +\Blstgt +\Blstgtb +\Blstgtbb +\Blstgtbbb +\Blstgtbbbb + \end{align*} + + parens, etc: +\begin{align*} +\Bprn{\Bprnb{\Bprnbb{\Bprnbb{\Bprnbbb{\Bprnbbb{}}}}}}&\quad\ +\end{align*}\begin{align*} + \Bsqpr{\Bsqprb{\Bsqprbb{\Bsqprbbb{\Bsqprbbbb{x}}}}}\\ + \end{align*}\begin{align*} +\Bcrl{\Bcrlb{\Bcrlbb{\Bcrlbbb{\Bcrlbbbb{z}}}}} +\end{align*}\begin{align*} +&\quad +\Bflr{\Bflrb{\Bflrbb{\Bflrbbb{\Bflrbbb{47}}}}}\\ +\Bceil{\Bceilb{\Bceilbb{\Bceilbbb{\Bceilbbbb{2}}}}}&\quad\Bnglbbbb{\Bnglbbb{\Bnglbb{\Bnglb{\Bngl{x|y}}}}}\\ +\end{align*} +\begin{align*} +\Babsbbbb{\Babsbbb{\Babsbb{\Babsb{\Babs{f}}}}}&\quad \Bnrmbbbb{\Bnrmbbb{\Bnrmbb{\Bnrmb{\Bnrm{z}}}}}\\ +%\cardbbbb{\cardbbb{\cardbb{\cardb{\card{x}}}}}\\ +\Blprn{\Blprnb{\Blprnbb{\Blprnbb{\Blprnbbb{\Blprnbbb{x}}}}}}&\quad \Blsqpr{\Blsqprb{\Blsqprbb{\Blsqprbbb{\Blsqprbbbb{}}}}}\\ +\Blcrl{\Blcrlb{\Blcrlbb{\Blcrlbbb{\Blcrlbbbb{}}}}}&\quad +\Blflr{\Blflrb{\Blflrbb{\Blflrbbb{\Blflrbbb{}}}}}\\ +\end{align*} +\begin{align*} +\Blceil{\Blceilb{\Blceilbb{\Blceilbbb{\Blceilbbbb{}}}}} +&\quad\Blnglbbbb{\Blnglbbb{\Blnglbb{\Blnglb{\Blngl{x|y}}}}}\\ +\end{align*} +\begin{align*} +\Blabsbbbb{\Blabsbbb{\Blabsbb{\Blabsb{\Blabs{}}}}} +&\quad \Blnrmbbbb{\Blnrmbbb{\Blnrmbb{\Blnrmb{\Blnrm{}}}}}\\ +\Brprn \Brprnb \Brprnbb \Brprnbb\Brprnbbb\Brprnbbb&\quad\ \Brsqpr{\Brsqprb{\Brsqprbb{\Brsqprbbb{\Brsqprbbbb{}}}}}\\ +\Brcrl{\Brcrlb{\Brcrlbb{\Brcrlbbb{\Brcrlbbbb{}}}}}&\quad +\Brflr{\Brflrb{\Brflrbb{\Brflrbbb{\Brflrbbb{}}}}}\\ +\Brceil{\Brceilb{\Brceilbb{\Brceilbbb{\Brceilbbbb{}}}}} +&\quad\Brnglbbbb{\Brnglbbb{\Brnglbb{\Brnglb{\Brngl{}}}}}\\ +\Brabsbbbb{\Brabsbbb{\Brabsbb{\Brabsb{\Brabs{}}}}} +&\quad \Brnrmbbbb{\Brnrmbbb{\Brnrmbb{\Brnrmb{\Brnrm{}}}}} +\end{align*} + \end{comment} +\end{document} for testing -- cgit v1.2.3