texlive[60483] Master/texmf-dist: crumbs (12sep21)

[commits+karl at tug.org]

Revision: 60483
          http://tug.org/svn/texlive?view=revision&revision=60483
Author:   karl
Date:     2021-09-12 22:34:58 +0200 (Sun, 12 Sep 2021)
Log Message:
-----------
crumbs (12sep21)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/crumbs/crumbs.pdf
    trunk/Master/texmf-dist/doc/latex/crumbs/crumbs.tex
    trunk/Master/texmf-dist/tex/latex/crumbs/crumbs.sty

Modified: trunk/Master/texmf-dist/doc/latex/crumbs/crumbs.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/crumbs/crumbs.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/crumbs/crumbs.tex	2021-09-12 20:34:26 UTC (rev 60482)
+++ trunk/Master/texmf-dist/doc/latex/crumbs/crumbs.tex	2021-09-12 20:34:58 UTC (rev 60483)
@@ -42,7 +42,7 @@
 
 \title{\ff{crumbs}: \LaTeX{} Package \\ for Navigation Crumbs}
 \author{Yegor Bugayenko}
-\date{0.2.2 2021/09/09}
+\date{0.3.0 2021/09/12}
 
 \begin{document}
 \pagenumbering{gobble}
@@ -114,6 +114,27 @@
 
 \subsection{How to Contribute}
 
+You may turn on the ``dry'' mode, which will prohibit the package to
+renew \ff{\char`\\section\{\}} and \ff{\char`\\subsection\{\}} commands.
+You will still be able to use the crumbs mechanism through
+\ff{\char`\\crumbection\{\}} and \ff{\char`\\subcrumbection\{\}}
+commands, for example:
+
+\begin{ffcode}
+\documentclass{article}
+\usepackage[dry]{crumbs}
+\begin{document}
+\crumbection[Intro]{Introduction} % Add it to \crumbs
+\section{Introduction} % Print it to the page
+Hello, world!
+\end{document}
+\end{ffcode}
+
+You can also instruct it to increment
+\ff{\char`\\section\{\}} and \ff{\char`\\subsection\{\}}
+on each call to \ff{\char`\\crumbection\{\}} and \ff{\char`\\subcrumbection\{\}}
+respectively. Just use the \ff{increment} package option.
+
 More details about this package you can find
 in the \ff{yegor256/crumbs} GitHub repository.
 

Modified: trunk/Master/texmf-dist/tex/latex/crumbs/crumbs.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/crumbs/crumbs.sty	2021-09-12 20:34:26 UTC (rev 60482)
+++ trunk/Master/texmf-dist/tex/latex/crumbs/crumbs.sty	2021-09-12 20:34:58 UTC (rev 60483)
@@ -21,13 +21,19 @@
 % SOFTWARE.
 
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{crumbs}[2021/09/09 0.2.2 Navigation Crumbs]
+\ProvidesPackage{crumbs}[2021/09/12 0.3.0 Navigation Crumbs]
 
+\makeatletter\newif\ifcrumbs at dry\makeatother
+\makeatletter\DeclareOption{dry}{\crumbs at drytrue}\makeatother
+\makeatletter\newif\ifcrumbs at increment\makeatother
+\makeatletter\DeclareOption{increment}{\crumbs at incrementtrue}\makeatother
+\ProcessOptions\relax
+
 \RequirePackage{etoolbox}
 
 % see https://tex.stackexchange.com/a/12414/1449
-\makeatletter\newcommand\back{\@backslashchar}\makeatother
-\makeatletter\newcommand\percent{\@percentchar}\makeatother
+\makeatletter\newcommand\crumbs at back{\@backslashchar}\makeatother
+% \makeatletter\newcommand\crumbs at percent{\@percentchar}\makeatother
 \RequirePackage{catchfile}
   \newwrite\appendwrite
   \newcommand*\appendtofile[2]{%
@@ -49,46 +55,59 @@
   \fi
 }
 
