summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/delimseasy
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-12-04 23:36:40 +0000
committerKarl Berry <karl@freefriends.org>2015-12-04 23:36:40 +0000
commit971fb26171aa3b19cbf53faf423175477a818ea7 (patch)
tree497fe2c35332d4480b25dd3f74da3c9be7426836 /Master/texmf-dist/doc/latex/delimseasy
parentc057b22ae349a7d9a35965f6d11446cd710c441c (diff)
delimseasy (4dec15)
git-svn-id: svn://tug.org/texlive/trunk@39015 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/delimseasy')
-rw-r--r--Master/texmf-dist/doc/latex/delimseasy/README.txt24
-rw-r--r--Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdfbin0 -> 203460 bytes
-rw-r--r--Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.tex271
3 files changed, 295 insertions, 0 deletions
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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/delimseasy/delimseasyMan.pdf
Binary files 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