slowbox.dtx: Reword `\newslowboxenv' description for better line breaks.

[mdwtools] / slowbox.dtx

diff --git a/slowbox.dtx b/slowbox.dtx
index bf031ba..f4b71a7 100644 (file)
--- a/slowbox.dtx
+++ b/slowbox.dtx
@@ -58,7 +58,6 @@
 \input{mdwtools}
 \describespackage{slowbox}
 \newcommand\opt[1]{\textsf{#1}}
-\expandafter\def\csname sb@box:tag\endcsname{{2cm}{1cm}{0.5cm}}
 \def\*{\hspace{0pt plus 0.1pt}\ignorespaces}
 \mdwdoc
 %</driver>
@@ -131,16 +130,18 @@
 % typeset regardless of the current mode setting.
 %
 % \DescribeMacro\newslowboxenv
-% There's an environment for building slow box environments.  Say
-% \syntax{"\\newslowboxenv{"<env-name>"}"\* "["<n-args>"]"\*
+% Plumbing all of this together is rather tedious, so there's also a
+% command for building slow box environments.  Say
+% \syntax{"\\newslowboxenv{"<env-name>"}"\* "["<n-args>"]"\*"["<default>"]"\*
 % "{"<before-text>"}"\* "{"<start-text>"}"\* "{"<end-text>"}"\*
 % "{"<after-text>"}"}. This creates a new environment (just like with
-% |\newenvironment|).  The contents are put in a slow box with \<start-text>
-% on the front and \<end-text> on the end.  Before the box is begun,
-% \<before-text> is performed, and \<after-text> is done afterwards.  The
-% environments so created have \env{$*$}-variants which ignore the current
-% mode, just like \env{slowbox$*$}.  They also gather an additional \<tag>
-% argument, which you don't have to bother with.
+% |\newenvironment|, taking \<n-args> arguments, maybe with the first one
+% optional and defaulting to \<default>).  The contents are put in a slow box
+% with \<start-text> on the front and \<end-text> on the end.  Before the box
+% is begun, \<before-text> is performed, and \<after-text> is done
+% afterwards.  The environments so created have \env{$*$}-variants which
+% ignore the current mode, just like \env{slowbox$*$}.  They also gather an
+% additional \<tag> argument, which you don't have to bother with.
 %
 % \DescribeMacro\doslowbox
 % Finally, for commands, there's \syntax{"\\doslowbox{"<tag>"}"\*