summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/unisugar
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-02-28 23:29:10 +0000
committerKarl Berry <karl@freefriends.org>2011-02-28 23:29:10 +0000
commitda98acfb686619bbeb89e3ccb80c0fbceca3f71b (patch)
treebd4ff867fbd945591b4425d57ede7e023b183235 /Master/texmf-dist/doc/xelatex/unisugar
parenta72ee27344c1305783b243a5919f9299a02cfe08 (diff)
unisugar (28feb11)
git-svn-id: svn://tug.org/texlive/trunk@21552 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xelatex/unisugar')
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/Makefile2
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/README36
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdfbin278749 -> 289674 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex48
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
Binary files differ
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