From aa65893614c2e0df298ca15aaacbf845658546b1 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 6 Jan 2013 23:58:19 +0000 Subject: concepts (6jan13) git-svn-id: svn://tug.org/texlive/trunk@28752 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/concepts/concepts.pdf | Bin 326899 -> 307423 bytes Master/texmf-dist/doc/latex/concepts/concepts.tex | 20 ++++++++++++-------- 2 files changed, 12 insertions(+), 8 deletions(-) (limited to 'Master/texmf-dist/doc/latex/concepts') diff --git a/Master/texmf-dist/doc/latex/concepts/concepts.pdf b/Master/texmf-dist/doc/latex/concepts/concepts.pdf index b4418f5522e..1f4682c3c6b 100644 Binary files a/Master/texmf-dist/doc/latex/concepts/concepts.pdf and b/Master/texmf-dist/doc/latex/concepts/concepts.pdf differ diff --git a/Master/texmf-dist/doc/latex/concepts/concepts.tex b/Master/texmf-dist/doc/latex/concepts/concepts.tex index 7a26c65024c..70c2c5c1f51 100644 --- a/Master/texmf-dist/doc/latex/concepts/concepts.tex +++ b/Master/texmf-dist/doc/latex/concepts/concepts.tex @@ -33,7 +33,7 @@ } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% Changes % +% Global Changes % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \changes{0.0.1}{2012/11/16}{initial version} @@ -41,6 +41,7 @@ \changes{0.0.3}{2012/12/01}{separated the .dtx file from the .sty file} \changes{0.0.4}{2012/12/08}{finished the documentation and made a few fixes} \changes{0.0.5}{2012/12/18}{implemented symbol-list commands and improved documentation} +\changes{0.0.6}{2013/1/1}{made concept `options' mandatory + fixed some spacing bugs} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{document} % @@ -91,7 +92,10 @@ cannot generate a glossary yet. In future versions, it will interface with the \textsf{glossaries} package to accomplish this, and more. I'm also planning to implement a rudimentary typesystem, to catch even more -kinds of mistakes in symbol usage. +kinds of mistakes in symbol usage. Also, I may want to integrate the +|ligature| option from the \textsf{semantic} package, which allows you to +choose arbitrary characters to typeset your symbols in math mode (with some +restrictions). %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{Usage} % @@ -103,14 +107,14 @@ Afterwards, its name and associated symbols can by typeset using other macros. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \describemacro{\NewConcept}{ - \marg{concept key} \oarg{options} + \marg{concept key} \marg{options} } Every concept needs a unique \meta{concept key}, by which it will be identified for the rest of the document. This key can also be used to automatically derive the name of the concept as well as the macro used to typeset the name. -Usually, you'll also want to add \meta{options}. This optional argument takes +Then you'll want to add \meta{options}. This argument takes a comma-separated list of |key=value| pairs. The following is a list of available options. Note that the option names are case-sensitive: % @@ -139,22 +143,22 @@ options. Note that the option names are case-sensitive: Here are a few examples which will also be used to illustrate the other commands: \begin{latex-example} -\NewConcept{swproduct}[ +\NewConcept{swproduct}{ name = software product, % options 'plural', 'Plural' Name = Software Product, % are implicitly defined namecmd = \product, % defines \product symbols = {p}, % p represents a product symbolcmd = \p % defines \p -] +} \end{latex-example} % \begin{latex-example} \let\delta\relax \let\d\relax % I won't be using these -\NewConcept{delta}[ +\NewConcept{delta}{ namecmd, % defines \delta symbols = {x, y, z}, % x, y and z represent deltas symbolcmd = \d % defines \d -] +} \end{latex-example} There are certain restrictions on new concept declarations. You may -- cgit v1.2.3