unisugar (28feb11)

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

4 files changed, 75 insertions, 11 deletions

diff --git a/Master/texmf-dist/doc/xelatex/unisugar/Makefile b/Master/texmf-dist/doc/xelatex/unisugar/Makefile
index 0547e59c103..fc29857bd38 100644
--- a/Master/texmf-dist/doc/xelatex/unisugar/Makefile
+++ b/Master/texmf-dist/doc/xelatex/unisugar/Makefile
@@ -1,5 +1,5 @@
 PACKAGE=unisugar
-SOURCES=${PACKAGE}.tex ${PACKAGE}.sty *.png Makefile
+SOURCES=${PACKAGE}.tex ${PACKAGE}.sty *.png Makefile README
 
 ${PACKAGE}.pdf: ${SOURCES}
 	yes q | xelatex ${PACKAGE}.tex >/dev/null
diff --git a/Master/texmf-dist/doc/xelatex/unisugar/README b/Master/texmf-dist/doc/xelatex/unisugar/README
new file mode 100644
index 00000000000..bc514c7b9ab
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/unisugar/README
@@ -0,0 +1,36 @@
+___________________
+The unisugar package
+v 0.91
+
+The package requires an TeX-alike system that uses Unicode input 
+in a native way: current examples are XeTeX and LuaTeX.
+
+This package provides syntactic sugar for LaTeX commands, using selected 
+Unicode characters: Certain Unicode characters can be used as shorthand for 
+popular LaTeX commands, e.g., a Unicode bullet can be used instead of a \item,
+and a pilcrow can be used instead paragraph.
+
+The intent is to minimize the use of English left-to-right charactes in 
+documents whose main language is written right-to-left, since mixing characters
+of different directionality confuses both text editors and human beings.
+
+Using this package,  you may find yourself typing a bit less, 
+provided you can configure your text editor or keyboard driver to 
+generate the handful of Unicode characters defined by this package.
+More importantly, the package is useful in defining macros whose name
+is composed of right-to-left characters and in minimizing mixed 
+directionality text in right-to-left documents.
+
+The author is Yossi Gil
+
+___________________
+Yossi Gil
+yogi@cs.technion.ac.il
+
+It may be distributed and/or modified 
+under the LaTeX Project Public License,
+version 1.3c or higher (your choice). The latest version of
+this license is at: http://www.latex-project.org/lppl.txt
+
+This work is author-maintained(as per LPPL maintenance status)
+by Yossi Gil.
diff --git a/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf b/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf
index 634ce100ae5..4019046e579 100644
--- a/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf
+++ b/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf
diff --git a/Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex b/Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex
index ebf44957ebc..32f4c516383 100644
--- a/Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex
+++ b/Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex
@@ -1,5 +1,6 @@
 \documentclass{ltxdoc} % Process with xelatex
 \usepackage{unisugar}
+\usepackage[colorlinks=true]{hyperref}
 
 ⌘let⌘use␣package=⌘usepackage
 ⌘use␣package{xspace}
@@ -17,7 +18,7 @@
 
 ⌘let⌘new␣environment=⌘newenvironment
 
-⌘new␣command⌘command␣key{{⌘codefont⌘⌘}⌘xspace}
+⌘new␣command⌘command␣key{{⌘codefont⌘⌘}}
 ⌘new␣command⌘return␣key{{⌘codefont⌘⏎}⌘xspace}
 
 ⌘new␣command⌘Unicode{⌘textsc{Unicode}⌘xspace}
@@ -31,14 +32,33 @@
   ⌘endquote
   ⌘endgroup
 }
