summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/msc/maintenance.tex
blob: 3e49133c6ee7909a59b2e8abd85fb22a020dbd5b (plain)
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
% file: maintenance.tex
% Copyright 2008 V. Bos, T. van Deursen, and S. Mauw
% This file is part of the MSC Macro Package.
%
\documentclass{article}
\usepackage{a4wide}
\usepackage{msc}

\title{
  A {\LaTeX{}} macro package for Message Sequence Charts---Maintenance 
  document
}


\author{
 \begin{tabular}{c}
  \begin{tabular}{ccc}
   Victor Bos &
   Ton van Deursen &
   Sjouke Mauw \\
   &
   \scriptsize Universit\'e du Luxembourg &
   \scriptsize Universit\'e du Luxembourg \\[-0.8ex]
   \scriptsize \texttt{victor.bos@ssf.fi} &
   \scriptsize \texttt{ton.vandeursen@uni.lu} & 
   \scriptsize \texttt{sjouke.mauw@uni.lu}
  \end{tabular}\\
 \end{tabular}
}

\begin{document}

\date{\small Version \mscversion, last update \today}

\maketitle

\begin{abstract}
\noindent
The MSC macro package facilitates the \LaTeX\ user to easily include
Message Sequence Charts in his texts. This document contains
information which supports the maintenance of the package.
\end{abstract}

\section{Introduction}
This document contains three lists related to the maintenance of the
MSC macro package. This is a \LaTeX\ package for drawing Message
Sequence Charts.
For additional information consult the following URL:
\verb+http://satoss.uni.lu/mscpackage/+.

The first list contains an overview of all publicly released versions 
of the MSC macro package. The second list contains all known (yet
unresolved) bugs of the MSC macro package. The third list is the wish
list, containing wishes expressed by the users of the package w.r.t.
desired additional functionality.

\section{Versions}
\begin{itemize}
\item Version 1.16, beta release, 2008/06/02

The MSC package used old \verb+PSTricks+-syntax of the \verb+\scalebox+
command. To prevent mismatches with the \verb+graphicx+ package, this
macro was renamed to \verb+\psscalebox+.

The \verb+action+ and \verb+condition+ macros are extended with a
starred version, which automatically adjust the size of the rectangle
and hexagon based on the size of the contents. 

Name and address information has been updated.

\item Version 1.13, beta release, 2002/06/27.

The label positioning of version 1.12 is reimplemented. In fact, the
implementation of messages is rewritten completely. The same method to
compute the location of labels is used in \verb+\mess+, \verb+create+,
\verb+lost+, and \verb+found+. The new implementation is backward
compatible, meaning that old documents using the MSC Macro Package
will still look the same.

In addition, the bounding box bug is partly fixed. An \verb+\fbox+ is
drawn around each msc, hmsc, and mscdoc diagram. This enables dvips to
compute the right bounding box. Since the \verb+\fbox+ is drawn in
white, there is no visible result as long as the background is white,
too. A consequence of this bug fix is that the MSC Macro package
requires the \textsf{color} package. Just like the other required
packages, \textsf{pstricks}, \textsf{calc}, and \textsf{ifthen}, this
is a standard \LaTeXe{} package.

\item Version 1.12, beta release, 2002/06/18.

In this version, the user has more control over the positioning of
message labels. Implementation not finished yet.

\item Version 1.11, Public release, 2002/06/06.

Minor bug fix.\\ The \verb+\stepcounter+ problem that occurred while
using the MSC Macro Package together with overlays (slides) is solved.

\item Version 1.10a, Public release, 2002/04/11.

Minor bug fixes.\\ 
The email addresses and websites mentioned in the files have been
corrected (if necessary).

The problem with the german package (german.sty) has been solved. This
bug was found by Christian Kaeunicke. The german package redefines the
meaning of the " symbol in order to type german texts more
efficiently. However, this was not compatible with the msc package
(before version 1.10a), because it uses the " symbol in
(error)-messages. The new version (1.10a) uses the ' symbol instead of
the " symbol. This seems to solve the problem with the german
package. However, there are probably packages assigning special
meaning to the ' symbol and which will therefore not work properly
with the msc package.

\item Version 1.10, Public release, 2002/04/10.

Major improvements: support for two new types of diagrams: High-level
MSCs and MSC documents. Additional MSC constructs: fat (double line)
instances, gates, time measurements, comments, instance regions
(activation, suspension, and co-regions), method replies (dashed
message arrows). Left and right overlap of inline expressions and MSC
references in an MSC diagram can be specified separately.

Reference manual. For a list of (all) commands and lengths, see
reference manual.

Package now also available at CTAN.

