From 168c4abebd344cda13d71257a8f5882ddf75b461 Mon Sep 17 00:00:00 2001
From: Norbert Preining <preining@logic.at>
Date: Tue, 17 Oct 2006 22:40:33 +0000
Subject: 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
---
 Master/texmf-dist/source/latex/units/units.dtx | 42 +++++++++++++++++---------
 1 file changed, 28 insertions(+), 14 deletions(-)

(limited to 'Master/texmf-dist/source/latex/units/units.dtx')

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}
   {%
-- 
cgit v1.2.3

