From 57fc22b5f52e24c72134d98514f448933fa064de Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 6 Mar 2016 21:57:41 +0000 Subject: asciilist (6mar16) git-svn-id: svn://tug.org/texlive/trunk@39952 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/asciilist/asciilist.pdf | Bin 371202 -> 378360 bytes .../source/latex/asciilist/asciilist.dtx | 60 +++++++++++++++++++-- .../texmf-dist/tex/latex/asciilist/asciilist.sty | 3 +- 3 files changed, 58 insertions(+), 5 deletions(-) (limited to 'Master') diff --git a/Master/texmf-dist/doc/latex/asciilist/asciilist.pdf b/Master/texmf-dist/doc/latex/asciilist/asciilist.pdf index 795c67f9f04..4989540962a 100644 Binary files a/Master/texmf-dist/doc/latex/asciilist/asciilist.pdf and b/Master/texmf-dist/doc/latex/asciilist/asciilist.pdf differ diff --git a/Master/texmf-dist/source/latex/asciilist/asciilist.dtx b/Master/texmf-dist/source/latex/asciilist/asciilist.dtx index f0012cf4010..0df6d947d13 100644 --- a/Master/texmf-dist/source/latex/asciilist/asciilist.dtx +++ b/Master/texmf-dist/source/latex/asciilist/asciilist.dtx @@ -22,7 +22,7 @@ %\NeedsTeXFormat{LaTeX2e}[1999/12/01] %\ProvidesPackage{asciilist} %<*package> - [2016/02/23 v2.0a Package for quickly creating nested lists] + [2016/03/05 v2.1 Package for quickly creating nested lists] % % %<*driver> @@ -110,7 +110,7 @@ % mapping between these characters and list levels is fixed for the % whole list. % -% The |AsciiDocList| environment (Section~\ref{sec:AsciiListStar}) +% The |AsciiDocList| environment (Section~\ref{sec:AsciiDocList}) % provides a list environment in which a sequence of characters at the % beginning of a line can be used to typeset an item at a particular % list level. The mapping between individual characters and list @@ -213,7 +213,7 @@ % \end{AsciiList} % \end{LTXexample} % -% \subsubsection{Automatic item detection} +% \subsubsection{Automatic Item Detection} % % If you want to be more flexible regarding the characters for the % list items, you can use |auto| as the parameter to the environment. @@ -239,8 +239,34 @@ % \end{AsciiList} % \end{LTXexample} % +% \subsubsection{Navigating Upwards} +% \changes{v2.1}{2016/03/05}{Documentation of \cs{UP} and \cs{UPTO}} +% +% If you want to typeset a list in which a list item is continued after +% sub-items of that item, you can use the |\UP| and |\UPTO| macros. +% \DescribeMacro{\UP} +% The |\UP|\oarg{N} macro goes back \meta{N} levels (default: 1) without +% starting a new item at the resulting level. +% \DescribeMacro{\UPTO} +% The |\UPTO|\marg{N} macro goes back to level \meta{N} (where the +% topmost level is 0) without starting a new item at the resulting +% level. +% The following example illustrates the use of the two macros. +% \begin{LTXexample} +% \begin{AsciiList}{auto} +% - first item +% * sub-item +% \UP[1] +% continuation one level higher +% * another sub-item +% + a sub-sub-item +% \UPTO{1} +% continuation on first-item level +% \end{AsciiList} +% \end{LTXexample} % -% \subsection{Lists with AsciiDoc-Like Notation}\label{sec:AsciiListStar} +% +% \subsection{Lists with AsciiDoc-Like Notation}\label{sec:AsciiDocList} % % \DescribeEnv{AsciiDocList} % Use the |AsciiDocList|\oarg{environments} environment to quickly create @@ -318,6 +344,26 @@ % \end{LTXexample} % \RestoreSecs % +% \subsubsection{Navigating Upwards} +% \changes{v2.1}{2016/03/05}{Documentation of \cs{UPTO}} +% +% If you want to typeset a list in which a list item is continued after +% sub-items of that item, you can use the |\UPTO| macro. +% \DescribeMacro{\UPTO} +% The |\UPTO|\marg{chars} macro goes back the level identified by +% \meta{chars} without starting a new item at the resulting level. +% The following example illustrates the use of the macro. +% \begin{LTXexample} +% \begin{AsciiDocList} +% ; description +% beginning of description +% ;+ item +% ;+* sub-item +% \UPTO{;} +% continuation of description +% \end{AsciiDocList} +% \end{LTXexample} +% % % \section{Customizing List Environments}\label{sec:config} % @@ -867,6 +913,12 @@ {\expandafter\docsvlist\expandafter{\asclst@docdefaultenvs}}% {\docsvlist{#1}}% % \end{macrocode} +% And make the macro |\UPTO| available for switching to an upper level. +% \changes{v2.1}{2016/03/04}{Add \cs{UPTO} to explicitly changle levels +% upwards} +% \begin{macrocode} + \let\UPTO=\asclst@changedoclistlevel% +% \end{macrocode} % Ensure that the scanning for an item char starts with the very first % line of the environment. % \changes{v2.0a}{2016/02/23}{Improved first-line handling.} diff --git a/Master/texmf-dist/tex/latex/asciilist/asciilist.sty b/Master/texmf-dist/tex/latex/asciilist/asciilist.sty index e485f0890a9..3d4c65b254a 100644 --- a/Master/texmf-dist/tex/latex/asciilist/asciilist.sty +++ b/Master/texmf-dist/tex/latex/asciilist/asciilist.sty @@ -20,7 +20,7 @@ %% \NeedsTeXFormat{LaTeX2e}[1999/12/01] \ProvidesPackage{asciilist} - [2016/02/23 v2.0a Package for quickly creating nested lists] + [2016/03/05 v2.1 Package for quickly creating nested lists] \RequirePackage{etoolbox} \RequirePackage{trimspaces} \newenvironment{AsciiList}[2][\asclst@defaultenvs]{% @@ -137,6 +137,7 @@ \ifstrempty{#1}% {\expandafter\docsvlist\expandafter{\asclst@docdefaultenvs}}% {\docsvlist{#1}}% + \let\UPTO=\asclst@changedoclistlevel% \asclst@ifnextnewline{}{\asclst@docnewline}% }{% \asclst@changedoclistlevel{}% -- cgit v1.2.3