Debian Codegraph @

texmf-dist/source/latex/nchairx/chairxmathDelimitersDoc.dtx

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 2018 - 2021 by ChairX
4 %
5 % This file may be distributed and/or modified under the
6 % conditions of the LaTeX Project Public License, either
7 % version 1.3 of this license or (at your option) any later
8 % version. The latest version of this license is in:
9 %
10 % http://www.latex-project.org/lppl.txt
11 %
12 % and version 1.3 or later is part of all distributions of
13 % LaTeX version 2005/12/01 or later.
14 %
15 % This file contains the documentation of new delimiters.
16 %
17 % Macros have to be described by (delete the first %)
18 % \DescribeMacro{\macro}
19 % Description and usage of the macro.
20 %
21 % The description will appear in the usage
22 % part of the documentation. Use \subsubsection{} etc. for structuring.
23 %
24 % The implementation of the macros defined here has to be written in
25 % chairxmathDelimitersDoc.dtx
26 %\fi
27 %
28 %
29 % We use |\DeclarePairedDelimiters| to generate all kind of bracket
30 % expressions of variable size as used e.g. in differential
31 % geometry. This has the big advantage that one has two options to set
32 % the size of the brackets: either with an explicit optional argument
33 % |\big|, \ldots, |\Bigg|, |\vast|, or |\Vast| like
34 % \begin{quote}
35 % |\Schouten[\vast]{X, Y}|: $\Schouten[\vast]{X, Y}$
36 % \end{quote}
37 % or you can use the *-version which produces automatic sizes via
38 % |\left| and |\right|.
39 % \begin{quote}
40 % |\abs*{\lim\limits_{n\to\infty} b_n}|
41 % yields
42 % $\abs*{\lim\limits_{n\to\infty} b_n}$
43 % \end{quote}
44 % Note, however, that this will typically result in sub-optimal
45 % spacing. Also, the brackets turn out to be typically too large.
46 %
47 %
48 % Note that using the bracket constructions with
49 % |\DeclarePairedDelimiters| gives typically much better spacing than
50 % doing things by hand:
51 % \DeleteShortVerb{\|}
52 % \begin{quote}
53 % good \verb|\abs{\det(A)}|:
54 % $\abs{\det(A)}$
55 % \qquad
56 % bad \verb+|\det(A)|+:
57 % $|\det(A)|$
58 % \end{quote}
59 % \MakeShortVerb{\|}
60 %
61 %
62 % \DescribeMacro{\vast}
63 % \DescribeMacro{\Vast}
64 % \DescribeMacro{\vastl}
65 % \DescribeMacro{\vastm}
66 % \DescribeMacro{\vastr}
67 % \DescribeMacro{\Vastl}
68 % \DescribeMacro{\Vastm}
69 % \DescribeMacro{\Vastr}
70 % In many formulas one needs large delimiters typically ranging from
71 % |\big| to |\Bigg|. However, in very large formula constructions even
72 % that is not enough. To have a systematic enlargement the following
73 % delimiters sizes are introduced: |\vast| and |\Vast| together with
74 % the corresponding helper macros |\vastl|, |\vastr|, |\vastm|,
75 % |\Vastl|, |\Vastr|, and |\Vastm| needed to define pairs of
76 % delimiters. They allow to produce large (pairs of) delimiters,
77 % always provided that the corresponding font has the symbols in the
78 % correct size.
79 %
80 %
81 % The following commands allow for an option size argument:
82 % \begin{itemize}
83 % \item Absolute value |\abs|
84 % \item Generic norm |\norm|
85 % \item Supremum norm |\supnorm|
86 % \item Essential supremum norm |\essupnorm|
87 % \item Dirac ket |\ket|
88 % \item Dirac bra |\bra|
89 % \item Dirac ketbra |\ketbra|
90 % \item Dirac braket |\braket|
91 % \item Schouten bracket |\Schouten|
92 % \item Nijenhuis-Richardson bracket |\NRbracket|
93 % \item Frölicher-Nijenhuis bracket |\FNbracket|
94 % \item Courant bracket |\Courant|
95 % \item Dorfman bracket |\Dorfman|
96 % \item Generic scalar product |\SP|
97 % \item Generic inner product with decorations |\IP|
98 % \item Restriction of a map |\at|
99 % \item Étalé space of a presheaf |\etale|
100 % \end{itemize}
101 %