diff options
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/COPYRIGHT | 28 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/COPYRIGHT.txt | 31 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/README | 37 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/maintenance.pdf | bin | 0 -> 61584 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/maintenance.tex | 207 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/manual.pdf | bin | 0 -> 229228 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/manual.tex | 63 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/refman.pdf | bin | 0 -> 154934 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/msc/refman.tex | 169 |
9 files changed, 206 insertions, 329 deletions
diff --git a/Master/texmf-dist/doc/latex/msc/COPYRIGHT b/Master/texmf-dist/doc/latex/msc/COPYRIGHT deleted file mode 100644 index 7178a7ee4a8..00000000000 --- a/Master/texmf-dist/doc/latex/msc/COPYRIGHT +++ /dev/null @@ -1,28 +0,0 @@ -%% MSC Macro Package -%% msc.sty -%% Version 1.14 -%% March 15, 2004 -%% -%% Copyright 2002 V. Bos and S. Mauw -% -% This program may be distributed and/or modified under the -% conditions of the LaTeX Project Public License, either version 1.2 -% of this license or (at your option) any later version. -% The latest version of this license is in -% http://www.latex-project.org/lppl.txt -% and version 1.2 or later is part of all distributions of LaTeX -% version 1999/12/01 or later. -% -% This program consists of the files -% msc.sty -% manual.tex -% manual.ps -% refman.tex -% refman.ps -% biblio.bib -% maintenance.tex -% maintenance.ps -% README -% COPYRIGHT - - diff --git a/Master/texmf-dist/doc/latex/msc/COPYRIGHT.txt b/Master/texmf-dist/doc/latex/msc/COPYRIGHT.txt new file mode 100644 index 00000000000..3d7872812d5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/msc/COPYRIGHT.txt @@ -0,0 +1,31 @@ +%% MSC Macro Package +%% msc.sty +%% June 2, 2008 +%% +%% Copyright 2008 V. Bos, T. van Deursen, and S. Mauw +% +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.3 +% of this license or (at your option) any later version. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3 or later is part of all distributions of LaTeX +% version 2005/12/01 or later. +% +% This work has the LPPL maintenance status `maintained'. +% +% The Current Maintainer of this work is T. van Deursen. +% +% This program consists of the files +% msc.sty +% manual.tex +% manual.pdf +% refman.tex +% refman.pdf +% biblio.bib +% maintenance.tex +% maintenance.pdf +% README +% COPYRIGHT + + diff --git a/Master/texmf-dist/doc/latex/msc/README b/Master/texmf-dist/doc/latex/msc/README index eea9428f21b..5388eceb50e 100644 --- a/Master/texmf-dist/doc/latex/msc/README +++ b/Master/texmf-dist/doc/latex/msc/README @@ -1,43 +1,42 @@ MSC Macro Package ----------------- -Version 1.14 -March 15, 2004 +Version 1.16 +June 2, 2008 ---------------------------------------------------------------------- -Copyright 2002 V. Bos and S. Mauw +Copyright 2008 V. Bos, T. van Deursen, and S. Mauw -This program may be distributed and/or modified under the -conditions of the LaTeX Project Public License, either version 1.2 +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either version 1.3 of this license or (at your option) any later version. The latest version of this license is in http://www.latex-project.org/lppl.txt -and version 1.2 or later is part of all distributions of LaTeX -version 1999/12/01 or later. +and version 1.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. This program consists of the files msc.sty manual.tex - manual.ps + manual.pdf refman.tex - refman.ps + refman.pdf biblio.bib maintenance.tex - maintenance.ps + maintenance.pdf README COPYRIGHT ---------------------------------------------------------------------- The MSC macro package is a LaTeX2e package to draw MSC diagrams. See -user manual (manual.ps) and reference manual (refman.ps) for more +user manual (manual.pdf) and reference manual (refman.pdf) for more information. Contact address: -S. Mauw -Eindhoven University of Technology -P.O. Box 513 -5600 MB Eindhoven -The Netherlands -Email: sjouke@win.tue.nl, vbos@abo.fi -Updates via: http://www.win.tue.nl/~sjouke/mscpackage.html -and via CTAN directory: macros/latex/contrib/msc/ +Ton van Deursen +Universit\'e du Luxembourg +Facult\'e des Sciences, de la Technologie et de la Communication +6, rue Richard Coudenhove-Kalergi +L-1359 Luxembourg +Email: ton.vandeursen@uni.lu +Updates via: http://satoss.uni.lu/mscpackage/ diff --git a/Master/texmf-dist/doc/latex/msc/maintenance.pdf b/Master/texmf-dist/doc/latex/msc/maintenance.pdf Binary files differnew file mode 100644 index 00000000000..c050ebe05b0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/msc/maintenance.pdf diff --git a/Master/texmf-dist/doc/latex/msc/maintenance.tex b/Master/texmf-dist/doc/latex/msc/maintenance.tex index 67eb3479a9c..3e49133c6ee 100644 --- a/Master/texmf-dist/doc/latex/msc/maintenance.tex +++ b/Master/texmf-dist/doc/latex/msc/maintenance.tex @@ -1,9 +1,7 @@ % file: maintenance.tex -% Copyright 2002 V. Bos and S. Mauw +% Copyright 2008 V. Bos, T. van Deursen, and S. Mauw % This file is part of the MSC Macro Package. % -% RCS version: $Id: maintenance.tex,v 1.11 2004/03/15 11:40:27 vbos Exp $ -% \documentclass{article} \usepackage{a4wide} \usepackage{msc} @@ -13,25 +11,23 @@ document } + \author{ - \begin{tabular}{cc} - Victor Bos & Sjouke Mauw\\ - \footnotesize Turku Centre for Computer Science & - \footnotesize Eindhoven University of Technology \\ [-0.8ex] - \footnotesize Software Construction Laboratory & - \footnotesize Department of Mathematics and Computing Science \\ [-0.8ex] - \footnotesize Lemminkäisenkatu 14 & - \footnotesize P.O.\ Box 513 \\ [-0.8ex] - \footnotesize FIN--20520 Turku & - \footnotesize NL--5600 MB Eindhoven \\ [-0.8ex] - \footnotesize Finland & - \footnotesize The Netherlands \\ - \footnotesize \texttt{vbos@abo.fi} & - \footnotesize \texttt{sjouke@win.tue.nl} - \end{tabular} + \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} @@ -50,7 +46,7 @@ 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://www.win.tue.nl/~sjouke/mscpackage.html+. +\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 @@ -60,65 +56,45 @@ desired additional functionality. \section{Versions} \begin{itemize} -\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. - -\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.2, Public release, 1999/03/29. +\item Version 1.16, beta release, 2008/06/02 -Minor bug fixes. -Code restructuring. -Additionally supports: Actions.\\ -Extra parameters: -\verb+\actionheight+, \verb+\actionwidth+. +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+. -\item Version 1.3, Public release, 1999/04/10. +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. -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.4, Public release, 1999/04/23. +Name and address information has been updated. -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.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.10, Public release, 2002/04/10. +\item Version 1.12, beta release, 2002/06/18. -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. +In this version, the user has more control over the positioning of +message labels. Implementation not finished yet. -Reference manual. For a list of (all) commands and lengths, see -reference manual. +\item Version 1.11, Public release, 2002/06/06. -Package now also available at CTAN. +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. @@ -137,40 +113,63 @@ 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.11, Public release, 2002/06/06. +\item Version 1.10, Public release, 2002/04/10. -Minor bug fix.\\ The \verb+\stepcounter+ problem that occurred while -using the MSC Macro Package together with overlays (slides) is solved. +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. -\item Version 1.12, beta release, 2002/06/18. +Reference manual. For a list of (all) commands and lengths, see +reference manual. -In this version, the user has more control over the positioning of -message labels. Implementation not finished yet. +Package now also available at CTAN. -\item Version 1.13, beta release, 2002/06/27. +\item Version 1.4, Public release, 1999/04/23. -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. +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. -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.3, Public release, 1999/04/10. -\item Version 1.14, Public release, 2004/03/15. +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. -This version fixes a bug in the drawing routine of messages. In -earlier versions, the arrow heads of messages were sometimes -positioned at the center of an instance axis, even though the instance -was an activation region. +\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} @@ -216,19 +215,13 @@ 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! -\item The MSC Macro Package (version $\leq 1.13$) sometimes draws -arrow heads at the wrong place. Paulo S\'ergio Almeida discovered this -for messages drawn from right to left and for which the receiver -instance is an activation region. In fact, as Paulo noticed, the -manual contains an example of this bug, see Section~6.12 of the -manual. He also provided some \LaTeX{} code to fix the big. In -version~1.14, this code replaces the erroneous code. - \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 @@ -246,11 +239,11 @@ 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 Add option to messages to determine relative position of -label. S. Mauw (sjouke@win.tue.nl), 1999/04/15. - \item A possibility to change the color of instance regions. V. Bos -(09/04/2002). +(2002/04/09). + +\item Add option to messages to determine relative position of +label. (S. Mauw 1999/04/15). \end{itemize} diff --git a/Master/texmf-dist/doc/latex/msc/manual.pdf b/Master/texmf-dist/doc/latex/msc/manual.pdf Binary files differnew file mode 100644 index 00000000000..9cc6c420cf4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/msc/manual.pdf diff --git a/Master/texmf-dist/doc/latex/msc/manual.tex b/Master/texmf-dist/doc/latex/msc/manual.tex index a032b52de25..d6025770fe4 100644 --- a/Master/texmf-dist/doc/latex/msc/manual.tex +++ b/Master/texmf-dist/doc/latex/msc/manual.tex @@ -1,14 +1,11 @@ % file: manual.tex -% Copyright 2002 V. Bos and S. Mauw +% Copyright 2008 V. Bos, T. van Deursen, and S. Mauw % This file is part of the MSC Macro Package. % -% RCS version: $Id: manual.tex,v 1.9 2004/03/15 11:35:47 vbos Exp $ -% \documentclass[12pt,a4paper]{article} \usepackage{a4wide} \usepackage{url} \usepackage{moreverb} -\usepackage{graphicx} \usepackage{multicol} \usepackage{msc} @@ -110,21 +107,19 @@ } \author{ - \begin{tabular}{cc} - Victor Bos & Sjouke Mauw\\ - \footnotesize Turku Centre for Computer Science & - \footnotesize Eindhoven University of Technology \\ [-0.8ex] - \footnotesize Software Construction Laboratory & - \footnotesize Department of Mathematics and Computing Science \\ [-0.8ex] - \footnotesize Lemmink\"aisenkatu 14 & - \footnotesize P.O.\ Box 513 \\ [-0.8ex] - \footnotesize FIN--20520 Turku & - \footnotesize NL--5600 MB Eindhoven \\ [-0.8ex] - \footnotesize Finland & - \footnotesize The Netherlands \\ - \footnotesize \texttt{vbos@abo.fi} & - \footnotesize \texttt{sjouke@win.tue.nl} - \end{tabular} + \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} } \date{\small Version \mscversion, last update \today\\ @@ -146,6 +141,14 @@ design and use of the \mscpack. \section{New} \label{new} +\paragraph{Version~1.16} solves a bug that was due to a change in +syntax of the \verb+scalebox+ macro in the \verb+PSTricks+ package. + +The \verb+action+ and \verb+condition+ macros are extended with a +starred option. The starred version of the macros automatically +adjusts the size of the rectangle and hexagon based on the size of the +contents. + \paragraph{Version~1.13} has a reimplementation of message commands in MSC diagrams. The affected commands are: \verb+\create+, \verb+\found+, \verb+\lost+, \verb+\mess+, and \verb+\order+. The new implementation @@ -293,7 +296,7 @@ an appropriate set of parameters. The \mscpack{} is still under development. The authors appreciate any comments and suggestions for improvements. The most recent version of the package can be downloaded from -\url{http://www.win.tue.nl/~sjouke/mscpackage.html}. +\url{http://satoss.uni.lu/mscpackage/}. The \mscpack{} has a \emph{LaTeX Project Public License} @@ -991,7 +994,7 @@ doubled in order to fit the comments inside the frame. An instance can perform an action, which is denoted by a rectangle. \begin{verbatim} -\action{name}{instance} +\action(*){name}{instance} \end{verbatim} The action is attached at the current level to the \verb+instance+. @@ -1003,6 +1006,10 @@ symbol (see Section~\ref{parameters}): \verb+\actionwidth+ (the width of the action symbol), and \verb+\actionheight+ (the height of the action symbol). +The starred version of the command, \verb+\action*+, produces the same +result as \verb+\action+, except that the height and width of the +action symbol are adjusted to fit the contents of the rectangle. + The next example shows that after an action often a multiple level increment is needed to obtain nice pictures. @@ -1134,9 +1141,8 @@ with the command which is a dashed polyline. The position of the mark symbol relative to the marked event is determined by the \verb+placement+. -(\verb+tl+ means top-left, \verb+tr+ means top-right, \verb+ml+ means -middle-left, \verb+mr+ means middle-right, -\verb+bl+ means bottom-left, and \verb+br+ means bottom-right). +(\verb+tl+ means top-left, \verb+tr+ means top-right, \verb+bl+ means +bottom-left, and \verb+br+ means bottom-right). A \verb+\measure+ connects two events from \verb+instance1+ and \verb+instance2+. The first event is at the current level. The second @@ -1327,6 +1333,10 @@ symbol (see Section~\ref{parameters}): symbol which extends over the rightmost/leftmost contained instance axis). +The starred version of the command, \verb+\condition*+, produces the same +result as \verb+\condition+, except that the height and width of the +condition symbol are adjusted to fit the contents of the hexagon. + The following example contains some conditions. \medskip @@ -2823,10 +2833,7 @@ following \LaTeX\ fragment. \section{Acknowledgments} Thanks are due to the following people for providing us with useful -input: Peter Peters, Michel Reniers. In addition, we -thank the people who have submitted bugs, and sometimes even -bug-fixes. These people are mentioned in the \emph{Maintenance} -document of the \mscpack{} (Section~3, \emph{Bugs}). +input: Peter Peters, Michel Reniers. \bibliographystyle{plain} \bibliography{biblio} diff --git a/Master/texmf-dist/doc/latex/msc/refman.pdf b/Master/texmf-dist/doc/latex/msc/refman.pdf Binary files differnew file mode 100644 index 00000000000..8423cc8ade6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/msc/refman.pdf diff --git a/Master/texmf-dist/doc/latex/msc/refman.tex b/Master/texmf-dist/doc/latex/msc/refman.tex index a4c416a4b6c..84d60381633 100644 --- a/Master/texmf-dist/doc/latex/msc/refman.tex +++ b/Master/texmf-dist/doc/latex/msc/refman.tex @@ -1,9 +1,7 @@ % file: refman.tex -% Copyright 2002 V. Bos and S. Mauw +% Copyright 2008 V. Bos, T. van Deursen, and S. Mauw % This file is part of the MSC Macro Package. % -% RCS version: $Id: refman.tex,v 1.7 2002/07/01 10:38:59 vbos Exp $ -% \documentclass[a4paper]{article} \usepackage{a4wide} @@ -98,21 +96,19 @@ } \author{ - \begin{tabular}{cc} - Victor Bos & Sjouke Mauw\\ - \footnotesize Turku Centre for Computer Science & - \footnotesize Eindhoven University of Technology \\ [-0.8ex] - \footnotesize Software Construction Laboratory & - \footnotesize Department of Mathematics and Computing Science \\ [-0.8ex] - \footnotesize Lemmink\"aisenkatu 14 & - \footnotesize P.O.\ Box 513 \\ [-0.8ex] - \footnotesize FIN--20520 Turku & - \footnotesize NL--5600 MB Eindhoven \\ [-0.8ex] - \footnotesize Finland & - \footnotesize The Netherlands \\ - \footnotesize \texttt{vbos@abo.fi} & - \footnotesize \texttt{sjouke@win.tue.nl} - \end{tabular} + \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{vbos@abo.fi} & + \scriptsize \texttt{ton.vandeursen@uni.lu} & + \scriptsize \texttt{sjouke.mauw@uni.lu} + \end{tabular}\\ + \end{tabular} } \date{\small Version \mscversion, last update \today\\ @@ -616,11 +612,12 @@ define the upper right corner of the \MSCdoc. \begin{defs} -\item[\cmd{action}\{\emph{txt}\}\{\emph{nm}\}] Draws an \emph{action} +\item[\cmd{action(*)}\{\emph{txt}\}\{\emph{nm}\}] Draws an \emph{action} symbol on the instance with nickname \emph{nm}. The parameter \emph{txt} defines the name of the action. The size of the action symbol is controlled by the \verb|\actionheight| and \verb|\actionwidth| -lengths. +lengths. The starred version adjusts the height and width of the +action symbol to the size of the contents. \item[\cmd{arrow}\cmdarg{nm0}\opt{\coordargs{xpos${}_1$}{ypos${}_1$}$\ldots$\coordargs{xpos${}_n$}{ypos${}_n$}}\cmdarg{nm1}] Draws an arrow in an \HMSC{} diagram. The arrow starts at the symbol @@ -633,7 +630,7 @@ is a list of intermediate points the arrow should pass through. bar width of instance \emph{nm} to \emph{wd}. The parameter \emph{wd} should be a valid \LaTeX{} length. -\item[\cmd{comment}\opt{\emph{pos}}\{\emph{txt}\}\{\emph{nm}\}] Puts a +\item[\cmd{msccomment}\opt{\emph{pos}}\{\emph{txt}\}\{\emph{nm}\}] Puts a comment at instance \emph{nm}. The parameter \emph{txt} is the comment. The optional parameter \emph{pos} defines the horizontal position of the comment relative to instance \emph{nm}. Valid @@ -645,14 +642,15 @@ the instance axis. If \emph{pos} is a length, the comment will be put comment to the left and a positive \emph{pos} puts it to the right of the instance axis. -\item[\cmd{condition}\{\emph{txt}\}\{\emph{instancelist}\}] Draws a +\item[\cmd{condition(*)}\{\emph{txt}\}\{\emph{instancelist}\}] Draws a \emph{condition} symbol on the instances occurring in \emph{instancelist}. The parameter \emph{txt} defines the text to be placed in the \emph{condition} symbol. The parameter \emph{instancelist} is a comma separated list of instance nicknames. Note that there should be no white space between the commas and the nicknames; only if a nickname contains white space is a white -space allowed in \emph{instancelist}. +space allowed in \emph{instancelist}. The starred version adjusts the +height and width of the condition symbol to the size of the contents. \item[\cmd{coregionend}\{\emph{nm}\}] Ends the co-region on the instance \emph{nm}. This command is obsolete (see \verb|\regionend|). @@ -837,7 +835,7 @@ is~1. \item[\cmd{measureend(*)}\opt{\emph{pos}}\{\emph{txt}\}\{\emph{nm}\}\{\emph{gate}\}] -Puts a \emph{measure end} symbol at instance \emph{nm}.The starred +Puts a \emph{measure end} symbol at instance \emph{nm}. The starred version puts the triangular measure symbol outside the measure; the unstarred version puts the triangular measure symbol inside the measure. The \emph{txt} parameter defines the label of the @@ -1542,129 +1540,6 @@ is given below. \end{verbatim} } - -\paragraph{Automatic resizing of actions} - -Consider the \MSC{} of Figure~\ref{fig:small:action}. The source code -for this diagram is: -{ -\small -\begin{verbatim} -\begin{msc}{small action} -\declinst{i}{$i$}{} -\declinst{j}{$j$}{} -\action{\parbox{1cm}{\centering Do it now}}{i} -\nextlevel[2] -\end{msc} -\end{verbatim} -} - -\begin{figure}[htb] -\begin{center} -\begin{msc}{small action} -\declinst{i}{$i$}{} -\declinst{j}{$j$}{} -\action{\parbox{1cm}{\centering Do it now}}{i} -\nextlevel[2] -\end{msc} -\end{center} - -\caption{Small action symbol} -\label{fig:small:action} -\end{figure} - -It is clear that the action symbol is too small for the action -label. The normal solution to this problem would be to change the -values of \cmd{actionwidth} and \cmd{actionheight} such that the -\cmd{parbox} containing the action label fits in the frame of the -action symbol. - -Instead of computing these lengths and adding the necessary -\cmd{setlength} commands manually, it would be nice to have a macro -that computes and adjusts the lengths as required. The \cmd{Action} macro -defined below does just that. -{ -\small -\begin{verbatim} -\newsavebox{\labelbox} -\newlength{\oldwd} -\newlength{\oldht} -\newcommand{\Action}[2]{% - \setlength{\oldwd}{\actionwidth}% - \setlength{\oldht}{\actionheight}% - \savebox{\labelbox}{#1}% - \setlength{\actionwidth}{\wd\labelbox + 2\labeldist}% - \setlength{\actionheight}{\ht\labelbox + \dp\labelbox + 2\labeldist}% - \action{\usebox{\labelbox}}{#2}% - \setlength{\actionwidth}{\oldwd}% - \setlength{\actionheight}{\oldht}% -} -\end{verbatim} -} Note that we define a box (\cmd{labelbox}) and two lengths -(\cmd{oldwd} and \cmd{oldht}) as scratch variables. Furthermore, -before changing the width and height of action symbols, the old values -are saved in \cmd{oldwd} and \cmd{oldht}, respectively. The new width -and height of action symbols accomodate for white space around the -action label by using the \mscpack{} length \cmd{labeldist}. After -changing the lengths, the action is drawn using the normal -\cmd{action} command. Finally, the old values of \cmd{actionwidth} and -\cmd{actionheight} are restored. - - -\newsavebox{\labelbox} -\newlength{\oldwd} -\newlength{\oldht} -\newcommand{\Action}[2]{% - \setlength{\oldwd}{\actionwidth}% - \setlength{\oldht}{\actionheight}% - \savebox{\labelbox}{#1}% - \setlength{\actionwidth}{\wd\labelbox + 2\labeldist}% - \setlength{\actionheight}{\ht\labelbox + \dp\labelbox + 2\labeldist}% - \action{\usebox{\labelbox}}{#2}% - \setlength{\actionwidth}{\oldwd}% - \setlength{\actionheight}{\oldht}% -} - -Figure~\ref{fig:resizing:action} shows the effect of automatic -resizing action symbols. Instance~$i$ has automically resizing -action. The actions of instance~$j$ are normal actions that show the -new \cmd{Action} command changes the size of one action symbol -only. The source of this diagram is given below. - -\begin{figure}[htb] -\begin{center} -\begin{msc}{small action} -\declinst{i}{$i$}{} -\declinst{j}{$j$}{} -\action{A}{j} -\Action{\parbox{1cm}{\centering Do it now}}{i} -\nextlevel[2] -\action{B}{j} -\nextlevel[2] -\end{msc} -\end{center} - -\caption{Automatic resizing action symbol} -\label{fig:resizing:action} -\end{figure} - - -{ -\small -\begin{verbatim} -\begin{msc}{small action} -\declinst{i}{$i$}{} -\declinst{j}{$j$}{} -\action{A}{j} -\Action{\parbox{1cm}{\centering Do it now}}{i} -\nextlevel[2] -\action{B}{j} -\nextlevel[2] -\end{msc} -\end{verbatim} -} - - \bibliographystyle{plain} \bibliography{biblio} |