summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-11-16 22:22:53 +0000
committerKarl Berry <karl@freefriends.org>2015-11-16 22:22:53 +0000
commitd8258d9565c2f3e2c0e2a4d6f71099f8f604bbed (patch)
treed383ef5805c5e290869af382ce31d47b12292447 /Master/texmf-dist
parent46ee5d1eeb4e4c40471c0fae622e8fcc810a8261 (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.txt14
-rw-r--r--Master/texmf-dist/doc/generic/commado/commado.pdfbin575800 -> 594760 bytes
-rw-r--r--Master/texmf-dist/source/generic/commado/commado.tex86
-rw-r--r--Master/texmf-dist/source/generic/commado/srcfiles.tex8
-rw-r--r--Master/texmf-dist/tex/generic/commado/commado.RLS7
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
index 11d6fda71e5..231917bc79e 100644
--- a/Master/texmf-dist/doc/generic/commado/commado.pdf
+++ b/Master/texmf-dist/doc/generic/commado/commado.pdf
Binary files differ
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 ]