+⌘new␣command⌘me{unisugar}
+⌘title{The ⌘textsf{⌘me} Package\thanks{
+  Copyright ⌘copyright{} 2011 by Yossi Gil  
+    ⌘url{mailto:yogi@cs.technion.ac.il}.
+  This work may be distributed and/or modified under the conditions of the
+    ⌘emph{⌘LaTeX{} Project Public License} (LPPL), either version 1.3 of this 
+    license or (at your option) any later version.  
+The latest version of this license is in 
+  ⌘url{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 Yossi Gil. 
+This work consists of the files ⌘texttt{⌘me.tex} and ⌘texttt{⌘me.sty} 
+  and the derived file
+  ⌘texttt{⌘me.pdf}
+}}
 
-⌘title{The ⌘textsf{unisugar} Package}
 ⌘author{Yossi Gil⌘thanks{⌘url{mailto:yogi@cs.Technion.ac.IL}}⏎
    ⌘normalsize Department of Computer Science⏎
    ⌘normalsize The Technion---Israel Institute of Technology⏎
    ⌘normalsize Technion City, Haifa 32000, Israel
 }
 
+⌘date{{⌘makeatletter
+     ⌘date@unisugar\thanks{
+        This document describes ⌘unisugar ⌘version@unisugar.}}}
+
 ⌘begin{document}
 ⌘maketitle
 ⌘begin{abstract}
@@ -46,10 +66,10 @@ This package provides syntactic sugar
   for ⌘LaTeX{} commands, using selected 
     ⌘href{http://www.unicode.org/standard/standard.html}⌘Unicode 
     characters:
-Certain ⌘Unicode characters can be used as shorthand for certain 
+Selected ⌘Unicode characters can be used as shorthand for certain 
   ⌘LaTeX{} commands.
 The package also makes it possible to use the familiar 
-  command key symbol,~⌘command␣key as a prefix of ⌘TeX{}'s 
+  command key symbol,~⌘command␣key{} as a prefix of ⌘TeX{}'s 
   macros (the backlash character,~⌘textbackslash, can
   still be used).
 And it allows the use of visual space,~⌘␣, 
@@ -95,7 +115,7 @@ If your document is indeed going to include right-to-left text, please
     your document divisioning directives, and 
     to Section~☝{Section:rtl:commands},
     which explains how ⌘unisugar makes it easier
-    to intermix ⌘LaTeX commands with your text.
+    to intermix ⌘LaTeX{} commands with your text.
 If however you are not likely to include right-to-left text in 
   your documents,
   you do not need to read these sections.
@@ -238,7 +258,7 @@ Broadly speaking, characters come
       characters of the Hebrew
   alphabet.
 • Undirected characters, including the digits 0-9, punctuation characters, 
-    and characters such as ⌘§, ⌘¶, ⌘␣, and ⌘command␣key
+    and characters such as ⌘§, ⌘¶, ⌘␣, and ⌘command␣key{}
     which are not part of specific writing script.
 ⌘end{enumerate}
 ⌘Unicode assigns a direction to each line
@@ -385,7 +405,7 @@ This package offers a slightly better syntax for writing these.
 First, ⌘Unicode's code point 2318, rendered as ⌘command␣key, 
   is used in many computing systems
    to denote the command key. 
-With ⌘unisugar,the~⌘command␣key
+With ⌘unisugar,the~⌘command␣key{}
   character can be used as a control sequence
   prefix,
 So, instead of writing at the beginning of this document
@@ -434,12 +454,12 @@ I wrote
 §§ Intermixing Commands with Right-to-Left Text
 ⌖{Section:rtl:commands}
 You may not appreciate so much the advantage of 
-  typing ⌘Unicode's~⌘command␣key 
+  typing ⌘Unicode's~⌘command␣key{}
   instead of plain ASCII's~⌘texttt{⌘textbackslash}.
 Granted, on most keyboards, typing~⌘texttt{⌘textbackslash}
   would be easier.
   
-However, the nice property of ⌘command␣key is that it directionally 
+However, the nice property of ⌘command␣key{} is that it directionally 
   neutral.
 You would have to think about a sentence 
   involving at least one ⌘LaTeX⌘ control sequence
@@ -556,7 +576,8 @@ The distinction between the first and which is the last ``backslash''
   }%
   )}
   
-The fact that the ⌘command␣key character does not lean neither left nor right,
+The fact that the ⌘command␣key{} character does not 
+  lean neither left nor right,
   takes care of the first annoyance.
   
 The remedy for the second is simpler---use a pair of curly brackets
@@ -619,6 +640,13 @@ With ⌘texttt{sukkar}
 עשה⌘␣{}כותרת
 ⌘end{hebrew}
   instead of ⌘verb+\make_title+.
+  
+  
+§ History
+⌘begin{description}
+•[Version 0.9] Initial release.
+•[Version 0.91] Placed under 
+⌘end{description}
     
 
 § Acknowledgements