diff options
author | Karl Berry <karl@freefriends.org> | 2015-11-16 22:22:53 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-11-16 22:22:53 +0000 |
commit | d8258d9565c2f3e2c0e2a4d6f71099f8f604bbed (patch) | |
tree | d383ef5805c5e290869af382ce31d47b12292447 /Master/texmf-dist | |
parent | 46ee5d1eeb4e4c40471c0fae622e8fcc810a8261 (diff) |
commado (16nov15)
git-svn-id: svn://tug.org/texlive/trunk@38875 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r-- | Master/texmf-dist/doc/generic/commado/SrcFILEs.txt | 14 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/commado/commado.pdf | bin | 575800 -> 594760 bytes | |||
-rw-r--r-- | Master/texmf-dist/source/generic/commado/commado.tex | 86 | ||||
-rw-r--r-- | Master/texmf-dist/source/generic/commado/srcfiles.tex | 8 | ||||
-rw-r--r-- | Master/texmf-dist/tex/generic/commado/commado.RLS | 7 |
5 files changed, 96 insertions, 19 deletions
diff --git a/Master/texmf-dist/doc/generic/commado/SrcFILEs.txt b/Master/texmf-dist/doc/generic/commado/SrcFILEs.txt index 363382a631e..4236cde316f 100644 --- a/Master/texmf-dist/doc/generic/commado/SrcFILEs.txt +++ b/Master/texmf-dist/doc/generic/commado/SrcFILEs.txt @@ -1,19 +1,19 @@ *File List* - commado.RLS 2012/11/30 v0.11 fix final trim + commado.RLS 2015/11/16 r0.11a doc. `AllOf' in dowith commado.sty 2012/11/30 v0.11 iterate on CSL (UL) filesdo.sty 2012/11/27 v0.1 iterate on files (UL) - commado.tex 2012/11/30 -- documenting commado.sty -srcfiles.tex 2012/11/27 -- file infos -> SrcFILEs.txt + commado.tex 2015/11/16 -- documenting commado.sty +srcfiles.tex 2015/11/16 -- file infos -> SrcFILEs.txt ---USED.--- -- -- -- -- ---- fifinddo.sty 2012/11/17 v0.61 filtering TeX(t) files by TeX (UL) makedoc.sty 2012/08/28 v0.52 TeX input from *.sty (UL) -niceverb.sty 2012/11/27 v0.51 minimize doc markup (UL) -texlinks.sty 2012/11/28 v0.7 TeX-related links (UL) - makedoc.cfg 2012/11/30 -- documentation settings +niceverb.sty 2015/11/09 v0.61 minimize doc markup (UL) +texlinks.sty 2015/07/20 v0.83 TeX-related links (UL) + makedoc.cfg 2013/03/25 -- documentation settings mdoccorr.cfg 2012/11/13 -- `makedoc' local typographical corrections *********** - List made at 2012/11/30, 16:12 + List made at 2015/11/16, 06:27 from script file srcfiles.tex diff --git a/Master/texmf-dist/doc/generic/commado/commado.pdf b/Master/texmf-dist/doc/generic/commado/commado.pdf Binary files differindex 11d6fda71e5..231917bc79e 100644 --- a/Master/texmf-dist/doc/generic/commado/commado.pdf +++ b/Master/texmf-dist/doc/generic/commado/commado.pdf diff --git a/Master/texmf-dist/source/generic/commado/commado.tex b/Master/texmf-dist/source/generic/commado/commado.tex index b0e7935502a..e7ba43d9d83 100644 --- a/Master/texmf-dist/source/generic/commado/commado.tex +++ b/Master/texmf-dist/source/generic/commado/commado.tex @@ -1,4 +1,4 @@ -\ProvidesFile{commado.tex}[2012/11/30 documenting commado.sty] +\ProvidesFile{commado.tex}[2015/11/16 documenting commado.sty] \title{\pkg{\huge commado.sty} and \pkg{\huge filesdo.sty}\\---\\% Immediately Extend a One-Argument Macro\\ to Comma-Separated Lists and Combinations\\ @@ -11,10 +11,12 @@ \RequirePackage{makedoc} \ProcessLineMessage{} \renewcommand*{\mdSectionLevelOne}{\string\subsection} \MakeJobDoc{19}{\SectionLevelOneParseInput} %% 2012/11/26 -% \documentclass[fleqn]{article}%% TODO paper dimensions!? -\documentclass{article} %% TODO paper dimensions!? +\documentclass[fleqn]{article}%% TODO paper dimensions!? +% \documentclass{article} %% TODO paper dimensions!? \usepackage{catchdq} %% TODO earlier than `langcode' \input{makedoc.cfg} %% shared formatting settings +\ifpdf\else \errhelp{hyperref v6.83m option [draft] bad with \begin{equation}} + \errmessage{run this with pdflatex only}\fi \ReadPackageInfos{commado,filesdo} % \usepackage{commado} \MDkeywords{macro programming, programming structures, loops, lists} @@ -69,17 +71,84 @@ So roughly, % \pagebreak \section{Syntax and Relation to the 'dowith' Package} -In <list> with `\DoWithCSL{<cmd>}{<list>}', blank spaces +In <list> with |\DoWithCSL{<cmd>}{<list>}|, blank spaces %% boxed 2015/11/15 before entries or after commas as well as preceding the closing brace are ignored. So \[`\DoWithCSL{<cmd>}{ cfg, sty, tex }'\] works like -\[`\DoWith{<cmd>}{{cfg}{sty}{tex}}'\] +\[`\DoWithAllOf{<cmd>}{{cfg}{sty}{tex}}'\] %% added `AllOf' 2015/11/15 from \ctanpkgstyref{dowith}.\urlfoot{CtanPkgRef}{dowith} %% foot 2012/11/30 With `\DoWithCSL' (at present), %% 2012/11/27 an item cannot be empty or consist of blank spaces only. -Empty or blank items can be handled by `\DoWith'. +Empty or blank items can be handled by `\DoWith'\-`AllOf'. +%% <- was not wrong without `AllOf', however ... 2015/11/15 +%% ... hyphenation is a great compromise! without hyphen? +\par %% 2015/11/15 +\begingroup \footnotesize +As to \strong{relevance}, the previous remark addresses those +who want to understand what I am doing, such as me. +The two commands provide a rather obvious ``link'' between the 'commado' +and the 'dowith' bundle. But neither of them is a command that +``you shouldn't miss.'' 'commado.sty' is mainly a programming tool +(and I isolate it as an object of study). +% similar to a chess diagram to demonstrate how to trap a lonely king +% with king and rook only, the actual task being expandability, +% in my case to generate \acro{HTML} with \TeX's `\write' primitive). + \par\strong{Choosing between 'dowith' and 'commado'.}\quad What I +\strong{really use} in the case of comma-separated lists is +\strong{'filesdo.sty'} as described in the next section. %% TODO really? +It is great to keep certain files or file sections small (\strong{readability}), +actually in describing package bundles, on \acro{CTAN} as well as +with a complex book at which I am working. However, +the comma feature is a little more complex than the 'dowith' way, +and I like to avoid unnecessarily complex things. +The real advantage of 'filesdo', as I feel it, +is the readability of the code with combinations of file \emph{basenames} +and \emph{extensions}, similar to \emph{brace expansion} in the +\Wikidisambref{Bash}{Unix shell} shell. +The braces make obvious which are the basenames and which are the +extensions, and the commas structure each of these two lists. + +In applications of \strong{'dowith'}, saving \strong{tokens} and +\strong{expansion} steps is more important to me (a kind of sports). +\emph{Tokens} actually are saved with 'dowith' when <list> consists of +single tokens rather than ``\strong{brace groups},'' +and the former is the application of 'dowith' in my \ctanpkgdref{langcode} package +(in the 'dowith' discussion, I compare this with the \ctanpkgdref{xspace} package). +On the other hand, a <list> of brace groups even needs more tokens than a comma-separated list. +% (Due to \TeX's tokenization, readability and parsimony are opposite and +% incompatible goals.) +The number of tokens or expansion steps is relevant when a list is stored +as a macro or in a token register. It is less relevant when a list +is processed once only at the moment the input file is read +and then is not stored any longer. + +There is a situation where I prefer lists of \emph{brace groups} +to comma-separated lists although the former need more tokens +and their readablility is worse: I use something like +\begin{equation} + `\autrefs{{apples}{oranges}{pears}}' +\end{equation} +to generate a list of internal links in a \acro{HTML} file. +`\autrefs' this way rests on `\DoSeparateWith' from 'domore.sty'. +`\DoSeparateWith' is based on `\DoWith'. Sometimes I use the former +one directly as an \emph{author}. The alternative +\begin{equation} + `\autrefs{apples,oranges,pears}' +\end{equation} +would need less tokens (which is absolutely irrelevant in this case +because the line is in \TeX's memory for a moment only) +and may be easier to read. However, often I want to change the order +of the items. When I try this by cut\&paste in a comma-separated list, +I always wonder whether I should cut/copy the right-hand comma +of a list item or the left-hand comma; and at the next moment, +I have forgotten whether I cut the right-hand comma +or the other one. With the 'dowith' approach, I just cut\&paste +a brace group. A function key opens an empty brace group in my +favorite editor. + +\par \endgroup \section{Example for 'filesdo.sty'} In the file `srcfiles.tex' for the \ctanpkgdref{nicetext} bundle, @@ -129,3 +198,8 @@ VERSION HISTORY 2012/11/24 for v0.1 very first 2012/11/30 for v0.11 \ctanpkgdref moves to `makedoc.cfg', 2 more link footnotes +2015/11/15f. `AllOf' was missing in the description of + the relation to the `dowith' bundle -- + added an "essay" +2015/11/15 error message to deal with hyperref's + draft/equation problem as in dowith.tex diff --git a/Master/texmf-dist/source/generic/commado/srcfiles.tex b/Master/texmf-dist/source/generic/commado/srcfiles.tex index 5bc54458bef..1bffd266637 100644 --- a/Master/texmf-dist/source/generic/commado/srcfiles.tex +++ b/Master/texmf-dist/source/generic/commado/srcfiles.tex @@ -1,10 +1,10 @@ -\ProvidesFile{srcfiles.tex}[2012/11/27 file infos -> SrcFILEs.txt] +\ProvidesFile{srcfiles.tex}[2015/11/16 file infos -> SrcFILEs.txt] \RequirePackage[r,wrap]{nicefilelist} \RequirePackage{stacklet,filedate} \MaxBaseEmptyList* -\ModDates \FileDateAutoChecks %% release: -\ReadFileInfos{commado.RLS} +\ReadFileInfos{commado.RLS} %% tested below +\ModDates \FileDateAutoChecks %% packages: \ReadPackageInfos{commado,filesdo} %% documentation: @@ -13,5 +13,7 @@ \FileListRemark[ ----]{---USED.---} \ReadPackageInfos{fifinddo,makedoc,niceverb,texlinks} \ReadFileInfos{makedoc.cfg,mdoccorr.cfg} +\DatesDiffWarnings +\CheckDateOfToday{commado.RLS} \ListInfos[SrcFILEs.txt] diff --git a/Master/texmf-dist/tex/generic/commado/commado.RLS b/Master/texmf-dist/tex/generic/commado/commado.RLS index c026bdd1a81..4134b7c2770 100644 --- a/Master/texmf-dist/tex/generic/commado/commado.RLS +++ b/Master/texmf-dist/tex/generic/commado/commado.RLS @@ -1,3 +1,4 @@ -\ProvidesFile{commado.RLS} %% RELEASE INFO - [2012/11/30 v0.11 fix final trim] - [2012/11/27 v0.1 initial] +\ProvidesFile{commado.RLS} %%%% RELEASE INFO %%%% + [2015/11/16 r0.11a doc. `AllOf' in dowith] + [2012/11/30 v0.11 fix final trimming ] + [2012/11/27 v0.1 initial ] |