path: root/Master/texmf-dist/source/latex/SIstyle/sistyle.dtx

% \iffalse (meta-comment)
% -----------------------------------------------------------------
% File:   sistyle.dtx
% Author: Danie Els (dnjels@sun.ac.za)
%
% This file is part of the SIstyle package.
%
% Copyright 2004 by Danie Els. All rights reserved.
%
% This work may be distributed and/or modified under the conditions
% of the LaTeX Project Public License, either version 1.3 of this
% license or (at your option) any later version. The latest version
% of the license is in
%      http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2003/12/01 or later.
%
% This work has the LPPL maintenance status "author-maintained".
%
% -----------------------------------------------------------------
% This file contains the documentations and source code for the
% SIstyle package for use with LaTeX2e. See the file 'readme.txt'
% for a list of all the files as well as directions for the
% installation of this package.
% -----------------------------------------------------------------
% \fi
%
% \CheckSum{0}
%
% \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
%   Digits        \0\1\2\3\4\5\6\7\8\9
%   Exclamation   \!     Double quote  \"     Hash (number) \#
%   Dollar        \$     Percent       \%     Ampersand     \&
%   Acute accent  \'     Left paren    \(     Right paren   \)
%   Asterisk      \*     Plus          \+     Comma         \,
%   Minus         \-     Point         \.     Solidus       \/
%   Colon         \:     Semicolon     \;     Less than     \<
%   Equals        \=     Greater than  \>     Question mark \?
%   Commercial at \@     Left bracket  \[     Backslash     \\
%   Right bracket \]     Circumflex    \^     Underscore    \_
%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%   Right brace   \}     Tilde         \~}
%
% \iffalse
%<*dtx>
\ProvidesFile{sistyle.dtx}
%</dtx>
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{sistyle}
%<driver>\ProvidesFile{sistyle.drv}
%\ProvidesFile{sistyle.dtx}
   [2004/07/09  v2.0  SI units and numbers (DNJ Els)]
%<*driver>
\documentclass[a4paper]{ltxdoc}
\usepackage{calc}
%\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{amsmath}
\usepackage{sistyle}
  \SIdefaultNfam{\mathnormal}
  \SIdefaultMfam{\mathrm}
  \SIthousandsep{\,}
  \SIunitsep{\;}
  \SIunitdot{\cdot}
  \SIproductsign{\times}
  \SIobeyboldfalse
%  \newcommand*{\micro}{\ensureupmath{\mbox{\textmu}}}
\usepackage{array}
\usepackage{graphicx}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
\setlength\hfuzz{15pt}
\hbadness=7000
\begin{document}
  \DocInput{sistyle.dtx}
