summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/units/units.dtx
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2006-10-17 22:40:33 +0000
committerNorbert Preining <preining@logic.at>2006-10-17 22:40:33 +0000
commit168c4abebd344cda13d71257a8f5882ddf75b461 (patch)
tree8a77f74ef5ce60f97952ee40ab54953f76140dbd /Master/texmf-dist/source/latex/units/units.dtx
parentabf72be1c8d2ecea135ae14dcbdff593a8496321 (diff)
various additions to tpm-ctan-check, and updated to packages
unitsdef, undertilde, ushort, units, umich-thsis, uiucthesis git-svn-id: svn://tug.org/texlive/trunk@2343 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/units/units.dtx')
-rw-r--r--Master/texmf-dist/source/latex/units/units.dtx42
1 files changed, 28 insertions, 14 deletions
diff --git a/Master/texmf-dist/source/latex/units/units.dtx b/Master/texmf-dist/source/latex/units/units.dtx
index c3ed958aaaa..e63a7554275 100644
--- a/Master/texmf-dist/source/latex/units/units.dtx
+++ b/Master/texmf-dist/source/latex/units/units.dtx
@@ -10,6 +10,9 @@
%
% \CheckSum{174}
%
+% \changes{v0.9a}{1998-06-25}{First release}
+% \changes{v0.9b}{1998-08-04}{Documentation update}
+%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
@@ -34,7 +37,7 @@
%
% \title{\file{units.sty} -- \file{nicefrac.sty}}
% \author{Axel Reichert}
-% \date{1998-06-25}
+% \date{1998-08-04}
% \maketitle
% \begin{abstract}
% \file{units.sty} is a package for setting units in a
@@ -91,6 +94,12 @@
% formula into such a fraction, you have misunderstood the purpose
% of this package. \winkey
%
+% A common mistake is to forget the enclosing braces when using the
+% optional argument of the commands inside another optional
+% argument. This is no package bug, but a \LaTeX{} feature. Correct
+% example: |\section[{\unit[1]{m}}]{...}|.\footnote{Credits go to
+% \person{Frank Knappe} for suggesting this documentation update.}
+%
% It is very important to be aware of the fact that all these
% commands distinguish between text mode and math mode. Within text
% mode, the font of the surrounding text will be used by default,
@@ -152,17 +161,17 @@
% ``\unit{m}'' is meter, ``$m$'' is a variable, for example a mass.
%
% Why should the space between the value and the dimension be
-% non-breakable? Because the reader is disturbed by linebreaks like
+% non-breakable? Because the reader is disturbed by linebreaks like
% 1 $\mathrm{m}$.
%
% Why should the space between the value and the dimension be a
-% half word space only? Because things belonging together are
+% half word space only? Because things belonging together are
% typeset tighter. Compare \unit[1]{m} with 1~m and the normal word
% spacing, which can vary from line to line.
%
% Why should nice fractions be typeset so that the numerator does
% not extend above the height of the letter ``M'' and the
-% denominator does not extend below the baseline? Because otherwise
+% denominator does not extend below the baseline? Because otherwise
% a stretching of the baselineskip could be necessary due to
% descenders.
%
@@ -198,13 +207,14 @@
% slash is bad. In fact, there is none.
% \item The combination of the \option{ugly} option with text mode
% can lead to ambiguous fractions. Be happy that a warning is
-% issued. Why do you use this option? Your boss? Ah, I see.
+% issued. Why do you use this option? Your boss? Ah, I see.
% \end{itemize}
% \section{Implementation}
% \subsection{Documentation Driver}
% \begin{macrocode}
%<*driver>
-\documentclass[12pt,a4paper]{ltxdoc} \usepackage{units}
+\documentclass[12pt,a4paper]{ltxdoc}
+\usepackage{units}
\begin{document}
\DocInput{units.dtx}
\end{document}
@@ -247,7 +257,7 @@
% The package identifies itself with its release date, a version
% number, and a short description.
% \begin{macrocode}
-\ProvidesPackage{units}[1998/06/25 v0.9a Typesetting units]
+\ProvidesPackage{units}[1998/08/04 v0.9b Typesetting units]
% \end{macrocode}
% \subsubsection{Initialization}
% The \package{ifthen} package is loaded because a new boolean
@@ -283,7 +293,7 @@
% called \package{nicefrac}, which therefore is required by
% \file{units.sty}.
% \begin{macrocode}
-\RequirePackage{nicefrac}[1998/06/25]
+\RequirePackage{nicefrac}[1998/08/04]
% \end{macrocode}
% \subsubsection{Defining Commands}
% In order to make debugging easier for the package user (missing
@@ -355,7 +365,7 @@
% \subsubsection{Identification}
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{nicefrac}[1998/06/25 v0.9a Nice fractions]
+\ProvidesPackage{nicefrac}[1998/08/04 v0.9b Nice fractions]
% \end{macrocode}
% \subsubsection{Initialization}
% First, some new lengths are allocated.
@@ -461,18 +471,22 @@
% \begin{macrocode}
\mkern-2mu/\mkern-1mu%
% \end{macrocode}
+% \changes{v0.9b}{1998-08-04}{\cmd{\bgroup} and \cmd{\egroup}
+% instead of \cmd{\begingroup} and \cmd{\endgroup}}
% The denominator needs a seperate group to delimit the range of the
-% font commands. The choice for the fontsize and the font changing
-% are made just like for the numerator.
+% font commands.\footnote{Credits go to \person{Michael Switkes}
+% for the bug report and to \person{Heiko Oberdiek} for telling me
+% why the fix works.} The choice for the fontsize and the font
+% changing are made just like for the numerator.
% \begin{macrocode}
- \begingroup
+ \bgroup
\mathchoice
{\scriptstyle}%
{\scriptstyle}%
{\scriptscriptstyle}%
{\scriptscriptstyle}%
#1{#3}%
- \endgroup
+ \egroup
}%
% \end{macrocode}
% Now the code for nice fractions in text mode:
@@ -529,6 +543,7 @@
}
% \end{macrocode}
% \end{macro}
+% \clearpage
% \begin{macro}{\@UnitsUglyFrac}
% Ugly fractions in math mode~\ldots
% \begin{macrocode}
@@ -540,7 +555,6 @@
\frac{#1{#2}}{#1{#3}}%
}%
% \end{macrocode}
-% \newpage
% In text mode~\ldots
% \begin{macrocode}
{%