From 8b8a5ec42a2b505d7e21eb76bc3c60ce1a665cbd Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Fri, 8 Aug 2008 00:11:15 +0000
Subject: dlfltxb update (7aug08)

git-svn-id: svn://tug.org/texlive/trunk@10155 c570f23f-e606-0410-a88d-b1316a301751
---
 .../doc/latex/dlfltxb/dlfltxbcodetips.tex          | 107 +++++++++++++++++++--
 1 file changed, 99 insertions(+), 8 deletions(-)

(limited to 'Master/texmf-dist/doc/latex/dlfltxb/dlfltxbcodetips.tex')

diff --git a/Master/texmf-dist/doc/latex/dlfltxb/dlfltxbcodetips.tex b/Master/texmf-dist/doc/latex/dlfltxb/dlfltxbcodetips.tex
index 076b35305bb..0f584e617e1 100644
--- a/Master/texmf-dist/doc/latex/dlfltxb/dlfltxbcodetips.tex
+++ b/Master/texmf-dist/doc/latex/dlfltxb/dlfltxbcodetips.tex
@@ -11,7 +11,7 @@
 
 \setlrmargins{*}{*}{0.7}
 \setulmargins{*}{*}{1}
-\setlength\marginparwidth{4cm}
+\setlength\marginparwidth{3.5cm}
 
 \checkandfixthelayout
 
@@ -25,7 +25,9 @@
 \definecolor{linkcolour}{rgb}{0,0.2,0.6}
 \definecolor{citecolour}{rgb}{0,0.6,0.2}
 \definecolor{urlcolour} {rgb}{0.8,0,0.8}