\end{document}
%</driver>
% \fi
%
%
% \changes{v1.0}{2004/02/01}{Initial version}
% \changes{v2.0}{2004/07/09}{Better display math detection with \cs{displaywidth}}
%
%  \DoNotIndex{\,}
%  \DoNotIndex{\., \;}
%  \DoNotIndex{\@car, \@empty, \@firstofone, \@firstoftwo, \@ifstar,
%              \@ifundefined, \@nameuse,\@nil, \@nnil, \@onlypreamble,
%              \@secondoftwo, \@undefined}
%  \DoNotIndex{\AtBeginDocument}
%  \DoNotIndex{\begingroup, \bfseries, \bgroup, \boldmath}
%  \DoNotIndex{\catcode, \cdot, \chardef, \check@mathfonts, \circ,
%              \csname}
%  \DoNotIndex{\DeclareMathSymbol, \DeclareRobustCommand, \def}
%  \DoNotIndex{\edef, \egroup, \else, \endcsname, \endgroup, \ensuremath,
%              \ensureupmath, \expandafter}
%  \DoNotIndex{\f@family, \f@series, \fam, \fi}
%  \DoNotIndex{\gdef, \GetMathFontFams, \global}
%  \DoNotIndex{\if, \ifinner, \ifmmode, \ifnum, \ifx}
%  \DoNotIndex{\kern}
%  \DoNotIndex{\let, \long, \lowercase}
%  \DoNotIndex{\math@version, \mathcode, \mathord, \mathrm, \mathsf,
%              \mathtt, \mbox, \mdseries}
%  \DoNotIndex{\NeedsTeXFormat, \newcommand, \newif, \newtoks, \noexpand}
%  \DoNotIndex{\Omega}
%  \DoNotIndex{\PackageError, \prime, \providecommand, \ProvidesPackage}
%  \DoNotIndex{\relax, \renewcommand, \RequirePackage, \rmfamily}
%  \DoNotIndex{\sbox, \scriptspace, \sfdefault, \sffamily}
%  \DoNotIndex{\text, \textsuperscript, \the, \times, \ttdefault,
%              \ttfamily}
%  \DoNotIndex{\unboldmath, \upshape}
%  \DoNotIndex{\zap@space}
%
%
% \makeatletter
%
%^^A==== Temporaries ================================================
%
% \newsavebox{\tboxa}
% \newsavebox{\tboxb}
% \newlength{\tdima}
%
%^^A==== Doc Environments ===========================================
%
% \newenvironment{Item}[2][\textsl]{^^A
%    \begin{list}{}^^A
%                {\renewcommand{\makelabel}[1]{\mbox{#1{##1:}}\hfill}^^A
%                 \settowidth{\labelwidth}{#1{#2:}}^^A
%                 \setlength{\labelsep}{1em}^^A
%                 \setlength{\leftmargin}{\labelwidth}^^A
%                 \addtolength{\leftmargin}{\labelsep}^^A
%                 \addtolength{\textwidth}{-\leftmargin}^^A
%                 \addtolength{\textwidth}{-\rightmargin}}^^A
%    \item[#2]^^A
%  }{\end{list}}
%
% \newenvironment{cmddef}[1][l]^^A
%     {\nopagebreak\par\small
%      \addvspace{3.2ex plus 0.8ex minus 0.2ex}^^A
%      \vskip -\parskip
%      \noindent^^A
%      \begin{tabular}{|#1|}
%         \hline\rule{0pt}{1em}\ignorespaces}^^A
%     {\\\hline
%     \end{tabular}
%     \par\nopagebreak\addvspace{3.2ex plus 0.8ex minus 0.2ex}^^A
%     \vskip -\parskip}
%
%^^A==== Indented Environments ======================================
%
% \newlength{\mytab}
% \setlength{\mytab}{\parindent}
% \newcommand{\tab}{\hspace*{\mytab}}
%
% \newenvironment{IndentPara}
%    {\list{}{\setlength{\leftmargin}{\mytab}^^A
%             \setlength{\labelwidth}{0pt}^^A
%             \setlength{\labelsep}{0pt}^^A
%             \setlength{\itemindent}{\parindent}^^A
%             \setlength{\listparindent}{\parindent}^^A
%             \setlength{\parsep}{\parskip}^^A
%             }^^A
%             \item[]}^^A
%    {\endlist}
%
%  \newenvironment{Ipara}[1][\small]^^A
%    {\begin{IndentPara}\noindent#1\ignorespaces}^^A
%    {\end{IndentPara}}
%  \newenvironment{Itabb}[1][\small]
%    {\begin{IndentPara}#1\ignorespaces\begin{tabbing}\ignorespaces}^^A
%    {\end{tabbing}\end{IndentPara}}
%
%^^A==== Headings ===================================================
%
% \newcommand{\@headfamily}{\normalfont}
%
% \renewcommand*{\partname}{Part}
%
% \def\@part[#1]#2{^^A
%    \ifnum \c@secnumdepth >\m@ne\relax
%       \refstepcounter{part}^^A
%       \addcontentsline{toc}{part}{\partname\ \thepart.
%          \protect\enspace\protect\noindent #1}^^A
%   \else
%      \addcontentsline{toc}{part}{#1}^^A
%   \fi
%   \begingroup
%      \centering
%      \@headfamily
%      \ifnum \c@secnumdepth >\m@ne\relax
%         {\large\bfseries \partname\ \thepart}
%         \vskip 1em
%      \fi
%      \Large \bfseries #1^^A
%      \markboth{}{}\par
%   \endgroup
%   \nobreak
%   \vskip 2em
%   \@afterheading}
%
% \@addtoreset{section}{part}
% \renewcommand{\thepart}{\arabic{part}}
% \renewcommand{\thesection}{\thepart.\arabic{section}}
%
%^^A \renewcommand{\@seccntformat}[1]{^^A
%^^A    \protect\makebox[0pt][r]{\@nameuse{the#1}\quad}}
%
% \def\section{^^A
%   \@startsection {section}{1}{\z@}^^A
%                  {-3.5ex plus -1ex minus -.2ex}^^A
%                  {2.3ex plus .2ex}^^A
%                  {\noindent\@headfamily\raggedright\large\bfseries}}
%
% \def\subsection{^^A
%    \@startsection{subsection}{2}{\z@}^^A
%                  {-3.25ex plus -1ex minus -.2ex}^^A
%                  {1.5ex plus .2ex}^^A
%                  {\noindent\@headfamily\normalsize\bfseries}}^^A
%
%^^A==== TOC setup ==================================================
%
%\newcommand\tableofcontentsX{^^A
%    \begin{center}
%       \large\bfseries\contentsname
%    \end{center}
%    \@mkboth{\MakeUppercase\contentsname}^^A
%            {\MakeUppercase\contentsname}^^A
%    \@starttoc{toc}}
%
% \renewcommand\tableofcontents{%
%^^A    \section*{\contentsname}^^A
%    \centerline{\Large\bfseries\contentsname}
%    \medskip
%    \@mkboth{\MakeUppercase\contentsname}^^A
%            {\MakeUppercase\contentsname}^^A
%    \@starttoc{toc}}
%
% \renewcommand*\l@part[2]{^^A
%   \ifnum \c@tocdepth >-2\relax
%     \addpenalty\@secpenalty
%     \bigskip
%     \setlength\@tempdima{3em}^^A
%     \begingroup
%       \parindent \z@ \rightskip \@pnumwidth
%       \parfillskip -\@pnumwidth
%       {\leavevmode
%        \large\bfseries #1\hfil \hb@xt@\@pnumwidth{\hss #2}}\par
%        \nobreak
%        \if@compatibility
%          \global\@nobreaktrue
%          \everypar{\global\@nobreakfalse\everypar{}}^^A
%       \fi
%     \endgroup
%     \smallskip
%   \fi}
%
% \renewcommand*\l@section[2]{^^A
%   \ifnum \c@tocdepth >\z@
%     \addpenalty\@secpenalty
%^^A     \smallskip
%     \setlength\@tempdima{2em}^^A
%     \begingroup
%       \parindent \z@ \rightskip \@pnumwidth
%       \parfillskip -\@pnumwidth
%       \leavevmode
%       \advance\leftskip\@tempdima
%       \hskip -\leftskip
%       #1\nobreak\hfil \nobreak\hb@xt@\@pnumwidth{\hss #2}\par
%     \endgroup
%   \fi}
%
% \renewcommand*\l@subsection{\@dottedtocline{2}{2em}{3em}}
%
%^^A==== Lists ======================================================
%
% \renewcommand{\theenumi}{\alph{enumi}}
% \renewcommand{\labelenumi}{(\theenumi)}
%
%^^A==== Misc =======================================================
%
% \def\meta@font@select{\slshape}
%
% \newcommand{\myemph}[1]{\textsl{#1}}
% \newcommand{\xnum}[1]{\ensuremath{\SI@defaultNfam{#1}}}
%
% \newcommand{\pkg}[1]{\textsf{#1}}
% \newcommand{\RA}{\>$\rightarrow$\quad}
% \newcommand{\RAt}{\quad$\rightarrow$\quad}
% \newcommand*{\tlde}{\text{$\mathtt{\scriptstyle\sim}$}}
%
% \makeatother
%
%^^A==== Titling ====================================================
%
% \GetFileInfo{sistyle.dtx}
%
% \title{The \pkg{SIstyle} package\thanks{This file has
%              version number \fileversion,
%              last revised \filedate.}}
% \author{D.N.J.\ Els\\[1ex]
%        \texttt{(dnjels@sun.ac.za)}}
% \date{\filedate}
% \maketitle
%
%^^A==== Abstract ===================================================
%
% \begin{abstract}
%    \noindent
%    The \pkg{SIstyle} package provides macros to type
%    numbers and units in a consistent way according to SI
%    requirements.  The following commands are provided:
%    \begin{Itabb}
%       \cmd{\SI}\marg{number}\marg{unit}\hspace{3em}\=$\rightarrow$~ Setting numbers with units\\
%       \cmd{\num}\marg{number}           \>$\rightarrow$~ Setting a number\\
%       \cmd{\ang}|{|\meta{degs}|;|\meta{mins}|;|\meta{secs}|}|           \>$\rightarrow$~ Setting an angle
%    \end{Itabb}
%    The requirements for formatting and typesetting of SI units and
%    numbers listed in this document, were extracted verbatim from the
%    \textit{NIST Special Publication 811} (SP 811):
%    \begin{Ipara}
%       |http://physics.nist.gov/cuu/Units/rules.html|
%    \end{Ipara}
%    It is not a full list of all the requirements, but only those
%    relevant to font type and spacing formatting.
%
%    It is the responsibility of the user to use the correct units and
%    prefixes, because the purpose of this package is only to typeset
%    the SI units and numbers properly. It is therefore recommended
%    that the user makes a thorough study of SP 811 or the equivalent
%    specification for his or her country.
% \end{abstract}
%
%^^A==== Contents ===================================================
%
% \clearpage
% \tableofcontents
%
%^^A==== Main Document ==============================================
% \clearpage
% \part{Using The \pkg{SIstyle} Package}
%
% \section{Loading the \pkg{SIstyle} Package}
%
% The \pkg{SIstyle} package is loaded in the document preamble with
% \begin{Ipara}
% |\usepackage{sistyle}|
% \end{Ipara}
%
% \section{The Typesetting Commands}
% \subsection{SI numbers with units}
%
% The \cmd{\SI} command typeset SI numbers with units and it
% conforms to the rules as given in Part \ref{prt:SI}.
%
% \begin{cmddef}
%  \cmd{\SI}\marg{number}\marg{unit}
% \end{cmddef}
%
% \noindent Inside the \cmd{\SI}\ command the point, ``.'',
% is make active and redefined to \cmd{\SIunitdot}. The hard space,
% ``\tlde'', is redefined to \cmd{\SIunitspace}. This makes for
% convenient shorthand in that by typing \texttt{N.m} you obtain
% ``\SI{}{N.m}'' or \texttt{N\tlde m} gives ``\SI{}{N~m}''.
%
% \begin{cmddef}
%  \cmd{\pnt}
% \end{cmddef}
%
% \noindent The point can now not be used as a decimal point as part
% of a unit and the symbol \cmd{\pnt}\ is defined as substitute. It
% is however recommended to use the \cmd{\num} command to ensure
% uniform formatting of numbers.
%
%
% \begin{Item}{Example}\small^^A
% \begin{tabular}[t]{@{}l@{\RAt}l}
%   |\SI{}{m.kg/(s^3.A)}|         & \SI{}{m.kg/(s^3.A)}\\
%   |\SI{}{(MPa)^{0\pnt 5}}|      & \SI{}{(MPa)^{0\pnt 5}}\\
%   |\SI{}{(MPa)^{\num{0.5}}}|    & \SI{}{(MPa)^{\num{0,5}}}\\
%   |$v=\SI{10}{m.s^{-1}}$|       & $v=\SI{10}{m.s^{-1}}$\\
%   |$v=\SI{10}{m/s}$|            & $v=\SI{10}{m/s}$\\
%   |$v=\SI{10}{\tfrac{m}{s}}$|   & $v=\SI{10}{\tfrac{m}{s}}$\\
%   |$\tau=\SI{3}{N|\tlde|m}$|    & $\tau=\SI{3}{N~m}$
% \end{tabular}
% \end{Item}
%
% \noindent^^A
% The numbers and units are set inside a math environment with an
% upright font. When the \cmd{\SI}\ command is used in normal text
% or inside inline maths, it follows the surrounding fonts. Display
% maths on the other hand will follow the active math fonts. When
% different text and math fonts are used, it can be problematic,
% because unit that are typed inside normal text will have a
% different font from the units inside display maths.
%
% \begin{Item}{Example}
%  The velocity is \SI{15.3}{m/s} at the ...\\
%  \textbf{\itshape The velocity is \SI{15.3}{m/s} at the ...}\\
%  \textsf{The velocity is \SI{15.3}{m/s} at the ...}\\
%  \texttt{The velocity is \SI{15.3}{m/s} at the ...}
% \end{Item}
%
% \noindent The typesetting of SI units obeys the surrounding bold
% text depending on the following switches:
%
% \begin{cmddef}
%   \cmd{\SIobeyboldtrue}\\
%   \cmd{\SIobeyboldfalse}\quad(default)
% \end{cmddef}
%
% \begin{Item}{Example}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
%   \cmd{\SIobeyboldtrue}
%      &\SIobeyboldtrue\textbf{\itshape The velocity is \SI{15.3}{m/s} at the ...}\\
%   \cmd{\SIobeyboldfalse}
%      &\textbf{\itshape The velocity is \SI{15.3}{m/s} at the ...}
% \end{tabular}
% \end{Item}
%
%
% \subsection{Numbers}
%
% Numbers can be formatted with the \cmd{\num} command.
%
% \begin{cmddef}
%  \cmd{\num}\marg{decimal number}\\
%  \cmd{\num*}\marg{decimal number}
% \end{cmddef}
%
% \noindent  Numbers may only consist of:
% ``\xnum{+-0\,1\,2\,3\,4\,5\,6\,7\,8\,9\,.\,,\,}e\,E''\@. The input
% decimal separator can be either a point ``|.|'' or a comma
% ``|,|''. The output is formatted according to the
% \cmd{\SIdecimalsign} setting. No thousand separators are allowed
% in the argument (spaces are ignored).
% ``$\mathtt{E}\,x$'' or ``$\mathtt{e}\,x$'' is
% converted to $10^x$.
%
% \begin{Item}{Example}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
% |\num{1.2e3}| & \num{1.2e3}\\
% |\num{1,2E3}| & \num{1,2E3}
% \end{tabular}
% \end{Item}
%
% \noindent The \cmd{\num} command simplifies the input of numbers
% and typeset them correctly.
%
% \begin{Item}{Example}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
%  |\num{E1.5}|      & \num{E1.5}        \\
%  |\num{ - e -.5}|  & \num{ - e -.5}\\
%  |\num{+1e-.5}|    & \num{+1e-.5}      \\
%  |\num{1.23456e5}| & \num{1.23456e5}   \\
%  |\num{+1.234}|    & \num{+1.234}      \\
%  |\num{-.12345}|   & \num{-.12345}      \\
%  |\num{1.}|        & \num{1.}          \\
%  |\num{1}|         & \num{1}          \\
%  |\num{123}|       & \num{123}         \\
%  |\num{1234}|      & \num{1234}        \\
%  |\num{12345}|     & \num{12345}       \\
%  |\num{-123456}|   & \num{-123456}
% \end{tabular}
% \end{Item}
%
% \noindent The grouping of the four digits can be switched on or of
% --- e.g., in a table --- with the following switches :
%
% \begin{cmddef}
%   \cmd{\SIgroupfourtrue}\quad(default)\\[1ex]
%   \cmd{\SIgroupfourfalse}
% \end{cmddef}
% \noindent Please make sure that changes are kept local to ensure
% uniformity throughout a document.
% \begin{Item}{Example}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
%   |{\SIgroupfourtrue\num{1234.5678}}| & \SIgroupfourtrue\num{1234.5678}\\
%   |{\SIgroupfourfalse\num{1234.5678}}| & \SIgroupfourfalse\num{1234.5678}
% \end{tabular}
% \end{Item}
%
%
% \noindent The starred form, \cmd{\num*}, typeset the number in the normal
% active \LaTeX{} font. This is needed when numbers are inserted in
% headings, etc. The unstarred version uses the same upright math
% font as the SI units.
%
% \begin{Item}{Example}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
%  |\textit{There were \num{123} of them}|
%    &  \textit{There were \num{123} of them}\\
%  |\textit{There were \num*{123} of them}|
%    &  \textit{There were \num*{123} of them}
% \end{tabular}
% \end{Item}
%
%
%
% \subsection{Angles}
%
% The \cmd{\ang} command is supplied by the \pkg{SIstyle} package to
% typeset angles. Note the degrees, minutes and seconds are
% separated with a semi-colon ``|;|''.
%
% \begin{cmddef}
%  \cmd{\ang}|{|\meta{degs}|;|\meta{mins}|;|\meta{secs}|}|\\[1ex]
%  \cmd{\ang}\marg{decimal degrees}
% \end{cmddef}
% \begin{Item}{Example}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
%  |\ang{10}|         & \ang{10}      \\
%  |\ang{10; 12}|     & \ang{10;12}  \\
%  |\ang{10; 12; 4}|  & \ang{10;12;4}\\
%  |\ang{10; 12; 4,01}|  & \ang{10;12;4,01}\\[1ex]
%  |\ang{; ; 4}|      & \ang{; ; 4}\\[1ex]
%  |\ang{10.2011}|    & \ang{10.2011} \\
%  |\ang{+10}|        & \ang{+10}     \\
%  |\ang{-10}|        & \ang{-10}
% \end{tabular}
% \end{Item}
%
%
% \section{Additional Units Symbols}\label{sec:AddUnits}
%
% Most of the SI unit symbols are characters from the Latin
% alphabet, except for the few listed in table \ref{tab:symbs} and
% which are provided by the \pkg{SIstyle} package. Note
% that the commands are only provided if the user do not
% define the command in the preamble.
%
% If the user redefines or supplies his own commands for
% units, than all the symbols must be available in math mode. For
% symbols that are only available in text mode, e.g., from the
% \pkg{textcomp} package, the symbol must be placed inside a
% \cmd{\mbox} command. The best way to define a new unit command
% is with the aid if the \pkg{SIstyle} internal command
% \cmd{\ensureupmath}.
%
% \subsubsection*{\mdseries\itshape Symbols available in math mode:}
% \newcommand*{\mps}{\ensureupmath{m/s}}
% \begin{Item}{Example}
%    |\newcommand*{\mps}{\ensureupmath{m/s}}|
%
%    which can be used in text and math mode
%    \begin{Itabb}
%       |$v/(\mps)=\num{10}$| \=\kill
%       |\SI{10}{\mps}|       \>\RAt \SI{10.2}{\mps}\\
%       |The unit \mps\ ...|  \>\RAt The unit \mps\ ...\\
%       |$v/(\mps)=\num{10}$| \>\RAt $v/(\mps)=\num{10}$
%    \end{Itabb}
% \end{Item}
%
%  \subsubsection*{\mdseries\itshape Symbols only available in text mode (\pkg{textcomp})}
% \renewcommand*{\micro}{\ensureupmath{\mbox{\textmu}}}
% \newcommand*{\microsec}{\ensureupmath{\micro s}}
% \begin{Item}{Example}
%    |\renewcommand*{\micro}{\ensureupmath{\mbox{\textmu}}}|\\
%    |\newcommand*{\microsec}{\ensureupmath{\micro s}}|
%
%    which can be used in text and math mode
%    \begin{Itabb}
%       |The prefix \micro\ ...| \=\kill
%       |\SI{5}{\micro s}|       \>\RAt \SI{5}{\micro s}\\
%       |The prefix \micro\ ...| \>\RAt The prefix \micro\ ...\\
%       |$t/\microsec =\num{5}$|    \>\RAt $t/\microsec =\num{5}$
%    \end{Itabb}
% \end{Item}
%
% \begin{table}[h]
% \centering
% \caption{Additional SI symbols}
% \label{tab:symbs}
% \smallskip
% \begin{tabular}{@{}lcc@{}}
%   \hline\noalign{\vskip3pt}
%   Command     &&  Symbol \\
%   \cline{1-1} \cline{3-3}
%   \noalign{\vskip3pt}
%   \cmd{\angstrom}\hspace{1cm}   && \angstrom    \\
%   \cmd{\micro}$^a$              && $\mu$        \\
%   \cmd{\ohm}                    && $\Omega$     \\[1ex]
%   \cmd{\degC}                   && \ensureupmath{{}^{\circ}\kern-\scriptspace C}\\
%   \cmd{\degF}\,$^b$             && \ensureupmath{{}^{\circ}\kern-\scriptspace F} \\[1ex]
%   \cmd{\arcdeg}                 && ${}^{\circ}$ \\
%   \cmd{\arcmin}                 && \arcmin      \\
%   \cmd{\arcsec}                 && \arcsec      \\
%   \hline
%   \noalign{\vskip3pt}
%   \multicolumn{3}{@{}p{9cm}@{}}{\footnotesize\textsc{Note:}
%            Contrary to the common practice in many countries,
%            is the correct SI symbol for litre a capital L
%            or lowercase l, and \emph{not} the
%            script l, $\ell$ (\cmd{\ell}).}\\[2ex]
%   \multicolumn{3}{p{9cm-\tabcolsep}@{}}{\footnotesize\makebox[0pt][r]{$^{a}\,$}^^A
%           Some fonts have an upright Greek \textmu\ character available
%           in the TS1 encoding (\pkg{textcomp} package).
%           Fonts such as Lucida and Adobe Symbol also supply upright
%           Greek math characters. See also the \pkg{upgreek} and
%           \pkg{gensymb} packages.}\\[2ex]
%   \multicolumn{3}{p{9cm-\tabcolsep}@{}}{\footnotesize\makebox[0pt][r]{$^{b}\,$}^^A
%           Not a standard SI symbol.}\\
% \end{tabular}
% \end{table}
%
%
%
% \section{Configuring The Output}
% \subsection{Configuring commands}
%
% The output of the \cmd{\SI} command can be formatted by the user
% by setting the following commands:
%
% \begin{cmddef}[ll]
%   \cmd{\SIunitsep}\marg{spacing cmd}   & |[|default: |{\,}    ]|\\
%   \cmd{\SIunitspace}\marg{spacing cmd} & |[|default: |{\,}    ]|\\
%   \cmd{\SIunitdot}\marg{cmd}           & |[|default: |{\cdot} ]|
% \end{cmddef}
%
% \vspace{-\topsep}
% \begin{itemize}
% \item The spacing between the number and the unit is set with
% \cmd{\SIunitsep}.
%
% \item Inside the \cmd{\SI}\ command the point, ``.'', is make
% active and redefined to \cmd{\SIunitdot}.
%
% \item The hard space, ``\tlde'', is redefined to
% \cmd{\SIunitspace}.
% \end{itemize}
%
%
%
% \noindent The user can change the number format with the following
% commands:
%
% \begin{cmddef}[ll]
%   \cmd{\SIdecimalsign}\marg{cmd}         & |[|default: |{.}     ]|\\
%   \cmd{\SIthousandsep}\marg{spacing cmd} & |[|default: |{\,}    ]|\\
%   \cmd{\SIproductsign}\marg{cmd}         & |[|default: |{\times}]|
% \end{cmddef}
%
%
% \noindent The default fonts to be selected by the \pkg{SIstyle}
% package can be changed. The following commands are provided:
%
% \begin{cmddef}[ll]
%   \cmd{\SIdefaultMfam}\marg{math font command} & |[|default: |{\mathrm}  ]|\\
%   \cmd{\SIdefaultNfam}\marg{math font command} & |[|default: |{\mathrm}  ]|\\
%   \cmd{\SIdefaultTfam}\marg{text font family}  & |[|default: |{\rmfamily}]|
% \end{cmddef}
%
% \vspace{-\topsep}
% \begin{itemize}
%  \item\cmd{\SIdefaultMfam}: Sets the default math font of the units.
%  \item\cmd{\SIdefaultNfam}: Sets the default math font of the numbers.
%  \item\cmd{\SIdefaultTfam}: Set the default text font when text
%       components are included with the units (e.g., from the
%       \pkg{textcomp} package)
% \end{itemize}
%
% \begin{Item}{Note}
%  An interesting side-effect can be obtained when you are using
%  Computer Modern fonts by setting the \cmd{\SIdefaultNfam} to
%  \cmd{\mathnormal}. The result is that all the numbers are then in
%  lowercase: \xnum{0123456789} as oppose to 0123456789.
%  This document was formatted with this setting.
% \end{Item}
%
%
% \subsection{Examples formats}\label{sec:ExmplFmt}
%
% \paragraph{USA:}
%
% NIST Special Publication 811 -- \textit{Guide for the Use of the
% International System of Units (SI)}
%
% \begin{Ipara}
% |\SIdecimalsign{.}     |\\
% |\SIthousandsep{\,}    |\\
% |\SIproductsign{\times}|\\
% |\SIunitsep{\,}        |\\
% |\SIunitspace{\cdot}   |\quad(give \tlde\ and |.| the same output) \\
% |\SIunitdot{\cdot}     |
% \end{Ipara}
% {^^A------------------
% \SIdefaultNfam{\mathrm}
% \SIdecimalsign{.}
% \SIthousandsep{\,}
% \SIproductsign{\times}
% \SIunitsep{\,}
% \SIunitspace{\cdot}
% \SIunitdot{\cdot}
%^^A
% \noindent This will format a number and unit:
% \begin{Ipara}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
% |\SI{-1.23456e^3}{N.m}| & \SI{-1.23456e^3}{N.m}
% \end{tabular}
% \end{Ipara}
% \noindent To obtain tighter numbers, put the multiplication and
% half high dot signs inside braces
% \begin{Ipara}
% |\SIproductsign{{\times}}|\\
% |\SIunitspace{{\cdot}}   |\\
% |\SIunitdot{{\cdot}}     |
% \end{Ipara}
% \SIproductsign{{\times}}
% \SIunitspace{{\cdot}}
% \SIunitdot{{\cdot}}
%^^A
% \noindent This will then format the number and unit:
% \begin{Ipara}
% \begin{tabular}[t]{@{}l@{\RAt}l@{}}
% |\SI{-1.23456e^3}{N.m}| & \SI{-1.23456e^3}{N.m}
% \end{tabular}
% \end{Ipara}
% }^^A------------------
%
%
%
%  \section{Locales}
%
%  The \pkg{SIstyle} package  provides a number of style setup commands
%  for the formatting conventions in different countries
%  (or your own pivate setting).
%
% \begin{cmddef}
%  \cmd{\AddToSIstyle\ }\marg{locale}\\
%  \cmd{\AddToSIstyle*}\marg{locale}\\[1ex]
%  \cmd{\SIstyle}\marg{locale}\\[1ex]
%  \cmd{\SIstyleToLang}\marg{language}\marg{locale}
% \end{cmddef}
%
% \noindent The \cmd{\AddToSIstyle} appends formatting commands to a
% locale. The starred form clears the list before appending. As an
% example for the USA (see \S\ref{sec:ExmplFmt})
%
% \begin{Ipara}
% |\AddToSIstyle{USA}{%      |\\
% |   \SIdecimalsign{.}%     |\\
% |   \SIthousandsep{\,}%    |\\
% |   \SIunitsep{\,}%        |\\
% |   \SIunitdot{\cdot}%     |\\
% |   \SIunitspace{\;}%      |\\
% |   \SIproductsign{\times}%|\\
% |   \SIobeyboldfalse       |\\
% |   \SIgroupfourtrue}      |
% \end{Ipara}
%
% \noindent See table \ref{tab:locales} for a list of predefined
% settings.\footnote{Any contribution shall be appreciated.}
% A predefined setting can then be activated with the \cmd{\SIstyle}
% command, for example:
%
% \begin{Ipara}
% |\SIstyle{USA}|
% \end{Ipara}
%
% \noindent Locales can also be linked to the language setup
% commands of \pkg{babel} with the \cmd{\SIstyleToLang} command,
% for example:
%
% \begin{Ipara}
% |\SIstyleToLang{english}{USA}|
% \end{Ipara}
%
% \noindent The settings of |USA| will then be activated every
% time \pkg{babel} makes |english| the active languge. This
% command is provided because a number formatting are not linked
% to languages (nearly every English speaking country has a
% different number format).
%
% \begin{table}[h]
% \centering
% \caption{Predefined styles}
% \label{tab:locales}
% \small
% \smallskip
% \begin{tabular}{@{}llclcl@{}}
%   \hline
%   \noalign{\vskip3pt}
%   \multicolumn{2}{@{}l}{\bfseries Style}   &&
%   \multicolumn{1}{c}{\bfseries Locale} &&
%   \multicolumn{1}{c}{\bfseries Example} \\
%   \cline{1-2}  \cline{4-4} \cline{6-6}
%   \noalign{\vskip3pt}
% Germany     &                   && |German|   && \SIstyle{German}\SI{-1.23456e^3}{N.m}\\
% South Africa& (SABS M 33a:1992) && |S-Africa| && \SIstyle{S-Africa}\SI{-1.23456e^3}{N.m}\\
% USA         & (NIST SP811)      && |USA|      && \SIstyle{USA}\SI{-1.23456e^3}{N.m}\\
%   \hline
%   \noalign{\vskip3pt}
% \end{tabular}
% \end{table}
%
%^^A Einheiten und Formelzeichen
%^^A
%^^A DIN 1301-1 (12/93) Einheiten, Einheitennamen, Einheitenzeichen
%^^A DIN 1302   (12/99) Allgemeine mathematische Zeichen und Begriffe
%^^A DIN 1304-1 (03/94) Formelzeichen; Allgemeine Formelzeichen
%^^A DIN 1313   (12/98) Physikalische Größen und Gleichungen
%^^A DIN 1338   (08/96) Formelschreibweise und Formelsatz
%
%^^A=================================================================
% \changes{v2.0}{2004/07/09}{Documentation of interface with other packages}
%  \section{Other packages}
%  \subsection{\pkg{textcomp}}
%
% The \pkg{SIstyle} package defines a number of unit
% symbols that are not available as standard characters.
% If the \pkg{textcomp} package is loaded, the symbols in the
% righthand column of table~\ref{tab:textcomp} automatically used.
%
% \begin{table}[h]
% \centering
% \caption{SI symbols defined by \pkg{textcomp} package}
% \label{tab:textcomp}
% \smallskip
% \begin{tabular}{@{}lcccc}
%   \hline\noalign{\vskip3pt}
%   Command     &&  Symbol  &&\pkg{textcomp}\\
%   \cline{1-1} \cline{3-3} \cline{5-5}
%   \noalign{\vskip3pt}
%   \cmd{\angstrom}\hspace{1cm} && \angstrom    && \capitalring{A} \\
%   \cmd{\micro}                && $\mu$        && \textmu \\
%   \cmd{\ohm}                  && $\Omega$     && \textohm \\[1ex]
%   \cmd{\degC}                 && \ensureupmath{{}^{\circ}\kern-\scriptspace C}
%                                                 && \textcelsius \\
%   \cmd{\degF}                 && \ensureupmath{{}^{\circ}\kern-\scriptspace F}
%                                                 &&  \textdegree F \\[1ex]
%   \cmd{\arcdeg}               && ${}^{\circ}$ &&  \textdegree \\
%   \hline
%   \noalign{\vskip3pt}
% \end{tabular}
% \end{table}
%
%
% \subsection{\pkg{SIunits}}
%
% The \pkg{SIunits} package provides commands for all the SI units and
% prefixes. It can be used together with \pkg{SIstyle}, but care must be
% taken to ensure that both the packages have identical configurations.
%
% \begin{Item}{Example}
%    \begin{Itabb}
%    |\usepackage{textcomp}|\\
%    |\usepackage[cdot,textstyle]{SIunits}|\\
%    |   \let\ohm\relax|\\
%    |\usepackage{sistyle}|\\
%    |   \SIunitspace{\cdot}|\\
%    |   \SIunitdot{\cdot}|
%    \end{Itabb}
%    Inside the document \pkg{SIunits} can then be used as
%    \begin{Itabb}
%    |\SI{30}{\watt\per\square\metre\usk\kelvin}| ~~$\rightarrow$~~  \SI{30}{W/m^2.K}
%    \end{Itabb}
%    As the author of \pkg{SIunits}, I prefere to write
%    \begin{Itabb}
%    |\SI{30}{W/m^2.K}| ~~$\rightarrow$~~  \SI{30}{W/m^2.K}
%    \end{Itabb}
%  \end{Item}
%
% \subsection{\pkg{mathcomp}}
%
% The \pkg{mathcomp} package provided the \pkg{textcomp} symbols in
% math mode.  Unfortunately it is only available in the \cmd{\mathrm}
% math alphabet and is therefore of little use to \pkg{SIstyle}.
%
% \subsection{\pkg{upgreek}}
%
% The \pkg{upgreek} package can be used to redefine the \cmd{\micro}
% and \cmd{\ohm} commands.
%
% \begin{Item}{Example}
%    \begin{Itabb}
%    |\usepackage{sistyle}|\\
%    |\usepackage[Euler]{upgreek}|\\
%    |   \newcommand*{\micro}{\ensureupmath{\upmu}}|\\
%    |   \newcommand*{\ohm}{\ensureupmath{\upOmega}}|
%    \end{Itabb}
% \end{Item}
%
% \subsection{\pkg{gensymb}}
%
% The \pkg{gensymb} package provides  generic commands \cmd{\degree},
% \cmd{\celsius}, \cmd{\perthousand}, \cmd{\micro} and \cmd{\ohm}
% which work both in text and math mode. Note that \pkg{SIstyle} typeset
% all its symbols in math mode which will cause \pkg{gensymb} to provide
% only math symbols.  The result is that only the \cmd{\mathrm} versions
% of the symbols are then output in a document, thereby ingnoring the
% font changing mechanism of \pkg{SIstyle}.
%
%
%^^A=================================================================
% \clearpage
% \part{Typesetting SI Units}\label{prt:SI}
%
% \section{SI Units}\label{sec:1}
% \subsection{Typeface}
%
% Unit symbols are printed in normal roman (upright)
% type regardless of the type used in the surrounding text.
%
% \begin{Item}{Example}
%  {\bfseries\itshape A torque of\/ \SI{10}{N.m} was applied.}
% \end{Item}
% \begin{Item}{Listing}\small
%  |{\bfseries\itshape A torque of\/ \SI{10}{N.m} was applied.}|
% \end{Item}
%
%
%
% \subsection{Unit symbols obtained by multiplication}
%
% Symbols for units formed from other units by multiplication are
% indicated by means of either a half-high (that is, centered) dot
% or a space. However, the half-high dot is preferred, because it is
% less likely to lead to confusion.
%
% \begin{Item}{Example}
% \SI{}{N~m} or \SI{}{N.m}
% \end{Item}
% \begin{Item}{Listing}\small
% |\SI{}{N~m} or \SI{}{N.m}|
% \end{Item}
%
% \begin{Item}{Notes}
% \end{Item}
% \begin{enumerate}
% \item A half-high dot or space is usually imperative. For example,
%       \SI{}{m.s^{-1}} is the symbol for the metre per second while
%       \SI{}{ms^{-1}} is the symbol for the reciprocal millisecond
%       (\SI{1e3}{s^{-1}}).
%
% \item The ISO 31-0 specification suggests that if a space is used
%       to indicate units formed by multiplication, the space may be
%       omitted if it does not cause confusion. This possibility is
%       reflected in the common practice of using the symbol
%       \SI{}{kWh} rather than \SI{}{kW.h} or \SI{}{kW~h} for the kilowatt
%       hour.  Nevertheless, is the position taken that a
%       half-high dot or a space should always be used to avoid
%       possible confusion; and that for this same reason, only one
%       of these two allowed forms should be used in any given
%       manuscript.
% \end{enumerate}
%
%
%
% \subsection{Unit symbols obtained by division}
%
% Symbols for units formed from other units by division are
% indicated by means of a solidus (oblique stroke, \texttt{/} ), a
% horizontal line, or negative exponents.
%^^A
% \begin{Item}{Example}
%    \SI{}{m/s},~ \SI{}{\dfrac{m}{s}},~ or~ \SI{}{m.s^{-1}}
% \end{Item}
% \begin{Item}{Listing}\small
%    |\SI{}{m/s}, \SI{}{\dfrac{m}{s}}, or \SI{}{m.s^{-1}}|
% \end{Item}
%^^A
% \noindent However, to avoid ambiguity, the solidus must not be
% repeated on the same line unless parentheses are used.
%^^A
% \begin{Item}{Examples}
% \begin{tabular}[t]{@{}lll@{}}
%^^A \SI{}{m.kg/(s^3.A)}~ or~ \SI{}{m.kg.s^{-3}.A^{-1}}~~~\=\kill
%  \SI{}{m/s^2}~ or~  \SI{}{m.s^{-2}}~
%     & \myemph{but not:}
%     & \SI{}{m/s/s} \\
%  \SI{}{m.kg/(s^3.A)}~ or~ \SI{}{m.kg.s^{-3}.A^{-1}}
%     & \myemph{but not:}
%     & \SI{}{m.kg/s^3/A}
% \end{tabular}
% \end{Item}
% \begin{Item}{Listing}\small
%    |\SI{}{m.kg/(s^3.A)} or \SI{}{m.kg.s^{-3}.A^{-1}}|
% \end{Item}
%^^A
% \noindent Negative exponents should be used in complicated cases.
%
%
%
%
% \section{Rules for Expressing Values of Quantities}
% \subsection{Value and numerical value of a quantity}
% \label{sec:numval}
%
% The \myemph{value} of a quantity is its magnitude expressed as the
% product of a number and a unit, and the number multiplying the
% unit is the \myemph{numerical} value of the quantity expressed in
% that unit.
%
% More formally, the value of quantity $A$ can be written as $A
% {=}\{A\}[A ]$, where $\{A\}$ is the numerical value of $A$ when the
% value of $A$ is expressed in the unit $[A]$. The numerical value
% can therefore be written as $\{A\}{=}A/[A]$, which is a convenient
% form for use in figures and tables. Thus, to eliminate the
% possibility of misunderstanding, an axis of a graph or the heading
% of a column of a table can be labeled ``$t/\SI{}{\degC}\,$''
% instead of ``$t\,(\SI{}{\degC})$'' or ``Temperature
% $(\SI{}{\degC})$.''
%
% \begin{figure}[!b]
% \sbox{\tboxa}{\includegraphics{fig1}}^^A
% \sbox{\tboxb}{\includegraphics{fig2}}^^A
% \setlength{\tdima}{\wd\tboxa}^^A
% \addtolength{\tdima}{\wd\tboxb}^^A
% \addtolength{\tdima}{1em}^^A
% \centering^^A
% \makebox[0pt][c]{
% \begin{minipage}[t]{\tdima}
%    \begin{minipage}[t]{\wd\tboxa}
%       \usebox{\tboxa}
%       \caption{Units included with the scale of the graph. This
%                form is usually difficult to obtain with most
%                graphing software.}
%       \label{fig:1}
%    \end{minipage}
%    \hfill
%    \begin{minipage}[t]{\wd\tboxb}
%       \usebox{\tboxb}
%       \caption{The graph labels includes the units and the scales
%                 are dimensionless. Notice that there is no
%                 ambiguity with this form of labeling, because
%                 everything makes mathematical sense.}
%        \label{fig:2}
%    \end{minipage}
% \end{minipage}}
% \end{figure}
%
%
% \begin{Item}{Example}
% \end{Item}
% \begin{enumerate}
% \item In the SI, the value of the velocity of light in vacuum is
%       $c = \SI{299792458}{m/s}$ exactly. The number
%       \num{299792458} is the numerical value of $c$ when $c$ is
%       expressed in the unit \SI{}{m/s}, and equals $c/(\SI{}{m/s})$.
%
%       \begin{Item}{Listing}\small
%          |$c = \SI{299792458}{m/s}$|\\
%          |$c/(\SI{}{m/s})$|
%       \end{Item}
%
% \item The ordinate of a graph is labeled $t/\SI{}{\micro s}$,
%       where $t$ is the symbol for time and \SI{}{s} is the unit
%       symbol for second, and has scale marks at \num{0}, \num{4},
%       \num{8}, and \num{12}. If the ordinate
%       value of a point on a curve in the graph is estimated to
%       be \num{3.2}, the corresponding time is ~
%       $t/\SI{}{\micro s}=\num{3.2}$ ~ or ~ $t =\SI{3.2}{\micro s}
%       = \SI{3.6e-6}{s}$. Notice
%       the lack of ambiguity in this form of labelling compared
%       with ``Time $(\SI{}{\micro s})$.'' See figures
%       \ref{fig:1} and \ref{fig:2} for examples.
%
% \item An expression such as $\ln(p/\SI{}{MPa})$, where $p$ is the
%       quantity symbol for pressure and \SI{}{MPa} is the unit symbol
%       for megapascal, is perfectly acceptable because $p/\SI{}{MPa}$
%       is the numerical value of $p$ when $p$ is expressed in the
%       unit \SI{}{MPa} and is simply a number.
%       \begin{Item}{Listing}\small
%          |$\ln(p/\SI{}{MPa})$|
%       \end{Item}
% \end{enumerate}
%
%
%
% \begin{Item}{Notes}
% \end{Item}
% \begin{enumerate}
% \item For the conventions concerning the grouping of digits, see
%       section~\S\ref{sec:digits}.
%
% \item An alternative way of writing $c/(\SI{}{m/s})$ is
%       $\{c\}_{\SI{}{m/s}}$, meaning the numerical value of $c$ when
%       $c$ is expressed in the unit \SI{}{m/s}.
%
%       \begin{Item}{Listing}\small
%          |$\{c\}_{\SI{}{m/s}}$|
%       \end{Item}
% \end{enumerate}
%
%
% \subsection{Space between numerical value and unit symbol}
%
% In the expression for the value of a quantity, the unit symbol is
% placed after the numerical value and a \myemph{space} is left
% between the numerical value and the unit symbol. Note that this
% rule includes the persentage sign \%.
%
% The only exceptions to this rule are for the unit symbols for
% degree, minute, and second for plane angles: \arcdeg, \arcmin, and
% \arcsec, respectively, in which case no space is left between the
% numerical value and the unit symbol.
%
% \begin{Item}{Examples}
%   $x = \SI{10}{mm}$\\
%   $q = \SI{25}{\%}$\\
%   $\theta = \ang{30;22;8}$
% \end{Item}
% \begin{Item}{Listing}\small
%   |$x = \SI{10}{mm}$|\\
%   |$q = \SI{25}{\%}$|\\
%   |$\theta = \ang{30;22;8}$|
% \end{Item}
%
% \noindent This rule means that:
%
% \begin{enumerate}
% \item The symbol \degC\ for the degree Celsius is preceded by a
%       space when one expresses the values of Celsius temperatures.
%
%       \begin{Item}{Example}
%         $t = \SI{30.2}{\degC}$~~
%            \myemph{but not:}~~
%         $t = \num{30.2}\degC$ ~~or~~
%         $t = \num{30.28}\mathrm{{}^{\circ}~C}$
%       \end{Item}
%       \begin{Item}{Listing}\small
%         |$t = \SI{30.2}{\degC}$|
%       \end{Item}
%
% \item Even when the value of a quantity is used in an adjectival
%       sense, a space is left between the numerical value and the
%       unit symbol. (This rule recognizes that unit symbols are not
%       like ordinary words or abbreviations but are mathematical
%       entities, and that the value of a quantity should be
%       expressed in a way that is as independent of language as
%       possible.)
%
%       \begin{Item}{Examples}
%          a \SI{1}{m} end gauge
%              \myemph{but not:}
%          a \num{1}-\SI{}{m} end gauge
%
%          a \SI{10}{kV} resistor
%              \myemph{but not:}
%          a \num{10}-\SI{}{kV} resistor
%       \end{Item}
%
%       However, if there is any ambiguity, the words should be
%       rearranged accordingly. For example, the statement ``the
%       samples were placed in \SI{22}{mL} vials'' should be
%       replaced with the statement ``the samples were placed in
%       vials of volume \SI{22}{mL}.''
%
%       \begin{Item}{Note}
%          When unit names are spelled out, the normal rules of
%          English apply. Thus, for example, ``a roll of
%          \num{35}-millimetre film'' is acceptable.
%       \end{Item}
% \end{enumerate}
%
% \subsection{Clarity in writing values of quantities}
%
% The value of a quantity is expressed as the product of a number
% and a unit (see section~\S\ref{sec:numval}). Thus, to avoid
% possible confusion, this \myemph{Guide} takes the position that
% values of quantities must be written so that it is completely
% clear to which unit symbols the numerical values of the quantities
% belong. Also to avoid possible confusion, this \myemph{Guide}
% strongly recommends that the word ``to'' be used to indicate a
% range of values for a quantity instead of a range dash (that is, a
% long hyphen) because the dash could be misinterpreted as a minus
% sign. (The first of these recommendations once again recognizes
% that unit symbols are not like ordinary words or abbreviations but
% are mathematical entities --- see section~\S\ref{sec:numval}.)
%
% \begin{Item}{Examples}
% \end{Item}
% \begin{tabbing}
% \hskip1pc\=\hskip15pc\=\kill \>
% $\SI{51}{mm}\times\SI{51}{mm}\times\SI{25}{mm}$ \>
%    \myemph{but not:} ~
%    $\num{51}\times\num{51}\times\SI{25}{mm}$ \\[1ex]
%
% \> \SI{225}{nm} to \SI{2400}{nm} or
%    $(\num{225}\text{ to }\num{2400})\,\SI{}{nm}$ \>
%    \myemph{but not:}  ~
%    \num{225} to \SI{2400}{nm}\\[1ex]
%
% \> \SI{0}{\degC} to \SI{100}{\degC} or
%    $(\num{0}\text{ to }\num{100})\,\degC$ \>
%    \myemph{but not:} ~
%    $\SI{0}{\degC} - \SI{100}{\degC}$\\[1ex]
%
% \> \SI{0}{V} to \SI{5}{V} or (\num{0} to \num{5})\,V \>
%    \myemph{but not:} ~
%    $\num{0} - \SI{5}{V}$ \\[1ex]
%
% \> (\num{8.2}, \num{9.0}, \num{9.5}, \num{9.8},
%    \num{10.0})\,\SI{}{GHz} \>
%    \myemph{but not:} ~
%    \num{8.2}, \num{9.0}, \num{9.5}, \num{9.8}, \SI{10.0}{GHz}\\[1ex]
%
% \> $\SI{63.2}{m} \pm \SI{0.1}{m}$ or $(\num{63.2} \pm
%    \num{0.1})\,\SI{}{m}$ \>
%    \myemph{but not:} ~
%    $\num{63.2} \pm \SI{0.1}{m}$ or $\SI{63.2}{m} \pm \num{0.1}$ \\[1ex]
%
% \> $\SI{129}{s} - \SI{3}{s} = \SI{126}{s}$ or
%    $(\num{129}-\num{3})\,\SI{}{s} = \SI{126}{s}$ \>
%    \myemph{but not:} ~
%    $\num{129} - \SI{3}{s} = \SI{126}{s}$
%
% \end{tabbing}
%
% \begin{Item}{Note}
% For the conventions concerning the use of the multiplication sign,
% see section~\S\ref{sec:mult}.
% \end{Item}
%
%^^A==========================================================
%
% \section{Printing Numbers}
%
% \subsection{Typeface for numbers}
%
% Arabic numerals expressing the numerical values of quantities are
% generally printed in lightface (that is, regular) roman type
% irrespective of the type used for the surrounding text. Arabic
% numerals other than numerical values of quantities may be printed
% in lightface or bold italics, or in bold roman type, but lightface
% roman type is usually preferred.
%
% \subsection{Decimal sign or marker}
%
% The sign or marker being used depends very much on the practices
% of a country (and/or language), e.g., in the United States is the
% dot on the line, while in Germany it is the comma.
%
% For numbers less than one, a zero is written before the decimal
% marker. For example, \SI{0.25}{s} is the correct form, not
% \xnum{.25}\,s.
%
% \subsection{Grouping digits}\label{sec:digits}
%
% Because the comma is widely used as the decimal marker, it should
% not be used to separate digits into groups of three (there are
% exceptions for certain countries). Instead, digits should be
% separated into groups of three, counting from the decimal marker
% towards the left and right, by the use of a thin, fixed space.
% However, this practice is not usually followed for numbers having
% only four digits on either side of the decimal marker except when
% uniformity in a table is desired.
% \begin{Item}{Examples}
% \begin{tabbing}
%    \xnum{8012.5947} or \xnum{8\;012.594\;7}~\= \myemph{is highly preferred to:}~~\=\kill
%    \num{76483522}                         \> \myemph{but not:}                 \>\xnum{76{,}483{,}522}\\
%    \num{43279.16829}                      \> \myemph{but not:}                 \>\xnum{43{,}279.168\;29}\\
%   \xnum{8012} or \xnum{8\;012}            \> \myemph{but not:}                 \>\xnum{8{,}012}\\
%    \num{0.4917223}                        \> \myemph{is highly preferred to:}  \>\xnum{0.4917223}\\
%   \xnum{0.5947} or \xnum{0.594\;7}        \> \myemph{but not:}                 \>\xnum{0.59\;47}\\
%   \xnum{8012.5947} or \xnum{8\;012.594\;7}\> \myemph{but not:}                 \>\xnum{8\;012.5947} or \xnum{8012.594\;7}
% \end{tabbing}
% \end{Item}
%
% \begin{Item}{Note}
%    The practice of using a space to group digits is not usually
%    followed in certain specialized applications, such as engineering
%    drawings and financial statements.
% \end{Item}
%
%
% \subsection{Multiplying numbers}\label{sec:mult}
%
% When the dot is used as the decimal marker (USA convention), the
% preferred sign for the multiplication of numbers or values of
% quantities is a cross (that is, multiplication sign) ($\times$),
% not a half-high (that is, centered) dot ($\cdot$).
%
% \begin{Item}{Examples}
% \begin{tabular}[t]{@{}lll@{}}
%  $\num{25}\times\num{60.5}$       &\myemph{but not:}& $\num{25}\cdot\num{60.5}$\\
%  $\SI{53}{m/s}\times\SI{10.2}{s}$ &\myemph{but not:}& $\SI{53}{m/s}\cdot\SI{10.2}{s}$\\
%  $\num{15}\times\SI{72}{kg}$      &\myemph{but not:}& $\num{15}\cdot\SI{72}{kg}$\\
% \end{tabular}
% \end{Item}
%
%
% \begin{Item}{Notes}
% \end{Item}
% \begin{enumerate}
% \item When the comma is used as the decimal marker, the preferred
%       sign for the multiplication of numbers is the half-high dot
%       (German convention).
%       \begin{Ipara}[\normalsize]
%       \xnum{3{,}645\;98 \cdot 10^2} ~ or ~
%       \xnum{2{,}58 \cdot 31{,}2}
%       \end{Ipara}
%       The comma is also used together with the cross for the
%       multiplication of values of quantities (South African Convention).
%       \begin{Ipara}[\normalsize]
%       \xnum{3{,}645\;98 {\times} 10^2} ~ or ~
%       \xnum{2{,}58 \times 31{,}2}
%       \end{Ipara}
%
% \item The multiplication of quantity symbols (or numbers in
% parentheses or values of quantities in parentheses) may be
% indicated in one of the following ways: $ab$, $a\;b$, $a\cdot b$,
% $a\times b$.
% \end{enumerate}
%
%
%^^A=================================================================
% \StopEventually{\PrintChanges\PrintIndex}
% \clearpage
% \part{Implementation: \pkg{SIstyle}}
%
%    \begin{macrocode}
%<*package>
%    \end{macrocode}
%
%    \section{Utilities}
%
%    We need the \cmd{\text} command from the \AmS\ package
%    \pkg{amstext} for the typesetting of text in math mode.
%    \begin{macrocode}
\RequirePackage{amstext}
%    \end{macrocode}
%
%    \subsection{Test for empty argument}
%
%    \begin{macro}{\SI@ifempt}
%    Test for a empty argument (Wilson, Arseneau in
%    \pkg{ifmtarg.sty}).\\
%    Usage: \cmd{\SI@ifempt}\marg{arg}\marg{true}\marg{false}
%
%    \begin{macrocode}
\begingroup
   \catcode`\Q=3
   \long\gdef\SI@ifempt#1{\SI@xifempt#1QQ\@secondoftwo\@firstoftwo\@nil}
   \long\gdef\SI@xifempt#1#2Q#3#4#5\@nil{#4}
\endgroup
%    \end{macrocode}
%    \end{macro}
%
%    \subsection{Font test commands}
%
%    \begin{macro}{\GetMathFontFams}
%    There exists no hook to test for the current active
%    math font. Get the different families at the beginning
%    of the document. We only look for \cmd{\mathsf} and
%    \cmd{\mathtt}. The others are set with the default
%    math font (\cmd{\mathrm}).
%    \begin{macrocode}
 \newcommand{\GetMathFontFams}{%
    \sbox{0}{$%
       \@ifundefined{mathsf}
          {\global\chardef\SI@sffam=99}%
          {\mathsf{\global\chardef\SI@sffam=\fam}}%
       \@ifundefined{mathtt}
          {\global\chardef\SI@ttfam=99}%
          {\mathtt{\global\chardef\SI@ttfam=\fam}}%
       $}%
  }
%    \end{macrocode}
%    \end{macro}
%    \begin{macrocode}
\AtBeginDocument{\GetMathFontFams}
%    \end{macrocode}
%
%    \begin{macro}{\IfTbold}
%    Test if bold text (\cmd{\bfseries} or \cmd{\bxseries}) is
%    active.\\
%    Usage: \cmd{\IfTbold}\marg{true}\marg{false}
%    \begin{macrocode}
\newcommand{\IfTbold}[2]{%
   \if b\expandafter\@car\f@series\@nil%
      #1\else #2\fi}
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\IfMbold}
%    Test if \cmd{\boldmath} is active.
%    Usage: \cmd{\IfMbold}\marg{true}\marg{false}
%    \begin{macrocode}
\newcommand{\IfMbold}[2]{%
   \edef\temp@bm{bold}%
   \ifx\math@version\temp@bm
      #1\else #2\fi}
%    \end{macrocode}
%    \end{macro}
%
%
%    \subsection{Font user setup commands}
%
%    \begin{macro}{\SIobeybold}
%    User flag to obey bold text and math bold setting for
%    SI units and numbers.
%    \begin{macrocode}
\newif\ifSIobeybold
\SIobeyboldfalse
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\SIdefaultMfam}
%    \begin{macro}{\SI@defaultMfam}
%    The default upright math font for typesetting SI units. This
%    is normally the \cmd{\mathrm} command, but the user may select
%    a different font.
%    \begin{macrocode}
\newcommand*{\SI@defaultMfam}{\mathrm}
\newcommand*{\SIdefaultMfam}[1]{\renewcommand*{\SI@defaultMfam}{#1}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%    \begin{macro}{\SIdefaultNfam}
%    \begin{macro}{\SI@defaultNfam}
%    The default upright math font for typesetting numbers. This
%    is normally the \cmd{\mathrm} command, but the user may select
%    a different font, for example \cmd{\mathnormal} to obtain
%    old-style digits.
%    \begin{macrocode}
\newcommand*{\SI@defaultNfam}{\mathrm}
\newcommand*{\SIdefaultNfam}[1]{\renewcommand*{\SI@defaultNfam}{#1}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SIdefaultTfam}
%    \begin{macro}{\SI@defaultTfam}
%    The default text font for units set inside a \cmd{\mbox},
%    such as symbols from the \pkg{textcomp} package. It sets the
%    font when the surrounding text font is not \cmd{\sffamily} or
%    \cmd{\ttfamily} or if it is set inside display math.
%    \begin{macrocode}
\newcommand*{\SI@defaultTfam}{\rmfamily}
\newcommand*{\SIdefaultTfam}[1]{\renewcommand*{\SI@defaultTfam}{#1}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SIupmath}
%    This command set units and numbers in an upright font.
%    When called inside a normal text paragraph or inside
%    inline math |$...$|, it will follow the surrounding
%    text font: sansserif or typewrite otherwise it will
%    default to the roman font. Inside display math it will
%    follows the active math font.
%
%    The prerequisite to toggle the \cmd{\boldmath} math version
%    results in setting the argument inside the \AmS\ \cmd{\text}
%    command. It has the added benefit of scaling with the active
%    math style.
%
%    Usage: \cmd{\SIupmath}\oarg{math font}\marg{argument}
%
%    \begin{macro}{\ifupmath}
%    Flag to indicate whether we are inside \cmd{\SIupmath}.
%    \begin{macrocode}
\newif\ifupmath
\upmathfalse
%    \end{macrocode}
%    \begin{macrocode}
\newcommand*{\SIupmath}[2][\SI@defaultMfam]{%
\begingroup
   \upmathtrue
   \edef\temp@sf{\sfdefault}%
   \edef\temp@tt{\ttdefault}%
   \let\SI@bold=\relax
   \ifmmode
      \ifdim\displaywidth>0pt\relax%--- DISPLAY MATH ------------
         \ifnum\the\fam=\SI@sffam
            \let\SI@mfam=\mathsf
            \let\SI@tfam=\sffamily
         \else \ifnum\the\fam=\SI@ttfam
            \let\SI@mfam=\mathtt
            \let\SI@tfam=\ttfamily
         \else
            \let\SI@mfam=#1%
            \let\SI@tfam=\SI@defaultTfam
         \fi\fi
         \IfMbold{\def\SI@bold{\bfseries}}%
                 {\def\SI@bold{\mdseries}}%
      \else%--- INLINE MATH ----------
         \ifx\f@family\temp@sf
            \let\SI@mfam=\mathsf
            \let\SI@tfam=\sffamily
         \else\ifx\f@family\temp@tt
            \let\SI@mfam=\mathtt
            \let\SI@tfam=\ttfamily
         \else
            \let\SI@mfam=#1%
            \let\SI@tfam=\SI@defaultTfam
         \fi\fi
         \IfTbold{\def\SI@bold{\boldmath}}%
                 {\def\SI@bold{\unboldmath}}%
      \fi
   \else%----- NORMAL TEXT --------------
      \ifx\f@family\temp@sf
         \let\SI@mfam=\mathsf
         \let\SI@tfam=\sffamily
      \else\ifx\f@family\temp@tt
         \let\SI@mfam=\mathtt
         \let\SI@tfam=\ttfamily
      \else
         \let\SI@mfam=#1%
         \let\SI@tfam=\SI@defaultTfam
      \fi\fi
      \IfTbold{\def\SI@bold{\boldmath}}%
              {\def\SI@bold{\unboldmath}}%
   \fi%----- END OF TEST --------------
   \text{%
      \ifSIobeybold\SI@bold\else\unboldmath\mdseries\fi
      \upshape\SI@tfam
      $\SI@mfam{#2}$}%
\endgroup
\check@mathfonts}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\ensureupmath}
%    A user command to use the \cmd{\SIupmath} command.
%    \begin{macrocode}
\DeclareRobustCommand{\ensureupmath}{%
   \ifupmath
      \expandafter\@firstofone
   \else
      \expandafter\SIupmath
   \fi}
%    \end{macrocode}
%    \end{macro}
%
%
%    \section{Typeset Numbers}
%
%    \subsection{Setup for typesetting numbers}
%
%    \begin{macro}{\SIdecimalsign}
%    \begin{macro}{\SI@decsign}
%    User command to set decimal sign.
%    \begin{macrocode}
\newcommand*{\SI@decsign}{{.}}
\newcommand*{\SIdecimalsign}[1]{\renewcommand*{\SI@decsign}{{#1}}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SIthousandsep}
%    \begin{macro}{\SI@thousandsep}
%    User command to set thousands separator.
%    \begin{macrocode}
\newcommand*{\SI@thousandsep}{{\,}}
\newcommand*{\SIthousandsep}[1]{\renewcommand*{\SI@thousandsep}{{#1}}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SIproductsign}
%    \begin{macro}{\SI@prod}
%    User command to set product sign.
%    \begin{macrocode}
\newcommand*{\SI@prod}{\ensuremath{{}\times{}}}
\newcommand*{\SIproductsign}[1]{\renewcommand*{\SI@prod}{\ensuremath{{}#1{}}}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\ifSIgroupfour}
%    User flag for the grouping of four digits.
%    \begin{macrocode}
\newif\ifSIgroupfour
\SIgroupfourtrue
%    \end{macrocode}
%    \end{macro}
%
%
%    \subsection{Number parser}
%
%    \begin{macro}{\SI@num}
%     Main command for typesetting numbers. Zap all input spaces and
%     make E's lowercase.
%    \begin{macrocode}
\def\SI@num#1{%
   \SI@ifempt{#1}{}{%
      \edef\SI@tmpa{\lowercase{\noexpand\SI@@num{\zap@space#1 \@empty}}}%
      \SI@tmpa}}
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\SI@@num}
%    \begin{macro}{\SI@numsplit}
%    Split of the exponential part (Downes, Oberdiek on c.t.t)
%    \begin{macrocode}
\def\SI@@num#1{\SI@numsplit#1ee\SI@numexp\SI@realp\@empty}
\def\SI@numsplit#1e#2e#3#4#5{#4{#1}{#2}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SI@p@tst}
%    \begin{macro}{\SI@m@tst}
%    Temporaries to test for $+$ and $-$.
%    \begin{macrocode}
\def\SI@p@tst{+}
\def\SI@m@tst{-}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SI@numexp}
%    Type the exponent if the argument contains an ``E'' or ``e''.
%    \begin{macrocode}
\def\SI@numexp#1#2{%
   \SI@ifempt{#1}{}{%
      \def\SI@tmpb{#1}%
      \ifx\SI@tmpb\SI@p@tst\ensuremath{+}\else
      \ifx\SI@tmpb\SI@m@tst\ensuremath{-}\else
         \SI@realp{#1}{}\SI@prod%
      \fi\fi}%
   \ifmmode
     10^{\SI@realp{#2}{}}%
   \else
     10\textsuperscript{\SI@realp{#2}{}}%
   \fi}
%    \end{macrocode}
%    \end{macro}
%
%
%    \begin{macro}{\SI@realp}
%    \begin{macro}{\SI@realpsplit}
%    Split of the integer and decimal part (for decimal point).
%    \begin{macrocode}
\def\SI@realp#1#2{\SI@realpsplit#1..\SI@realfrc\SI@realc\@empty}
\def\SI@realpsplit#1.#2.#3#4#5{#4{#1}{#2}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SI@realc}
%    \begin{macro}{\SI@realcsplit}
%    Split of the integer and decimal part (for decimal comma).
%    \begin{macrocode}
\def\SI@realc#1#2{\SI@realcsplit#1,,\SI@realfrc\SI@signedint\@empty}
\def\SI@realcsplit#1,#2,#3#4#5{#4{#1}{#2}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%
%    \begin{macro}{\SI@realfrc}
%    Type the number if it contains a fraction part. Insert a zero
%    if the integer is empty (no sign either).
%    \begin{macrocode}
\def\SI@realfrc#1#2{%
   \SI@ifempt{#1}{\SI@int{0}}%
                 {\SI@signedint{#1}{}}%
   \SI@decsign\SI@dec{#2}}
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\SI@signedint}
%    Split the plus and minus from the integer.
%    \begin{macrocode}
\def\SI@signedint#1#2{\SI@@signedint#1 }
\def\SI@@signedint#1#2 {%
  \if +#1\ensuremath{+}%
      \SI@ifempt{#2}{\SI@int{0}}{\SI@int{#2}}%
  \else
  \if -#1\ensuremath{-}%
      \SI@ifempt{#2}{\SI@int{0}}{\SI@int{#2}}%
  \else
  \SI@int{#1#2}\fi \fi}
%    \end{macrocode}
%    \end{macro}
%
%
%    \begin{macro}{\SI@not@v}
%    \begin{macro}{\SI@@not@v}
%    Test for a fifth digit.
%    \begin{macrocode}
\def\SI@not@v#1{\SI@@not@v#1\@empty\@empty\@empty\@empty\@empty\@nil}
\def\SI@@not@v#1#2#3#4#5\@nil{%
   \ifx\@empty#5\@empty
      \expandafter\@firstoftwo
   \else
      \expandafter\@secondoftwo
   \fi}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%
%    \begin{macro}{\SI@int}
%    Set the integer. If \cmd{\ifSIgroup} is true and the number has
%    four or less digits, then set the number. Otherwise pass it
%    on to the formatting command.
%    \begin{macrocode}
\def\SI@int#1{%
   \ifSIgroupfour
      \SI@not@v{#1}{#1}{\SI@intfmt{}#1\@empty\@empty\@empty}%
   \else
      \SI@intfmt{}#1\@empty\@empty\@empty%
   \fi}
%    \end{macrocode}
%    \end{macro}
%
%
%    \begin{macro}{\SI@intfmt}
%    \begin{macro}{\SI@intfmtafterfi}
%    \begin{macro}{\SI@addthousandsep}
%    Finally typeset the integer in groups of three. (From a macro
%    to typeset Dollar amounts by Donald Arseneau on c.t.t.)
%    \begin{macrocode}
\def\SI@intfmt#1#2#3#4{%
  \ifx\@empty#2\@empty%
    \SI@addthousandsep#1\relax
  \else
    \ifx\@empty#3\@empty%
      \SI@addthousandsep\@empty\@empty#1#2\relax
    \else
      \ifx\@empty#4\@empty%
        \SI@addthousandsep\@empty#1#2#3\relax
      \else
        \SI@intfmtafterfi{#1#2#3#4}%
      \fi
    \fi
  \fi}
%    \end{macrocode}
%
%    \begin{macrocode}
\def\SI@intfmtafterfi#1\fi\fi\fi{\fi\fi\fi\SI@intfmt{#1}}
%    \end{macrocode}
%
%    \begin{macrocode}
\def\SI@addthousandsep#1#2#3#4{#1#2#3%
  \if\relax#4\relax
  \else
    \SI@thousandsep\expandafter\SI@addthousandsep\expandafter#4%
  \fi}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SI@dec}
%    \begin{macro}{\SI@decfmt}
%     Set the decimal part (from \pkg{frenchb.ldf} by by Johannes L. Braams)
%    \begin{macrocode}
\def\SI@dec#1{%
   \ifSIgroupfour
      \SI@not@v{#1}{#1}{\SI@decfmt#1\@empty\@empty\@empty\@empty}%
   \else
      \SI@decfmt#1\@empty\@empty\@empty\@empty%
   \fi}
%    \end{macrocode}
%
%    \begin{macrocode}
\def\SI@decfmt#1#2#3#4{#1#2#3%
  \ifx\@empty#4\@empty%
  \else
    \SI@thousandsep\expandafter\SI@decfmt\expandafter#4%
  \fi}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%
%
%
%    \subsection{Number commands}
%
%    \begin{macro}{\SInum}
%    Command to typeset a number in upright math font
%    with \cmd{\SIupmath}
%    \begin{macrocode}
\newcommand*{\SInum}[1]{{%
   \let\SI@unitdot=\pnt%
   \SIupmath[\SI@defaultNfam]{\SI@num{#1}}}}
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\num}
%    The robust user command to typeset a number.
%    The starred form gives a number in the normal active
%    font.
%    \begin{macrocode}
\DeclareRobustCommand*{\num}{\@ifstar{\SI@num}{\SInum}}
%    \end{macrocode}
%    \end{macro}
%
%
%    \section{Typesetting Angles}
%
%    \begin{macro}{\SI@degs}
%    \begin{macro}{\SI@mins}
%    \begin{macro}{\SI@secs}
%    Scratch commands to hold definitions.
%    \begin{macrocode}
\let\SI@degs=\relax
\let\SI@mins=\relax
\let\SI@secs=\relax
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\ang}
%    \begin{macro}{\SI@ang}
%    The robust user command to typeset angles.
%    \begin{macrocode}
\DeclareRobustCommand{\ang}[1]{\SI@ang#1;;;\@nnil}
%    \end{macrocode}
%    \begin{macrocode}
\def\SI@ang#1;#2;#3;#4\@nnil{%
\bgroup
   \SI@ifempt{#3}{}{\def\SI@secs{\SInum{#3}\SIupmath{\arcsec}}%
                    \def\SI@mins{\SInum{0}\SIupmath{\arcmin}}%
                    \def\SI@degs{\SInum{0}\SIupmath{\arcdeg}}}%
   \SI@ifempt{#2}{}{\def\SI@mins{\SInum{#2}\SIupmath{\arcmin}}%
                    \def\SI@degs{\SInum{0}\SIupmath{\arcdeg}}}%
   \SI@ifempt{#1}{}{\def\SI@degs{\SInum{#1}\SIupmath{\arcdeg}}}%
   \SI@degs\SI@mins\SI@secs
\egroup}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%
%
%     \section{Typesetting Units}
%     \subsection{Unit setup commands}
%
%    \begin{macro}{\SIunitsep}
%    \begin{macro}{\SI@unitsep}
%    User command to set unit separation width from the number.
%    \begin{macrocode}
\newcommand*{\SI@unitsep}{\,}
\newcommand*{\SIunitsep}[1]{\renewcommand*{\SI@unitsep}{#1}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SIunitspace}
%    \begin{macro}{\SI@unitspace}
%    User command to set the spacing between units when
%    ``\tlde'' is issued.
%    \begin{macrocode}
\newcommand*{\SI@unitspace}{\,}
\newcommand*{\SIunitspace}[1]{\renewcommand*{\SI@unitspace}{#1}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\SIunitdot}
%    \begin{macro}{\SI@unitdot}
%    User command to set the unit dot when ``.'' is
%    given between units.
%    \begin{macrocode}
\newcommand*{\SI@unitdot}{{\cdot}}
\newcommand*{\SIunitdot}[1]{\renewcommand*{\SI@unitdot}{#1}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%
%    \begin{macro}{\pnt}
%    Supply \cmd{\pnt}  command for ``.'' in mathmode.
%    Define the point ``.'' as a command when active
%    (|\mathcode`.="8000|) inside math environment.
%    \begin{macrocode}
\DeclareMathSymbol{\pnt}{\mathord}{letters}{58}   %(\pnt = .)
{\catcode`\.=13 \gdef.{\SI@unitdot}}
%    \end{macrocode}
%    \end{macro}
%
%
%    \subsection{Commands for units}
%
%    \begin{macro}{\SIunit}
%    Command that sets the environment for typesetting units.
%    The ``.'' is made active and the ``\tlde'' is redefined.
%    \begin{macrocode}
\newcommand*{\SIunit}[1]{%
\begingroup%
    \mathcode`.="8000%
    \def~{\SI@unitspace}%
    \SIupmath{#1}%
\endgroup}
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\SI}
%    Command to typeset numbers with units.
%
%    Usage: \cmd{\SI}\marg{number}\marg{unit}
%    \begin{macrocode}
\DeclareRobustCommand*{\SI}[2]{%
   \SI@ifempt{#1}{}{\SInum{#1}\SI@unitsep}%
   \SIunit{#2}}
%    \end{macrocode}
%    \end{macro}
%
%    \section{Additional Units}
%
%    \noindent
%    Additional non Latin user symbols are defined:
%    \begin{macrocode}
\AtBeginDocument{%
    \@ifpackageloaded{textcomp}{%
         \providecommand*{\micro}{\ensureupmath{\mbox{\textmu}}}%
         \providecommand*{\ohm}{\ensureupmath{\mbox{\textohm}}}%
         \providecommand*{\degC}{\ensureupmath{\mbox{\textcelsius}}}%
         \providecommand*{\degF}{\ensureupmath{\mbox{\textdegree F}}}%
         \providecommand*{\arcdeg}{\ensureupmath{\mbox{\textdegree}}}%
         \providecommand*{\angstrom}{\ensureupmath{\mbox{\capitalring{A}}}}%
    }{%
         \providecommand*{\micro}{\ensureupmath{\mu}}%
         \providecommand*{\ohm}{\ensureupmath{\Omega}}%
         \providecommand*{\degC}{%
             \ensureupmath{{}^{\circ}\kern-\scriptspace C}}%
         \providecommand*{\degF}{%
             \ensureupmath{{}^{\circ}\kern-\scriptspace F}}%
         \providecommand*{\arcdeg}{\ensureupmath{{}^{\circ}}}%
         \providecommand*{\angstrom}{\ensureupmath{\mbox{\AA}}}%
    }%
   \providecommand*{\arcmin}{\ensureupmath{{}^{\prime}}}%
   \providecommand*{\arcsec}{\ensureupmath{{}^{\prime\prime}}}%
}
%    \end{macrocode}
%
%    \section{Locales}
%    \subsection{Macros}
%
%    Temporary tokens.
%    \begin{macrocode}
\newtoks\ttoks@A
\newtoks\ttoks@B
%    \end{macrocode}
%
%    \begin{macro}{\SIstyle}
%    The main command to activate a spesific style.
%    \begin{macrocode}
\newcommand{\SIstyle}[1]{%
   \@ifundefined{SIstyle#1}%
      {\PackageError{SIstyle}{Style `#1' is not defined}%
                           {See SIstyle package documentation}}%
      {\@nameuse{SIstyle#1}}}
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\AddToSIstyle}
%    \begin{macro}{\SI@s@addto@stl}
%    \begin{macro}{\SI@addto@stl}
%    Append the command list in |#2| to the style command |\SIstyle#1|.
%    The starred form clears the list before appending.
%    \begin{macrocode}
\newcommand{\AddToSIstyle}{%
   \@ifstar{\SI@s@addto@stl}{\SI@addto@stl}}
%    \end{macrocode}
%
%    \begin{macrocode}
\newcommand{\SI@s@addto@stl}[1]{%
   \expandafter\let\csname SIstyle#1\endcsname\relax
   \SI@addto@stl{#1}}
%    \end{macrocode}
%
%    \begin{macrocode}
\newcommand{\SI@addto@stl}[2]{%
   \expandafter\SI@addto@list\csname SIstyle#1\endcsname{#2}}
%    \end{macrocode}
%    \end{macro}
%    \end{macro}
%    \end{macro}
%    \begin{macrocode}
\@onlypreamble\AddToSIstyle
%    \end{macrocode}
%
%    \begin{macro}{\SIstyleToLang}
%    Links a locale to the \pkg{babel} language changing
%    |\extras|\meta{lang}.
%
%    \begin{macrocode}
\newcommand*{\SIstyleToLang}[2]{%
   \expandafter\SI@addto@list
      \csname extras#1\expandafter\endcsname
      \csname SIstyle#2\endcsname}
%    \end{macrocode}
%    \begin{macrocode}
\@onlypreamble\SIstyleToLang
%    \end{macrocode}
%    \end{macro}
%
%    \begin{macro}{\SI@addto@list}
%    The general macro to append to a list
%    (stolen for \pkg{varioref}).
%
%    \begin{macrocode}
\newcommand{\SI@addto@list}[2]{%
   \ttoks@A{#2}%
   \ifx#1\@undefined
      \edef#1{\the\ttoks@A}%
   \else
      \ifx#1\relax
         \edef#1{\the\ttoks@A}%
      \else
         \ttoks@B\expandafter{#1}%
         \edef#1{\the\ttoks@B\the\ttoks@A}%
      \fi
   \fi
   \ttoks@A{}\ttoks@B\ttoks@A}
%    \end{macrocode}
%    \end{macro}
%
%    \subsection{Country spesific setup}
%
% \paragraph{USA:}
% NIST Special Publication 811 -- \textit{Guide for the Use of the
% International System of Units (SI)}
%
%    \begin{macrocode}
\AddToSIstyle{USA}{%
  \SIdecimalsign{.}%
  \SIthousandsep{\,}%
  \SIunitsep{\,}%
  \SIunitdot{\cdot}%
  \SIunitspace{\;}%
  \SIproductsign{\times}%
  \SIobeyboldfalse
  \SIgroupfourtrue}
%    \end{macrocode}
% \paragraph{Germany:}
%    \begin{macrocode}
\AddToSIstyle{German}{%
   \SIdecimalsign{,}%
   \SIthousandsep{\,}%
   \SIproductsign{\cdot}%
   \SIunitsep{\,}%
   \SIunitspace{\,}%
   \SIunitdot{\cdot}%
   \SIobeyboldfalse
   \SIgroupfourtrue}
%    \end{macrocode}
% \paragraph{South Africa:}
% SABS M 33a:1992 -- \textit{The international metric system (SI).
% Guide to the use of the SI in South Africa.}
%    \begin{macrocode}
\AddToSIstyle{S-Africa}{%
   \SIdecimalsign{,}%
   \SIthousandsep{\,}%
   \SIproductsign{\times}%
   \SIunitsep{\,}%
   \SIunitspace{\,}%
   \SIunitdot{\cdot}%
   \SIobeyboldfalse
   \SIgroupfourtrue}
%    \end{macrocode}
%    \begin{macrocode}
%</package>
%    \end{macrocode}
%    The end of this package.
%    \Finale
\endinput