braille (4dec10)

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

1 files changed, 167 insertions, 119 deletions

diff --git a/Master/texmf-dist/tex/latex/braille/braille.sty b/Master/texmf-dist/tex/latex/braille/braille.sty
index 3f9a66ef532..3827121aace 100644
--- a/Master/texmf-dist/tex/latex/braille/braille.sty
+++ b/Master/texmf-dist/tex/latex/braille/braille.sty
@@ -1,123 +1,171 @@
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-% braille.sty
-%
-% William Park <opengeometry@yahoo.ca>
-% September 1998, April 1999
-%
-% Major additions made by Dominique Unruh <dominique@unruh.de>
-% March 2001, October 2001
-%  - braille yields error, if invalid points are used in \braillbox
-%  - Option compact causes loading of \braille and tables to be ommitted
-%    (saves memory)
-%  - Option 8dots enables 8-dot braille
-%  - Option mirror mirrors.
-%  - Options useemptybox, puttinydots, 8dots, mirror can be switched on and off
-%    inside the document via \ifbraille...true and \ifbraille...false
-%  - Documentation in the header of braille.sty updated to reflect above
-%    changes
-%  - \braille{} command
-%  - compatible with e-LaTeX's r2l mode.
-%
-%
-% This package defines macros, commands, and fonts to typeset 6- or
-% 8-dot braille symbols for the blinds.  Both Grade 1 and 2 Braille are
-% supported.  All 189 Grade 2 contractions are defined; however, some
-% puctuation symbols are missing, simply because I couldn't find them.
-% 
-% Normally,
-%     \usepackage{braille}
-% is sufficient.  The command \braille{} takes braille "text" which is
-% made up of single character or string enclosed in {}.  It converts
-% "text" arguments into braille tags and calls predefined TeX macros to
-% print out the braille symbols.  For example, 
-%     \usepackage{braille}
-%     \braille{I {like} {com}put{er}}
-% will print braille symbols for
-%     'I', 'like', 'com', 'p', 'u', 't', 'er'
-% along with the 2 spaces.
-%
-% In the argument, whitespaces are processed by TeX in the usual manner.
-% Multiple whitespaces (' ', '\t', '\n') collapse to single space.  If
-% extra spacing is needed, then it must come from outside of \braille{}.
-% 
-% Examples:
-%     \braille{September {Number}1998}
-%     \braille{I run L{in}ux Slackw{ar}e {Number}3.3}
-%     \braille{{Capital}{this} is LaTeX package {for} {braille} {ou}tput.}
-%     \braille{I {also} wrote Py{th}on script {for} {con}v{er}t{ing}
-%     text {to}{braille}.}
-%
-% Therefore, you can type braille paragraph just as you would type
-% normal text paragraph.  To print single character, type that
-% character.  To print multi-character contraction, type that string
-% enclosed in {}.
-%
-% Note that the \braille command assumes English text. Other languages have
-% other abbreviations.
-%
-% The package is used as
-%     \usepackage[puttinydots,useemptybox,compact,8dots]{braille}
-% where
-%     puttinydots -- puts {\tiny.} at all dot positions for visual check
-%     useemptybox -- uses empty braille box instead of \hskip
-%     compact -- load only command \braillebox, not \braille (saves
-%		 memory)
-%     8dots -- display 8-dot braille (not used by \braille)
-%     mirror -- mirrors each braille box (for "printing" braille by hand
-%		with a needle, use e-LaTeX to get right-to-left
-%		writing).
-% You may activate or deactive inside the document
-%     puttinydots by \brailleputtinydotstrue resp. \brailleputtinydotsfalse
-%     useemptybox by \brailleuseemptyboxtrue resp. \brailleuseemptyboxfalse
-%     8dots       by \brailleeightdotstrue   resp. \brailleeightdotsfalse
-%     mirror      by \braillemirrortrue      resp. \braillemirrorfalse
-%
-% Four macros are available to the user:
-%     \braillebox{} -- LaTeX picture box used as braille font
-%     \brailleunit -- \unitlength for \braillebox{}
-%     \brailledot{} -- actual dot printed in \braillebox{}
-%     \braille{} -- main user command (unless option compact is
-%		    activated)
-% 
-% Additional vertical space between paragraphs may be necessary, since
-% \parskip=0pt is default.  \braillebox{} is simple LaTeX picture box
-%     \begin{picture}(2,3) ... \end{picture}
-% containing the actual patterns of dot which are placed with
-%     \put(0.5,0.5){\brailledot} ...
-% The size and shape of braille box and dot can be changed by modifying
-% \brailleunit and \brailledot{}, respectively.
-%
-%
-% List of TeX macros and braille symbols defined here is summarized in
-%     summary.tex -- "Summary of Grade 1 and 2 Braille"
-%     summary.ps
-% In order to type the braille tags manually, user would have to know
-% Braille.  To make it easier for people who don't know Braille, I wrote
-% Python scripts to convert ordinary ASCII text into grade 1 and 2
-% braille tags:
-%     grade1.py -- converts text into grade 1 braille
-%     grade2.py -- converts text into grade 2 braille
-% which behave like any Unix filters.  Since my knowledge of Braille is
-% limited, there will be errors and omissions.  So, check with a braille
-% expert.
-%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%  braille.sty
+%  
+%  William Park <opengeometry@yahoo.ca>
+%  September 1998, April 1999
+%      - original author
+%
+%  Dominique Unruh <dominique@unruh.de>
+%  March 2001, October 2001
+%      - major additions
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%  Copyright 1998-2010 William Park
+%
+%  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 this license is in
+%      http://www.latex-project.org/lppl.txt
+%  and version 1.3 or later is part of all distributions of LaTeX
+%  version 2005/12/01 or later.
+%
+%  This work has the LPPL maintenance status `maintained'.
+%
+%  The Current Maintainer of this work is William Park.
+%
+%  This work consists of all files listed below:
+%      README          -- this file
+%      braille.html    -- short description of braille.sty, grade[12].py
+%      braille.sty     -- LaTeX2e package for typesetting Braille
+%      braillegif1.gif -- transparent image
+%      braillegif2.gif -- transparent image
+%      grade1.py       -- Python script to convert text to Grade 1 Braille
+%      grade2.py       -- Python script to convert text to Grade 2 Braille
+%      summary.pdf     -- PDF of summary.tex
+%      summary.tex     -- list of TeX macros and Braille symbols
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%
+%  Major additions made by Dominique Unruh <dominique@unruh.de>
+%  March 2001, October 2001
+%   - braille yields error, if invalid points are used in \braillbox
+%   - Option compact causes loading of \braille and tables to be ommitted (saves
+%     memory)
+%   - Option 8dots enables 8-dot braille
+%   - Option mirror mirrors.
+%   - Options useemptybox, puttinydots, 8dots, mirror can be switched on and off
+%     inside the document via \ifbraille...true and \ifbraille...false
+%   - Documentation in the header of braille.sty updated to reflect above
+%     changes
+%   - \braille{} command
+%   - compatible with e-LaTeX's r2l mode.
+%
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%  Author:
+%  -------
+%  William Park <opengeometry@yahoo.ca>
+%  September 1998, April 1999
+%
+%  Description:
+%  ------------
+%
+%  This package defines macros, commands, and fonts to typeset 6-dot or 8-dot
+%  braille symbols for the blinds.  Both Grade 1 and 2 Braille are supported.
+%  All 189 Grade 2 contractions are defined; however, some puctuation symbols
+%  are missing, simply because I couldn't find them.
+%  
+%  Normally,
+%      \usepackage{braille}
+%  is sufficient.  The command \braille{} takes braille "text" which is made up
+%  of single character or string enclosed in {}.  It converts "text" arguments
+%  into braille tags and calls predefined TeX macros to print out the braille
+%  symbols.  For example, 
+%      \usepackage{braille}
+%      \braille{I {like} {com}put{er}}
+%  will print braille symbols for
+%      'I', 'like', 'com', 'p', 'u', 't', 'er'
+%  along with the 2 spaces.
+%
+%  In the argument, whitespaces are processed by TeX in the usual manner.
+%  Multiple whitespaces (' ', '\t', '\n') collapse to single space.  If extra
+%  spacing is needed, then it must come from outside of \braille{}.
+%  
+%  Examples:
+%      \braille{September {Number}1998}
+%      \braille{I run L{in}ux Slackw{ar}e {Number}3.3}
+%      \braille{{Capital}{this} is LaTeX package {for} {braille} {ou}tput.}
+%      \braille{I {also} wrote Py{th}on script {for} {con}v{er}t{ing} text
+%      {to}{braille}.}
+%
+%  Therefore, you can type braille paragraph just as you would type normal text
+%  paragraph.  To print single character, type that character.  To print
+%  multi-character contraction, type that string enclosed in {}.
+%
+%  Note that the \braille command assumes English text. Other languages have
+%  other abbreviations.
+%
+%
+%  Options:
+%  --------
+%
+%  The package is used as
+%      \usepackage[puttinydots,useemptybox,compact,8dots]{braille}
+%  where
+%      puttinydots -- puts {\tiny.} at all dot positions for visual check
+%      useemptybox -- uses empty braille box instead of \hskip
+%      compact     -- load only command \braillebox, not \braille (saves memory)
+%      8dots       -- display 8-dot braille (not used by \braille)
+%      mirror      -- mirrors each braille box (for "printing" braille by hand
+%                     with a needle, use e-LaTeX to get right-to-left writing).
+%
+%  You may activate or deactive inside the document
+%      puttinydots by \brailleputtinydotstrue resp. \brailleputtinydotsfalse
+%      useemptybox by \brailleuseemptyboxtrue resp. \brailleuseemptyboxfalse
+%      8dots       by \brailleeightdotstrue   resp. \brailleeightdotsfalse
+%      mirror      by \braillemirrortrue      resp. \braillemirrorfalse
+%
+%  Four macros are available to the user:
+%      \braillebox{} -- LaTeX picture box used as braille font
+%      \brailleunit  -- \unitlength for \braillebox{}
+%      \brailledot{} -- actual dot printed in \braillebox{}
+%      \braille{}    -- main user command (unless option compact is activated)
+%  
+%  Additional vertical space between paragraphs may be necessary, since
+%  \parskip=0pt is default.  \braillebox{} is simple LaTeX picture box
+%      \begin{picture}(2,3) ... \end{picture}
+%  containing the actual patterns of dot which are placed with
+%      \put(0.5,0.5){\brailledot} ...
+%  The size and shape of braille box and dot can be changed by modifying
+%  \brailleunit and \brailledot{}, respectively.
+%
+%
+%  Other Files:
+%  ------------
+%
+%  List of TeX macros and braille symbols defined here is summarized in
+%      summary.tex -- "Summary of Grade 1 and 2 Braille"
+%      summary.pdf
+%  In order to type the braille tags manually, user would have to know Braille.
+%  To make it easier for people who don't know Braille, I wrote Python scripts
+%  to convert ordinary ASCII text into grade 1 and 2 braille tags:
+%      grade1.py -- converts text into grade 1 braille
+%      grade2.py -- converts text into grade 2 braille
+%  which behave like any Unix filters.  Since my knowledge of Braille is
+%  limited, there will be errors and omissions.  So, check with a braille
+%  expert.
+%
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{braille}
 %  With options
-%       puttinydots     = put {\tiny.} at all dot positions
-%       useemptybox     = use empty braille box for space, not \hskip
+%      puttinydots = put {\tiny.} at all dot positions
+%      useemptybox = use empty braille box for space, not \hskip
 
 
 %  Usage:  \braillebox{12345678}
 %  Put dot (\brailledot) at positions 1, 2, 3, 4, 5, 6, 7, 8
 %  Dot locations:
-%   14
-%   25
-%   36
-%   78
+%      14
+%      25
+%      36
+%      78
 %
 \newlength{\brailleunit}        % size of box containing one dot
 \setlength{\brailleunit}{2mm}
@@ -250,7 +298,7 @@
 \newcommand{\suffix@char}[3]{\new@char{#3}{\old@char{#1}\braillebox{#2}}}
 
 
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %  Defines  \BRAILLE...
 %  where ... can be one or more characters.
 
@@ -304,14 +352,14 @@
 \def@char{z}{1356}  \prefix@char{6}{z}{Z}                \ln@char{z}{as}      
 
 %  Punctuation
-\def@char{,}{2}	    \ln@char{,}{ea}
-\def@char{;}{23}    \ln@char{;}{bb}	\ln@char{;}{be}
-\def@char{:}{25}    \ln@char{:}{cc}	\ln@char{:}{con}
-\def@char{.}{256}   \ln@char{.}{$}	\ln@char{.}{dd}	    \ln@char{.}{dis}
-\def@char{!}{235}   \ln@char{!}{ff}	\ln@char{!}{to}
-\def@char{(}{2356}  \ln@char{(}{)}	\ln@char{(}{gg}	    \ln@char{(}{were}
-\def@char{``}{236}  \ln@char{``}{?}	\ln@char{``}{his}
-\def@char{''}{356}  \ln@char{''}{by}	\ln@char{''}{was}
+\def@char{,}{2}     \ln@char{,}{ea}
+\def@char{;}{23}    \ln@char{;}{bb}     \ln@char{;}{be}
+\def@char{:}{25}    \ln@char{:}{cc}     \ln@char{:}{con}
+\def@char{.}{256}   \ln@char{.}{$}      \ln@char{.}{dd}     \ln@char{.}{dis}
+\def@char{!}{235}   \ln@char{!}{ff}     \ln@char{!}{to}
+\def@char{(}{2356}  \ln@char{(}{)}      \ln@char{(}{gg}     \ln@char{(}{were}
+\def@char{``}{236}  \ln@char{``}{?}     \ln@char{``}{his}
+\def@char{''}{356}  \ln@char{''}{by}    \ln@char{''}{was}
 \def@char{-}{36}    \ln@char{-}{com}
 \def@char{'}{3}
 \def@char{/}{34}