Document Classes ⇒ Problem in macro declaration

[jlb]

Hi everybody

I am writing macros to help in the description of an API. I have one environment and one command
The command accumulate informations in a macro used by the closing part of the environment to display the informations in good order:

The environment is as follow :

Code: Select all

Code, edit and compile here:

1
2
3
4
5
6
7
8
9
10
11
12
\newenvironment{arguments}{%
  \def\arglist{}
  \def\empty{}
  \def\argdesc{}
}
{
  {\tt \servicereturn\ \servicename(\arglist);}
  
  {\bf Arguments of \servicename\ are:}
  
  \argdesc
}
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Run LaTeX here

\argdesc and \arglist are filled by the following command

Code: Select all

Code, edit and compile here:

1
2
3
4
5
6
7
8
\newcommand{\argument}[3]{%
  \edef\argdesc{\argdesc\par\begingroup\hangindent=2em\hangafter=1 #2 #3\par\endgroup}
  \ifx\arglist\empty
    \def\arglist{#1 #2}
  \else
    \edef\arglist{\arglist, #1 #2}
  \fi
}
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Run LaTeX here

The whole thing is used like that :

Code: Select all

Code, edit and compile here:

1
2
3
4
\begin{arguments}
  \argument{TaskType}{TaskID}{the id of the task}
  \argument{EventMaskType}{Mask}{the event mask}
\end{arguments}
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Run LaTeX here

It works but when I try to add other macros in the

Code: Select all

1
  \edef\argdesc{\argdesc\par\begingroup\hangindent=2em\hangafter=1 #2 #3\par\endgroup}
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

definition, like :

\edef\argdesc{\argdesc\par\begingroup\hangindent=2em\hangafter=1 {\tt #2} #3\par\endgroup}

I get an error :

! Missing control sequence inserted.
<inserted text>
\inaccessible
l.73 \end{arguments}

If I use \texttt, I get a different error :

! Undefined control sequence.
<argument> \@nil

l.72 ...e}{TaskID}{The id of the task to activate}

I tried to use \protect before #2 but it does not change anything.

I am a little bit lost and need a TeX guru

[gmedina]

Hi,

you can use a box to store the modification to the second argument before starting the grouping (I completed your code providing some dummy definition for \servicename and \servicereturn):

Code: Select all

Code, edit and compile here:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
\documentclass{article}
\usepackage{amsmath}
\usepackage{accents}
\newcommand\servicereturn{Service return}
\newcommand\servicename{Service name}
\newenvironment{arguments}{%
  \def\arglist{}
  \def\empty{}
  \def\argdesc{}
}
{
  {\ttfamily \servicereturn\ \servicename(\arglist);}
  
  {\bfseries Arguments of \servicename\ are:}
  
  \argdesc
}
\newsavebox\mybox
\newcommand{\argument}[3]{
  \sbox\mybox{\ttfamily #2}%
  \edef\argdesc{\argdesc\par\begingroup\hangindent=2em\hangafter=1 \usebox\mybox\ #3\par\endgroup}
  \ifx\arglist\empty
    \def\arglist{#1 #2}
  \else
    \edef\arglist{\arglist, #1 #2}
  \fi
}
\begin{document}
\begin{arguments}
  \argument{TaskType}{TaskID}{the id of the task}
  \argument{EventMaskType}{Mask}{the event mask}
\end{arguments}
\end{document}
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Run LaTeX here

I changed the obsolete commands \tt and \bf to \ttfamily, and \bfseries, respectively.

[jlb]

Thanks a lot

It works almost

However, the last item saved in the box is replicated for every \argument

I suspect it is because the \edef is not expanded until \argdesc is expanded and at that time the box contains the last item.