summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/msc/maintenance.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/msc/maintenance.tex')
-rw-r--r--macros/latex/contrib/msc/maintenance.tex250
1 files changed, 0 insertions, 250 deletions
diff --git a/macros/latex/contrib/msc/maintenance.tex b/macros/latex/contrib/msc/maintenance.tex
deleted file mode 100644
index 3e49133c6e..0000000000
--- a/macros/latex/contrib/msc/maintenance.tex
+++ /dev/null
@@ -1,250 +0,0 @@
-% 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}