summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-05-08 23:07:14 +0000
committerKarl Berry <karl@freefriends.org>2011-05-08 23:07:14 +0000
commit923c59fcdff0b3f2a5ade27687660858ddc68f3c (patch)
tree887207a132971cc1efd76203ae77de299d66c68b /Master/texmf-dist/doc/xelatex
parentb762ba1368a8785e9f6832f1186588171e168a0a (diff)
unisugar (8may11)
git-svn-id: svn://tug.org/texlive/trunk@22357 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xelatex')
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/Makefile2
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/README39
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdfbin289674 -> 290702 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex62
4 files changed, 69 insertions, 34 deletions
diff --git a/Master/texmf-dist/doc/xelatex/unisugar/Makefile b/Master/texmf-dist/doc/xelatex/unisugar/Makefile
index fc29857bd38..3683205a4b6 100644
--- a/Master/texmf-dist/doc/xelatex/unisugar/Makefile
+++ b/Master/texmf-dist/doc/xelatex/unisugar/Makefile
@@ -8,7 +8,7 @@ ${PACKAGE}.pdf: ${SOURCES}
wrap: ${PACKAGE}.zip
-${PACKAGE}.zip: ${PACKAGE}.pdf $(SOURCES)
+${PACKAGE}.zip: ${PACKAGE}.pdf $(SOURCES) *.png
zip $@ $?
clean:
diff --git a/Master/texmf-dist/doc/xelatex/unisugar/README b/Master/texmf-dist/doc/xelatex/unisugar/README
index bc514c7b9ab..ace88b1da07 100644
--- a/Master/texmf-dist/doc/xelatex/unisugar/README
+++ b/Master/texmf-dist/doc/xelatex/unisugar/README
@@ -1,36 +1,27 @@
-___________________
-The unisugar package
-v 0.91
+The unisugar package 0.92
+=========================
-The package requires an TeX-alike system that uses Unicode input
+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
+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
+The intent is to minimize the use of English left-to-right characters 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.
+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 package may be distributed and/or modified under the LaTeX Project Public
+License (LPPL), version 1.3 or higher (your choice). The latest version of this
+license can be found at: http://www.latex-project.org/lppl.txt
This work is author-maintained(as per LPPL maintenance status)
-by Yossi Gil.
+by Yossi Gil <yogi@cs.Technion.ac.IL>
diff --git a/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf b/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf
index 4019046e579..8cbb73e6262 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 32f4c516383..e1df1d8d23f 100644
--- a/Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex
+++ b/Master/texmf-dist/doc/xelatex/unisugar/unisugar.tex
@@ -1,6 +1,8 @@
-\documentclass{ltxdoc} % Process with xelatex
+\documentclass{ltxdoc} % Process with xelatex -shell-esc
\usepackage{unisugar}
\usepackage[colorlinks=true]{hyperref}
+\usepackage{bashful}
+\usepackage{varioref}
⌘let⌘use␣package=⌘usepackage
⌘use␣package{xspace}
@@ -58,8 +60,40 @@ This work consists of the files ⌘texttt{⌘me.tex} and ⌘texttt{⌘me.sty}
⌘date{{⌘makeatletter
⌘date@unisugar\thanks{
This document describes ⌘unisugar ⌘version@unisugar.}}}
+
+
⌘begin{document}
+⌘bash[stdoutFile=README]
+cat << EOF
+The unisugar package 0.92
+=========================
+
+This package requires a TeX-alike system that uses native Unicode input system;
+current examples are XeTeX and LuaTeX. The package provides syntactic sugar for
+selected LaTeX commands, allowing these to be replaced with their Unicode-
+character counterpart, e.g., a Unicode bullet can be used instead of a \item,
+and a pilcrow can be used instead of \paragraph.
+
+The intent is to minimize the use of English left-to-right characters 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.
+
+This package may be distributed and/or modified under the LaTeX Project Public
+License (LPPL), version 1.3 or higher (your choice). The latest version of this
+license can be found at: http://www.latex-project.org/lppl.txt
+
+This work is author-maintained(as per LPPL maintenance status) by Yossi Gil
+<yogi@cs.Technion.ac.IL>
+EOF
+\END
+
⌘maketitle
⌘begin{abstract}
This package provides syntactic sugar
@@ -228,7 +262,7 @@ As the cursor moves forward beginning at the first character in
expect it to proceed to the adjacent
letter ⌘texthebrew{א}.
This so called ⌘emph{visual} flow is
- in fact incorrect.
+ in incorrect.
The more correct ⌘emph{logical} flow prescribes
that the cursor should instead ``jump'' to the
to the letter ⌘texthebrew{מ}, which is the first letter of
@@ -294,9 +328,9 @@ This might be confusing even further since the section body will,
⌘begin{figure}[!htbp]
⌘begin{center}
- \includegraphics[scale=0.3]{traditional.png}
+ ⌘includegraphics[scale=0.3]{traditional.png}
⌘end{center}
-\caption{Using traditional sectioning directive with right-to-left text}
+⌘caption{Using traditional sectioning directive with right-to-left text}
⌖{Figure:traditional}
⌘end{figure}
@@ -347,11 +381,11 @@ Still, four more ⌘Unicode characters are used by ⌘unisugar
⌘begin{enumerate}
• Code point 2022, the bullet, rendered as ⌘•, is
yet another name for the ⌘verb+\item+ command.
- In fact, to obtain this item, I typed
+To obtain this item, I typed
⌘begin{code}
\• Code point 2022, the bullet, rendered as ⌘textbackslash\•,⏎
is yet another name for the ⌘verb-\verb+\item+- command.⏎
- In fact, to obtain this item, I typed:⏎
+ To obtain this item, I typed:⏎
⌘end{code}
• Code point 23CE, the return symbol, rendered
as~⌘return␣key is an alias for ⌘verb+\\+.
@@ -383,6 +417,10 @@ is yet another name for the ⌘verb-\verb+\item+- command.⏎
To reference Table {\fontspec{DejaVu Sans Mono}\☝}\{Table:divisions\},
I wrote
⌘end{code}
+
+• Code point 2026 (horizontal ellipsis), rendered as \verb+…+, serves as a sugar nickname for
+ \verb+\ldots+, the lower ellipsis command.
+
⌘end{enumerate}
@@ -433,8 +471,8 @@ The intention is that it will serve for separating words
several words.
-The names of large number of ⌘LaTeX{} commands are made
- from two words
+The names of a large number of ⌘LaTeX{} commands are made
+ from two words.
There are even a dozen or so control sequences whose
name consists of three words, e.g., ⌘verb+\enlargethispage+
and ⌘verb+\addcontentsline+.
@@ -645,7 +683,8 @@ With ⌘texttt{sukkar}
§ History
⌘begin{description}
•[Version 0.9] Initial release.
-•[Version 0.91] Placed under
+•[Version 0.91] Placed under LPPL.
+•[Version 0.92] Added U+2026 HORIZONTAL ELLIPSIS, as nickname for ⌘verb+\ldots+.
⌘end{description}
@@ -660,4 +699,9 @@ Martin Scharrer and Will Robertson encouraged me to work on this package.
Vafa Khalighi
devotion to bidirectional text processing with ⌘LaTeX{}
was truly inspirational.
+
+
+
+
+
⌘end{document}