From da98acfb686619bbeb89e3ccb80c0fbceca3f71b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 28 Feb 2011 23:29:10 +0000 Subject: unisugar (28feb11) git-svn-id: svn://tug.org/texlive/trunk@21552 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/xelatex/unisugar/Makefile | 2 +- Master/texmf-dist/doc/xelatex/unisugar/README | 36 ++++++++++++++++ .../texmf-dist/doc/xelatex/unisugar/unisugar.pdf | Bin 278749 -> 289674 bytes .../texmf-dist/doc/xelatex/unisugar/unisugar.tex | 48 ++++++++++++++++----- 4 files changed, 75 insertions(+), 11 deletions(-) create mode 100644 Master/texmf-dist/doc/xelatex/unisugar/README (limited to 'Master/texmf-dist/doc/xelatex/unisugar') 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 Binary files a/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf and b/Master/texmf-dist/doc/xelatex/unisugar/unisugar.pdf 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 -- cgit v1.2.3