summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-12-05 00:11:31 +0000
committerKarl Berry <karl@freefriends.org>2010-12-05 00:11:31 +0000
commit4a35a6083597c5be84ca9a8c1f2da109d8c3a960 (patch)
tree0adcbbe7164b8923fe6218c1e83760eae732e554
parentcc655ac3a75a0bf9ce53c6acc5e0c0128a599af5 (diff)
braille (4dec10)
git-svn-id: svn://tug.org/texlive/trunk@20655 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/braille/README51
-rw-r--r--Master/texmf-dist/doc/latex/braille/braille.html8
-rw-r--r--Master/texmf-dist/doc/latex/braille/summary.pdfbin67811 -> 57727 bytes
-rw-r--r--Master/texmf-dist/tex/latex/braille/braille.sty286
4 files changed, 209 insertions, 136 deletions
diff --git a/Master/texmf-dist/doc/latex/braille/README b/Master/texmf-dist/doc/latex/braille/README
index abb8cb6d9c3..67580780f1f 100644
--- a/Master/texmf-dist/doc/latex/braille/README
+++ b/Master/texmf-dist/doc/latex/braille/README
@@ -1,11 +1,40 @@
-braille.html -- short description of braille.sty, grade[12].py
-braillegif1.gif -- transparent image
-braillegif2.gif -- transparent image
-braille.sty -- LaTeX2e package for typesetting Braille
-grade1.py -- Python script to convert text to Grade 1 Braille
-grade2.py -- Python script to convert text to Grade 2 Braille
-summary.tex -- list of TeX macros and Braille symbols
-summary.ps -- postscript of summary.tex
-
-William Park <parkw@better.net> <cv601@torfree.net>
-April 1999
+Author:
+-------
+
+William Park <opengeometry@yahoo.ca>
+September 1998, April 1999
+ - original author
+
+Dominique Unruh <dominique@unruh.de>
+March 2001, October 2001
+ - major additions
+
+
+Copyright:
+----------
+
+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
+
diff --git a/Master/texmf-dist/doc/latex/braille/braille.html b/Master/texmf-dist/doc/latex/braille/braille.html
index 6f0db66f902..061575135be 100644
--- a/Master/texmf-dist/doc/latex/braille/braille.html
+++ b/Master/texmf-dist/doc/latex/braille/braille.html
@@ -3,7 +3,7 @@ LaTeX2e package for typesetting Braille
</title></head><body bgcolor="whitesmoke">
<center>
<p><big><big>LaTeX2e package for typesetting Braille</big></big></p>
-<p><big>William Park</big></p>
+<p><big>William Park <a href="mailto:opengeometry@yahoo.ca">&lt;opengeometry@yahoo.ca&gt;</a></big></p>
<p><big>April 1999</big></p>
</center>
<h2><a name="Sec1">1&nbsp;&nbsp;&nbsp;&nbsp;Introduction</a></h2>
@@ -19,7 +19,7 @@ and fonts to typeset 6-dot braille symbols. 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. List of TeX macros and braille symbols can be found in
-<b>summary.tex</b> and <b>summary.ps</b>.
+<b>summary.tex</b> and <b>summary.pdf</b>.
The full usage is
<xmp>\usepackage[puttinydots,useemptybox]{braille}</xmp>
where <tt>puttinydots</tt> puts <tt>{\tiny.}</tt> at all dot positions
@@ -102,8 +102,4 @@ or their usage as python module are
<li> <a href="#Sec3">3&nbsp;&nbsp;&nbsp;&nbsp;grade1.py, grade2.py</a>
<li> <a href="#Sec4">4&nbsp;&nbsp;&nbsp;&nbsp;Table of Contents</a>
</ul>
-<p><hr></p>
-This file was generated using <b>HTMLtag</b> package.<br>
-William Park <a href="mailto:parkw@better.net">parkw@better.net</a> <br>
-April 1999
</body></html>
diff --git a/Master/texmf-dist/doc/latex/braille/summary.pdf b/Master/texmf-dist/doc/latex/braille/summary.pdf
index 3e08248a448..ab45bf5fb1d 100644
--- a/Master/texmf-dist/doc/latex/braille/summary.pdf
+++ b/Master/texmf-dist/doc/latex/braille/summary.pdf
Binary files differ
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}