-\NewCommandCopy\crumbsoldsection\section
-\renewcommand\section[2][]{
-  \def\temp{#1}
-  \ifx\crumbs\empty
+\makeatletter\newcommand\crumbection[2][]{%
+  \def\temp{#1}%
+  \ifx\crumbs\empty%
     \appendtofile{\jobname.crumbs}{
-      \back ifx \back crumbs \back empty
-        \back gappto \back crumbs{\back setcounter{crumbi}{0}}
-      \back fi
-      \back gappto\back crumbs{\back stepcounter{crumbi}\back crumb{\ifx\temp\empty #2\else #1\fi}{#2}}
-    }
-  \fi
-  \crumbsoldsection{#2}
-}
+      \crumbs at back ifx \crumbs at back crumbs \crumbs at back empty
+        \crumbs at back gappto \crumbs at back crumbs{\crumbs at back setcounter{crumbi}{0}}
+      \crumbs at back fi
+      \crumbs at back gappto\crumbs at back crumbs{\crumbs at back stepcounter{crumbi}\crumbs at back crumb{\ifx\temp\empty #2\else #1\fi}{#2}}
+    }%
+  \fi%
+  \ifcrumbs at increment\stepcounter{section}\fi%
+}\makeatother
 
-\NewCommandCopy\crumbsoldsubsection\subsection
-\renewcommand\subsection[2][]{
-  \def\temp{#1}
-  \ifx\crumbs\empty
+\makeatletter\newcommand\subcrumbection[2][]{%
+  \def\temp{#1}%
+  \ifx\crumbs\empty%
     \appendtofile{\jobname.crumbs}{
-      \back ifcsname crumbs\romannumeral\the\value{section}\back endcsname\back else
-        \back expandafter\back newcommand\back csname crumbs\romannumeral\the\value{section}\back endcsname{%
-          \back setcounter{subcrumbi}{0}
+      \crumbs at back ifcsname crumbs\romannumeral\the\value{section}\crumbs at back endcsname\crumbs at back else
+        \crumbs at back expandafter\crumbs at back newcommand\crumbs at back csname crumbs\romannumeral\the\value{section}\crumbs at back endcsname{%
+          \crumbs at back setcounter{subcrumbi}{0}
         }
-      \back fi
-      \back expandafter\back gappto\back csname crumbs\romannumeral\the\value{section}\back endcsname{%
-        \back stepcounter{subcrumbi}
-        \back subcrumb{\ifx\temp\empty #2\else #1\fi}{#2}
+      \crumbs at back fi
+      \crumbs at back expandafter\crumbs at back gappto\crumbs at back csname crumbs\romannumeral\the\value{section}\crumbs at back endcsname{%
+        \crumbs at back stepcounter{subcrumbi}
+        \crumbs at back subcrumb{\ifx\temp\empty #2\else #1\fi}{#2}
       }
-    }
-  \fi
-  \crumbsoldsubsection{#2}
-}
+    }%
+  \fi%
+  \ifcrumbs at increment\stepcounter{subsection}\fi%
+}\makeatother
 
+\makeatletter\ifcrumbs at dry
+  \message{Since "dry" mode is ON we don't renew "section" and "subsection" commands}
+\else
+  \NewCommandCopy\crumbs at oldsection\section
+  \renewcommand\section[2][]{%
+    \crumbection[#1]{#2}%
+    \crumbs at oldsection{#2}%
+  }
+  \NewCommandCopy\crumbs at oldsubsection\subsection
+  \renewcommand\subsection[2][]{%
+    \subcrumbection[#1]{#2}%
+    \crumbs at oldsubsection{#2}%
+  }
+\fi\makeatletter
+
 \ifcsname crumb\endcsname
-  \message{The command "crumb" already defined}
+  \message{The command "crumb" is already defined}
 \else
   \newcommand\crumb[2]{#1}
 \fi
 \ifcsname subcrumb\endcsname
-  \message{The command "crumb" already defined}
+  \message{The command "subcrumb" is already defined}
 \else
   \newcommand\subcrumb[2]{#1}
 \fi