diff options
author | Karl Berry <karl@freefriends.org> | 2016-06-11 23:06:44 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-06-11 23:06:44 +0000 |
commit | 876b86d0b964599f049d2ae7d670b73308961d4a (patch) | |
tree | b0fd38e2e0f32c2797b76e3e26fbab924adcc712 /Master/texmf-dist/doc/latex/xassoccnt | |
parent | a880c715c123c4ecf8da826a5283895cec739b42 (diff) |
xassoccnt (11jun16)
git-svn-id: svn://tug.org/texlive/trunk@41371 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/xassoccnt')
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/README | 6 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.pdf | bin | 94256 -> 94256 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.tex | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.pdf | bin | 417841 -> 430273 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.tex | 141 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.pdf | bin | 80724 -> 80724 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.tex | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.pdf | bin | 68837 -> 68384 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.tex | 6 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.pdf | bin | 0 -> 60527 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.tex | 94 |
11 files changed, 225 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/latex/xassoccnt/README b/Master/texmf-dist/doc/latex/xassoccnt/README index b73bb24eda1..02e0db32150 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/README +++ b/Master/texmf-dist/doc/latex/xassoccnt/README @@ -1,4 +1,4 @@ -%% LaTeX package xassoccnt - version 0.7 (2016/05/10 -- 00/41/54) +%% LaTeX package xassoccnt - version 0.8 (2016/06/10 -- 23/28/27) %% README file for xassoccnt.sty %% %% @@ -26,7 +26,7 @@ the associated counters as well. This package can be regarded as a supplement to the totcount package by Vasileios Koutavas (http://www.ctan.org/pkg/totcount), but can be used without it too. -As of 2016/05/10 xassoccnt does not supersede the package assoccnt by the same author, however, -the older package isn't declared obsolete as of 2016/05/10 +As of 2016/06/10 xassoccnt does not supersede the package assoccnt by the same author, however, +the older package isn't declared obsolete as of 2016/06/10 diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.pdf b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.pdf Binary files differindex 17476450b1c..011e364122c 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.pdf +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.pdf diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.tex b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.tex index b015aabf611..e4551a286c2 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.tex +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_coupledcounters.tex @@ -1,5 +1,5 @@ -%% LaTeX package xassoccnt - version 0.7 (2016/05/10 -- 00/41/54) -%% Coupled counters examples file for xassoccnt.sty +%% LaTeX package xassoccnt - version 0.8 (2016/06/10 -- 23/28/27) +%% Example file for coupled counters file for xassoccnt.sty %% %% %% ------------------------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.pdf b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.pdf Binary files differindex 8b173192452..572082f925f 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.pdf +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.pdf diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.tex b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.tex index c0ff88c6290..f67c6ecab59 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.tex +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_doc.tex @@ -1,5 +1,5 @@ -%% LaTeX package xassoccnt - version 0.7 (2016/05/10 -- 00/41/54) -%% Documentation file for xassoccnt.sty +%% LaTeX package xassoccnt - version 0.8 (2016/06/10 -- 23/28/27) +%% Documentation file for xassoccnt.sty %% %% %% ------------------------------------------------------------------------------------------- @@ -51,6 +51,7 @@ \newlist{codeoptionsenum}{enumerate}{1} \setlist[codeoptionsenum,1]{label={\textcolor{blue}{\#\arabic*}}} +\renewcommand{\rmdefault}{\sfdefault} \newcolumntype{C}[1]{>{\centering\arraybackslash}p{#1}} @@ -67,10 +68,31 @@ \def\KVchdocfilepurpose{#1}% } + +\newcommand{\chdocextractversion}[1]{% + \@nameuse{#1}% +} + + + +\@namedef{xassoccntversion0.4}{v0.4 2016-01-26} + +\@namedef{xassoccntversion0.5}{v0.5 2016-02-27} + +\@namedef{xassoccntversion0.6}{v0.6 2016-03-05} + +\@namedef{xassoccntversion0.7}{v0.7 2016-05-10} + +\@namedef{xassoccntversion0.8}{v0.8 2016-05-16} + + \makeatother + + + \fancypagestyle{plain}{% \fancyfoot[L]{\begin{tabular}[t]{l}\PackageDocName\ \packageversion \tabularnewline \textcopyright\ Dr. Christian Hupfer\end{tabular}}% \fancyfoot[C]{\thepage}% @@ -84,6 +106,7 @@ } + \newtcolorbox{CHPackageTitleBox}[1][]{% enhanced jigsaw, drop lifted shadow, @@ -287,8 +310,9 @@ \newcommand{\versionzerofourdate}{v0.4 2016-01-26} \newcommand{\versionzerofivedate}{v0.5 2016-02-27} \newcommand{\versionzerosixdate}{v0.6 2016-03-05} -\newcommand{\currentversiondate}{2016-05-10} -\newcommand{\versionzerosevendate}{v0.7 \currentversiondate} +\newcommand{\versionzerosevendate}{v0.7 2016-05-10} +\newcommand{\currentversiondate}{2016-06-10} +\newcommand{\versionzeroeightdate}{v0.8 \currentversiondate} \begin{document} \mmddyyyydate @@ -398,7 +422,8 @@ For potential problems see \cref{subsection:incompatibilities} \begin{marker} -\tcbdocmarginnote{\tcbdocupdated{\versionzerosevendate}} +%\tcbdocmarginnote{\tcbdocupdated{\versionzerosevendate}} +\tcbdocmarginnote{\tcbdocupdated{\chdocextractversion{xassoccntversion0.7}}} Of course any package other that loads \CHDocPackage{calc} must be loaded before \PackageDocName, i.e. \CHDocPackage{mathtools}. \end{marker} @@ -836,6 +861,32 @@ This command sequence tests whether the counter \meta{reset counter} is not in t See the related commands \refCom{IfInResetListTF} and \refCom{IfInResetListT} as well. \end{docCommand} +\begin{docCommand}{DisplayResetList}{\oarg{separator={,}}\marg{resetting counter}}\tcbdocmarginnote{\tcbdocnew{\chdocextractversion{xassoccntversion0.8}}} + +This command displays the reset list of a counter as a separated list. If the counter has no resetting list, nothing is shown. + +\begin{docCommandArgs}{DisplayResetList}% + +\begin{codeoptionsenum} +\item \oarg{separator}% + This separator is used for display, it defaults to a comma character. + +\item \marg{resetting counter}% + + Contains the name of counter whose resetting list should be displayed. +\end{codeoptionsenum} +\end{docCommandArgs} + +\end{docCommand} + +\begin{docCommand}{ShowResetList}{\marg{resetting counter}}\tcbdocmarginnote{\tcbdocnew{\chdocextractversion{xassoccntversion0.8}}} + +This command displays the reset list of a counter on the terminal as the \cs{show} command would do. This is rather useful for debugging purposes only. +\end{docCommand} + + + + \subsection[Information macros]{Information on counters} \label{subsection::informationcmds} On occasions it might be important to have some information which counter has been changed last. Since there are four commands manipulating counter values, there are four corresponding routines for this: @@ -939,15 +990,45 @@ Please note, that all of this commands are only working in the current run of co \section[Suspending and Resuming]{Suspending and resuming (associated) counters}\label{section::suspendedresumedcounters} + + Rather than removing an associated counter from the list, it is possible to suspend the automatic stepping for a while and then resume it (or completely drop it), for example, if the value of a counter should not be stepped within a specific chapter etc. +\tcbdocmarginnote{\tcbdocnew{\chdocextractversion{xassoccntversion0.8}}} +\begin{marker} + Suspension and resuming counters can cause wrong hyper links if \CHDocPackage{hyperref} is used. +\end{marker} + \begin{docCommand}{SuspendCounters}{\oarg{options}\marg{counters list}}% \begin{docCommandArgs}{SuspendCounters}% \begin{codeoptionsenum} \item \oarg{options}% + + Not used so far, reserved for later usage. + +\item \marg{counters list}% - Not used so far, reserved for later usages + Contains the name of counters to be suspended, separated by commas (CSV - list) +\end{codeoptionsenum} +\end{docCommandArgs} +\end{docCommand}% + +\begin{docCommand}{CascadeSuspendCounters}{\oarg{options}\marg{counters list}}\tcbdocmarginnote{\tcbdocnew{\chdocextractversion{xassoccntversion0.8}}} + +This macro is more powerful than \refCom{SuspendCounters}, since it tries to detect whether a counter has a reset list and 'mutes' the counters on this list as well and checks whether those counters themselves have reset lists and cascades down to the final state. + +\begin{marker} + Stated differently: All counters anyhow connected to a counter named \CHDocCounter{foo} will be suspended, e.g. for the \CHDocClass{book} class and \CHDocCounter{chapter}, this means in a standard setup, that \CHDocCounter*{section,figure,table,equation,footnote} will be suspended, as well as in consequence \CHDocCounter*{subsection,subsubsection,paragraph,subparagraph}, assuming hereby no other counters have been added to the reset lists. +\end{marker} + + +\begin{docCommandArgs}{CascadeSuspendCounters}% + +\begin{codeoptionsenum} +\item \oarg{options}% + + Not used so far, reserved for later usage. \item \marg{counters list}% @@ -956,10 +1037,17 @@ Rather than removing an associated counter from the list, it is possible to susp \end{docCommandArgs} \end{docCommand}% + \begin{docCommand}{ResumeSuspendedCounters}{\oarg{options}\marg{counters list}} + As of version \packageversion\ the optional argument is not used and reserved for later purposes. This command revokes the suspension of the counters in the \marg{counters} list. \end{docCommand} +\begin{docCommand}{ResumeAllSuspendedCounters}{\oarg{options}} \tcbdocmarginnote{\tcbdocnew{\chdocextractversion{xassoccntversion0.8}}} + As of version \packageversion\ the optional argument is not used and reserved for later purposes. + This command revokes all suspended counters. +\end{docCommand} + \begin{marker} If a driver counter is suspended, all counters associated to it are suspended too! @@ -1132,7 +1220,7 @@ This macro swaps the values of the counters given in arguments 2 and 3 \begin{docCommand}{SyncCounters}{\oarg{options}\marg{driver counter}} -This document synchronizes the driver counter value to the associated values. It has the some options as \refCom{SetDocumentCounter}. If the given counter is no driver counter, nothing is done. +This document synchronizes the driver counter value to the associated values. It has the same options as \refCom{SetDocumentCounter}. If the given counter is no driver counter, nothing is done. \begin{docCommandArgs}{SyncCounters}% @@ -1732,7 +1820,7 @@ to the users at tex.stackexchange.com, especially to \item Enrico Gregorio \item Joseph Wright \item David Carlisle - \item Werner + \item Werner Grundlingh \item Gonzalo Medina \item Cosmo Huber (for providing the bug report with the \CHDocPackage{calc} package.) \end{itemize} @@ -1750,21 +1838,34 @@ write this documentation. \section{Version history} \begin{itemize} -\item -Version 0.7 - -\begin{itemize}[label={$\checkmark$}] -\item Fixed a small bug in the \CHDocPackage{\PackageDocName} version of \cs{stepcounter} -\item Added some macros that support the output of binary, octal or hexadecimal (both lower/uppercase) values of counters. \tcbdocmarginnote{\tcbdocnew{\versionzerosevendate}} - \item Added the \cs{Loop...Counters} macros that performs an action in loop on all given counter names. \tcbdocmarginnote{\tcbdocnew{\versionzerosixdate}} -\end{itemize} \item -Version 0.6 - +Version 0.8 \begin{itemize}[label={$\checkmark$}] - \item The coupled counters allow to specify a counter group to which all relevant counters belong, this allows several coupled counter groups then \tcbdocmarginnote{\tcbdocnew{\versionzerosixdate}} - \item Fixed a small bug within backup counter support -- the resetting was not done any more \tcbdocmarginnote{\tcbdocnew{\versionzerosixdate}} +\item Fixed the \refCom{SuspendCounters} and \refCom{ResumeSuspendedCounters} macros -- the comma separated list of counters was not used (contrary to the purpose and the documentation description). \tcbdocmarginnote{\tcbdocupdated{\chdocextractversion{xassoccntversion0.8}}} + \item Additions of commands\tcbdocmarginnote{\tcbdocnew{\chdocextractversion{xassoccntversion0.8}}} + \begin{itemize}[label={$\triangleright$}] + \item \refCom{ResumeAllSuspendedCounters} + \item \refCom{CascadeSuspendCounters} + \item \refCom{DisplayResetList} + \item \refCom{ShowResetList} + \end{itemize} + \end{itemize} +\item + Version 0.7 + + \begin{itemize}[label={$\checkmark$}] + \item Fixed a small bug in the \CHDocPackage{\PackageDocName} version of \cs{stepcounter} + \item Added some macros that support the output of binary, octal or hexadecimal (both lower/uppercase) values of counters. \tcbdocmarginnote{\tcbdocnew{\versionzerosevendate}} + \item Added the \cs{Loop...Counters} macros that performs an action in loop on all given counter names. \tcbdocmarginnote{\tcbdocnew{\versionzerosevendate}} + \end{itemize} + + \item + Version 0.6 + + \begin{itemize}[label={$\checkmark$}] + \item The coupled counters allow to specify a counter group to which all relevant counters belong, this allows several coupled counter groups then \tcbdocmarginnote{\tcbdocnew{\versionzerosixdate}} + \item Fixed a small bug within backup counter support -- the resetting was not done any more \tcbdocmarginnote{\tcbdocnew{\versionzerosixdate}} \item Added the \CHDocKey{nonumberofruns}\ package option. \end{itemize} \item diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.pdf b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.pdf Binary files differindex 5e6876b0467..673de363105 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.pdf +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.pdf diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.tex b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.tex index d79e6bbe5f4..c07fb83b19b 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.tex +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_driver.tex @@ -1,5 +1,5 @@ -%% LaTeX package xassoccnt - version 0.7 (2016/05/10 -- 00/41/54) -%% Driver file for xassoccnt.sty +%% LaTeX package xassoccnt - version 0.8 (2016/06/10 -- 23/28/27) +%% Driver file for xassoccnt.sty %% %% %% ------------------------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.pdf b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.pdf Binary files differindex 1eb68c663cc..ef38cd07e92 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.pdf +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.pdf diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.tex b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.tex index 431621c5d22..e29df7fe8ca 100644 --- a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.tex +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_example.tex @@ -1,5 +1,5 @@ -%% LaTeX package xassoccnt - version 0.7 (2016/05/10 -- 00/41/54) -%% Example file for xassoccnt.sty +%% LaTeX package xassoccnt - version 0.8 (2016/06/10 -- 23/28/27) +%% Example file for xassoccnt.sty %% %% %% ------------------------------------------------------------------------------------------- @@ -141,7 +141,7 @@ In section \ref{section::query} same queries and statistics are shown. \QuickSections{10}{subsection}% % Resume all counters -\ResumeSuspendedCounters +\ResumeAllSuspendedCounters \QuickSections{20}{subsection}% diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.pdf b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.pdf Binary files differnew file mode 100644 index 00000000000..8ab5eac4d3d --- /dev/null +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.pdf diff --git a/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.tex b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.tex new file mode 100644 index 00000000000..d84116837d4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xassoccnt/xassoccnt_suspendedcounters_example.tex @@ -0,0 +1,94 @@ +%% LaTeX package xassoccnt - version 0.8 (2016/06/10 -- 23/28/27) +%% Example file for suspended counters file for xassoccnt.sty +%% +%% +%% ------------------------------------------------------------------------------------------- +%% Copyright (c) 2016 by Dr. Christian Hupfer <christian dot hupfer at yahoo dot de> +%% ------------------------------------------------------------------------------------------- +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either version 1.3 +%% 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.3 or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. +%% +%% +%% This work has the LPPL maintenance status `author-maintained` +%% +%% + +\documentclass{book} + +\usepackage{xassoccnt} +\usepackage{blindtext} + + +\setcounter{secnumdepth}{4} +\begin{document} +\tableofcontents +\listoffigures +\listoftables + + +\CascadeSuspendCounters{chapter} +\chapter{The first chapter} +\section{Foo} + + +\begin{figure} + +\caption{A foo figure} +\end{figure} + +\begin{table} +\caption{A foo table} +\end{table} + + + +\subsection{My First subsection} +\blindtext +\section{Foobar} +\subsection{Foobar subsection} +\blindtext +\subsubsection{Foobar Again} +\blindtext + + +\ResumeAllSuspendedCounters + +\chapter{Another chapter} + + +\begin{figure} +\caption{Another figure} +\end{figure} + + + +\SuspendCounters{chapter,section} + +\chapter{Yet another chapter} + +\section{Foo section in yet another chapter} + +\begin{figure} +\caption{Another figure} +\end{figure} + + + +\end{document} + + +\subsubsection{Foobar Again} +\blindtext + +\subsection{Foobar subsection} +\blindtext + +\subsubsection{Foobar Again} +\blindtext + |