diff options
author | Karl Berry <karl@freefriends.org> | 2010-06-03 00:05:53 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-06-03 00:05:53 +0000 |
commit | 66d458ffb4296f606adea295988eec449f55621e (patch) | |
tree | 3cbd19eeac92cfa52aff17515893b571d0bd343c /Master/texmf-dist/doc/latex/newcommand/README | |
parent | 38164db6bdc7213159b596311fb51c3c5fe73e6a (diff) |
new support package newcommand 2.0 (2jun10)
git-svn-id: svn://tug.org/texlive/trunk@18704 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/newcommand/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/newcommand/README | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/newcommand/README b/Master/texmf-dist/doc/latex/newcommand/README new file mode 100644 index 00000000000..09bc10e65f2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/newcommand/README @@ -0,0 +1,58 @@ + +------------------------------------+ + | NEWCOMMAND.PY | + | | + | More flexible argument processing | + | than what \newcommand provides | + | | + | By Scott Pakin, scott+nc@pakin.org | + +------------------------------------+ + + +Description +----------- + +LaTeX's \newcommand is fairly limited in the way it processes optional +arguments, but the TeX alternative, a batch of \defs and \futurelets, +can be overwhelming to the casual LaTeX user. newcommand.py is a +Python program that automatically generates LaTeX macro definitions +for macros that require more powerful argument processing than +\newcommand can handle. newcommand.py is intended for LaTeX advanced +beginners (i.e., those who know how to use \newcommand but not +internal LaTeX2e commands such as \@ifnextchar) and for more advanced +users who want to save some typing when defining complex macros. + +With newcommand.py, the user specifies a template for a macro's +arguments. newcommand.py then custom-generates a macro definition +according to the user's specifications and includes a user-friendly +"Put code here" comment to indicate where the macro's main code should +appear. newcommand.py supports arbitrary interleavings of required +and optional arguments, starred macros, mandatory literal text, macros +with more than nine arguments, optional arguments delimited by +parentheses instead of square brackets, and optional arguments whose +value defaults to the value given for a prior argument. The generated +macros can easily be pasted into a LaTeX document and edited as +desired. + + +Installation +------------ + +You'll need a Python interpreter (http://www.python.org/). Besides +that, just make sure that newcommand.py is placed somewhere in your +path and that spark.py is somewhere that newcommand.py can find it. + + +Copyright and license +--------------------- + +Copyright (C) 2010 Scott Pakin, scott+nc@pakin.org + +This package may be distributed and/or modified under the conditions +of the LaTeX Project Public License, either version 1.3c 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.3c or later is part of all distributions of LaTeX version +2006/05/20 or later. |