braket doc update, own package (21feb09)

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

3 files changed, 58 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/braket/braket.pdf b/Master/texmf-dist/doc/latex/braket/braket.pdf
new file mode 100644
index 00000000000..6fbf5f51cd4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/braket/braket.pdf
diff --git a/Master/texmf-dist/doc/latex/braket/braket.tex b/Master/texmf-dist/doc/latex/braket/braket.tex
new file mode 100644
index 00000000000..6b4f4a3bd63
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/braket/braket.tex
@@ -0,0 +1,58 @@
+\documentclass[parskip=half, pagesize=auto, version=last]{scrartcl}
+
+\usepackage{fixltx2e}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage{array}
+\usepackage{braket}
+\usepackage{microtype}
+
+\addtokomafont{title}{\rmfamily}
+
+\title{The \textsf{braket} package}
+\subtitle{Macros for Dirac bra--ket $\langle\mid\rangle$ notation and sets $\lbrace\mid\rbrace$}
+\author{Donald Arseneau\\\texttt{asnd@triumf.ca}}
+\date{12--Sept--2006}
+
+
+\begin{document}
+
+\maketitle
+
+Commands defined are:
+
+\begin{tabular}{@{}*{4}{>{\ttfamily\textbackslash}c<{\{~\}}}>{(}l<{~versions)}@{}}
+  bra & ket & braket & set & small \\
+  Bra & Ket & Braket & Set & expanding
+\end{tabular}
+
+The ``small versions'' use fixed-size brackets independent of their
+contents, whereas the ``expanding versions'' make the brackets and 
+vertical lines expand to envelop their contents (internally using 
+the \verb+\left+ and \verb+\right+ commands).  You should use the vertical bar
+character ``\verb+|+'' to input any extra vertical lines.  In \verb+\Braket+ these
+vertical lines will expand to match the arguments, and in \verb+\Set+ the
+first vertical will expand.  E.\,g.,
+
+\begingroup
+\renewcommand*{\arraystretch}{1.7}
+\setlength{\tabcolsep}{10pt}
+\begin{tabular}{@{}>{\footnotesize}r>{$\displaystyle}l<{$}@{}}
+  \verb+\Braket{ \phi | \frac{\partial^2}{\partial t^2} | \psi }+ & \Braket{ \phi | \frac{\partial^2}{\partial t^2} | \psi } \\
+  \verb+\Set{ x\in\mathbf{R}^2 | 0<{|x|}<5 }+                     & \Set{ x\in\mathbf{R}^2 | 0<{|x|}<5 }                    \\
+\end{tabular}
+\endgroup
+
+Likewise, you may make an expandable double-bar using either
+the ``\verb+\|+'' command or its local alias ``\verb+||+''.
+
+NOT defined is ``\verb+\ketbra+'' (for projection operators) because I prefer
+\verb+\ket{ } \bra{ }+.
+
+Because each definition is so small, it makes no sense to have a 
+complicated generic version for many bracket styles.  Instead, 
+you can just copy the definitions and change \verb+\langle+ or \verb+\rangle+,
+to what you like.
+
+\end{document}
diff --git a/Master/texmf-dist/tex/latex/ltxmisc/braket.sty b/Master/texmf-dist/tex/latex/braket/braket.sty
index b3f338847a5..b3f338847a5 100644
--- a/Master/texmf-dist/tex/latex/ltxmisc/braket.sty
+++ b/Master/texmf-dist/tex/latex/braket/braket.sty