-  
+\definecolor{nicered}{rgb}{.647,.129,.149}
+
+
 \hypersetup{
   pdftitle={The dlfltxbcodetips package},
   pdfauthor={Copyright \textcopyright\ \number\year\ Lars Madsen},
@@ -47,6 +49,8 @@
 \usepackage[round]{natbib}
 
 \usepackage{dlfltxbcodetips}
+\OverloadUnderscoreInMath
+
 \usepackage[loadsampleconfig]{dlfltxbmarkup}
 \renewcommand\felineMarginAdjustment{\RaggedLeft}
 
@@ -117,6 +121,11 @@
 
 
 \pagestyle{plain}
+\newcommand\note[1]{\textcolor{nicered}{\sffamily #1}}
+
+
+\hyphenation{Provide-PGF-Pages-Four-On-One-With-Space-For-Notes}
+\hyphenation{Overload-Underscore-In-Math}
 
 \begin{document}
 
@@ -321,6 +330,10 @@ might become a problem.
    h(x) & = 0
 \end{alignat}
 \end{sourcedisplay}
+\noindent\note{This macro have been added to the mathtools package, and will be
+  available with the next mathtools release, afterwhich it will be
+  removed from this package.}
+
 
 
 \section{Switch dead space}
@@ -387,18 +400,22 @@ and
   &\qquad{}\otimes\dbx[6cm]\,.
 \end{align*}
 But having to do all those indentations by hand quickly becomes quite
-dull. Instead, align everything to the left, and pull back the first
+tedious. Instead, align everything to the left, and pull back the first
 line. This is what the following macro does.
+
+\note{Please note that this macro have been added to the
+mathtools package and will be available with the next release of
+mathtools, afterwhich it will be removed from this package.}
 \begin{syntax}
-  \markup{PullBack}\oarg{number}
+  \markup{MoveEqLeft}\oarg{number}
 \end{syntax}
 The optional argument is a number (without unit, em will be used)
 indicating the amount of indentation. 2\,em is the default. Now simply
-use \markup[nomk]{PullBack} instead of the >>\texttt{\&}<< on the
+use \markup[nomk]{MoveEqLeft} instead of the >>\texttt{\&}<< on the
 first line.
 \begin{sourcedisplay}
 \begin{align*}
-  \PullBack f(x) + g(x) + \dbx[4cm] \\
+  \MoveEqLeft f(x) + g(x) + \dbx[4cm] \\
   & = \dbx[5cm] \\
   & = \dbx[5cm] 
 \end{align*}
@@ -407,7 +424,7 @@ The optional argument is usually used whenever the alignment is moved
 to the right of the equal signs.
 \begin{sourcedisplay}
 \begin{align*}
-  \PullBack[3] f(x) + g(x) + \dbx[4cm] \\
+  \MoveEqLeft[3] f(x) + g(x) + \dbx[4cm] \\
    ={} & \dbx[5cm] \\
    & + \dbx[5cm] 
 \end{align*}
@@ -478,7 +495,55 @@ Of course, non-balanced \markup[nomk]{left}--\markup[nomk]{right}
 constructions may not be used.
 
 
-\chapter{Additional layout for the \textsf{pfgpages} package}
+
+
+\chapter{Declaring sets}
+\label{cha:declaring-sets}
+
+It is a good idea to avoid the one (or two) letter shortcuts for sets
+etc., e.g.\ \verb+\R+ for \verb+\mathbb{R}+, it can cause problems
+when co-writing articles with people with other naming habits. 
+
+To help with this we provide 
+\begin{syntax}
+\markup{DeclareMathSet}\oarg{options}\marg{identifier}
+\end{syntax}
+By default it can be used as
+\begin{Sourcedisplay}
+\DeclareMathSet{R}% => \setR = \mathbb{R}
+$ \setR $  
+\end{Sourcedisplay}
+But we have several options to change things. Options
+(\Arg{key}=\Arg{value} style, note that \Arg{identifier} is what is
+given to the formating macro).
+\begin{description}\firmlist
+\item[format] the macro used to format the output, default: \verb|\mathbb|
+\item[name] this defaults to \Arg{identifier}, but can be used to
+  change a part of the macro name,
+  e.g. \verb+\DeclareMathSet[name=Cat,format=\matcal]{C}+ results in
+  \verb+\setCat=\mathcal{C}+. 
+\item[prefix] this defaults to \verb+set+, but one might want to use
+  \begin{syntax}
+    \verb+\DeclareMathSet[prefix=group,format=\mathrm]{U}+
+  \end{syntax}
+to get
+  \verb+\groupU+, the unitary group.
+\item[overwrite] boolean, if true, then you can overwrite an existing
+  macro, otherwise it will throw an error.
+ 
+\end{description}
+Note that for sets it is not a good idea to declare them as math
+operators, as some mathematical operations take sets as their
+argument, so the spacing before an operator would be wrong in that
+case.
+
+\note{Note that this will also be added to the mathtools package, and
+  then removed from this package}
+
+\chapter{Misc}
+\label{cha:misc}
+
+\section{Additional layout for the \textsf{pfgpages} package}
 \label{sec:addit-layo-textsfpfg}
 
 The macro \markup{ProvidePGFPagesFourOnOneWithSpaceForNotes} will
@@ -487,6 +552,18 @@ with the \markup[sty,nomk]{pgfpages} package. It is basically the same
 as the >>\verb*+8 on 1+<< layout but leaving the second column empty
 for reader to fill in their own notes.
 
+\section{Overloading \texttt{\_} in math-mode}
+\label{sec:overl-texttt_-math}
+
+Placing \markup{OverloadUnderscoreInMath} in the preamble will
+overload the \texttt{\_} character in math-mode such that 
+\begin{Sourcedisplay}
+\[
+   X_{ab} = X_|max|  
+\]
+\end{Sourcedisplay}
+that is \verb+_|...|+ is that same as \verb+_{\textup{...}}+. 
+
 \bibliographystyle{plainnat}
 \bibliography{package_doc}
 
@@ -501,3 +578,17 @@ for reader to fill in their own notes.
 %%% TeX-PDF-mode: nil
 %%% End: 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-- 
cgit v1.2.3

