trunk/Master/texmf-dist/source/latex/decimal

git-svn-id: svn://tug.org/texlive/trunk@221 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 279 insertions, 0 deletions

diff --git a/Master/texmf-dist/source/latex/decimal/decimal.dtx b/Master/texmf-dist/source/latex/decimal/decimal.dtx
new file mode 100644
index 00000000000..545f0e1b51c
--- /dev/null
+++ b/Master/texmf-dist/source/latex/decimal/decimal.dtx
@@ -0,0 +1,227 @@
+%% \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
+%
+% (c) copyright 2003 A Syropoulos & RWD Nickalls
+% This program can be redistributed and/or modified under the terms
+% of the LaTeX Project Public License Distributed from CTAN
+% archives in directory macros/latex/base/lppl.txt; either
+% version 1 of the License, or any later version.
+%
+% However, the above copyright notice does not apply in the case of
+% ``Crete University Press'' as this publisher is not allowed to
+% use or alter this file in any way.
+%
+% Please report errors or suggestions for improvement to
+%    
+%    Apostolos Syropoulos        and/or  Dick Nickalls
+%    apostolo@obelix.ee.duth.gr          dicknickalls@compuserve.com
+%
+%\fi
+% \CheckSum{21}
+% \iffalse This is a Metacomment
+%
+%<decimal, >\ProvidesFile{decimal.sty}
+%
+%<decimal, >  [2003/07/12 v1.0 Package `decimal.sty']
+%
+%    \begin{macrocode}
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage{decimal}
+\newcommand{\hidot}{\ensuremath{\raise.95ex\hbox{.}}}
+\GetFileInfo{decimal.drv}
+\begin{document}
+   \DocInput{decimal.dtx}
+\end{document}
+%</driver>
+%    \end{macrocode}
+% \fi
+%\StopEventually{}
+%\MakeShortVerb{\|}
+%\title{The `decimal' package}
+%\author{A.Syropoulos and R.W.D.Nickalls}
+% \date{2003/07/12}
+%\maketitle
+% \begin{abstract}
+% In traditional English typography the decimal point in printed as
+% slightly raised dot. This little package provides this functionallity
+% by making the period (``.'') active in math mode. In addition, we
+% redefine the commad |\.| so that it produces a dot in math mode, while
+% it retains its ordinary functionality in text mode. 
+%\end{abstract}
+%
+% \section{Introduction}
+% The decimal point is variously used as  a comma (European), a
+% full point (North American), or as a raised full point (English).
+% While the comma and full point have always been supported,
+% the English decimal point has been somewhat overlooked---until now.
+%
+% The \textsl{decimal} package places the height of the decimal
+% point level with the center of the `equals' sign, as shown by 
+% $x=0.3456$, by re-implementing a math mode full point as the 
+% |\cdot| character. However, in old texts the practice was to place
+% the full point rather higher, as in $25{\hidot}345$. While this is a bit 
+% too high for visual comfort nowadays, the reason for the original high
+% position lies in the name used by metal type-setters for the decimal point, 
+% namely a ``turned' full point, as mentioned in the following extract from 
+% an $80$~year-old \textsl{Authors' \& Printers' Dictionary}.%
+% \footnote{Collins H (1921). Authors' \& Printers' Dictionary: a guide for 
+% authors, editors, printers, correctors of the press, compositors, and 
+% typists. With a full list of abbreviations. An attempt to codify the best
+% typographical practices of the present day. (pub: Humphrey Milford, 
+% London).}
+%
+%\begin{center}
+%\begin{minipage}{0.7\textwidth}
+%\begin{itemize}
+% \item [\ ]\textbf{\hspace{-5mm}decimal fractions}, no decimal can be plural,
+% or take verb in pl., however many figures it contains; (typ.)
+% print in figures. The decimal
+% point in all cases to be a full point turned.
+%\end{itemize}
+%\end{minipage}
+%\end{center}
+%
+% But what is meant by a full point `turned'? The clue comes from an entry 
+% in the dictionary on `turned commas', as follows.
+%\begin{center}
+%\begin{minipage}{0.7\textwidth}
+%\begin{itemize}
+%  \item [\ ]\textbf{\hspace{-5mm}turned commas} (typ.),
+%   those used at the commencement of a quotation, as these~``, two
+%   apostrophes being  at the end.
+%\end{itemize}
+%\end{minipage}
+%\end{center}
+% If we  use a turned comma to  show the location  a  full point would occupy 
+% if `turned' in the same way,  we  can see that the position is somewhat 
+% high, as in the decimal fraction $2$`$6$. Swapping the turned
+% comma for a similarly turned full point we obtain~$2{\hidot}6$, which 
+% shows the decimal point in essentially the position we observe in older 
+% texts. All is now clear---the typesetter simply turned the metal block of 
+% the full point through $180\deg$ and, \textsl{eh presto}, he had a practical
+%  decimal point, albeit slightly on the high side.
+%
+% \section{Usage}
+%
+% First use  the \textsl{decimal} package using the |\usepackage{}| command 
+% in the preamble.
+%\begin{center}
+% |\usepackage{decimal}|
+%\end{center}
+% The \textsl{decimal} package will now operate globally to
+% implement the English decimal point where one types a fullpoint in
+% math mode. For example the value $123.456$ is obtained by typing
+% |$123.456$|. The correct positioning of the decimal is preserved even
+% when the smaller mathmode fonts are used, as shown in the following two 
+% examples.
+% $$
+%  23.562^{1.23^{\,2.6}}\hspace{2cm}
+%  j = \sqrt{  \underbrace{{ax^2 + bx +c }}_{-3.78} \ +\cos(3\pi/4 +\theta)}
+% $$
+%
+% On those occasions when a true full point is
+% required in math mode (e.g.~at the end of a series of equations)
+% then this is implemented by typing |\.|. For example
+% $$
+%   y = ax^2 + bx +c\.
+% $$
+% is obtained by typing |$y = ax^2 + bx +c\.$|.
+%
+% It is important to appreciate that there are math mode commands which 
+% include a full point as an integral part of the command, and in these cases 
+% one must, of course,  \textsl{not} use the |\.| command. A common situation 
+% where this arises is in the typesetting of unbalanced vertical braces, in 
+% which case a full point is used by one of the commands to represent the 
+% absent brace. For example, the structure
+% $$
+% \left\{
+% \begin{array}{l}
+% \displaystyle   x = -b/6 \\
+% \displaystyle   y = (4ac - b^2)/7
+% \end{array}
+% \right.
+% $$
+% is typeset by the following code
+%\begin{verbatim}
+% $$
+% \left\{
+%   \begin{array}{l}
+%   \displaystyle   x =  -b/6 \\
+%   \displaystyle   y = (4ac - b^2)/7
+%   \end{array}
+% \right.
+% $$
+%\end{verbatim}
+% which uses the command \verb!\right.! to balance the left brace
+% command \verb!\left\{! before the array. Since the full point
+% is part of the command then there is no need to use the |\.| command.
+% If we now add some punctuation to the above structure, say, a
+% comma terminating the first line and a full point to terminate
+% the second line as follows,
+% $$
+%  \left\{
+% \begin{array}{l}
+%  \displaystyle   x = -b/6, \\
+%  \displaystyle   y = (4ac - b^2)/3\.
+% \end{array}
+% \right.
+% $$
+% then we  add the full point using
+% the command |\.|  as shown in the following code.
+%\begin{verbatim}
+% $$
+% \left\{
+%  \begin{array}{l}
+%   \displaystyle   x =  -b/6, \\
+%   \displaystyle   y = (4ac - b^2)/7\.
+%  \end{array}
+% \right.
+%
+%\end{verbatim}
+% Outside math mode the command \verb!\.! performs its usual
+% function of placing a dot above a character, for example
+% the command \verb!\.{a}! generates the  \.{a} character.
+%
+% \section{The Implementation}
+%
+% The code of the package is quite simple. Initially, we introduce a new
+% command which has the functionality of the |\.| command. Then we redefine
+% the |\.| command so that it produces a dot in math mode, while it 
+% retains its original functionality in text mode.
+%    \begin{macrocode}
+%<*decimal>
+\let\peri@d\.
+\def\.{\ifmmode\mbox{.}\else\expandafter\peri@d\fi}
+%    \end{macrocode}
+% One thing we need to do is to define a new math command which will yield a 
+% |\cdot| without any leading or trailing white space. 
+%    \begin{macrocode}
+\DeclareMathSymbol{\cd@t}{\mathord}{symbols}{"01}
+%    \end{macrocode}
+% Now, we are ready to change the mathcode of the period so that it produces
+% the desired result in math mode. Note that this ``trick'' is documented
+% in the \TeX{}book and in the book ``Digital Typography Using \LaTeX,''
+% Springer-Verlag New York, ISBN 0-387-95217-9, 2003.   
+%    \begin{macrocode}
+\mathcode`\.="8000
+{\catcode`\.=\active%
+ \gdef.{\cd@t} }
+%</decimal>
+%    \end{macrocode}
+%
+% \Finale
diff --git a/Master/texmf-dist/source/latex/decimal/decimal.ins b/Master/texmf-dist/source/latex/decimal/decimal.ins
new file mode 100644
index 00000000000..4f479270c1c
--- /dev/null
+++ b/Master/texmf-dist/source/latex/decimal/decimal.ins
@@ -0,0 +1,52 @@
+%% Copyright 2003 Apostolos Syropoulos and Dick Nickalls
+%%
+%% This file is part of the `decimal' package.
+%% You are not allowed to modify its contents.
+%%
+\def\filedate{2003/07/12}
+\def\batchfile{decimal.ins}
+\input docstrip.tex
+
+{\ifx\generate\undefined
+\Msg{**********************************************}
+\Msg{*}
+\Msg{* This installation requires docstrip}
+\Msg{* version 2.3c or later.}
+\Msg{*}
+\Msg{* An older version of docstrip has been input}
+\Msg{*}
+\Msg{**********************************************}
+\errhelp{Move or rename old docstrip.tex.}
+\errmessage{Old docstrip in input path}
+\batchmode
+\csname @@end\endcsname
+\fi}
+
+\preamble
+
+ (c) copyright 2003 Apostolos Syropoulos and Dick Nickalls
+ This program can be redistributed and/or modified under the terms
+ of the LaTeX Project Public License Distributed from CTAN
+ archives in directory macros/latex/base/lppl.txt; either
+ version 1 of the License, or any later version.
+
+ Please report errors or suggestions for improvement to
+    
+    Apostolos Syropoulos          Dick Nickalls
+    apostolo@obelix.ee.duth.gr    dicknickalls@compuserve.com
+
+\endpreamble
+
+
+\keepsilent
+ 
+\generate{\generateFile{decimal.sty}{f}{\from{decimal.dtx}{decimal}}}
+\postamble
+\endpostamble
+\Msg{**********************************************************}
+\Msg{* To finish installation you have to copy}
+\Msg{* the generated .sty file in the appropriate}
+\Msg{* directory and then to rehash your TeX system}
+\Msg{*                  Happy English TeXing!}
+\Msg{**********************************************************}
+\endinput