\item Version 1.4, Public release, 1999/04/23.

Minor bug fixes.\\
Additionally supports: Instance creation, MSC references, and inline
expressions.\\
Extra parameters:
\verb+\referenceoverlap+, \verb+\inlineoverlap+, \verb+\stopwidth+.\\
Adjustment of default values. There are now three sizes
(large/normal/small) instead of two. The middle size is now default.\\
New command \verb+\setmscscale+ to scale the complete MSC up/down.

\item Version 1.3, Public release, 1999/04/10.

Minor bug fixes.
Additionally supports: Conditions, combined timer symbols, instance
stop.\\
Extra parameters:
\verb+\conditionheight+, \verb+\conditionoverlap+, \verb+\stopwidth+.
Leveloffset can be specified in \verb+nextlevel+ command.

\item Version 1.2, Public release, 1999/03/29.

Minor bug fixes.
Code restructuring.
Additionally supports: Actions.\\
Extra parameters:
\verb+\actionheight+, \verb+\actionwidth+.

\item Version 1.1, Public release, 1999/03/24.

Minor bug fixes.
Additionally supports: timers (singular events), lost and found
messages, generalized ordering. Extra parameters:
\verb+\lostsymbolradius+, \verb+\timerwidth+. The macro
\verb+\setfootcolor+ replaces \verb+\setfootgrayness+, and the macro
\verb+\setmscvalues+ replaces \verb+\resetmsclengths+.
Some default values have been adjusted.

\item Version 1.0, First public release, 1999/03/16.

Supports drawing of the following MSC constructs: MSC frame,
instances, messages (including self and env messages), coregions.
Includes some parameters for fine tuning of the drawing.

\end{itemize}

\section{Bugs}
The MSC macro package contains numerous bugs (and hidden features).
As of now, these are the only ones that have revealed themselves in public.

\begin{itemize}

\item Some starred versions of commands of the MSC Macro package do
not cooperate with the \textsf{amsbsy} package. The problem is that
the latter package redefined the macro \verb+\@ifstar+. This bug was
dicovered by Sjouke Mauw.

\item The size of msc diagrams is computed incorrectly. After
generating an eps file (dvips -E) from a dvi file containing exactly
one msc diagram, the diagram is clipped incorrectly. This bug was
dicovered by Tim Willemse.

\item There are \LaTeX{} packages that assign special meaning to some
characters. Consequently, the  MSC Macro package might not function properly
with such packages. Since we cannot anticipate on these semantical
changes of symbols, we don't know of a good solution to it. However,
we try to find solutions for these problems if they originated from
packages that are in the standard \LaTeX{} distribution.

A concrete example was the \textsf{german} package, as pointed out by
Christian Kaeunicke. This package assigns special meaning to the "
symbol. If you issue \verb+\usepackage{german}+ \emph{before}
\verb+\usepackage{msc}+, you will get an error as soon as your first
msc diagram is compiled. As Christian also mentioned, the error does
not occur if the import order of the packages is reversed.

As of MSC Macro package version 1.10a, this concrete bug with the
\textsf{german} package has been solved and the order between
\textsf{msc} and \textsf{german} is not restricted anymore.

\item The MSC Macro Package (version $\leq 1.10a$) crashes with the
overlay environment of the slides document class. The bug is due to a
redefinition of the \verb+\refstepcounter+ macro by the slides
documentclass.  This bug was discovered by Volker Stolz. He and Markus
Mohnen proposed a solution: increase the counters used by the MSC
macro package manually. In Version~1.11 this solution is
implemented. Thanks Volker and Markus!

\end{itemize}

\section{Wishes}
\begin{itemize}

\item Split MSCs over multiple pages (T. van Deursen, 2008/02/18)

\item Make the parameters of the MSC Macro package more
consistent. For example, the \verb+\mess+ macro and the
\verb+\measure+ have similar positioning parameters, but they cannot
have the same values. (V. Bos 2002/06/16)

\item Add a section to the user manual describing how to generate
other formats (like html, PostScript, pdf).  (S. Mauw 2002/06/14)

\item Add to the user manual a figure describing the various HMSC lengths.
      (S. Mauw 2002/06/14)

\item Add automatic resizing of action symbols, as described in one of
the tricks in the reference manual.  (S. Mauw 2002/06/14)

\item Add UML extensions to the MSC Macro package. Describe clearly
which UML diagrams we support.(S. Mauw, 2002/06/13)

\item A possibility to change the color of instance regions. V. Bos
(2002/04/09).

\item Add option to messages to determine relative position of
label. (S. Mauw 1999/04/15).

\end{itemize}

\end{document}