renamed

Makefile

@@ -27,12 +27,10 @@ $(PDF): $(TST) $(STY)
 	$(LTX) $(TST)
 
 .PHONY: clean clean_doc clean_sty clean_test clean_all all sty test quick
-clean: clean_test
+clean:
 	-rm $(shell find $(NAM)\.* | grep -Ev '\.dtx$$' | grep -Ev '\.sty$$' | grep -Ev '\.pdf$$')
 clean_doc:
 	-rm $(DOC)
 clean_sty:
 	-rm $(STY)
-clean_test:
-	-rm $(shell find $(TNM)\.* | grep -Ev '\.tex$$')
-clean_all: clean clean_doc clean_sty clean_test
+clean_all: clean clean_doc clean_sty

boxgrab.dtx → grabbox.dtx

@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% File: boxgrab.dtx Copyright (C) 2018 Jonathan P. Spratte
+% File: grabbox.dtx Copyright (C) 2018 Jonathan P. Spratte
 %
 % It may be distributed and/or modified under the conditions of the LaTeX
 % Project Public License (LPPL), either version 1.3c of this license or (at your
@@ -20,7 +20,7 @@
 \preamble
 
 --------------------------------------------------------------
-boxgrab -- utilities to get an argument as a box
+grabbox -- utilities to get an argument as a box
 E-mail: jspratte@yahoo.de
 Released under the LaTeX Project Public License v1.3c or later
 See http://www.latex-project.org/lppl.txt
@@ -38,15 +38,15 @@ the file:
 This work is "maintained" (as per LPPL maintenance status) by
   Jonathan P. Spratte.
 
-This work consists of the file  boxgrab.dtx
-and the derived files           boxgrab.pdf and
-                                boxgrab.sty.
+This work consists of the file  grabbox.dtx
+and the derived files           grabbox.pdf and
+                                grabbox.sty.
 
 \endpreamble
 % stop docstrip adding \endinput
 \postamble
 \endpostamble
-\generate{\file{boxgrab.sty}{\from{boxgrab.dtx}{pkg}}}
+\generate{\file{grabbox.sty}{\from{grabbox.dtx}{pkg}}}
 \ifx\fmtname\nameofplainTeX
   \expandafter\endbatchfile
 \else
@@ -55,39 +55,39 @@ and the derived files           boxgrab.pdf and
 %</driver>
 %
 %<*driver>
-\ProvidesFile{boxgrab.dtx}
+\ProvidesFile{grabbox.dtx}
   [%
-    \csname boxgrab@date\endcsname\ 
+    \csname grabbox@date\endcsname\ 
     utilities to get an argument as a box%
   ]
 \documentclass{l3doc}
 \usepackage{duckuments}
-\usepackage{boxgrab}
+\usepackage{grabbox}
 \author{Jonathan P. Spratte\thanks{Email: jspratte@yahoo.de}}
-\title{The \pkg{boxgrab} package}
+\title{The \pkg{grabbox} package}
 \makeatletter
-\date{\boxgrab@date\ v\boxgrab@version}
+\date{\grabbox@date\ v\grabbox@version}
 \renewcommand*{\thefootnote}{\fnsymbol{footnote}}
 \makeatother
 \begin{document}
-  \DocInput{boxgrab.dtx}
+  \DocInput{grabbox.dtx}
 \end{document}
 %</driver>
 %<*pkg>
-\newcommand*\boxgrab@date{2018-10-17}
-\newcommand*\boxgrab@version{1.0}
-\ProvidesPackage{boxgrab}
-  [\boxgrab@date\ v\boxgrab@version\ utilities to get an argument as a box]
+\newcommand*\grabbox@date{2018-10-17}
+\newcommand*\grabbox@version{1.0}
+\ProvidesPackage{grabbox}
+  [\grabbox@date\ v\grabbox@version\ utilities to get an argument as a box]
 %</pkg>
 % \fi
 %
 % \begin{center}
-%   \LARGE The \pkg{boxgrab} package\\[\bigskipamount]
+%   \LARGE The \pkg{grabbox} package\\[\bigskipamount]
 %   \large
 %   \setcounter{footnote}{1}%
 %   Jonathan P. Spratte\footnotemark\\[\medskipamount]
-%   Version \csname boxgrab@version\endcsname\\[\smallskipamount]
-%   Released \csname boxgrab@date\endcsname
+%   Version \csname grabbox@version\endcsname\\[\smallskipamount]
+%   Released \csname grabbox@date\endcsname
 % \end{center}
 % \footnotetext{E-mail: jspratte@yahoo.de}
 %
@@ -97,20 +97,20 @@ and the derived files           boxgrab.pdf and
 %
 % \section{Introduction}
 %
-% This package provides \cs{boxgrab} to grab an argument inside of a box. The
+% This package provides \cs{grabbox} to grab an argument inside of a box. The
 % used mechanism allows category code changes in that argument as long as it is
 % used in a place allowing category code changes (so not inside of another
 % argument).
 %
-% It is written as a docstrip file: executing |latex boxgrab.dtx| generates the
-% \file{boxgrab.sty} file and typesets this documentation; execute
-% |tex boxgrab.dtx| to only generate \file{boxgrab.sty}.
+% It is written as a docstrip file: executing |latex grabbox.dtx| generates the
+% \file{grabbox.sty} file and typesets this documentation; execute
+% |tex grabbox.dtx| to only generate \file{grabbox.sty}.
 % 
 % \section{The macro}
 %
-% \begin{function}{\boxgrab}
+% \begin{function}{\grabbox}
 %   \begin{syntax}
-%     \cs{boxgrab}\meta{*}
+%     \cs{grabbox}\meta{*}
 %       \marg{box register}\oarg{inject pre}\marg{box type}\oarg{inject post}
 %       \marg{next}\oarg{save args}
 %   \end{syntax}
@@ -131,18 +131,18 @@ and the derived files           boxgrab.pdf and
 %
 %   \smallskip
 %   All assignments are made local. Currently it is not safe to nest macros
-%   which use \cs{boxgrab}. It should become save if you're macros use
-%   \cs{boxgrab} inside of a group, so the local assignments don't affect the
+%   which use \cs{grabbox}. It should become save if you're macros use
+%   \cs{grabbox} inside of a group, so the local assignments don't affect the
 %   outer macro.
 %
-%   \cs{boxgrab} uses \cs{afterassignment} and \cs{aftergroup} to do its magic.
+%   \cs{grabbox} uses \cs{afterassignment} and \cs{aftergroup} to do its magic.
 %   The \cs{afterassignment} should be safe where it is used, the
 %   \cs{aftergroup} is used inside of the boxed argument before any contents are
 %   inserted.
 %
-%   Since \cs{boxgrab} works by setting a boxregister using \cs{setbox} (and a
+%   Since \cs{grabbox} works by setting a boxregister using \cs{setbox} (and a
 %   bunch of temporary macros), it is of course not expandable and defined
-%   \cs{protected}. Bear in mind that macros created with \cs{boxgrab} are
+%   \cs{protected}. Bear in mind that macros created with \cs{grabbox} are
 %   not expandable.
 %
 % \section{Useless Example!}
@@ -159,11 +159,11 @@ and the derived files           boxgrab.pdf and
 % \newcommand\examplecmd[2]
 %   {%
 %     \begingroup
-%     \boxgrab\ourbox[\itshape]\hbox[ \sffamily is]\examplecmdOut[{#1}{#2}]
+%     \grabbox\ourbox[\itshape]\hbox[ \sffamily is]\examplecmdOut[{#1}{#2}]
 %   }
 % \end{verbatim}
 %
-% And we need our helper macro which is executed after \cs{boxgrab}:
+% And we need our helper macro which is executed after \cs{grabbox}:
 %
 % \begin{verbatim}
 % \newcommand\examplecmdOut[3]
@@ -186,7 +186,7 @@ and the derived files           boxgrab.pdf and
 % \newcommand\examplecmd[2]
 %   {%
 %     \begingroup
-%     \boxgrab\ourbox[\itshape]\hbox[ \sffamily is]\examplecmdOut[{#1}{#2}]
+%     \grabbox\ourbox[\itshape]\hbox[ \sffamily is]\examplecmdOut[{#1}{#2}]
 %   }%
 % \newcommand\examplecmdOut[3]
 %   {%
@@ -220,7 +220,7 @@ and the derived files           boxgrab.pdf and
 % \newcommand\Rectangle[1][4]
 %   {%
 %     \begingroup
-%     \boxgrab\RectangleBox\hbox\RectangleOut[{#1}]
+%     \grabbox\RectangleBox\hbox\RectangleOut[{#1}]
 %   }
 % % Defining the secondary macro
 % \newcommand\RectangleOut[1]
@@ -233,9 +233,9 @@ and the derived files           boxgrab.pdf and
 %   }
 % \end{verbatim}
 %
-% As you can see, this macro uses \cs{boxgrab} in a group delimited by
+% As you can see, this macro uses \cs{grabbox} in a group delimited by
 % \cs{begingroup} and \cs{endgroup}. It should therefore be safe to nest it
-% inside other macros using \cs{boxgrab}.
+% inside other macros using \cs{grabbox}.
 %
 % Finally a usage example of our new macro (with the \pkg{duckuments} package
 % loaded):
@@ -250,7 +250,7 @@ and the derived files           boxgrab.pdf and
 % \newcommand\Rectangle[1][4]
 %   {%
 %     \begingroup
-%     \boxgrab\RectangleBox\hbox\RectangleOut[{#1}]
+%     \grabbox\RectangleBox\hbox\RectangleOut[{#1}]
 %   }%
 % \newcommand\RectangleOut[1]
 %   {%
@@ -275,17 +275,17 @@ and the derived files           boxgrab.pdf and
 %    \end{macrocode}
 %
 %    \begin{macrocode}
-\@ifdefinable{\if@boxgrab@spaces@}{\newif\if@boxgrab@spaces@}
-\newcommand*\boxgrab@args{}%
-\newcommand\boxgrab@def[2]
+\@ifdefinable{\if@grabbox@spaces@}{\newif\if@grabbox@spaces@}
+\newcommand*\grabbox@args{}%
+\newcommand\grabbox@def[2]
   {%
     \@ifdefinable#1{\protected\def#1{#2}}%
   }
-\newcommand\boxgrab@def@step[4]
+\newcommand\grabbox@def@step[4]
   {%
-    \@ifdefinable#1{\protected\def#1##1{\def#2{##1}\boxgrab@opt#3#4}}%
+    \@ifdefinable#1{\protected\def#1##1{\def#2{##1}\grabbox@opt#3#4}}%
   }
-\long\def\boxgrab@check@bracket #1[#2\endboxgrab@check@bracket
+\long\def\grabbox@check@bracket #1[#2\endgrabbox@check@bracket
   {%
     \if\relax\detokenize{#2}\relax
       \expandafter\@firstoftwo
@@ -293,80 +293,80 @@ and the derived files           boxgrab.pdf and
       \expandafter\@secondoftwo
     \fi
   }
-\protected\def\boxgrab@opt#1#2%
+\protected\def\grabbox@opt#1#2%
   {%
     \@ifnextchar[
-      {\boxgrab@opt@get#1#2}
+      {\grabbox@opt@get#1#2}
       {\def#1{}#2}%
   }
-\long\def\boxgrab@opt@get#1#2#3]%
+\long\def\grabbox@opt@get#1#2#3]%
   {%
-    \expandafter\boxgrab@opt@get@a\expandafter{\@gobble#3}#1#2%
+    \expandafter\grabbox@opt@get@a\expandafter{\@gobble#3}#1#2%
   }
-\protected\long\def\boxgrab@opt@get@a#1#2#3%
+\protected\long\def\grabbox@opt@get@a#1#2#3%
   {%
-    \boxgrab@check@bracket #1[\endboxgrab@check@bracket
+    \grabbox@check@bracket #1[\endgrabbox@check@bracket
       {\def#2{#1}#3}
-      {\boxgrab@opt@get@b#2#3{#1]}}%
+      {\grabbox@opt@get@b#2#3{#1]}}%
   }
-\protected\long\def\boxgrab@opt@get@b#1#2#3#4]%
+\protected\long\def\grabbox@opt@get@b#1#2#3#4]%
   {%
-    \boxgrab@check@bracket #4[\endboxgrab@check@bracket
+    \grabbox@check@bracket #4[\endgrabbox@check@bracket
       {\def#1{#3#4}#2}
-      {\boxgrab@opt@get@b#1#2{#3#4]}}%
+      {\grabbox@opt@get@b#1#2{#3#4]}}%
   }
-\boxgrab@def\boxgrab@unpack
+\grabbox@def\grabbox@unpack
   {%
-    \expandafter\ifx\boxgrab@type\hbox
+    \expandafter\ifx\grabbox@type\hbox
       \expandafter\@firstoftwo
     \else
       \expandafter\@secondoftwo
     \fi
     \unhbox
     \unvbox
-    \boxgrab@name
+    \grabbox@name
   }
-\boxgrab@def\boxgrab
+\grabbox@def\grabbox
   {%
     \@ifstar
-      {\@boxgrab@spaces@true\boxgrab@a}
-      {\@boxgrab@spaces@false\boxgrab@a}%
+      {\@grabbox@spaces@true\grabbox@a}
+      {\@grabbox@spaces@false\grabbox@a}%
   }
-\boxgrab@def@step\boxgrab@a\boxgrab@name\boxgrab@into@pre\boxgrab@b
-\boxgrab@def@step\boxgrab@b\boxgrab@type\boxgrab@into@post\boxgrab@c
-\boxgrab@def@step\boxgrab@c\boxgrab@final\boxgrab@args\boxgrab@d
-\boxgrab@def\boxgrab@d
+\grabbox@def@step\grabbox@a\grabbox@name\grabbox@into@pre\grabbox@b
+\grabbox@def@step\grabbox@b\grabbox@type\grabbox@into@post\grabbox@c
+\grabbox@def@step\grabbox@c\grabbox@final\grabbox@args\grabbox@d
+\grabbox@def\grabbox@d
   {%
-    \afterassignment\boxgrab@intermediate
-    \setbox\boxgrab@name\boxgrab@type
+    \afterassignment\grabbox@intermediate
+    \setbox\grabbox@name\grabbox@type
   }
-\boxgrab@def\boxgrab@intermediate
+\grabbox@def\grabbox@intermediate
   {%
-    \aftergroup\boxgrab@after
-    \boxgrab@into@pre
+    \aftergroup\grabbox@after
+    \grabbox@into@pre
   }
-\boxgrab@def\boxgrab@after
+\grabbox@def\grabbox@after
   {%
-    \if@boxgrab@spaces@
-      \setbox\boxgrab@name\boxgrab@type
+    \if@grabbox@spaces@
+      \setbox\grabbox@name\grabbox@type
         {%
-          \boxgrab@unpack
-          \boxgrab@into@post
+          \grabbox@unpack
+          \grabbox@into@post
         }%
     \else
-      \setbox\boxgrab@name\boxgrab@type
+      \setbox\grabbox@name\grabbox@type
         {%
-          \boxgrab@unpack
+          \grabbox@unpack
           \ifhmode\unskip\fi
-          \boxgrab@into@post
+          \grabbox@into@post
         }%
     \fi
-    \expandafter\boxgrab@final@exp@args\expandafter{\boxgrab@args}%
+    \expandafter\grabbox@final@exp@args\expandafter{\grabbox@args}%
   }
-\newcommand\boxgrab@final@exp@args[1]
+\newcommand\grabbox@final@exp@args[1]
   {%
-    \def\boxgrab@args{}%
-    \boxgrab@final#1%
+    \def\grabbox@args{}%
+    \grabbox@final#1%
   }
 %    \end{macrocode}
 %