Debian Codegraph @

texmf-dist/source/latex/struktex/struktex.dtx

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 1995 - 2025 by Jobst Hoffmann, FH Aachen, Campus Jülich
4 % <j.hoffmann_(at)_fh-aachen.de>
5 % -------------------------------------------------------------------------------------------
6 %
7 % This work may be distributed and/or modified under the conditions of the
8 % LaTeX Project Public License, either version 1.3c of this license or (at
9 % your option) any later version. The latest version of this license can be
10 % found at
11 %
12 % https://ctan.org/license/lppl1.3c
13 %
14 % and version 1.3c or later is part of all distributions of LaTeX version
15 % 2005/12/01 or later.
16 %
17 % This work is "maintained" (as per LPPL maintenance status) by
18 % Jobst Hoffmann.
19 %
20 % This work consists of the files README.md,
21 % struktex.dtx and
22 % and the derived files struktex.sty,
23 % strukdoc.sty,
24 % struktxf.sty
25 % struktxp.sty
26 % struktex-test_<n>.tex, n=1(1)3,
27 % struktex-tst-00.nss,
28 % struktxf-tst-00.tex,
29 % struktxp-tst-00.tex,
30 % build.lua
31 % build-config.lua
32 %
33 %<*ignore>
34 \begingroup
35 \def\x{LaTeX2e}
36 \expandafter\endgroup
37 \ifcase 0\ifx\install y1\fi\expandafter
38 \ifx\csname processbatchFile\endcsname\relax\else1\fi
39 \ifx\fmtname\x\else 1\fi\relax
40 \else\csname fi\endcsname
41 %</ignore>
42 %<*install>
43 %%
44 \input docstrip.tex
45
46 \preamble
47
48 Copyright (C) 1989-2025 by Jobst Hoffmann. All rights reserved.
49
50 IMPORTANT COPYRIGHT NOTICE:
51
52 No other permissions to copy or distribute this file in any form
53 are granted and in particular NO PERMISSION to modify its contents.
54
55 You are NOT ALLOWED to change this file.
56
57 Please address error reports and any problems in case of UNCHANGED versions
58 to
59 j.hoffmann_(at)_fh-aachen.de
60 \endpreamble
61
62 \declarepostamble\examplepost
63 \endpostamble
64
65 \BaseDirectory{~/texmf}
66 \UseTDS
67
68 \keepsilent
69
70 \def\targetdirectory{} % or may be for example
71 %\def\targetdirectory{../../../../texmf/tex/latex/struktex/}
72
73 % programs and packages
74
75 \Msg{*** Generating the package files ***}
76
77 \generate%
78 {%
79 \askforoverwritefalse
80 \file{struktex.drv}{\from{struktex.dtx}{driver}}
81 \file{struktex.sty}{\from{struktex.dtx}{struktex}}
82 \file{strukdoc.sty}{\from{struktex.dtx}{strukdoc}}
83 \file{struktxf.sty}{\from{struktex.dtx}{struktxf}}
84 \file{struktxp.sty}{\from{struktex.dtx}{struktxp}}
85 }
86
87 \Msg{*** Generating example files ***}
88
89 \preamble
90 \endpreamble%
91 \generate%
92 {%
93 \askforoverwritefalse
94 \usepostamble\examplepost
95 \file{struktex-tst-00.nss}{\from{struktex.dtx}{nss-sample}}
96 \file{struktex-test-1.tex}{\from{struktex.dtx}{example1}}
97 \file{struktex-test-2.tex}{\from{struktex.dtx}{example2}}
98 \file{struktex-test-3.tex}{\from{struktex.dtx}{example3}}
99 \file{struktxf-tst-00.tex}{\from{struktex.dtx}{struktxf-00}}
100 \file{struktxp-tst-00.tex}{\from{struktex.dtx}{struktxp-00}}
101 }
102
103 \Msg{*** Generating some additional files for easier handling ***}
104 \generate{%
105 \askforoverwritefalse%
106 \nopreamble\nopostamble\def\MetaPrefix{}%
107 \file{build-config.lua}{\from{struktex.dtx}{config}}
108 \file{build.lua}{\from{struktex.dtx}{lbuild}}
109 \file{struktex.el}{\from{struktex.dtx}{auctex}}
110 }
111
112 \ifToplevel{%
113 \Msg{***********************************************************}
114 \Msg{*}
115 \Msg{* To finish the installation you have to move the file}
116 \Msg{*}
117 \Msg{* \space\space\space\space struktex.sty}
118 \Msg{*}
119 \Msg{* into a directory searched by TeX:}
120 \Msg{* To produce the documentation, run the file}
121 \Msg{*}
122 \Msg{* \space\space\space\space struktex.dtx through LaTeX.}
123 \Msg{*}
124 \Msg{* To see the examples, run the files}
125 \Msg{*}
126 \Msg{* \space\space\space\space struktex-test-1.tex}
127 \Msg{* \space\space\space\space struktex-test-2.tex}
128 \Msg{* \space\space\space\space struktex-test-3.tex}
129 \Msg{* \space\space\space\space struktxf-tst-00.tex}
130 \Msg{* \space\space\space\space struktxp-tst-00.tex}
131 \Msg{*}
132 \Msg{* through LaTeX.}
133 \Msg{***********************************************************}
134 }
135
136 \endbatchfile
137 %</install>
138 %<*ignore>
139 \fi
140 %</ignore>
141 %<*driver>
142 % set the default formatting language:
143 \expandafter\ifx\csname primarylanguage\endcsname\relax
144 \def\primarylanguage{ngerman}
145 \def\secondarylanguage{english}
146 \fi
147
148 \documentclass[a4paper, \secondarylanguage, % select the language
149 \primarylanguage]{ltxdoc}
150
151 \PassOptionsToPackage{obeyspaces}{url} % must be done before any package is
152 % loaded
153
154 \usepackage{babel} % for switching the documentation language
155 \usepackage{moreverb} % for formatting the documentation of the driver
156 \usepackage{strukdoc} % the style-file for formatting this
157 % documentation
158
159 \usepackage[pict2e, % <---------- to produce finer results
160 % visible under xdvi, alternatives are
161 % curves or emlines2 (visible only under
162 % ghostscript), leave out if not
163 % available
164 verification,
165 outer, % <------------------- to set the position of the \ifthenelse
166 % flags to the outer edges
167 debug,
168 ]
169 {struktex}
170
171 % \EnableCrossrefs
172 % \DisableCrossrefs % remove comment char if index is ready
173 % \RecordChanges % remove comment char to gather update information
174 % \CodelineIndex % remove comment char to index entry code by line number
175 \OnlyDescription % add comment char to include the implementation details
176
177 \MakeShortVerb{\|} % |\foo| acts like \verb+\foo+
178
179 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
180 %% to avoid underfull ... messages while formatting two/three columns
181 \hbadness=10000 \vbadness=10000
182
183 \typeout{\string\primarylanguage: \primarylanguage, \string\language: \the\language}
184 \def\languageNGerman{\the\csname l@ngerman\endcsname} % depends on language.dat,
185 % there may be changes from release to
186 % release
187
188 \begin{document}
189 \makeatletter
190 \@ifundefined{selectlanguageEnglish}{}{\selectlanguage{english}}
191 \makeatother
192 \DocInput{struktex.dtx}
193 \end{document}
194 %</driver>
195 % \fi
196 %
197 % \GetFileInfo{struktex.sty}
198 %
199 % \changes{v3.0}{25/06/19}{updated Copyright to 2025}
200 % \changes{v2.4}{20/01/25}{updated Copyright to 2020}
201 % \changes{v2.3a}{18/03/07}{updated Copyright to 2018}
202 % \changes{v2.2b}{17/07/09}{better layout of the source code}
203 % \changes{v2.2a}{17/06/30}{added notes about versioning scheme}
204 % \changes{v2.2}{17/06/18}{rewrote LIESMICH.md and README.md}
205 % \changes{v2.1a}{17/06/11}{made the versioning git aware}
206 % \changes{v2.0}{17/06/01}{changed version control system to git}
207 % \changes{v2.0}{17/06/01}{updated copyright}
208 % \changes{v141}{12/04/10}{updated copyright}
209 % \changes{v131}{10/09/21}{some more layout changes}
210 % \changes{v130}{10/09/21}{some changes in the layout of the source,
211 % removed typos}
212 % \changes{v121}{10/08/31}{scrumbled the email a little bit}
213 % \changes{v121}{10/08/31}{moved opening brace to end of line in several cases}
214 % \changes{v084}{10/06/24}{small layout changes}
215 % \changes{v084}{10/06/24}{corrected revision macro---added missing command}
216 % \changes{v062}{10/05/31}{moved the docstrip guards into the corresponding macrocode environments}
217 % \changes{v061}{10/05/31}{corrected some more typos}
218 % \changes{v057}{10/01/21}{added some missing closing braces at the end of `ProvidesPackage}
219 % \iffalse%
220 %<struktex|struktxf|struktxp|strukdoc>\NeedsTeXFormat{LaTeX2e}[1999/12/01]{%
221 %<struktex|struktxf|struktxp|strukdoc> \def\@git@ $#1Date: #2-#3-#4 #5$$#6Revision: v#7$ {%
222 %<struktex> \ProvidesPackage{struktex}[#2/#3/#4 v#7 Nassi Shneiderman Diagrams (Jobst Hoffmann)]}
223 %<struktxf> \ProvidesPackage{struktxf}[#2/#3/#4 v#7 Fonts for Nassi Shneiderman Diagrams (Jobst Hoffmann)]}
224 %<struktxp> \ProvidesPackage{struktxp}[#2/#3/#4 v#7 Keywords for Nassi Shneiderman Diagrams (Jobst Hoffmann)]}
225 %<strukdoc> \ProvidesPackage{strukdoc}[#2/#3/#4 v#7 support for reading and writing files verbatim (Jobst Hoffmann)]}
226 %<struktex|struktxf|struktxp|strukdoc> %% git revision information
227 %<struktex|struktxf|struktxp|strukdoc>}%
228 % \fi
229 %
230 %
231 % \CheckSum{0} ^^A set to 0 to inactivate the CheckSum
232 % \def\docdate {2025/01/25} ^^A not style'able!!
233 %
234 % \iffalse meta-comment
235 % Alles bis zum nächsten `\ fi' (ohne Leerzeichen) wird
236 % ignoriert. Das ist notwendig, da `%' nicht weiter
237 % Kommentar einleitet, wenn diese Datei eingelesen wird.
238 %
239 % Stil-Option `struktex' zum Gebrauch mit LaTeX2e
240 % Copyright (C) 1995-2025 Jobst Hoffmann, alle Rechte vorbehalten.
241 %
242 %
243 % Das Kopieren dieser Datei ist nur zulässig, wenn
244 % (1) keinerlei Änderungen an dieser Datei durchgeführt werden, oder
245 % (2) wenn diese Datei geändert wird, sie einen anderen Namen als
246 % struktex.DTX erhält.
247 % Diese Einschränkung dient dazu, dass alle Stiloptionen identisch bleiben.
248 %
249 % Fehlermeldungen werden erbeten an: Jobst Hoffmann
250 % Email: <j.hoffmann_(at)_fh-aachen.de>
251 %
252 % Achtung: um korrekte Bearbeitung zu erzielen, muss die Umgebung
253 % \begin{macrocode}
254 % ...
255 % \end{macrocode}
256 % immer (mindestens) fünf Zeichen eingerückt sein, also in Spalte
257 % sechs beginnen!
258 %
259 % \fi
260 %
261 % \changes{v2.4}{20/01/28}{using `sFile as markup for file names}
262 % \def\StrukTeXSty{\sFile{struktex.sty}}
263 %
264 % \changes{v056}{10/01/21}{changed revision entries "vN.NNx" $\rightarrow$ "v-N.NNx"}
265 % \changes{v056}{10/01/21}{removed trailing blanks}
266 % \changes{v054}{10/01/18}{changed revisioning tool from cvs to subversion}
267 % \changes{v-9.1}{10/01/17}{changed the position of `label commands}
268 % \changes{v-8.3b}{06/08/20}{Erweiterung im Makefile: für dist wird automatisch
269 % eine Datei THIS\_IS\_VERSION\_... erzeugt.}
270 % \changes{v-8.3a}{06/08/19}{struktex.el erweitert: es wird die korrekte Anzahl
271 % von `switch{} generiert und mit Inhalt gefüllt}
272 % \changes{v-8.3}{06/08/18}{Weitere Optionen "`draft"' und "`final"' eingeführt}
273 % \changes{v-8.2a}{06/01/17}{struktex.el korrigiert und erweitert}
274 % \changes{v-8.1a}{05/09/01}{Erste (fehlerhafte) Version einer struktex.el Stil
275 % Datei zur Unterstützung von AUC\TeX{} hinzugefügt}
276 % \changes{v-8.0f}{05/06/11}{Dokumentation von `case verbessert}
277 % \changes{v-8.0d}{04/12/29}{`switch zeigt bei geeigneten Beispielen das
278 % rechtsbündige Setzen von Bedingungen}
279 % \changes{v-8.0c}{04/07/15}{Zweisprachigkeit verbessert, Bezeichner statt
280 % Nummern eingeführt}
281 % \changes{v-8.0b}{04/07/14}{`fileversion und `filedate zur einfacheren
282 % zentralen Verwaltung von Entwicklungsdaten eingeführt}
283 % \changes{v-7.0b}{04/03/09}{Anzahl der Zähler reduziert}
284 % \changes{v-7.0a}{03/04/21}{Code teilweise umgestellt}
285 % \changes{v-7.0a}{03/04/21}{Dateinamen geändert}
286 % \changes{v-7.0a}{03/04/21}{Tippfehler korrigiert}
287 % \changes{v-7.0a}{03/04/21}{Marker für interne Beispiele umbenannt}
288 % \changes{v-7.0a}{03/04/21}{Testrahmen geändert}
289 % \changes{v-7.0a}{03/04/21}{Beispiele für unterschiedlichen
290 % Programmierspracheneinsatz erweitert}
291 % \changes{v-7.0a}{03/04/21}{Makefile integriert}
292 % \changes{v-7.0a}{03/04/21}{`pLanguage geändert: `pLanguage@nss
293 % zusätzlich eingeführt}
294 % \changes{v-7.0a}{03/04/21}{Sprachbezeichnungen geändert: Suffix @nss}
295 % \changes{v-7.0}{03/04/21}{Wechsel von der RWTH Aachen zur FH Aachen,
296 % Abt. Jülich}
297 % \changes{v-6.0a}{01/04/22}{Dokumentation von `case verbessert}
298 % \changes{v-6.0a}{00/12/08}{Makros `cs, `marg, `oarg, `pparg sowie `envb
299 % und `enve zur besseren Dokumentation eingesetzt}
300 % \changes{v-6.0a}{00/11/24}{Englische Übersetzung der Dokumentation
301 % hinzugefügt }
302 % \changes{v-6.0a}{00/11/24}{Code umgestaltet, z.B. `def $\rightarrow$
303 % `newcommand, \$\ldots\$ $\rightarrow$ `(\ldots`) }
304 % \changes{v-6.0a}{00/11/24}{Zusätzliche Paketoption "`curves"' zur
305 % Gestaltung beliebiger Steigungen eingeführt}
306 % \changes{v-5.4b}{00/12/08}{Umgebungen zur einfacheren Notation der
307 % Dokumentation eingeführt}
308 % \changes{v-5.4b}{00/12/08}{Erster Versuch einer gemischtsprachigen
309 % Dokumentation}
310 % \changes{v-5.4a}{99/11/16}{\sFile{stuktxp.sty} überarbeitet zur
311 % besseren Darstellung von Programmen}
312 % \changes{v-5.3a}{98/11/27}{Die Form des Textes in Bedingungen ist nun an
313 % beliebige Steigungen angepasst}
314 % \changes{v-5.2b}{98/05/28}{Tippfehlerkorrektur: Umlaut "`ue"' durch
315 % "`ü"' ersetzt}
316 % \changes{v-5.2a}{97/12/03}{Umstellung der Dokumentation, dadurch Verzicht
317 % auf eigene Treiberdatei möglich}
318 % \changes{v-5.2a}{97/12/03}{kleinere Korrekturen}
319 % \changes{v-5.1b}{97/11/02}{Umstellung der Dokumentation mittels Umgebung
320 % \texttt{example}, `verbatiminput und verbatimwrite}
321 % \changes{v-5.1a}{97/04/29}{kleinere stilistische Änderungen nach W. Hanrath}
322 % \changes{v-5.0}{97/04/28}{Dateinamen zwecks Kompatibilität auf
323 % Kleinschreibung umgesetzt}
324 % \changes{v-5.0}{97/04/28}{kleinere textuelle Änderungen, Fontauswahl
325 % teilweise geändert}
326 % \changes{v-5.0}{97/04/28}{Abhängigkeiten der Dokumentation von
327 % zusätzlichen Paketen beseitigt}
328 % \changes{v-4.5e}{97/04/25}{Verzicht auf Groß- und Kleinschreibung im
329 % Namen von .sty-Dateien}
330 % \changes{v-4.5a}{96/03/14}{Umgebung \texttt{description} auf
331 % \texttt{list}-Umgebung zurückgeführt}
332 % \changes{v-4.5a}{96/03/14}{Eigenes Paket zur Formatierung von
333 % Programminhalten integriert}
334 % \changes{v-4.1c}{95/07/24}{Dokumentation verbessert}
335 % \changes{v-4.1b}{95/07/19}{Höhe des Bedingungsrechteckes bei `ifthenelse
336 % vorgebbar}
337 % \changes{v-4.1a}{95/07/17}{Geraden mit beliebiger Steigung durch `emline
338 % möglich}
339 % \changes{v-4.0a}{95/04/12}{Anpassung an LaTeX2e}
340 % \changes{v-3.5a}{94/11/22}{Entwicklunglinien J. Dietel, J. Hoffmann vereinigt}
341 % \changes{v-3.3a}{94/09/14}{Schnittstellenbeschreibung verallgemeinert}
342 % \changes{v-3.2a}{94/09/14}{Dokumentation verbessert}
343 % \changes{v-3.1a}{94/09/09}{Verschiedene Erweiterungen}
344 % \changes{v-3.0a}{94/06/06}{Urversion mit integrierter Dokumentation}
345 % \changes{v-2.5}{93/09/09}{Jobst Hoffmann, Rechenzentrum RWTH Aachen}
346 % \changes{v-2.0}{92/01/17}{Dorothea Rieger, Rechenzentrum RWTH Aachen}
347 % \changes{v-1.41}{88/06/20}{Andreas Wagener, Proze"srechner CYBER 815}
348 %
349 % \DoNotIndex{\ ,\!,\C,\[,\\,\],\^,\`,\{,\},\~,\<,\=}
350 % \DoNotIndex{\@ifundefined,\@ne,\catcode,\def,\docdate}
351 % \DoNotIndex{\else,\endinput,\expandafter,\fi,\filedate,\fileversion}
352 % \DoNotIndex{\gdef,\global,\ifnum,\ifx,\let,\long}
353 % \DoNotIndex{\newcount,\newdimen,\newif,\next,\space,\string}
354 % \DoNotIndex{\the,\xdef,\z@}
355 % \DoNotIndex{\@@par, \@empty, \@hangfrom, \@reffalse, \@reftrue,}
356 % \DoNotIndex{\advance, \Alph, \alph, \arabic, \baselineskip, \begin}
357 % \DoNotIndex{\bgroup, \box, \bullet, \cdot, \centering}
358 % \DoNotIndex{\columnwidth, \day, \divide}
359 % \DoNotIndex{\egroup, \end, \font, \footins, \foo}
360 % \DoNotIndex{\frenchspacing, \hbadness, \hbox, \hfil, \hfill}
361 % \DoNotIndex{\hrule, \hsize, \hskip, \hspace, \hss, \ifcase, \ifdim, \ifodd}
362 % \DoNotIndex{\ifvmode, \ignorespaces, \input, \interlinepenalty, \item}
363 % \DoNotIndex{\itemindent, \kern, \L, \list, \listparindent, \magstep}
364 % \DoNotIndex{\magstephalf, \makelabel, \MakeShortVerb, \marginpar}
365 % \DoNotIndex{\mark, \month, \newpage, \nobreak, \noindent, \normalsize, \null}
366 % \DoNotIndex{\number, \onecolumn, \or, \overfullrule}
367 % \DoNotIndex{\pagebreak, \parbox, \penalty, \phantom}
368 % \DoNotIndex{\raggedbottom, \raggedleft}
369 % \DoNotIndex{\relax, \renewcommand, \reversemarginpar}
370 % \DoNotIndex{\rightmargin, \rule, \setbox, \setcounter}
371 % \DoNotIndex{\setlength, \settowidth, \strut, \svtnsfb}
372 % \DoNotIndex{\thepage, \thispagestyle, \triangleright}
373 % \DoNotIndex{\underline, \vadjust, \vbadness, \vbox, \verb, \vfil}
374 % \DoNotIndex{\vspace, \wd, \year}
375 % \DoNotIndex{\arg}
376 % \DoNotIndex{\begingroup, \bottomfraction}
377 % \DoNotIndex{\CodelineIndex, \columnsep, \csname}
378 % \DoNotIndex{\DisableCrossrefs, \DocInput, \documentstyle, \dp}
379 % \DoNotIndex{\empty, \EnableCrossrefs, \endcsname, \endgroup}
380 % \DoNotIndex{\evensidemargin, \exhyphenpenalty}
381 % \DoNotIndex{\framebox}
382 % \DoNotIndex{\headsep, \ht, \hyphenpenalty}
383 % \DoNotIndex{\ifmmode, \ifundefined, \it}
384 % \DoNotIndex{\leftarrow, \leftskip}
385 % \DoNotIndex{\makeatletter, \makeatother, \makebox, \marginparwidth}
386 % \DoNotIndex{\newbox}
387 % \DoNotIndex{\oddsidemargin, \OnlyDescription}
388 % \DoNotIndex{\parfillskip, \parindent, \parshape, \parskip, \pretolerance}
389 % \DoNotIndex{\raise, \RecordChanges}
390 % \DoNotIndex{\textheight, \textwidth, \tolerance, \topmargin, \typeout}
391 % \DoNotIndex{\vrule, \vtop}
392 % \DoNotIndex{\bf, \tt, \par, \smallskip, \stepcounter}
393 %
394 % \pFonts{\itshape}{}{} ^^A Variablen werden als italics ausgegeben
395 %
396 % \changes{v-9.2}{10/01/18}{changed some textual layout}
397 % \IndexPrologue{%
398 % \section*{Index}
399 % \ifnum\language=\languageNGerman
400 % Die kursiven Zahlen bezeichnen die Seite, auf der der jeweilige Eintrag
401 % beschrieben ist, unterstrichene Zahlen verweisen auf seine Definition;
402 % alle anderen Zahlen geben Stellen an, an denen der Eintrag auftritt.%
403 % \else%
404 % The italic numbers mark the page certain entries are described on.
405 % Underlined numbers refer to its definition. All other numbers declare
406 % positions, where the entry occurs.%
407 % \fi}
408 % ^^A \setlength{\IndexMin}{0.3\textheight}
409 %
410 % ^^A \iflanguage{}{} ist für große Textblöcke nicht nutzbar (stack
411 % ^^A overflow), daher durchgehend die Konstruktion
412 % ^^A \ifnum\language=\languageNGerman
413 % ^^A <deutscher Text>
414 % ^^A \else
415 % ^^A <englischer Text>
416 % ^^A \fi
417 %
418 % \GlossaryPrologue{\section*{\ifnum\language=\languageNGerman
419 % Revisionsgeschichte
420 % \else%
421 % History\fi}}
422 %
423 % \title{\StrukTeXSty\thanks{\ifnum\language=\languageNGerman%
424 % Diese Datei hat die Versionsnummer \fileversion, wurde zuletzt
425 % bearbeitet am \filedate, und die Dokumentation datiert vom
426 % \docdate.
427 % \else%
428 % This file has version number \fileversion, last revised on
429 % \filedate{}, documentation dated \docdate.
430 % \fi%
431 % }
432 % }
433 % \author{\ifnum\language=\languageNGerman%
434 % Jobst Hoffmann\\
435 % Fachhochschule Aachen, Abt. Jülich\\
436 % Ginsterweg 1\\
437 % 52428 Jülich\\
438 % Bundesrepublik Deutschland
439 % \else%
440 % Jobst Hoffmann\\
441 % University of Applied Sciences Aachen, Abt. Jülich\\
442 % Ginsterweg 1\\
443 % 52428 Jülich\\
444 % Federal Republic of Germany%
445 % \fi%
446 % }
447 % \date{\ifnum\language=\languageNGerman gedruckt am \else printed on \fi \today}
448 %
449 % ^^A\markboth{\ifnum\language=\languageNGerman \LaTeX\ Stil-Option struktex,
450 % ^^A Version \fileversion\ vom \filedate
451 % ^^A \else \LaTeX\ styleoption struktex,
452 % ^^A version \fileversion\ from \filedate
453 % ^^A \fi}
454 % ^^A {\ifnum\language=\languageNGerman \LaTeX\ Stil-Option struktex,
455 % ^^A Version \fileversion\ vom \filedate
456 % ^^A \else \LaTeX\ styleoption struktex,
457 % ^^A version \fileversion\ from \filedate
458 % ^^A \fi}
459 %
460 % \maketitle
461 %
462 % \ifnum\language=\languageNGerman
463 % \begin{abstract}
464 % Dieser Artikel beschreibt den Einsatz und die Implementation des
465 % \LaTeX-Paketes \StrukTeXSty{} zum Setzen von Struktogrammen
466 % nach Nassi-Shneiderman.
467 % \end{abstract}
468 % \else
469 % \begin{abstract}
470 % This article describes the use and implementation of the
471 % \LaTeX-\foreign{package} \StrukTeXSty{} for structured box charts
472 % (Nassi-Shneiderman diagrams).
473 % \end{abstract}
474 % \fi
475 %
476 % \newif\ifmulticols
477 % \IfFileExists{multicol.sty}{\multicolstrue}{}
478 %
479 % \ifmulticols
480 % \addtocontents{toc}{\protect\begin{multicols}{2}}
481 % \fi
482 %
483 % {\parskip 0pt ^^A We have to reset \parskip
484 % ^^A (bug in \LaTeX)
485 % \tableofcontents
486 % }
487 %
488 %
489 % \changes{v074}{10/06/08}{little corrections concerning the license}
490 % \section{\ifnum\language=\languageNGerman Lizenzvereinbarung\else
491 % License\fi}
492 %
493 % This package is copyright \copyright{} 1995 -- 2025 by:
494 % \begin{quote}
495 % Jobst Hoffmann,
496 % E-Mail: j.hoffmann\_(at)\_fh-aachen.de
497 % \end{quote}
498 % This program can be redistributed and/or modified under the terms of
499 % the LaTeX Project Public License, distributed from the CTAN archives
500 % as file \url{https://ctan.org/license/lppl1.3c}; either version 1 of
501 % the License, or (at your option) any later version.
502 %
503 %
504 % \section{\ifnum\language=\languageNGerman Vorwort\else Preface\fi}
505 %\label{sec:vorwort}
506 %
507 % \begin{quote}
508 % \sffamily\small%
509 % \ifnum\language=\languageNGerman%
510 % \StrukTeX{} hat eine lange Entwicklung hinter sich. Bei der
511 % Entwicklung wurden verschiedene Programme zur Versionsverwaltung --
512 % cvs, subversion und aktuell git -- eingesetzt, die alle
513 % unterschiedliche Möglichkeiten bieten, Versionsnummern zu
514 % definieren. Um diese unterschiedlichen Versionsnummern zeitlich
515 % zuordnen zu können, wird folgendes Schema verwendet: Versionnummern
516 % der Form "`v-\meta{d}.\meta{d}[\meta{a}]"' mit \meta{d} als
517 % Dezimalzahl und \meta{a} als Buchstabe, etwa v-4.1a bezeichnen die
518 % erste Entwicklungslinie (rcs). Die folgenden Versionnummern haben die
519 % Form "`v\meta{n}\meta{n}\meta{n}"' mit \meta{n} als Dezimalziffer,
520 % \zB{} v122 (subversion). Die aktuelle Entwicklung erfolgt unter git
521 % und benutzt Versionnummern der Form
522 % "`v\meta{d}.\meta{d}[\meta{a}][-\meta{d}]-g\meta{x}"', beispielsweise
523 % v2.1-13-gd28a927; \meta{x} ist dabei eine Hexadezimalzahl. Allgemein
524 % gilt für das Alter und somit die Reihenfolge der Versionen%
525 % \else%
526 % \StrukTeX{} has a long history. In development several different
527 % programs for version management were used---rcs, subversion and
528 % currently git---, all of which offer different possibilities to
529 % define version numbers. To correlate these different version numbers
530 % correctly in time, the following schema will be used: Version numbers
531 % of the form ``v-\meta{d}.\meta{d}[\meta{a}]'' with \meta{d} as a decimal
532 % digit and \meta{a} as a character, say v-4.1a denote the first
533 % development line (rcs). The following version numbers have the form
534 % ``v\meta{n}\meta{n}\meta{n}'' with \meta{n} as a decimal number,
535 % e.\,g. v122 (subversion). The current development is under git and
536 % uses version numbers of the form
537 % \meta{d}.\meta{d}[\meta{a}][\meta{d}]-g\meta{x}, for example,
538 % v2.1-13-gd28a927; \meta{x} stands for a hexadecimal number. In
539 % general, the age and therefore the sequence of the versions is%
540 % \fi
541 % \[
542 % \mbox{v-\meta{d}.\meta{d}[\meta{a}]} <
543 % \mbox{v\meta{n}\meta{n}\meta{n}} <
544 % \mbox{v\meta{d}.\meta{d}[\meta{a}][-\meta{d}]-g\meta{x}}
545 % \]
546 % \end{quote}
547 %
548 % \changes{v100}{10/06/25}{added remark about Struktorizer}
549 % \changes{v-8.0b}{04/07/14}{Hinweis auf \sFile{pict2e.sty}}
550 % \changes{v-8.0b}{04/07/14}{Entwicklungsgeschichte korrigiert und
551 % erweitert}
552 % \ifnum\language=\languageNGerman
553 % Mit dem hier beschriebenen Makropaket ist es möglich,
554 % Struktogramme mit \LaTeX{} zu zeichnen. Das Makropaket wird im folgenden
555 % immer \StrukTeX\ genannt. Es ist in der Lage, die wichtigsten Elemente
556 % eines Struktogrammes wie \zB\ Verarbeitungsblöcke, Schleifenkonstrukte,
557 % Sinnbilder für Alternativen usw.\ zu generieren. Die Struktogramme
558 % werden mit Hilfe der Picture-Umgebung von \LaTeX{} erzeugt.\footnote{%
559 % Wer es scheut, Struktogramme mittels \LaTeX{} direkt zu schreiben, kann
560 % beispielsweise unter \url{http://structorizer.fisch.lu/} ein Programm
561 % (Struktorizer) finden, mit dem man seine Struktogramme mittels Maus
562 % entwickeln und abschließend als \LaTeX-Code exportieren kann.} %
563 % \else%
564 % It is possible to draw structured box charts by this package of macros
565 % which is described herewith. Through this article the package will be
566 % always called \StrukTeX. It can generate the most important elements of a
567 % structured box chart like processing blocks, loops, mapping conventions
568 % for alternatives etc.\footnote{%
569 % Those who don't like to code the diagrams by hand, can use for example
570 % the program Struktorizer (\url{http://structorizer.fisch.lu/}). By using
571 % this program one can draw the diagrams by mouse and export the result
572 % into a \LaTeX-file.} %
573 % \fi%
574 %
575 % \ifnum\language=\languageNGerman%
576 % Ab Version v-4.1a werden die mathematischen Symbole von \AmSTeX{} geladen,
577 % die den mathematischen Zeichensatz erweitern und andere Darstellungen von
578 % Mengensymbolen (etwa \(\nat\), \(\integer\) und
579 % \(\real\) für die natürlichen, ganzen und reellen Zahlen) ermöglichen.
580 % Insbesondere das Zeichen für die leere Menge
581 % ($\emptyset$) ist in der Darstellung auffälliger als das
582 % standardmäßige Zeichen
583 % ("`\(\mathchar"023B\)"') und somit besser für die Darstellung von
584 % Struktogrammen geeignet. Die Dokumentation der Zeichen und weiterer
585 % Kommandos findet sich in \ref{sec:spez-zeichen}%
586 % \else%
587 % Since version v-4.1a the mathematical symbols are loaded by \AmSTeX. They
588 % extend the mathematical character set and make other representations of
589 % symbols sets (like \(\nat\), \(\integer\) and \(\real\) for the
590 % natural, the integer and the real numbers) possible. specially the
591 % symbol for the empty set (\(\emptyset\)) has a more outstanding
592 % representation than the standard symbol
593 % (``\(\mathchar"023B\)''). Therefore it is the better representation
594 % in structured box charts.%
595 % \fi
596 %
597 % \ifnum\language=\languageNGerman
598 % Weiterhin ist aus dem \sFile{oz.sty} die Idee übernommen,
599 % Variablennamen in \foreign{italics} zu setzen, ohne dass die teilweise
600 % unschönen Zwischenräume erzeugt werden.
601 % \else%
602 % Furthermore the idea to set names of variables in \foreign{italics}
603 % without generating the partly unpleasant distances is taken over from
604 % \sFile{oz.sty}.
605 % \fi%
606 %
607 % \ifnum\language=\languageNGerman%
608 % Die Entwicklung dieses Makropaketes ist noch nicht abgeschlossen.
609 % Es war geplant, die Struktogramme unter dem Einsatz des Makros aus
610 % \sFile{emlines2.sty} zu zeichnen, um die durch \LaTeX{} gegebenen
611 % Einschränkungen -- es gibt nur vordefinierte Steigungen --
612 % aufzuheben. Dies ist -- für das \cs{ifthenelse} mit den
613 % Versionen v-4.1a und v-4.1b, für das \cs{switch} mit der Version v-4.2a --
614 % erledigt, nicht jedoch für Systeme, die die
615 % entsprechenden |\special{|\dots|}|-Befehle nicht unterstützen.
616 % Erreicht werden kann dies jedoch durch Einsatz entsprechender Makros
617 % aus dem \sFile{curves.sty}. Seit der Version v-8.0a wird das Paket
618 % \sFile{pict2e.sty} unterstützt, das mittels der üblichen Treiber die von
619 % der |picture|-Umgebung bekannten Beschränkungen auf nur wenige Steigungen
620 % im wesentlichen aufhebt, so dass sich die Benutzung der entsprechenden
621 % Option (s.u.) dauerhaft empfiehlt.
622 % \else%
623 % The development of this macro package is still not finished.
624 % It was planned to draw the structured box charts by using the macros of
625 % \sFile{emlines2.sty} for eliminating the constraints given by
626 % \LaTeX---there are only predefined slopes. This is done for the
627 % \cs{ifthenelse} in the versions v-4.1a and v-4.1b and for \cs{switch} in
628 % the version v-4.2a, but not for the systems, which do not support the
629 % corresponding |\special{|\dots|}|-commands. Nevertheless it can be
630 % attained by using the corresponding macros of \sFile{curves.sty}. Since
631 % version v-8.0a the package \sFile{pict2e} is supported. This package
632 % eliminates the above mentioned constraints by using the common drivers,
633 % so it is recommended to use the respective (see below) option permanently.%
634 % \fi%
635 %
636 % \ifnum\language=\languageNGerman%
637 % Ebenso ist es geplant, Struktogramme um Kommentarblöcke zu erweitern,
638 % wie sie in dem Buch von Futschek (\cite{Futschek:Programmentwicklung})
639 % eingesetzt werden. Dieses ist ebenfalls mit der Version v-8.0a realisiert
640 % worden.%
641 % \else%
642 % Just so it is planned to extend structured box charts by comments as they
643 % are used in the book of Futschek
644 % (\cite{Futschek:Programmentwicklung}). This is also implemented in
645 % version v-8.0a.%
646 % \fi
647 %
648 % \ifnum\language=\languageNGerman
649 % Weitere Zukunftspläne sind:
650 % \else%
651 % Further plans for future are:%
652 % \fi%
653 %
654 % \begin{enumerate}
655 % \item \ifnum\language=\languageNGerman%
656 % Ein \cs{otherwise}-Zweig beim \cs{switch} (abgeschlossen durch die
657 % Version v-4.2a).%
658 % \else%
659 % An \cs{otherwise}-branch at \cs{switch} (done in version v-4.2a).%
660 % \fi%
661 %
662 % \item \ifnum\language=\languageNGerman%
663 % Die Neuimplementation der |declaration|-Umgebung mittels der
664 % |list|-Umgebung gemäß
665 % \cite[Abs. 3.3.4]{GoossensMittelbachSamarin:Companion} (abgeschlossen
666 % mit der Version v-4.5a).%
667 % \else%
668 % The reimplementation of the |declaration|-environment through the
669 % |list|-environment by
670 % \cite[Abs. 3.3.4]{GoossensMittelbachSamarin:Companion} (done in
671 % version v-4.5a).%
672 % \fi%
673 %
674 % \item \ifnum\language=\languageNGerman%
675 % Die Anpassung an \LaTeXe\ im Sinne eines Packages (abgeschlossen
676 % durch die Version v-4.0a).%
677 % \else%
678 % The adaption to \LaTeXe\ in the sense of packages (done in version
679 % v-4.0a).%
680 % \fi%
681 %
682 % \item \ifnum\language=\languageNGerman%
683 % Die Verbesserung der Dokumentation, um Teile des Algorithmus
684 % verständlicher zu machen.
685 % \else%
686 % The improvement of documentation in order to make parts of the
687 % algorithm more understandable.%
688 % \fi%
689 %
690 % \item \ifnum\language=\languageNGerman%
691 % Die Unabhängigkeit des \StrukTeXSty{} von anderen
692 % \sFile{.sty}-Dateien wie etwa dem \sFile{JHfMakro.sty}
693 % (abgeschlossen mit der Version v-4.5a).%
694 % \else%
695 % The independence of \StrukTeXSty{} of other \sFile{.sty}-files like
696 % e.g. \sFile{JHfMakro.sty} (done in version v-4.5a).%
697 % \fi%
698 %
699 % \item \ifnum\language=\languageNGerman%
700 % \changes{v-4.5a}{96/03/14}{Umbenennungen: `sVar $\rightarrow$ `pVar, \ldots}%
701 % \changes{v-4.3a}{96/01/26}{Variable `sBoolValue ersetzt `sLVal}
702 % Die vollständige Implementation der Makros \cs{pVar}, \cs{pKey},
703 % \cs{pFonts}, \cs{pTrue}, \cs{pFalse} und \cs{pBoolValue} (erledigt
704 % vor Version v-7.0).%
705 % \else%
706 % \changes{v-4.5a}{96/03/14}{redesignation: `sVar $\rightarrow$ `pVar,
707 % \ldots}
708 % \changes{v-4.3a}{96/01/26}{variable `sBoolValue replaces `sLVal}%
709 % The complete implementation of the macros \cs{pVar}, \cs{pKey},
710 % \cs{pFonts}, \cs{pTrue}, \cs{pFalse} and \cs{pBoolValue} (done before
711 % version v-7.0).%
712 % \fi%
713 %
714 % \item \ifnum\language=\languageNGerman%
715 % \changes{v-4.4a}{96/02/29}{Kommando `ifthenelse internalisiert}%
716 % Die vollständige Internalisierung von Kommandos, die nur in der
717 % Umgebung |struktogramm| Sinn machen. Internalisierung bedeutet, dass
718 % diese Kommandos nur innerhalb der Umgebung definiert sind. Dies hat
719 % den Zweck, das Paket mit anderen Paketen verträglicher zu gestalten,
720 % etwa mit dem \sFile{ifthenelse.sty}. Begonnen wurde die
721 % Internalisierung mit der Version v-4.4a.
722 % \else%
723 % \changes{v-4.4a}{96/02/29}{command `ifthenelse internalisated}%
724 % The complete internalization of commands, which only make sense in
725 % the environment |struktogramm|. Internalization means, that these
726 % commands are only defined in this environment. This is for
727 % compatibility of this package with other packages, e.g. with
728 % \sFile{ifthenelse.sty}. The internalization has been started in
729 % version v-4.4a.
730 % \fi%
731 %
732 % \item \ifnum\language=\languageNGerman%
733 % Die Unabhängigkeit der Dokumentation von anderen
734 % \sFile{.sty}-Dateien wie etwa dem \sFile{JHfMakro.sty}
735 % (abgeschlossen mit der Version v-5.0).%
736 % \else%
737 % The independence of the documentation of other \sFile{.sty}-files
738 % like \sFile{JHfMakro.sty} (done in version v-5.0).%
739 % \fi%
740 %
741 % \item \ifnum\language=\languageNGerman%
742 % Eine alternative Darstellung der Deklarationen, wie sie von Rico Bolz
743 % vorgeschlagen wurde%
744 % \else%
745 % an alternative representation of declarations as proposed by Rico
746 % Bolz%
747 % \fi%
748 %
749 % \item \ifnum\language=\languageNGerman%
750 % Wiedereinführung der |make|-Ziele |dist-src| |dist-tar| und
751 % |dist-zip|.%
752 % \else%
753 % Reintroduction of the |make|-targets |dist-src| |dist-tar| and
754 % |dist-zip|.%
755 % \fi%
756 %
757 % \end{enumerate}
758 %
759 % \ifnum\language=\languageNGerman%
760 % Der derzeitige Stand der Implementierung ist an entsprechender Stelle
761 % vermerkt.
762 % \else%
763 % The current state of the implementation is noted at suitable points.%
764 % \fi%
765 %
766 %
767 % \section{\ifnum\language=\languageNGerman%
768 % Hinweise zur Pflege und Installation dieser Dokumentation%
769 % \else%
770 % Hints for maintenance and installation
771 % of this documentation%
772 % \fi}
773 %
774 % \ifnum\language=\languageNGerman%
775 % \changes{v3.0}{25/06/19}{rewrote text about installation using l3build}
776 % \changes{v-4.5e}{97/04/26}{Neue .sty-Datei strukdoc.sty eingeführt}
777 % \changes{v-1.5}{92/01/07}{StrukTeX Makros nun als .sty-Datei, J. Hoffmann}
778 % \changes{v-2.0}{92/01/17}{Erweitert um `exit, `forever und `foreverend, D. Rieger}
779 % \changes{v-2.1}{92/01/07}{`exit modifiziert, J. Hoffmann}
780 % \changes{v-2.2}{93/09/08}{Beschreibung von Variablen eingeführt, J. Hoffmann}
781 % \changes{v-2.2a}{93/09/09}{Beschreibung von Variablen verbessert, J. Hoffmann}
782 % \else%
783 % \changes{v-4.5e}{97/04/26}{new .sty-File strukdoc.sty introduced}
784 % \changes{v-1.5}{92/01/07}{StrukTeX macros now as .sty-File, J. Hoffmann}
785 % \changes{v-2.0}{92/01/17}{extended by `exit, `forever and `foreverend, D. Rieger}
786 % \changes{v-2.1}{92/01/07}{`exit modified, J. Hoffmann}
787 % \changes{v-2.2}{93/09/08}{description of variables introduced, J. Hoffmann}
788 % \changes{v-2.2a}{93/09/09}{description of variables improved, J. Hoffmann}%
789 % \fi%
790 %
791 % \ifnum\language=\languageNGerman%
792 % Das Paket, zu dem der \StrukTeXSty{} gehört, besteht aus
793 % insgesamt fünf Dateien:
794 % \begin{quote}
795 % \texttt{LIESMICH.md}, \\
796 % \texttt{README.md}, \\
797 % \texttt{struktex.dtx}, \\
798 % \texttt{struktex.de.pdf} und \\
799 % \texttt{struktex.en.pdf}.
800 % \end{quote}
801 % Um daraus einerseits die Dokumentation, andererseits die \sFile{.sty}-Datei
802 % zu erzeugen, muss folgendermaßen vorgegangen werden:
803 % \else%
804 % The package \StrukTeXSty{} is belonging to consists of altogether five files:
805 % \begin{quote}
806 % \texttt{LIESMICH.md}, \\
807 % \texttt{README.md}, \\
808 % \texttt{struktex.dtx}, \\
809 % \texttt{struktex.de.pdf} und \\
810 % \texttt{struktex.en.pdf}.
811 % \end{quote}
812 % In order to generate on the one hand the documentation and on the other hand the
813 % \sFile{.sty}-file one has to proceed as follows:%
814 % \fi%
815 %
816 % \changes{v3.0a}{25/06/20}{corrected last(?) glitches}
817 % \changes{v2.4}{20/01/28}{corrected number of examples}
818 % \ifnum\language=\languageNGerman%
819 % Zunächst wird mit \zB\
820 % \begin{quote}\tt
821 % pdftex struktex.dtx
822 % \end{quote}
823 % die Datei \sFile{struktex.dtx} formatiert.
824 %
825 % Dieser Formatierungslauf erzeugt einige weitere Dateien. Dies sind zunächst
826 % alle drei \sFile{.sty}-Dateien \sFile{struktex.sty},
827 % \sFile{struktxf.sty} und \sFile{struktxp.sty}, die beiden letzteren werden von
828 % \StrukTeXSty{} verwendet. Weiterhin sind dies die beiden Dateien
829 % \sFile{struktex-tst-00.nss} und \sFile{strukdoc.sty}, die
830 % für die Erstellung der hier vorgestellten Dokumentation verwendet werden. Dann gibt es
831 % fünf Testdateien \sFile{struktex-test-\textit{i}.tex}, \(i=1(1)3\),
832 % \sFile{struktxf.tex} und \sFile{struktxf.tex} zum Testen der
833 % entsprechenden \textsf{. sty}-Dateien und nicht zuletzt zwei
834 % Skriptdateien \sFile{lbuild.lua} und \sFile{lbuild-config.lua} (siehe
835 % \cref{sec:lbuild_lua}).
836 %
837 % Die Dokumentation wird gemäß \textsf{l3build} mit dem Befehl
838 % \begin{quote}\tt
839 % l3build doc
840 % \end{quote}
841 % erzeugt.
842 %
843 % Das Ergebnis dieses Formatierlaufes ist die
844 % Dokumentation in Form einer \sFile{.pdf}-Datei, die in gewohnter Weise
845 % weiterbearbeitet werden kann. Weitere Informationen zum Arbeiten mit der
846 % integrierten Dokumentation findet man in
847 % \cite{FM:TheDocAndShortvrbPackages-V-2.0} und
848 % \cite{MittelbachDuchierBraams:DocStrip-V-2.5b}.%
849 % \else%
850 % First the file \sFile{struktex.dtx} will be formatted e.g.\ with
851 % \begin{quote}\tt
852 % pdftex struktex.dtx
853 % \end{quote}
854 %
855 % This formatting run creates a few more files. These are first of
856 % all the three \sFile{.sty}-files \sFile{struktex.sty},
857 % \sFile{struktxf.sty} and \sFile{struktxp.sty}, the latter two are used by
858 % \StrukTeXSty. Furthermore these are the two files
859 % \sFile{struktex-tst-00.nss} and \sFile{strukdoc.sty}, which are used
860 % for the generation of the hereby presented documentation. Then there are
861 % five test files \sFile{struktex-test-\textit{i}.tex}, \(i=1(1)3\),
862 % \sFile{struktxf.tex}, and \sFile{struktxf.tex} for testing the
863 % corresponding \textsf{.sty}-files and last, but not least two script
864 % files \sFile{lbuild.lua} and \sFile{lbuild-config.lua} (see
865 % \cref{sec:lbuild_lua}).
866 %
867 % The documentation is generated according to \textsf{l3build} with the command
868 % \begin{quote}\tt
869 % l3build doc
870 % \end{quote}
871 %
872 % The result of this formatting run is the documentation in form of a
873 % \sFile{.pdf}-file, that can be manipulated the normal way. Further
874 % informations about the work with the integrated documentation one can
875 % find in \cite{FM:TheDocAndShortvrbPackages-V-2.0} and
876 % \cite{MittelbachDuchierBraams:DocStrip-V-2.5b}.%
877 % \fi
878 %
879 % \changes{v100}{10/06/25}{corrected some inconsistencies in the
880 % description of the installation process}
881 % \ifnum\language=\languageNGerman%
882 % Die Installation wird abgeschlossen, indem die Datei
883 % \texttt{struktex.sty} in ein Verzeichnis verschoben wird, das von \TeX{}
884 % gefunden werden kann, das ist in einer TDS-konformen Installation
885 % typischerweise \texttt{.../tex/latex/struktex/}, die Dokumentation wird
886 % analog in das Verzeichnis \texttt{.../doc/latex/struktex/}
887 % verschoben.\footnote{Wenn die automatische Installation (vgl. Abschnitt
888 % \ref{sec:lbuild_lua}) vorgenommen wird, erfolgt diese entsprechend.} %
889 % \else%
890 % To finish the installation, the file \texttt{struktex.sty} should be
891 % moved to a directory, where \TeX{} can find it, in a TDS conforming
892 % installation this is \texttt{.../tex/latex/struktex/} typical,
893 % analogously the documentation has to be moved to
894 % \texttt{.../doc/latex/struktex/}. If the installation process is done
895 % automatically (see section \ref{sec:lbuild_lua}), the target directories
896 % follow that rule. %
897 % \fi
898 %
899 % \ifnum\language=\languageNGerman%
900 % Sollen Änderungen durchgeführt werden, so sollten neben diesen
901 % die Werte von \cs{fileversion}, \cs{filedate} und \cs{docdate} bei Bedarf
902 % entsprechend geändert werden. Weiterhin sollte darauf geachtet werden,
903 % dass die Revisionsgeschichte durch Einträge von
904 % \begin{quote}
905 % |\changes{|\meta{Version}|}{|\meta{Datum}|}{|\meta{Kommentar}|}|
906 % \end{quote}
907 % weitergeschrieben wird.
908 % \meta{Version} gibt die Versionsnummer an, unter der die jeweilige
909 % Änderung durchgeführt wurde,
910 % \meta{Datum} gibt das Datum in der Form |yy/mm/dd| an und
911 % \meta{Kommentar} erläutert die jeweilige Änderung.
912 % \meta{Kommentar} darf nicht mehr als 64 Zeichen enthalten.
913 % Daher sollten Kommandos nicht mit dem "`$\backslash$"'
914 % (\foreign{backslash}) eingeleitet werden, sondern mit dem "``"'
915 % (\foreign{accent}).
916 % \else%
917 % If one wants to carry out changes, the values of \cs{fileversion}, \cs{filedate}
918 % and \cs{docdate} should be also changed if needed. Furthermore one should
919 % take care that the audit report will be carried on by items in the form of
920 % \begin{quote}
921 % |\changes{|\meta{version}|}{|\meta{date}|}{|\meta{comment}|}|
922 % \end{quote}
923 % The version number of the particular change is given by \meta{version}.
924 % The date is given by \meta{date} and has the form |yy/mm/dd|.
925 % \meta{comment} describes the particular change. It need not contain more
926 % than 64 characters. Therefore commands shouldn't begin with
927 % ``\texttt{\textbackslash}'' (\foreign{backslash}), but with the
928 % ``\texttt{`}'' (\foreign{accent}).% \fi%
929 %
930 % \changes{v2.1b}{17/06/17}{better wording: leftright $\rightarrow$ outer}
931 % \changes{v-8.0b}{04/07/14}{Umstellung der Sprachverwaltung auf babel}
932 % \ifnum\language=\languageNGerman%
933 % Die nächsten Anweisungen bilden den Treiber für die hier vorliegende
934 % Dokumentation.
935 % \else%
936 % The following commands make up the driver of the documentation lieing before.%
937 % \fi%
938 % \changes{v130}{10/09/21}{set additional option for (internally loaded)
939 % package url to obey spaces}
940 % \changes{v-9.2}{10/01/18}{changed the selection of languages}
941 % {%
942 % \def\listinglabel#1{\llap{\footnotesize\rmfamily\the#1}%
943 % \hskip\listingoffset\relax}
944 % \footnotesize\listinginput{1}{struktex.drv}
945 % }
946 %
947 %
948 % \section{\ifnum\language=\languageNGerman Die Benutzungsschnittstelle
949 % \else The User interface
950 % \fi}
951 % \changes{v2.4}{20/01/28}{unified `label/`ref arguments}
952 % \label{sec:interface}
953 % \changes{v-4.3a}{96/01/26}{Dokumentation verbessert und korrigiert}
954 % \ifnum\language=\languageNGerman%
955 % Der \StrukTeXSty{} wird wie jede andere |.sty|-Datei als \foreign{package} in
956 % ein \LaTeX-Dokument eingebunden:
957 % \begin{quote}
958 % |\usepackage[|\meta{Optionen}|]{struktex}|
959 % \end{quote}
960 % \else%
961 % The \StrukTeXSty{} will be included in a \LaTeX-document like every other
962 % |.sty|-file by \foreign{package}:
963 % \begin{quote}
964 % |\usepackage[|\meta{options}|]{struktex}|
965 % \end{quote}%
966 % \fi%
967 %
968 % \changes{v2.0c}{17/06/06}{added description of debug and leftright option}
969 % \changes{v141}{12/04/10}{added description of default values}
970 % \changes{v141}{12/04/10}{added description of language option}
971 % \ifnum\language=\languageNGerman%
972 % Die folgenden Optionen stehen zur Verfügung:
973 % \begin{enumerate}
974 % \item |english|, |ngerman| oder |german|:
975 %
976 % Die jeweilige Option legt die Sprache für definierte Werte wie
977 % |\sTrue| fest, Standardwert ist |english|.
978 % \item |emlines|, |curves| oder |pict2e|:
979 %
980 % Durch Angabe einer der drei Optionen ist es möglich, beliebige
981 % Steigungen in Struktogrammen zu zeichnen. Erstere Option ist
982 % sinnvoll, wenn mit dem em\TeX-Paket von Eberhard Mattes gearbeitet
983 % wird (DOS oder OS/2), ansonsten wird der Einsatz von |pict2e|
984 % empfohlen. Der Einsatz des Paketes \sFile{curves.sty} (Ian
985 % Maclaine-cross), das das Zeichnen von Geraden beliebiger Steigungen
986 % durch das Setzen vieler einzelner Punkte ermöglicht, ist durch das
987 % Erscheinen des Paketes \sFile{pict2e.sty} (Hubert Gäßlein und Rolf
988 % Niepraschk) im Prinzip obsolet, aus Kompatibilitätsgründen wird er
989 % weiter unterstützt. Durch die Angabe einer der genannten Option wird
990 % das jeweilige Paket (\sFile{emlines2.sty}, \sFile{curves.sty} bzw.
991 % \sFile{pict2e.sty}) automatisch geladen, Standardwert ist |pict2e|.
992 % \item |verification|:
993 %
994 % Nur wenn diese Option gesetzt ist, steht \cs{assert} als Kommando zur
995 % Verfügung.
996 % \item |nofiller|:
997 %
998 % Setzen dieser Option lässt jeden Freiraum leer. Ansonsten wird
999 % Freiraum in Alternativen als \(\emptyset\) markiert.
1000 % \item |draft|, |final|:
1001 %
1002 % Diese Optionen dienen in üblicher Weise dazu, den Entwurf
1003 % beziehungsweise die endgültige Fassung zu kennzeichnen (vgl.
1004 % |\sProofOn|/|\sProofOff|). Im Entwurfsmodus werden die vier Eckpunkte
1005 % eines Struktogramms in der vom Benutzer vorgegebenen Größe
1006 % ausgegeben, diese Markierung fällt in der endgültigen Fassung
1007 % weg. Der Standardwert ist |final|.
1008 % \item |debug|:
1009 %
1010 % Mit dem Setzen dieser Option werden Zeilen der Form
1011 % \begin{quote}
1012 % |===> dbg |\meta{Text}
1013 % \end{quote}
1014 % in die .log-Datei geschrieben.
1015 % \item |outer|:
1016 %
1017 % Das Setzen dieser Option führt dazu, die ja/nein Flaggen statt auf
1018 % der Mitte der Grundlinie jeweils links bzw. rechts außen erscheinen
1019 % zu lassen.
1020 % \end{enumerate}
1021 % Nach dem Laden der |.sty|-Datei stehen verschiedene Kommandos und Umgebungen
1022 % zur Verfügung, die das Zeichnen der Struktogramme ermöglichen.%
1023 % \else%
1024 % The following options are available:
1025 % \begin{enumerate}
1026 % \item |english|, |ngerman| oder |german|:
1027 %
1028 % This option defines the language of defined values as |\sTrue|,
1029 % default: |english|.
1030 % \item |emlines|, |curves|, or |pict2e|:
1031 %
1032 % If you set one of these options, any slope can be drawn in the
1033 % structured box chart. You should use |emlines|, if you are working
1034 % with the em\TeX-package for DOS or OS/2 by E. Mattes, else you should
1035 % use |pict2e|; |curves| is included just for compatibility. In all
1036 % cases the required packages (\sFile{emline2.sty},
1037 % \sFile{curves.sty}, or \sFile{pict2e} resp.) will be loaded
1038 % automatically; the default value is |pict2e|.
1039 % \item |verification|:
1040 %
1041 % Only if this option is set, the command \cs{assert} is available.
1042 % \item |nofiller|:
1043 %
1044 % Setting this option prohibits setting of \(\emptyset\) in alternatives.
1045 % \item |draft|, |final|:
1046 %
1047 % These options serve as usual to diffentiate between the draft and the
1048 % final version of a structured box chart (see |\sProofOn|). While in
1049 % the draft mode the user given size of the chart is denoted by the
1050 % four bullets, the final version leaves out these markers; the default
1051 % value is |final|.
1052 % \item |debug|:
1053 %
1054 % Setting this option produces lines of the form %
1055 % |===> dbg |\meta{text} in the .log-file.
1056 % \item |outer|:
1057 %
1058 % Setting this option changes the position of flags in the
1059 % |ifthenelse|-triangles from the mid to the left and right of the
1060 % baselines of the triangles.
1061 % \end{enumerate}
1062 % After loading the |.sty|-file there are different commands and environments,
1063 % which enable the draw of structured box charts.%
1064 % \fi%
1065 %
1066 % \DescribeMacro{\StrukTeX}
1067 % \ifnum\language=\languageNGerman%
1068 % Zunächst sei der Befehl erwähnt, der das Logo \StrukTeX\ erzeugt:
1069 % \else%
1070 % First of all the logo \StrukTeX\ producing command should be mentioned:%
1071 % \fi%
1072 % \begin{quote}
1073 % \verb-\StrukTeX-
1074 % \end{quote}
1075 %
1076 % \ifnum\language=\languageNGerman%
1077 % Damit kann in Dokumentationen auf die hier vorliegende Stil-Option
1078 % verwiesen werden.
1079 % \else%
1080 % So in documentations one can refer to the style option given hereby.%
1081 % \fi%
1082 %
1083 %
1084 % \subsection{\ifnum\language=\languageNGerman Die Makros zur Erzeugung von Struktogrammen
1085 % \else The macros for generating structured box charts
1086 % \fi}
1087 %
1088 % \DescribeEnv{struktogramm}
1089 % \DescribeMacro{\sProofOn}
1090 % \DescribeMacro{\sProofOff}
1091 % \DescribeMacro{\PositionNSS}
1092 % \ifnum\language=\languageNGerman%
1093 % Die Umgebung
1094 % \begin{quote}\obeylines
1095 % \envb{struktogramm}\pparg{Breite}{Höhe}\oarg{Überschrift}
1096 % \dots
1097 % \enve{struktogramm}
1098 % \end{quote}
1099 % erzeugt Raum für ein
1100 % neues Struktogramm. Die beiden Parameter
1101 % legen die Breite und die Höhe des Platzes fest, der für das Struktogramm
1102 % reserviert wird. Die Angaben werden in Millimetern gemacht, wobei der
1103 % aktuelle Wert von \cs{unitlength} keine Rolle spielt.
1104 % Dabei entspricht die Breite der tatsächlichen Breite,
1105 % die tatsächliche Höhe wird den Erfordernissen angepasst. Stimmt die
1106 % angegebene Höhe nicht mit den tatsächlichen Erfordernissen überein,
1107 % läuft das Struktogramm in den umgebenden Text hinein oder es bleibt
1108 % Raum frei. Es gibt einen Schalter \cs{sProofOn}, mit dem die angegebene
1109 % Größe des Struktogramms durch vier Punkte gezeigt wird, um Korrekturen
1110 % einfacher durchführen zu können. \cs{sProofOff} schaltet diese Hilfe
1111 % entsprechend wieder ab.
1112 % Die Überschrift dient zur Identifizierung des Struktogramms,
1113 % wenn man sich von anderer Stelle, etwa aus einem anderen Struktogramm
1114 % heraus auf dieses hier beziehen will.
1115 % \else%
1116 % The environment
1117 % \begin{quote}\obeylines
1118 % |\begin{struktogramm}(|\meta{width}|,|\meta{height}|)|\oarg{titel}
1119 % \dots
1120 % |\end{struktogramm}|
1121 % \end{quote}
1122 % generates space for a new box chart. Both the parameters provide the width
1123 % and the height of the place, which is reservated for the structured box chart.
1124 % Lengths etc. are described in millimeters. In doing so the actual
1125 % value of \cs{unitlength} is unimportand.
1126 % At the same time the width corresponds with the real width and the
1127 % real height will be adjusted to the demands. If the given height does'nt match
1128 % with the real demands, the structured box chart reaches into the surrounding
1129 % text or there is empty space respectively. There is a switch \cs{sProofOn},
1130 % with which the stated dimensions of the structured box charts is given by
1131 % four points to make corrections easier. \cs{sProofOff} similarly switches this help
1132 % off.
1133 % The title is for identification of structured box charts, if one wants to refer
1134 % to this from another part, e.g. from a second box chart.%
1135 % \fi%
1136 %
1137 % \ifnum\language=\languageNGerman%
1138 % Die Struktogramm-Umgebung basiert auf der |picture|-Umgebung von
1139 % \LaTeX.
1140 % Die in der |picture|-Umgebung
1141 % gebräuchliche Längeneinheit \cs{unitlength} wird bei den Struktogrammen
1142 % nicht benutzt; die Längeneinheit ist aus technischen Gründen auf $1\, mm$
1143 % festgelegt. Weiterhin müssen alle Längenangaben ganzzahlige Werte sein.
1144 % \cs{unitlength} hat zwar nach dem Zeichnen eines Struktogrammes mit
1145 % \StrukTeX\ den gleichen Wert wie vorher, ist aber innerhalb eines
1146 % Struktogrammes umdefiniert und darf dort auch nicht geändert werden.
1147 % \else%
1148 % The structured box chart environment is based on the |picture| environment of
1149 % \LaTeX.
1150 % The unit of length \cs{unitlength}, which is often used in the |picture| environment,
1151 % is not used in structured box charts. The unit of length is fixed by
1152 % $1\, mm$ for technical reasons. Furthermore all of length specifications have to
1153 % be whole numbers. After drawing a structured box chart by \StrukTeX\
1154 % \cs{unitlength} is of the same quantity as before. But it is redefined within a
1155 % structured box chart and need not be changed there.%
1156 % \fi%
1157 %
1158 % \DescribeMacro{\assign}
1159 % \ifnum\language=\languageNGerman%
1160 % Das Hauptelement eines Struktogramms ist ein Kasten, in dem eine Operation
1161 % beschrieben wird. Ein solcher Kasten wird mit \cs{assign} erzeugt. Die
1162 % Syntax ist
1163 % \begin{quote}
1164 % \cs{assign}\oarg{Höhe}\marg{Inhalt},
1165 % \end{quote}
1166 % wobei die eckigen Klammern wie üblich ein optionales Argument
1167 % bezeichnen. Die Breite und die Höhe des Kastens werden den
1168 % Erfordernissen gemäß automatisch angepasst, man kann aber mittels des
1169 % optionalen Argumentes die Höhe des Kastens vorgeben.%
1170 % \else%
1171 % The main element of a structured box chart is a box, in which an
1172 % operation is described. Such a box will be assigned by \cs{assign}. The
1173 % syntax is the following:
1174 % \begin{quote}
1175 % \cs{assign}\oarg{height}\marg{content},
1176 % \end{quote}
1177 % where the square brackets name an optional element as usual. The width
1178 % and the height of the box will be adjusted automatically according to
1179 % demands. But one can predefine the height of the box by the optional
1180 % argument.%
1181 % \fi
1182 %
1183 % \ifnum\language=\languageNGerman%
1184 % Der \textit{Text} wird normalerweise linksbündig in den
1185 % Kasten gesetzt; ist er dafür zu lang, so wird ein Paragraph (im
1186 % Blocksatz) gesetzt.
1187 % \else%
1188 % The \textit{text} is normally set centered in the box. If the text is too
1189 % long for that, then a (justified) paragraph is set.%
1190 % \fi%
1191 %
1192 % \ifnum\language=\languageNGerman%
1193 % \begin{tExample}
1194 % Ein einfaches Struktogramm wird mit den folgenden Anweisungen erzeugt:
1195 % \begin{verbatimwrite}{struktex.tmp}
1196 % \sProofOn
1197 % \begin{struktogramm}(70,12)[1.\ Versuch]
1198 % \assign{Quadratwurzel von \(\pi\) berechnen und ausgeben}
1199 % \end{struktogramm}
1200 % \sProofOff
1201 % \end{verbatimwrite}
1202 % \begin{quote}
1203 % \verbatiminput{struktex.tmp}
1204 % \end{quote}
1205 % Diese Anweisungen führen zu folgendem Struktogramm, wobei der Anwender
1206 % wie auch bei der zugrundeliegenden |picture|-Umgebung für eine geeignete
1207 % Positionierung zu sorgen hat. Die Positionierung erfolgt in dieser
1208 % Dokumentation im Regelfall mit der |quote|-Umgebung, man kann ein
1209 % Struktogramm aber auch mit der |center|-Umgebung zentrieren.
1210 % Die Breite des Struktogramms ist mit 70mm vorgegeben, die Höhe mit 12mm.
1211 % Eine Alternative ist durch die |centernss|-Umgebung gegeben,
1212 % die auf Seite \pageref{sec:centernss} beschrieben wird.
1213 % \else%
1214 % \begin{tExample}
1215 % A simple structured box chart will be generated by the following instructions:
1216 % \begin{verbatimwrite}{struktex.tmp}
1217 % \sProofOn
1218 % \begin{struktogramm}(70,20)[1.\ trial]
1219 % \assign{Calculate and output square root of \(\pi\)}
1220 % \end{struktogramm}
1221 % \sProofOff
1222 % \end{verbatimwrite}
1223 % \begin{quote}
1224 % \verbatiminput{struktex.tmp}
1225 % \end{quote}
1226 % These instructions lead to the following box chart, at which the user has to
1227 % provide an appropriate positioning like in the basing \cs{picture} environment.
1228 % Herewith the positioning is normally done by the |quote| environment. But one can
1229 % also center the structured box chart by the |center| environment.
1230 % The width of the box chart is given by 70mm, the height by 12mm. An alternative
1231 % is given by the |centernss| environment, that is described on page
1232 % \pageref{sec:centernss}%
1233 % \fi%
1234 %
1235 % \ifnum\language=\languageNGerman%
1236 % Gleichzeitig wird die Wirkung von \cs{sProofOn} und \cs{sProffOff} gezeigt,
1237 % wobei die zu große vorgegebene Größe des Struktogrammes zu beachten ist.
1238 % \else%
1239 % At the same time the effect of \cs{sProofOn} and \cs{sProofOff} is shown,
1240 % at which the too large size of structured box chart has to be taken notice of.%
1241 % \fi%
1242 % \begin{quote}
1243 % \input{struktex.tmp}
1244 % \end{quote}
1245 % \end{tExample}
1246 %
1247 % \ifnum\language=\languageNGerman%
1248 % Die Bedeutung des optionalen Argumentes macht das folgende Beispiel deutlich.
1249 % \begin{tExample}
1250 % Die Höhe des Kastens wird vorgegeben:
1251 % \begin{verbatimwrite}{struktex.tmp}
1252 % \begin{center}
1253 % \begin{struktogramm}(70,20)
1254 % \assign[20]{Quadratwurzel von \(\pi\) berechnen und ausgeben}
1255 % \end{struktogramm}
1256 % \end{center}
1257 % \end{verbatimwrite}
1258 % \begin{quote}
1259 % \verbatiminput{struktex.tmp}
1260 % \end{quote}
1261 % Diese Anweisungen führen zu folgendem Struktogramm, wobei zu beachten
1262 % ist, dass die |struktogramm|-Umgebung mittels einer |center|-Umgebung
1263 % zentriert wurde, wobei die Breite des Struktogramms wiederum mit 70mm
1264 % vorgegeben ist, die Höhe diesmal aber mit 20mm.
1265 % \else%
1266 % The meaning of the optional argument will be made clear by the following
1267 % example:
1268 % \begin{tExample}
1269 % The height of the box is given by:
1270 % \begin{verbatimwrite}{struktex.tmp}
1271 % \begin{center}
1272 % \begin{struktogramm}(70,20)
1273 % \assign[20]{Calculate and output square root of \(\pi\)}
1274 % \end{struktogramm}
1275 % \end{center}
1276 % \end{verbatimwrite}
1277 % \begin{quote}
1278 % \verbatiminput{struktex.tmp}
1279 % \end{quote}
1280 % These instructions lead to the following structured box chart. In doing so it is to
1281 % pay attention on the |struktogramm| environment, which has been centered
1282 % by the |center| environment, at which the width of the structured box chart is again
1283 % given by 70mm, but the height by 20mm this time.%
1284 % \fi%
1285 % \begin{quote}
1286 % \input{struktex.tmp}
1287 % \end{quote}
1288 % \end{tExample}
1289 %
1290 % \DescribeEnv{declaration}
1291 % \ifnum\language=\languageNGerman%
1292 % Die |declaration|-Umgebung dient der Beschreibung von Variablen bzw.
1293 % der Beschreibung der Schnittstelle. Ihre
1294 % Syntax ist
1295 % \begin{quote}\obeylines
1296 % \envb{declaration}\oarg{Überschrift}
1297 % \dots
1298 % \enve{declaration}
1299 % \end{quote}
1300 % \else%
1301 % The |declaration| environment is used for the description of variables or interfaces
1302 % respectively. Its syntax is given by
1303 % \begin{quote}\obeylines
1304 % \envb{declaration}\oarg{titel}
1305 % \dots
1306 % \enve{declaration}
1307 % \end{quote}%
1308 % \fi%
1309 %
1310 % \DescribeMacro{\declarationtitle}
1311 % \ifnum\language=\languageNGerman%
1312 % Die Überschriftsangabe ist optional. Lässt man die Angabe weg, so wird
1313 % standardmäßig die Überschrift: "`Speicher bereitstellen:"' erzeugt.
1314 % Will man einen anderen Text haben, wird dieser mit
1315 % \cs{declarationtitle}\marg{Überschrift} global festgelegt. Will man für
1316 % ein einzelnes Struktogramm einen speziellen Titel erzeugen, so gibt man
1317 % diesen in den eckigen Klammern an.
1318 % \else%
1319 % The declaration of the title is optional. If the declaration is omitted, the standard
1320 % title: `Providing Memory Space' will be generated.
1321 % If one wants to have another text, it will be provided globally by
1322 % \cs{declarationtitle}\marg{title}. If one wants to generate a special title for a
1323 % certain structured box chart, one has to declare it within square brackets.%
1324 % \fi%
1325 %
1326 % \DescribeMacro{\description}
1327 % \DescribeMacro{\descriptionindent}
1328 % \DescribeMacro{\descriptionwidth}
1329 % \DescribeMacro{\descriptionsep}
1330 % \changes{v-8.0b}{04/07/14}{Zeichnung zum Layout der Deklarationen
1331 % verbessert (`multiput statt n-mal `put, Korrektur von Bezeichnungen)}
1332 % \ifnum\language=\languageNGerman%
1333 % Innerhalb der |declaration|-Umgebung werden die Beschreibungen der einzelnen
1334 % Variablen mit
1335 % \begin{quote}
1336 % \cs{description}\marg{Variablenname}\marg{Variablenbeschreibung}
1337 % \end{quote}
1338 % erzeugt. Dabei ist zu beachten, dass \meta{Variablenname} keine
1339 % schließende eckige Klammer "`]"' beinhalten darf, da dieser Makro
1340 % mittels des \cs{item}-Makros definiert worden ist. Eckige Klammern sind in
1341 % diesem Fall als \cs{lbracket} und \cs{rbracket} einzugeben.
1342 % \else%
1343 % Within the |declaration| environment the descriptions of the variables can be
1344 % generated by
1345 % \begin{quote}
1346 % \cs{description}\marg{variableName}\marg{variableDescription}
1347 % \end{quote}
1348 % In doing so one has to pay attention on the \meta{variableName}, that is not
1349 % allowed to content a right square bracket ``]'', because this macro has been
1350 % defined by the \cs{item} macros. Square brackets have to be entered as
1351 % \cs{lbracket} or \cs{rbracket} respectively.%
1352 % \fi%
1353 %
1354 % \ifnum\language=\languageNGerman%
1355 % Das Aussehen einer Beschreibung lässt sich mit drei Parametern
1356 % steuern: \cs{descriptionindent}, \cs{descriptionwidth} und \cs{descriptionsep};
1357 % die Bedeutung der Parameter ist der \Abb{fig:description} zu entnehmen
1358 % (\cs{xsize@nss} und \cs{xin@nss} sind interne Größen, die von \StrukTeX\
1359 % vorgegeben werden).
1360 % Die Vorbesetzung dieser Werte ist folgendermaßen:
1361 % \begin{quote}
1362 % \begin{verbatim}
1363 % \descriptionindent=1.5em
1364 % \descriptionwidth=40pt
1365 % \descriptionsep=\tabcolsep
1366 % \end{verbatim}
1367 % \end{quote}
1368 % Die Bedeutung von \cs{descriptionwidth} ist darin zu sehen, dass ein
1369 % Variablenname, der kürzer als \cs{descriptionwidth} ist, eine Beschreibung
1370 % erhält, die auf der gleichen Höhe liegt; ansonsten wird die Beschreibung
1371 % eine Zeile tiefer begonnen.
1372 % \else%
1373 % The shape of a description can be controled by three parameters:
1374 % \cs{descriptionindent}, \cs{descriptionwidth} and \cs{descriptionsep}.
1375 % The meaning of the parameters can be taken from \ref{fig:description}
1376 % (\cs{xsize@nss} and \cs{xin@nss} are internal sizes, that are given by
1377 % \StrukTeX).
1378 % The default values are the following:
1379 % \begin{quote}
1380 % \begin{verbatim}
1381 % \descriptionindent=1.5em
1382 % \descriptionwidth=40pt
1383 % \descriptionsep=\tabcolsep
1384 % \end{verbatim}
1385 % \end{quote}
1386 % The significance of \cs{descriptionwidth} is, that a variable name, which
1387 % is shorter than \cs{descriptionwidth}, gets a description of the same
1388 % height. Otherwise the description will be commenced in the next line.%
1389 % \fi%
1390 % \begin{figure}[tb]
1391 % \unitlength 1.00mm
1392 % \linethickness{0.4pt}
1393 % \begin{picture}(125.00,100.00)
1394 % \put(0.00,0.00){\framebox(125.00,100.00)[cc]{}}
1395 % \put(62.50,95.00){\makebox(0,0)[cc]{{\cs{xsize@nss}}}}
1396 % \put(62.50,85.00){\makebox(0,0)[cc]{{\cs{tempxx@nss}}}}
1397 % \put(10.00,70.00){\framebox(105.00,5.00)[cc]{}}
1398 % \put(15.00,71.00){\makebox(0,0)[lb]{\ifnum\language=\languageNGerman%
1399 % \meta{Überschrift}%
1400 % \else%
1401 % \meta{title}%
1402 % \fi}}
1403 % \put(72.50,95.00){\vector(1,0){52.50}}
1404 % \put(52.50,95.00){\vector(-1,0){52.50}}
1405 % \put(73.50,85.00){\vector(1,0){41.50}}
1406 % \put(51.50,85.00){\vector(-1,0){41.50}}
1407 % \put(30.00,56.00){\makebox(0,0)[lb]{\ifnum\language=\languageNGerman%
1408 % \meta{Variablenname}%
1409 % \else%
1410 % \meta{variable name}%
1411 % \fi}}
1412 % \put(40.00,52.00){\vector(1,0){17.00}}
1413 % \put(19.00,57.00){\vector(-1,0){9.00}}
1414 % \put(67.00,5.00){\framebox(48.00,5.00)[cc]{}}
1415 % \put(67.00,25.00){\framebox(48.00,35.00)[cc]{}}
1416 % \put(72.00,56.00){\makebox(0,0)[lb]{\ifnum\language=\languageNGerman%
1417 % \meta{Variablenbeschreibung}%
1418 % \else%
1419 % \meta{variable description}%
1420 % \fi}}
1421 % \put(72.00,6.00){\makebox(0,0)[lb]{\ifnum\language=\languageNGerman%
1422 % \meta{Variablenbeschreibung}%
1423 % \else%
1424 % \meta{variable description}%
1425 % \fi}}
1426 % \put(30.00,16.00){\makebox(0,0)[lb]{\ifnum\language=\languageNGerman%
1427 % \meta{Variablenname}%
1428 % \else%
1429 % \meta{variable name}%
1430 % \fi}}
1431 % \put(25.00,15.00){\framebox(90.00,5.00)[cc]{}}
1432 % \put(19.00,57.00){\vector(1,0){6.00}}
1433 % \put(40.00,52.00){\vector(-1,0){15.00}}
1434 % \put(25.00,50.00){\framebox(32.00,10.00)[cc]{}}
1435 % \put(62.00,54.00){\vector(-1,0){5.00}}
1436 % \put(62.00,54.00){\vector(1,0){5.00}}
1437 % \put(15.00,17.00){\vector(1,0){10.00}}
1438 % \put(15.00,17.00){\vector(-1,0){5.00}}
1439 % \put(40.00,42.00){\makebox(0,0)[cc]{{\cs{descriptionwidth}}}}
1440 % \put(66.00,32.00){\makebox(0,0)[rc]{{\cs{descriptionsep}}}}
1441 % \put(12.00,36.00){\makebox(0,0)[lc]{{\cs{descriptionindent}}}}
1442 % \multiput(10.00,100.00)(0.00,-3.00){33}{\line(0,-1){2.00}}
1443 % \put(10.00,1.00){\line(0,-1){1.00}}
1444 % \multiput(115.00,100.00)(0.00,-3.00){33}{\line(0,-1){2.00}}
1445 % \put(115.00,1.00){\line(0,-1){1.00}}
1446 % \put(60.00,35.00){\line(0,-1){2.00}}
1447 % \put(17.00,33.00){\line(0,1){1.00}}
1448 % \put(17.00,39.00){\line(0,-1){1.00}}
1449 % \put(60.00,35.00){\line(0,1){19.00}}
1450 % \put(40.00,43.00){\line(0,1){9.00}}
1451 % \put(17.00,57.00){\line(0,-1){18.00}}
1452 % \put(17.00,33.00){\line(0,-1){16.00}}
1453 % \put(17.00,17.00){\circle*{1.00}}
1454 % \put(17.00,57.00){\circle*{1.00}}
1455 % \put(40.00,52.00){\circle*{1.00}}
1456 % \put(60.00,54.00){\circle*{1.00}}
1457 % \end{picture}
1458 % \caption{\label{fig:description}\ifnum\language=\languageNGerman Aufbau
1459 % einer Variablenbeschreibung
1460 % \else Construction of a variable description
1461 % \fi}
1462 % \end{figure}
1463 %
1464 % \begin{tExample}
1465 % \ifnum\language=\languageNGerman%
1466 % Zunächst wird nur eine einzelne Variable beschrieben.
1467 % \begin{verbatimwrite}{struktex.tmp}
1468 % \begin{struktogramm}(95,20)
1469 % \assign%
1470 % {%
1471 % \begin{declaration}
1472 % \description{\pVar{iVar}}{eine \pKey{int}-Variable,
1473 % deren Beschreibung hier allein dem
1474 % Zweck dient, den Makro vorzuführen}
1475 % \end{declaration}
1476 % }
1477 % \end{struktogramm}
1478 % \end{verbatimwrite}
1479 % \else%
1480 % First there will be described only one variable.
1481 % \begin{verbatimwrite}{struktex.tmp}
1482 % \begin{struktogramm}(95,20)
1483 % \assign%
1484 % {%
1485 % \begin{declaration}
1486 % \description{\pVar{iVar}}{an \pKey{int} variable, which is
1487 % described here just for presentation of the
1488 % macro}
1489 % \end{declaration}
1490 % }
1491 % \end{struktogramm}
1492 % \end{verbatimwrite}%
1493 % \fi%
1494 % \begin{quote}
1495 % \verbatiminput{struktex.tmp}
1496 % \end{quote}
1497 % \ifnum\language=\languageNGerman%
1498 % Das zugehörige Struktogramm, wobei zu beachten ist, dass durch die
1499 % leeren eckigen Klammern keine Überschrift erzeugt wird.
1500 % \else%
1501 % The corresponding structured box chart is the following, at which one has to
1502 % pay attention, that there are no titels generated by the empty square
1503 % brackets.%
1504 % \fi%
1505 % \begin{quote}
1506 % \input{struktex.tmp}
1507 % \end{quote}
1508 % \ifnum\language=\languageNGerman%
1509 % Nun werden Variablen genauer spezifiziert:
1510 % \begin{verbatimwrite}{struktex.tmp}
1511 % \begin{struktogramm}(95,50)
1512 % \assign{%
1513 % \begin{declaration}[Parameter:]
1514 % \description{\pVar{iPar}}{ein \pKey{int}-Parameter,
1515 % dessen Bedeutung hier beschrieben wird}
1516 % \end{declaration}
1517 % \begin{declaration}[lokale Variablen:]
1518 % \description{\pVar{iVar}}{eine \pKey{int}-Variable,
1519 % deren Bedeutung hier beschrieben wird}
1520 % \description{\pVar{dVar}}{eine \pKey{double}-Variable,
1521 % deren Bedeutung hier beschrieben wird}
1522 % \end{declaration}
1523 % }
1524 % \end{struktogramm}
1525 % \end{verbatimwrite}
1526 % \else%
1527 % Now variables will be specified more precisely:
1528 % \begin{verbatimwrite}{struktex.tmp}
1529 % \begin{struktogramm}(95,50)
1530 % \assign{%
1531 % \begin{declaration}[Parameter:]
1532 % \description{\pVar{iPar}}{an \pKey{int} parameter with the
1533 % meaning described here}
1534 % \end{declaration}
1535 % \begin{declaration}[local Variables:]
1536 % \description{\pVar{iVar}}{an \pKey{int} variable with the meaning
1537 % described here}
1538 % \description{\pVar{dVar}}{a \pKey{double} variable with the
1539 % meaning described here}
1540 % \end{declaration}
1541 % }
1542 % \end{struktogramm}
1543 % \end{verbatimwrite}%
1544 % \fi%
1545 % \begin{quote}
1546 % \verbatiminput{struktex.tmp}
1547 % \end{quote}
1548 % \ifnum\language=\languageNGerman%
1549 % Das ergibt:
1550 % \else%
1551 % This results in:%
1552 % \fi%
1553 % \begin{quote}
1554 % \input{struktex.tmp}
1555 % \end{quote}
1556 %
1557 % \changes{v121}{10/08/31}{removed catcoding from example code}
1558 % \ifnum\language=\languageNGerman%
1559 % Zuletzt die globale Vereinbarung eines Titels:
1560 % \begin{verbatimwrite}{struktex.tmp}
1561 % \def\declarationtitle{globale Variablen:}
1562 % \begin{struktogramm}(95,13)
1563 % \assign{%
1564 % \begin{declaration}
1565 % \description{\pVar{iVar_g}}{eine \pKey{int}-Variable}
1566 % \end{declaration}
1567 % }
1568 % \end{struktogramm}
1569 % \end{verbatimwrite}
1570 % \else%
1571 % Finally the global declaration of a titel:
1572 % \begin{verbatimwrite}{struktex.tmp}
1573 % \def\declarationtitle{global variables}
1574 % \begin{struktogramm}(95,13)
1575 % \assign{%
1576 % \begin{declaration}
1577 % \description{\pVar{iVar_g}}{an \pKey{int} variable}
1578 % \end{declaration}
1579 % }
1580 % \end{struktogramm}
1581 % \end{verbatimwrite}%
1582 % \fi%
1583 % \begin{quote}
1584 % \verbatiminput{struktex.tmp}
1585 % \end{quote}
1586 % \ifnum\language=\languageNGerman%
1587 % Dies ergibt das folgende Aussehen:
1588 % \else%
1589 % This results in the following shape:%
1590 % \fi%
1591 % \begin{quote}
1592 % \input{struktex.tmp}
1593 % \end{quote}
1594 % \ifnum\language=\languageNGerman%
1595 % Hier ist die lokale Umsetzung des \cs{catcode}s des Unterstrichs zu
1596 % beachten, die erforderlich ist, wenn man einen Unterstrich in einem
1597 % Makroargument einsetzen möchte. Diese lokale Umsetzung wird zwar auch
1598 % schon bei \cs{pVar} gemacht, reicht aber bei der Makroexpansionstechnik
1599 % von \TeX\ nicht aus.
1600 % \else%
1601 % Here one has to notice the local realisation of the \cs{catcode} of the
1602 % underline, which is necessary, if one wants to place an underline into
1603 % an argument of macro. Although this local transfer is already realized
1604 % at \cs{pVar} it doesn't suffice with the technique of macro expanding
1605 % of \TeX.%
1606 % \fi%
1607 % \end{tExample}
1608 %
1609 % \DescribeMacro{\sub}
1610 % \DescribeMacro{\return}
1611 % \ifnum\language=\languageNGerman%
1612 % Die Sinnbilder für einen Unterprogrammsprung und einen Aussprung aus dem
1613 % Programm sehen ähnlich aus und werden mit folgenden Befehlen gezeichnet:
1614 % \begin{quote}\obeylines
1615 % \cs{sub}\oarg{Höhe}\marg{Text}
1616 % \cs{return}\oarg{Höhe}\marg{Text}
1617 % \end{quote}
1618 % \else%
1619 % The mapping conventions for jumps of subprograms and for exits of program
1620 % look similar and are drawn by the following instructions:
1621 % \begin{quote}\obeylines
1622 % \cs{sub}\oarg{height}\marg{text}
1623 % \cs{return}\oarg{height}\marg{text}
1624 % \end{quote}%
1625 % \fi%
1626 % \ifnum\language=\languageNGerman%
1627 % Die Parameter haben dieselbe Bedeutung wie bei \cs{assign}.
1628 % Das nächste Beispiel zeigt, wie diese Sinnbilder gezeichnet werden.\par
1629 % \begin{verbatimwrite}{struktex.tmp}
1630 % \begin{struktogramm}(95,20)
1631 % \sub{Liste sortieren}
1632 % \return{Listenkopf zurückgeben}
1633 % \end{struktogramm}
1634 % \end{verbatimwrite}
1635 % \else%
1636 % The parameters mean the same as at \cs{assign}. The next example
1637 % shows how the mapping conventions are drawn.\par
1638 % \begin{verbatimwrite}{struktex.tmp}
1639 % \begin{struktogramm}(95,20)
1640 % \sub{sorting the list}
1641 % \return{return of list header}
1642 % \end{struktogramm}
1643 % \end{verbatimwrite}%
1644 % \fi%
1645 % \begin{tExample}
1646 % \begin{quote}
1647 % \verbatiminput{struktex.tmp}
1648 % \end{quote}
1649 % \ifnum\language=\languageNGerman%
1650 % Diese Anweisungen führen zu folgendem Struktogramm:
1651 % \else%
1652 % These instructions lead to the following structured box chart:%
1653 % \fi%
1654 % \begin{quote}
1655 % \input{struktex.tmp}
1656 % \end{quote}
1657 % \end{tExample}
1658 %
1659 %\DescribeMacro{\while}
1660 %\DescribeMacro{\whileend}
1661 %\DescribeMacro{\until}
1662 %\DescribeMacro{\untilend}
1663 %\DescribeMacro{\forallin}
1664 %\DescribeMacro{\forallinend}
1665 %\DescribeMacro{\forever}
1666 %\DescribeMacro{\foreverend}
1667 % \changes{v2.1}{17/06/06}{`forallin, `forallinend: added english documentation}
1668 % \changes{v2.0c}{17/06/06}{`forallin, `forallinend: added german documentation}
1669 % \changes{v2.0b}{17/06/02}{`forallin, `forallinend: renamed from
1670 % `foreach, `foreach to avoid conflict with tikz}
1671 % \changes{v2.0a}{17/06/02}{`foreach, `foreachend: renamed from `forall, `forallend}
1672 % \ifnum\language=\languageNGerman%
1673 % Zum Darstellen von Schleifenkonstrukten stehen die drei Befehle
1674 % \cs{while}, \cs{until} und \cs{forever} zur Verfügung.
1675 % Die While-Schleife stellt
1676 % eine Wiederholung mit vorausgehender Bedingungsprüfung (kopfgesteuerte
1677 % Schleife) dar, die
1678 % Until-Schleife testet die Bedingung am Schleifenende (fußgesteuerte
1679 % Schleife) und die
1680 % Forever-Schleife ist eine Endlosschleife, aus der man mit dem Befehl
1681 % \cs{exit} herausspringen kann.
1682 % \begin{quote}\obeylines
1683 % \cs{while}\oarg{Breite}\marg{Text}\meta{Unterstruktogramm}\cs{whileend}
1684 % \cs{until}\oarg{Breite}\marg{Text}\meta{Unterstruktogramm}\cs{untilend}
1685 % \cs{forever}\oarg{Breite}\meta{Unterstruktogramm}\cs{foreverend}
1686 % \cs{exit}\oarg{Höhe}\marg{Text}
1687 % \end{quote}
1688 % \meta{Breite} ist die Dicke des Rahmens des Sinnbildes,
1689 % \meta{Text} ist
1690 % der Bedingungstext, der in diesen Rahmen geschrieben wird. Wird die
1691 % Breite nicht angegeben, richtet sich die Rahmendicke nach der Höhe des
1692 % Textes. Der Text wird linksbündig in den Rahmen geschrieben.
1693 % Ist der Text leer, so wird ein dünner Rahmen gezeichnet.
1694 %
1695 % Ein Kontrollkonstrukt, das heute in vielen Programmiersprachen verfügbar
1696 % ist, ist eine Schleife, die abhängig von der jeweiligen Sprache als
1697 % |forall|-, |for| \ldots{} |in| oder |foreach|-Schleife bezeichnet
1698 % wird. Diese Schleifenart kann prinzipiell als kopfgesteuerte Schleife
1699 % angesehen werden, manche ziehen aber eine Schreibweise vor, die von der
1700 % Endlosschleife abgeleitet wird. Für diesen Fall gibt es das Konstrukt
1701 % \begin{quote}
1702 % \cs{forallin}\oarg{Breite}\marg{Text}\meta{Unterstruktogramm}\cs{forallinend}
1703 % \end{quote}
1704 % \else%
1705 % For representation of loop constructions there are three instructions
1706 % available:
1707 % \cs{while}, \cs{until} and \cs{forever}.
1708 % The while loop is a repetition with preceding condition check (loop with
1709 % a pre test).
1710 % The until loop checks the condition at the end of the loop (loop with a
1711 % post test).
1712 % And the forever loop is a neverending loop, that can be left by \cs{exit}.
1713 % \begin{quote}\obeylines
1714 % \cs{while}\oarg{width}\marg{text}\meta{structured subbox chart}%
1715 % \cs{whileend}
1716 % \cs{until}\oarg{width}\marg{text}\meta{structured subbox chart}%
1717 % \cs{untilend}
1718 % \cs{forever}\oarg{width}\meta{structured subbox chart}\cs{foreverend}
1719 % \cs{exit}\oarg{height}\meta{text}
1720 % \end{quote}
1721 % \meta{width} is the width of frame of the mapping convention and \meta{text}
1722 % is the conditioning text, that is written inside this frame. If the width
1723 % is not given, the thickness of frame depends on the height of text. The
1724 % text will be written left adjusted inside the frame. If there is'nt given
1725 % any text, there will be a thin frame.
1726 %
1727 % A control structure which nowadays is provided by many programming
1728 % languages is a loop known as |forall|-, |for| \ldots |in|-, or
1729 % |foreach|-loop. This kind of loop can be seen as tail first loop but some
1730 % people prefer the form of the endless loop with included text. For this
1731 % case there is the control structure
1732 % \begin{quote}
1733 % \cs{forallin}\oarg{width}\marg{text}\meta{structured subbox chart}\cs{forallinend}
1734 % \end{quote}%
1735 % \fi%
1736 %
1737 % \ifnum\language=\languageNGerman%
1738 % An Stelle
1739 % von \meta{Unterstruktogramm} können beliebige Befehle von \StrukTeX\
1740 % stehen (mit Ausnahme von \cs{openstrukt} und \cs{closestrukt}), die
1741 % das Struktogramm innerhalb der \cs{while}-, der \cs{until}- oder der
1742 % \cs{forever}-Schleife
1743 % bilden.
1744 % \else%
1745 % Instead of \meta{structured subbox chart} there might be written any
1746 % instructions of \StrukTeX\ (except \cs{openstrukt} and \cs{closestrukt}), which
1747 % build up the box chart within the \cs{while} loop, the \cs{until} loop or the
1748 % \cs{forever} loop.%
1749 % \fi%
1750 %
1751 % \ifnum\language=\languageNGerman%
1752 % \changes{v2.0}{17/06/01}{corrected typos}
1753 % Um Kompatiblität mit der Weiterentwicklung des \StrukTeXSty{} von J.~Dietel
1754 % zu erreichen, gibt es die Makros \cs{dfr} und \cs{dfrend} mit derselben
1755 % Bedeutung wie \cs{forever} und \cs{foreverend}.
1756 % \else%
1757 % For compatibility with further development of the \StrukTeXSty{} of J.~Dietel
1758 % there are the macros \cs{dfr} and \cs{dfrend} with the same meaning as
1759 % \cs{forever} and \cs{foreverend}.%
1760 % \fi%
1761 %
1762 % \ifnum\language=\languageNGerman%
1763 % Die beiden folgenden Beispiele zeigen den Einsatz der \cs{while}- und
1764 % \cs{until}-Makros sowie der \cs{forallin}-Makros,
1765 % \cs{forever} wird weiter unten gezeigt.
1766 % \begin{verbatimwrite}{struktex.tmp}
1767 % \begin{struktogramm}(95,40)
1768 % \assign{\(I \gets 1\)}
1769 % \while[8]{\(I < 99\)}
1770 % \assign{\(J \gets I+1\)}
1771 % \until{\(J < 100\)}
1772 % \sub{Vertausche, falls gilt: \(FELD(I) > FELD(J)\)}
1773 % \assign{\(J \gets J+1\)}
1774 % \untilend
1775 % \assign{\(I \gets I+1\)}
1776 % \whileend
1777 % \end{struktogramm}
1778 % \end{verbatimwrite}
1779 % \else%
1780 % The two following examples show use of \cs{while} and \cs{until} macros. \cs{forever}
1781 % will be shown later.
1782 % \begin{verbatimwrite}{struktex.tmp}
1783 % \begin{struktogramm}(95,40)
1784 % \assign{\(I \gets 1\)}
1785 % \while[8]{\(I < 99\)}
1786 % \assign{\(J \gets I+1\)}
1787 % \until{\(J < 100\)}
1788 % \sub{Swap, if valid: \( ARRAY(I) > ARRAY(J) \)}
1789 % \assign{\(J \gets J+1\)}
1790 % \untilend
1791 % \assign{\(I \gets I+1\)}
1792 % \whileend
1793 % \end{struktogramm}
1794 % \end{verbatimwrite}%
1795 % \fi%
1796 %
1797 % \begin{tExample}
1798 % \begin{quote}
1799 % \verbatiminput{struktex.tmp}
1800 % \end{quote}
1801 % \ifnum\language=\languageNGerman%
1802 % Diese Anweisungen führen zu folgendem Struktogramm:
1803 % \else%
1804 % These instructions lead to the following structured box chart:%
1805 % \fi%
1806 % \begin{quote}
1807 % \input{struktex.tmp}
1808 % \end{quote}
1809 % \end{tExample}
1810 %
1811 % \ifnum\language=\languageNGerman%
1812 % \begin{verbatimwrite}{struktex.tmp}
1813 % \begin{struktogramm}(95, 25)
1814 % \sub{berechne Liste \(L\) der ersten 100 Primzahlen}
1815 % \forallin{\(\forall l\in L\)}
1816 % \assign{gib \(l\) aus}
1817 % \forallinend
1818 % \end{struktogramm}
1819 % \end{verbatimwrite}
1820 % \else%
1821 % \begin{verbatimwrite}{struktex.tmp}
1822 % \begin{struktogramm}(95, 25)
1823 % \sub{compute the list \(L\) of the first 100 primes}
1824 % \forallin{\(\forall l\in L\)}
1825 % \assign{print \(l\)}
1826 % \forallinend
1827 % \end{struktogramm}
1828 % \end{verbatimwrite}%
1829 % \fi%
1830 %
1831 % \begin{tExample}
1832 % \begin{quote}
1833 % \verbatiminput{struktex.tmp}
1834 % \end{quote}
1835 % \ifnum\language=\languageNGerman%
1836 % Diese Anweisungen führen zu folgendem Struktogramm:
1837 % \else%
1838 % These instructions lead to the following structured box chart:%
1839 % \fi%
1840 % \begin{quote}
1841 % \input{struktex.tmp}
1842 % \end{quote}
1843 % \end{tExample}
1844 %
1845 % \ifnum\language=\languageNGerman%
1846 % Die \cs{exit}-Anweisung gibt nur im Zusammenhang mit einfachen oder mehrfachen
1847 % Verzweigungen Sinn, daher wird sie im Anschluss an die Diskussion der
1848 % Verzweigungen vorgestellt.
1849 % \else%
1850 % The \cs{exit} instruction only makes sense in connection with simple or
1851 % multiple branches. Therefore it will be presented after the discussion
1852 % of branches.%
1853 % \fi%
1854 %
1855 % \DescribeMacro{\ifthenelse}%
1856 % \DescribeMacro{\change}%
1857 % \DescribeMacro{\ifend}%
1858 % \ifnum\language=\languageNGerman%
1859 % Zur Darstellung von Alternativen stellt \StrukTeX\ die Sinnbilder für
1860 % einen If-Then-Else-Block und für mehrfache Alternativen eine
1861 % Case-Konstruktion zur Verfügung. Da in der klassischen
1862 % |picture|-Umgebung von \LaTeX{} nur Linien mit bestimmten Steigungen
1863 % gezeichnet werden können, muss der Benutzer bei beiden Befehlen selbst
1864 % den Winkel bestimmen, mit dem die notwendigen schrägen Linien gezeichnet
1865 % werden sollen (hier ist also etwas mehr \glq Handarbeit\grq\ nötig).%
1866 % \else%
1867 % For the representation of alternatives \StrukTeX\ provides mapping
1868 % conventions for an If-Then-Else-block and a Case-construction for
1869 % multiple alternatives. Since in the traditional |picture| environment of
1870 % \LaTeX{} only lines of certain slopes can be drawn, in both cases the
1871 % user has to specify himself the angle, with which the necessary slanted
1872 % lines shall be drawn. (Here is a little bit more \grq manual work\grq\
1873 % required.)%
1874 % \fi%
1875 %
1876 % \changes{v2.0}{17/06/01}{mention pict2e.sty}
1877 % \changes{v-6.0}{00/11/24}{Einsatz von curves.sty zum Zeichnen beliebiger
1878 % Steigungen implementiert}
1879 % \ifnum\language=\languageNGerman%
1880 % Wenn hingegen der \sFile{curves.sty}, der \sFile{emlines2.sty} oder der
1881 % \sFile{pict2e.sty} eingesetzt wird, ist die Darstellung von Geraden mit
1882 % beliebiger Steigung möglich.
1883 % \else%
1884 % If however the \sFile{curves.sty}, the \sFile{emlines2.sty} or the
1885 % \sFile{pict2e.sty} is used, then the representation of lines with any
1886 % slope can be drawn.%
1887 % \fi%
1888 %
1889 % \ifnum\language=\languageNGerman%
1890 % Der If-Then-Else-Befehl sieht so aus:
1891 % \begin{quote}\obeylines
1892 % \cs{ifthenelse}\oarg{Höhe}\marg{Linker Winkel}\marg{Rechter Winkel}
1893 % ~~~~~~~~\marg{Bedingung}\marg{Linker Text}\marg{Rechter Text}
1894 % ~~~~\meta{Unterstruktogramm}
1895 % \cs{change}
1896 % ~~~~\meta{Unterstruktogramm}
1897 % \cs{ifend}
1898 % \end{quote}
1899 % \else%
1900 % The If-Then-Else-command looks like:
1901 % \begin{quote}\obeylines
1902 % \cs{ifthenelse}\oarg{height}\marg{left angle}\marg{right angle}
1903 % ~~~~~~~~\marg{condition}\marg{left text}\marg{right text}
1904 % ~~~~\meta{structured subbox chart}
1905 % \cs{change}
1906 % ~~~~\meta{structured subbox chart}
1907 % \cs{ifend}
1908 % \end{quote}%
1909 % \fi%
1910 % \ifnum\language=\languageNGerman%
1911 % Für den Fall, dass das optionale Argument \meta{Höhe} nicht angegeben
1912 % ist, sind \meta{Linker Winkel} (\texttt{\#1}) und \meta{Rechter Winkel}
1913 % (\texttt{\#2}) Ziffern
1914 % zwischen 1 und 6; diese bestimmen die Steigung der beiden Unterteilungslinien
1915 % des If-Then-Else-Blocks (großer Wert = kleine Steigung). Größere Werte
1916 % werden auf 6 gesetzt, kleinere auf 1. Das genaue
1917 % Verhalten der Steigungen ist dem folgenden Bild zu entnehmen;
1918 % \cs{xsize@nss} ist
1919 % dabei die Breite des aktuellen Unterstruktogrammes. Wird die \meta{Höhe}
1920 % vorgegeben, so bestimmt dieser Wert statt des Ausdruckes
1921 % \(\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt \#1 + \#2}}\) die Höhe des
1922 % Bedingungsrechteckes.
1923 % \else%
1924 % In the case of omitting the optional argument \meta{height} \meta{left
1925 % angle} and \meta{right angle} are numbers from 1 to 6.
1926 % They specify the slope of both the partitioning lines of
1927 % the If-Then-Else-block (large number = small slope). Larger values are
1928 % put on 6, smaller values on 1. The precise characteristics of the slopes
1929 % can be taken from the following picture. Thereby \cs{xsize@nss} is the width
1930 % of the actual structured subbox chart.
1931 % If the \meta{height} is given, then this value determines the height of the
1932 % conditioning rectangle instead of the expression \(\frac{\mbox{\cs{xsize@nss}}}
1933 % {\mbox{\tt \#1 + \#2}}\).%
1934 % \fi%
1935 % \begin{quote}
1936 % \unitlength 1.00mm
1937 % \linethickness{0.4pt}
1938 % \begin{picture}(100.00,20.00)
1939 % \put(10.00,5.00){\framebox(90.00,10.00)[cc]{}}
1940 % \put(50.00,18.00){\makebox(0,0)[cc]{\cs{xsize@nss}}}
1941 % \put(2.00,10.00){\makebox(0,0)[cc]
1942 % {$\frac{\mbox{\tt\char92 xsize@nss}}{\mbox{\tt \#1 + \#2}}$}}
1943 % \put(0.00,15.00){\line(1,0){4.00}}
1944 % \put(2.00,15.00){\line(0,-1){2.00}}
1945 % \put(0.00,5.00){\line(1,0){4.00}}
1946 % \put(2.00,5.00){\line(0,1){2.00}}
1947 % \put(10.00,4.00){\line(0,-1){4.00}}
1948 % \put(40.00,4.00){\line(0,-1){4.00}}
1949 % \put(100.00,0.00){\line(0,1){4.00}}
1950 % \put(70.00,2.00){\makebox(0,0)[cc]
1951 % {\tt \#2 $\cdot\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt \#1 + \#2}}$}}
1952 % \put(25.00,2.00){\makebox(0,0)[cc]
1953 % {\tt \#1 $\cdot\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt \#1 + \#2}}$}}
1954 % \put(10.00,2.00){\line(1,0){5.00}}
1955 % \put(35.00,2.00){\line(1,0){25.00}}
1956 % \put(80.00,2.00){\line(1,0){20.00}}
1957 % \put(10.00,16.00){\line(0,1){4.00}}
1958 % \put(100.00,16.00){\line(0,1){4.00}}
1959 % \put(10.00,18.00){\line(1,0){30.00}}
1960 % \put(60.00,18.00){\line(1,0){40.00}}
1961 % \put(10.00,15.00){\line(3,-1){30.00}}
1962 % \put(40.00,5.00){\line(6,1){60.00}}
1963 % \end{picture}
1964 % \end{quote}
1965 % \ifnum\language=\languageNGerman%
1966 % \meta{Bedingung}
1967 % wird in das so gebildete obere mittlere Dreieck gesetzt; die Parameter
1968 % \meta{Linker Text} und \meta{Rechter Text} werden in das
1969 % linke bzw.\ rechte
1970 % untere Dreieck gesetzt. Der Bedingungs-Text kann in seinem Dreiecks-Feld
1971 % umgebrochen werden. Ab Version v-5.3 wird der Bedingungstext durch
1972 % geeigneten Umbruch beliebigen Steigungen angepasst.\footnote{Diese
1973 % Erweiterung stammt von Daniel Hagedorn, dem ich hiermit herzlich danken
1974 % möchte} Die beiden anderen Texte sollten kurz sein (\zB\
1975 % ja/nein oder true/false), da sie nicht umgebrochen werden können und
1976 % sonst über ihr Dreiecks-Feld hinausragen. Um an dieser Stelle
1977 % Einheitlichkeit zu erzielen, sollten die Makros \cs{pTrue} und
1978 % \cs{pFalse} (vgl. \cref{sec:makros-variablen})
1979 % benutzt werden. Hinter \cs{ifthenelse}
1980 % werden die Befehle für das linke, hinter \cs{change} die für das
1981 % rechte "`Unterstruktogramm"' geschrieben. Falls diese beiden
1982 % Struktogramme nicht gleich lang sind, wird ein Kasten mit einem
1983 % \(\emptyset\) (vgl. \cref{sec:spez-zeichen})
1984 % ergänzt.\footnote{Eventuell ist ein \cs{strut} hilfreich, um
1985 % unterschiedliche Höhen von Texten auszugleichen.} Mit \cs{ifend} wird das
1986 % If-Then-Else-Element beendet.
1987 % Es folgen zwei Beispiele für die Anwendung.
1988 % \begin{verbatimwrite}{struktex.tmp}
1989 % \begin{struktogramm}(95,32)
1990 % \ifthenelse[12]{1}{2}
1991 % {Flag für Drucker-Ausgabe gesetzt ?}{\sTrue}{\sFalse}
1992 % \assign[15]{Ausgabe auf Drucker umleiten}
1993 % \change
1994 % \assign{Ausgabe auf den Bildschirm}
1995 % \ifend
1996 % \end{struktogramm}
1997 % \end{verbatimwrite}
1998 % \else%
1999 % \meta{condition} is set in the upper triangle built in the above way. The
2000 % parameters \meta{left text} and \meta{right text} are set in the left or
2001 % right lower triangle respectively. The conditioning text can be made up
2002 % in its triangle box. As of version v-5.3, the condition text is adapted
2003 % to any slopes using suitable wrapping.\footnote{This extension is due
2004 % to Daniel Hagedorn, whom I have to thank for his work.} Both the other
2005 % texts should be short (e.g. yes/no or true/false), since they can't be
2006 % made up and otherwise they stand out from their triangle box. For
2007 % obtaining uniformity here the macros \cs{pTrue} and \cs{pFalse}
2008 % (see \cref{sec:makros-variablen}) should be used. Behind \cs{ifthenelse}
2009 % the instructions for the left ``structured subbox chart'' are written and
2010 % behind \cs{change} the instructions for the right ``structured subbox
2011 % chart'' are written. If these two box charts have not the same length,
2012 % then a box with \(\emptyset\) (see \cref{sec:spez-zeichen}) will be
2013 % completioned. The If-Then-Else-element is finished by \cs{ifend}. In the
2014 % following there are two examples for application.
2015 % \begin{verbatimwrite}{struktex.tmp}
2016 % \begin{struktogramm}(95,32)
2017 % \ifthenelse[12]{1}{2}
2018 % {Flag for Output on Printer set ?}{\sTrue}{\sFalse}
2019 % \assign[15]{Output directed to Printer}
2020 % \change
2021 % \assign{Output on Screen}
2022 % \ifend
2023 % \end{struktogramm}
2024 % \end{verbatimwrite}%
2025 % \fi%
2026 % \begin{tExample}
2027 % \begin{quote}
2028 % \verbatiminput{struktex.tmp}
2029 % \end{quote}
2030 % \ifnum\language=\languageNGerman%
2031 % Diese Anweisungen führen zu folgendem Struktogramm:
2032 % \else%
2033 % These instructions lead to the following structured box chart:%
2034 % \fi%
2035 % \begin{quote}
2036 % \input{struktex.tmp}
2037 % \end{quote}
2038 % \end{tExample}
2039 % \ifnum\language=\languageNGerman%
2040 % \begin{verbatimwrite}{struktex.tmp}
2041 % \begin{struktogramm}(90,30)
2042 % \ifthenelse{3}{4}
2043 % {Flag für Drucker-Ausgabe gesetzt ?}{\sTrue}{\sFalse}
2044 % \assign[15]{Ausgabe auf Drucker umleiten}
2045 % \change
2046 % \assign{Ausgabe auf den Bildschirm}
2047 % \ifend
2048 % \end{struktogramm}
2049 % \end{verbatimwrite}
2050 % \else%
2051 % \begin{verbatimwrite}{struktex.tmp}
2052 % \begin{struktogramm}(90,30)
2053 % \ifthenelse{3}{4}
2054 % {Output on Printer set ?}{\sTrue}{\sFalse}
2055 % \assign[15]{Output redirected to printer}
2056 % \change
2057 % \assign{Output on Screen}
2058 % \ifend
2059 % \end{struktogramm}
2060 % \end{verbatimwrite}%
2061 % \fi%
2062 % \begin{tExample}
2063 % \begin{quote}
2064 % \verbatiminput{struktex.tmp}
2065 % \end{quote}
2066 % \ifnum\language=\languageNGerman%
2067 % Diese Anweisungen führen zu folgendem Struktogramm:
2068 % \else%
2069 % These instructions lead to the following structured box chart:%
2070 % \fi%
2071 % \begin{quote}
2072 % \input{struktex.tmp}
2073 % \end{quote}
2074 % \end{tExample}
2075 %
2076 % \DescribeMacro{\case}
2077 % \DescribeMacro{\switch}
2078 % \DescribeMacro{\caseend}
2079 % \ifnum\language=\languageNGerman%
2080 % Das Case-Konstrukt hat folgende Syntax:
2081 % \begin{quote}\obeylines
2082 % \cs{case}\oarg{Höhe}\marg{Winkel}\marg{Anzahl der Fälle}\marg{Bedingung}\marg{Text des 1. Falles}
2083 % ~~~~\meta{Unterstruktogramm}
2084 % \cs{switch}\oarg{Position}\marg{Text des 2. Falles}
2085 % ~~~~\meta{Unterstruktogramm}
2086 % \dots
2087 % \cs{switch}\oarg{Position}\marg{Text des n.\ Falles}
2088 % ~~~~\meta{Unterstruktogramm}
2089 % \cs{caseend}
2090 % \end{quote}
2091 % \else%
2092 % The Case-Construct has the following syntax:
2093 % \begin{quote}\obeylines
2094 % \cs{case}\oarg{height}\marg{angle}\marg{number of cases}\marg{condition}\marg{text of 1. case}|}|
2095 % ~~~~\meta{structured subbox chart}
2096 % \cs{switch}\oarg{position}\marg{text of 2. case}
2097 % ~~~~\meta{structured subbox chart}
2098 % \dots
2099 % \cs{switch}\oarg{position}\marg{text of n.\ case}
2100 % ~~~~\meta{structured subbox chart}
2101 % \cs{caseend}
2102 % \end{quote}%
2103 % \fi%
2104 % \ifnum\language=\languageNGerman%
2105 % Ist die \meta{Höhe} nicht angegeben, so erhält die Unterteilungslinie
2106 % des Case-Sinnbildes die durch \meta{Winkel} angegebene Steigung (die bei
2107 % \cs{ifthenelse} erwähnten Winkelwerte). In das obere der durch diese
2108 % Linie entstandenen beiden Dreieck wird der Text \meta{Bedingung}
2109 % gesetzt. Die Größenverhältnisse ergeben sich aus der folgenden Skizze
2110 % (\cs{xsize@nss} ist die aktuelle Breite des (Unter-)Struktogramms):
2111 % \else%
2112 % If the \meta{height} is not given, then the partitioning line of the
2113 % mapping convention of case gets the slope given by \meta{angle} (those
2114 % values mentioned at \cs{ifthenelse}). The text \meta{condition} is set
2115 % into the upper of the both triangles built by this line. The proportions
2116 % are sketched below:%
2117 % \fi%
2118 % \begin{center}
2119 % \label{fig:case1}
2120 % \unitlength 1.00mm
2121 % \linethickness{0.4pt}
2122 % \begin{picture}(64.00,40.00)
2123 % \put(9.00,5.00){\framebox(50.00,30.00)[cc]{}}
2124 % \put(9.00,36.00){\line(0,1){4.00}}
2125 % \put(9.00,38.00){\line(1,0){15.00}}
2126 % \put(34.00,38.00){\makebox(0,0)[cc]{\cs{xsize@nss}}}
2127 % \put(44.00,38.00){\line(1,0){15.00}}
2128 % \put(59.00,40.00){\line(0,-1){4.00}}
2129 % \put(0.00,35.00){\line(1,0){4.00}}
2130 % \put(2.00,35.00){\line(0,-1){10.00}}
2131 % \put(2.00,15.00){\line(0,-1){10.00}}
2132 % \put(0.00,5.00){\line(1,0){4.00}}
2133 % \put(2.00,20.00){\makebox(0,0)[cc]{%
2134 % $\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt\#1}}$}}
2135 % \put(9.00,35.00){\line(5,-3){50.00}}
2136 % \put(29.00,5.00){\line(0,1){18.00}}%
2137 % \put(9.00,0.00){\line(0,1){4.00}}
2138 % \put(29.00,0.00){\line(0,1){4.00}}
2139 % \put(19.00,2.00){\makebox(0,0)[cc]{%
2140 % $\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt\#2}}$}}
2141 % \put(60.00,35.00){\line(1,0){4.00}}
2142 % \put(60.00,23.00){\line(1,0){4.00}}
2143 % \put(62.00,35.00){\line(0,-1){2.00}}
2144 % \put(62.00,23.00){\line(0,1){2.00}}
2145 % \put(62.00,29.00){\makebox(0,0)[cc]{%
2146 % $\frac{\mbox{\tt\#2}\cdot\mbox{\cs{xsize@nss}}}
2147 % {\mbox{\tt\#1}}$}}
2148 % \end{picture}
2149 % \end{center}
2150 % \ifnum\language=\languageNGerman%
2151 % Der zweite Parameter \meta{Anzahl der Fälle} gibt die Anzahl der zu
2152 % zeichnenden Fälle an; alle Unterstruktogramme der einzelnen Fälle
2153 % erhalten die gleiche Breite. Der \meta{Text des 1. Falles} muss als
2154 % Parameter des \cs{case}-Befehls angegeben werden, alle weiteren Fälle
2155 % werden über den \cs{switch}-Befehl eingeleitet. Hinter dem Text folgen
2156 % dann die Befehle für das eigentliche Unterstruktogramm des jeweiligen
2157 % Falles. Der letzte Fall wird mit \cs{caseend} abgeschlossen. Ein
2158 % Case-Sinnbild mit drei Fällen zeigt das folgende Beispiel.
2159 % \else%
2160 % The second parameter \meta{number of cases} specifies the number of
2161 % cases, that have to be drawn. All structured subbox charts of the
2162 % certain cases get the same width. The \meta{text of 1. case} has to be
2163 % given as a parameter of the \cs{case} instruction. All other cases are
2164 % introduced by the \cs{switch} instruction. Behind the text the
2165 % instructions for the proper structured subbox chart of certain case
2166 % follow. The last case is finished by \cs{caseend}. A mapping convention
2167 % of case with three cases is shown in the following example.%
2168 % \fi%
2169 %
2170 % \ifnum\language=\languageNGerman%
2171 % \begin{tExample}
2172 % \begin{verbatimwrite}{struktex.tmp}
2173 % \begin{struktogramm}(95,30)
2174 % \case{4}{3}{Signum(x)}{-1}
2175 % \assign{\(z \gets - \frac{1}{x}\)}
2176 % \switch{0}
2177 % \assign{Ausgabe: Division durch 0}
2178 % \switch{1}
2179 % \assign{\(z \gets \frac{1}{x}\)}
2180 % \caseend
2181 % \end{struktogramm}
2182 % \end{verbatimwrite}
2183 % \begin{quote}
2184 % \verbatiminput{struktex.tmp}
2185 % \end{quote}
2186 % Diese Anweisungen führen zu folgendem Struktogramm:
2187 % \else%
2188 % \begin{tExample}
2189 % \begin{verbatimwrite}{struktex.tmp}
2190 % \begin{struktogramm}(95,30)
2191 % \case{4}{3}{Signum(x)}{-1}
2192 % \assign{\(z \gets - \frac{1}{x}\)}
2193 % \switch{0}
2194 % \assign{Output: Division by 0}
2195 % \switch{1}
2196 % \assign{\(z \gets \frac{1}{x}\)}
2197 % \caseend
2198 % \end{struktogramm}
2199 % \end{verbatimwrite}
2200 % \begin{quote}
2201 % \verbatiminput{struktex.tmp}
2202 % \end{quote}
2203 % These instructions lead to the following structured box chart:%
2204 % \fi%
2205 % \begin{quote}
2206 % \input{struktex.tmp}
2207 % \end{quote}
2208 % \end{tExample}
2209 %
2210 % \ifnum\language=\languageNGerman%
2211 % Der optionale Parameter \oarg{Höhe} ist nur einzusetzen, wenn die Option
2212 % "`|curves|"', "`|emlines2|"' oder "`|pict2e|"' gesetzt ist; ist das nicht
2213 % der Fall, können die Struktogramme durcheinander kommen. Die
2214 % Erweiterung des \cs{switch}-Kommandos mit \oarg{Höhe} führt zu einer
2215 % anderen Bedeutung von \meta{Winkel}. Ist der Wert gerade, wird wie zuvor
2216 % eine gerade Linie zur Aufteilung des zugrundeliegenden Rechtecks
2217 % gezeichnet; ist der Wert hingegegen ungerade, wird der letzte Fall wie im
2218 % folgenden gezeigt als Sonderfall gezeichnet.
2219 % \else%
2220 % The optional parameter \oarg{height} can be used if and only if one of
2221 % the options ``curves'', ``emlines2'' or ``pict2e'', resp. is set; if this
2222 % is not the case, the structured chart box may be scrumbled up. The
2223 % extension of the \cs{switch} instruction by \oarg{height} results in the
2224 % following shape with a different slope of a slanted line, which now is
2225 % fixed by the height given by the optional parameter. If the value of the
2226 % parameter \meta{angle} is even, a straight line is drawn as before. If
2227 % the value is odd, the last case is drawn as a special case as showed
2228 % below.
2229 %\fi
2230 % \begin{center}
2231 % \label{fig:case2}
2232 % \unitlength 1.00mm
2233 % \linethickness{0.4pt}
2234 % \begin{picture}(69.00,30.00)
2235 % \put(9.00,5.00){\framebox(60.00,20.00)[cc]{}}
2236 % \put(9.00,26.00){\line(0,1){4.00}}
2237 % \put(9.00,28.00){\line(1,0){20.00}}
2238 % \put(39.00,28.00){\makebox(0,0)[cc]{\cs{xsize@nss}}}
2239 % \put(49.00,28.00){\line(1,0){20.00}}
2240 % \put(69.00,30.00){\line(0,-1){4.00}}
2241 % \put(0.00,25.00){\line(1,0){4.00}}
2242 % \put(2.00,25.00){\line(0,-1){5.00}}
2243 % \put(2.00,10.00){\line(0,-1){5.00}}
2244 % \put(0.00,5.00){\line(1,0){4.00}}
2245 % \put(2.00,15.00){\makebox(0,0)[cc]{%
2246 % \ifnum\language=\languageNGerman\meta{Höhe}\else\meta{height}\fi}}
2247 % \put(29.00,5.00){\line(0,1){13.33}}
2248 % \put(9.00,25.00){\line(6,-2){60.00}}
2249 % \put(9.00,0.00){\line(0,1){4.00}}
2250 % \put(29.00,0.00){\line(0,1){4.00}}
2251 % \put(19.00,2.00){\makebox(0,0)[cc]{$\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt\#2}}$}}
2252 % \put(70.00,25.00){\line(1,0){4.00}}
2253 % \put(70.00,18.33){\line(1,0){4.00}}
2254 % \put(72.00,25.00){\line(0,-1){1.00}}
2255 % \put(72.00,18.33){\line(0,1){1.00}}
2256 % \put(72.00,21.66){\makebox(0,0)[cc]{%
2257 % $\frac{\mbox{\ifnum\language=\languageNGerman\meta{Höhe}\else
2258 % \meta{height}\fi}}{\mbox{\tt\#2}}$}}
2259 % \end{picture}
2260 % \vspace{5mm}
2261 % \begin{picture}(69.00,30.00)
2262 % \put(9.00,5.00){\framebox(60.00,20.00)[cc]{}}
2263 % \put(9.00,26.00){\line(0,1){4.00}}
2264 % \put(9.00,28.00){\line(1,0){20.00}}
2265 % \put(39.00,28.00){\makebox(0,0)[cc]{\cs{xsize@nss}}}
2266 % \put(49.00,28.00){\line(1,0){20.00}}
2267 % \put(69.00,30.00){\line(0,-1){4.00}}
2268 % \put(0.00,25.00){\line(1,0){4.00}}
2269 % \put(2.00,25.00){\line(0,-1){5.00}}
2270 % \put(2.00,10.00){\line(0,-1){5.00}}
2271 % \put(0.00,5.00){\line(1,0){4.00}}
2272 % \put(2.00,15.00){\makebox(0,0)[cc]{%
2273 % \ifnum\language=\languageNGerman\meta{Höhe}\else\meta{height}\fi}}
2274 % \put(29.00,5.00){\line(0,1){10.00}}
2275 % \put(9.00,25.00){\line(4,-2){40.00}}
2276 % \put(49.00,5.00){\line(2,2){20.00}}
2277 % \put(9.00,0.00){\line(0,1){4.00}}
2278 % \put(29.00,0.00){\line(0,1){4.00}}
2279 % \put(19.00,2.00){\makebox(0,0)[cc]{%
2280 % $\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt\#2}}$}}
2281 % \put(70.00,25.00){\line(1,0){4.00}}
2282 % \put(70.00,15.00){\line(1,0){4.00}}
2283 % \put(72.00,25.00){\line(0,-1){2.00}}
2284 % \put(72.00,15.00){\line(0,1){2.00}}
2285 % \put(72.00,20.00){\makebox(0,0)[cc]{%
2286 % $\displaystyle\frac{\mbox{\ifnum\language=\languageNGerman%
2287 % \meta{Höhe}\else\meta{height}\fi}}{\mbox{\tt\#2}-1}$}}
2288 % \end{picture}
2289 % \end{center}
2290 %
2291 % \ifnum\language=\languageNGerman%
2292 % \begin{tExample}
2293 % \begin{verbatimwrite}{struktex.tmp}
2294 % \begin{struktogramm}(95,30)
2295 % \case[10]{4}{3}{Signum(x)}{-1}
2296 % \assign{\(z \gets - \frac{1}{x}\)}
2297 % \switch{0}
2298 % \assign{Ausgabe: Division durch 0}
2299 % \switch{1}
2300 % \assign{\(z \gets \frac{1}{x}\)}
2301 % \caseend
2302 % \end{struktogramm}
2303 % \end{verbatimwrite}
2304 % \else%
2305 % \begin{tExample}
2306 % \begin{verbatimwrite}{struktex.tmp}
2307 % \begin{struktogramm}(95,30)
2308 % \case[10]{4}{3}{Signum(x)}{-1}
2309 % \assign{\(z \gets - \frac{1}{x}\)}
2310 % \switch{0}
2311 % \assign{Output: Division by 0}
2312 % \switch{1}
2313 % \assign{\(z \gets \frac{1}{x}\)}
2314 % \caseend
2315 % \end{struktogramm}
2316 % \end{verbatimwrite}%
2317 % \fi%
2318 % \begin{quote}
2319 % \verbatiminput{struktex.tmp}
2320 % \end{quote}
2321 % \ifnum\language=\languageNGerman%
2322 % Diese Anweisungen führen zu folgendem Struktogramm:
2323 % \else%
2324 % These instructions lead to the following structured box chart:%
2325 % \fi%
2326 % \begin{quote}
2327 % \input{struktex.tmp}
2328 % \end{quote}
2329 % \end{tExample}
2330 %
2331 % \ifnum\language=\languageNGerman%
2332 % Ist der erste Parameter hingegen ungerade, wird ein Standardzweig
2333 % gezeichnet; der Wert für den Standardfall sollte dann rechtsbündig
2334 % ausgerichtet werden.
2335 % \begin{tExample}
2336 % \begin{verbatimwrite}{struktex.tmp}
2337 % \begin{struktogramm}(95,30)
2338 % \case[10]{5}{3}{Signum(x)}{-1}
2339 % \assign{\(z \gets - \frac{1}{x}\)}
2340 % \switch{1}
2341 % \assign{\(z \gets \frac{1}{x}\)}
2342 % \switch[r]{0}
2343 % \assign{Ausgabe: Division durch 0}
2344 % \caseend
2345 % \end{struktogramm}
2346 % \end{verbatimwrite}
2347 % \else%
2348 % But if the first parameter is odd, then a default branch is drawn; the
2349 % value for the default branch should be set flushed right.
2350 % \begin{tExample}
2351 % \begin{verbatimwrite}{struktex.tmp}
2352 % \begin{struktogramm}(95,30)
2353 % \case[10]{5}{3}{Signum(x)}{-1}
2354 % \assign{\(z \gets - \frac{1}{x}\)}
2355 % \switch{1}
2356 % \assign{\(z \gets \frac{1}{x}\)}
2357 % \switch{0}
2358 % \assign{Output: Division by 0}
2359 % \caseend
2360 % \end{struktogramm}
2361 % \end{verbatimwrite}%
2362 % \fi%
2363 % \begin{quote}
2364 % \verbatiminput{struktex.tmp}
2365 % \end{quote}
2366 % \ifnum\language=\languageNGerman%
2367 % Diese Anweisungen führen zu folgendem Struktogramm:
2368 % \else%
2369 % These instructions lead to the following structured box chart:%
2370 % \fi%
2371 % \begin{quote}
2372 % \input{struktex.tmp}
2373 % \end{quote}
2374 % \end{tExample}
2375 %
2376 % \changes{v-9.2}{10/01/18}{changed the selection of languages}
2377 % \ifnum\language=\languageNGerman%
2378 % Das folgende Beispiel zeigt, wie mittels einfacher Verzweigung aus einer
2379 % Endlosschleife gesprungen werden kann. Das Beispiel lässt sich ohne
2380 % weiteres auf eine mehrfache Verzweigung übertragen.
2381 % \begin{verbatimwrite}{struktex.tmp}
2382 % \begin{struktogramm}(95,40)
2383 % \forever
2384 % \assign{lies Zeichen}
2385 % \ifthenelse{3}{3}{Zeichen = 'E'?}
2386 % {j}{n}
2387 % \exit{Sprung hinter Schleife}
2388 % \change
2389 % \ifend
2390 % \assign{Gib Zeichen aus}
2391 % \foreverend
2392 % \end{struktogramm}
2393 % \end{verbatimwrite}
2394 % \else%
2395 % The following example shows, how one can exit a neverending loop by a simple
2396 % branch. The example is transferable to a multiple branch without much effort.
2397 % \begin{verbatimwrite}{struktex.tmp}
2398 % \begin{struktogramm}(95,40)
2399 % \forever
2400 % \assign{read character}
2401 % \ifthenelse{3}{3}{character = 'E'}
2402 % {y}{n}
2403 % \exit{Jump behind the Loop}
2404 % \change
2405 % \ifend
2406 % \assign{Put out Character}
2407 % \foreverend
2408 % \end{struktogramm}
2409 % \end{verbatimwrite}%
2410 % \fi%
2411 % \begin{tExample}
2412 % \ifnum\language=\languageNGerman%
2413 % \begin{quote}
2414 % \verbatiminput{struktex.tmp}
2415 % \end{quote}
2416 % Diese Anweisungen führen zu folgendem Struktogramm:
2417 % \else%
2418 % \begin{quote}
2419 % \verbatiminput{struktex.tmp}
2420 % \end{quote}
2421 % These instructions lead to the following structured box chart:%
2422 % \fi%
2423 % \begin{quote}
2424 % \input{struktex.tmp}
2425 % \end{quote}
2426 % \end{tExample}
2427 %
2428 % \changes{v-9.2}{10/01/18}{corrected some typos}
2429 % \changes{v-9.1}{10/01/17}{added first draft of of `inparallel, `task, and `inparallelend documentation}
2430 % \DescribeMacro{\inparallel}
2431 % \DescribeMacro{\task}
2432 % \DescribeMacro{\inparallelend}
2433 % \changes{v065}{10/06/07}{added some german translations}
2434 % \ifnum\language=\languageNGerman%
2435 % Heutzutage sind Prozessoren mit mehreren Kernen oder auch massive
2436 % Parallelrechner ein übliches Werkzeug zur Ausführung von Programmen. Um
2437 % die Fähigkeiten dieser Prozessoren auszunutzen, sollten entsprechende
2438 % parallele Algorithmen entwickelt und implementiert werden. Der Makro
2439 % \cs{inparallel} und die zugehörigen Makros \cs{task} und
2440 % \cs{inparallelend} ermöglichen die Darstellung paralleler Verarbeitung in
2441 % einem Programm. Die Syntax lautet:
2442 % \begin{quote}\obeylines
2443 % \cs{inparallel}\oarg{Höhe der 1. Task}\marg{Anzahl paralleler
2444 % Tasks}\marg{Beschreibung der 1. Task}|}|
2445 % \cs{task}\oarg{position}\marg{Beschreibung der 2. Task}
2446 % \dots
2447 % \cs{task}\oarg{position}\marg{Beschreibung der n. Task}
2448 % \cs{inparallelend}
2449 % \end{quote}
2450 %
2451 % Das Layout eines mit diesen Kommandos erzeugten Kastens ist der folgenden
2452 % Abbildung zu entnehmen (die Makroparameter \texttt{\#1}
2453 % und \texttt{\#2} beziehen sich auf die Parameter von \cs{inparallel}):
2454 % \else%
2455 % Nowadays multicore processors or even better massive parallel processors
2456 % are a common tool for executing programs. To use the features of these
2457 % processors parallel algorithms should be developed and implemented. The
2458 % \cs{inparallel} command enables the representation of parallel processing
2459 % in a program. The syntax is as follows:
2460 % \begin{quote}\obeylines
2461 % \cs{inparallel}\oarg{height of 1\(^{\mbox{st}}\) task}\marg{number of
2462 % parallel tasks}\marg{description of 1\(^{\mbox{st}}\) task}|}|
2463 % \cs{task}\oarg{position}\marg{description of 2\(^{\mbox{nd}}\) task}
2464 % \dots
2465 % \cs{task}\oarg{position}\marg{description of n\(^{\mbox{th}}\) task}
2466 % \cs{inparallelend}
2467 % \end{quote}
2468 %
2469 % The layout of the box is as follows (the macro parameters \texttt{\#1}
2470 % and \texttt{\#2} refer to the parameters of \cs{inparallel}):%
2471 % \fi%
2472 %
2473 % \changes{v065}{10/06/07}{changed figure which shows `inparallel layout}
2474 % \begin{center}
2475 % \label{fig:case3}
2476 % \unitlength 1.00mm
2477 % \linethickness{0.4pt}
2478 % \begin{picture}(90.00,40.00)
2479 % \put(9.00,5.00){\framebox(75.00,30.00)[cc]{}}
2480 % \put(9.00,36.00){\line(0,1){4.00}}
2481 % \put(9.00,38.00){\line(1,0){27.50}}
2482 % \put(46.50,38.00){\makebox(0,0)[cc]{\cs{xsize@nss}}}
2483 % \put(55.00,38.00){\line(1,0){27.50}}
2484 % \put(84.00,36.00){\line(0,1){4.00}}
2485 % \put(0.00,35.00){\line(1,0){4.00}}
2486 % \put(2.00,35.00){\line(0,-1){10.00}}
2487 % \put(2.00,15.00){\line(0,-1){10.00}}
2488 % \put(0.00,5.00){\line(1,0){4.00}}
2489 % \put(2.00,20.00){\makebox(0,0)[cc]{%
2490 % \shortstack{%
2491 % \ifnum\language=\languageNGerman\meta{Höhe}\else\meta{height}\fi\\\texttt{\#1}}}}
2492 % \put(21.00,20.00){\makebox(0,0)[cc]{%
2493 % \shortstack{%
2494 % \ifnum\language=\languageNGerman\meta{Beschreibung\(_1\)}%
2495 % \else\meta{desc\(_1\)}\fi\\\texttt{\#2}}}}
2496 % \put(46.50,20.00){\makebox(0,0)[cc]{%
2497 % \ifnum\language=\languageNGerman\meta{Beschreibung\(_{\ldots}\)}\else\meta{desc\(_{\ldots}\)}\fi}}
2498 % \put(71.50,20.00){\makebox(0,0)[cc]{%
2499 % \ifnum\language=\languageNGerman\meta{Beschreibung\(_n\)}\else\meta{desc\(_n\)}\fi}}
2500 % \put(34.00,11.67){\line(0,1){16.66}} ^^A vertical bars between descriptions
2501 % \put(59.00,11.67){\line(0,1){16.66}}
2502 % \put(9.00,0.00){\line(0,1){4.00}}
2503 % \put(9.00,2.00){\line(1,0){2.00}}
2504 % \put(34.00,0.00){\line(0,1){4.00}}
2505 % \put(34.00,2.00){\line(-1,0){2.00}}
2506 % \put(21.00,2.00){\makebox(0,0)[cc]{$\frac{\mbox{\cs{xsize@nss}}}{\mbox{\tt\#1}}$}}
2507 % \multiput(10.00,28.33)(3.00, 0.0){25}{\line(1,0){1.5}}
2508 % \multiput(10.00,31.66)(3.00, 0.0){25}{\line(1,0){1.5}}
2509 % \multiput(10.00,11.67)(3.00, 0.0){25}{\line(1,0){1.5}}
2510 % \multiput(10.00,8.34)(3.00, 0.0){25}{\line(1,0){1.5}}
2511 % \put(86.00,35.00){\line(1,0){4.00}} ^^A measuring at the right side
2512 % \put(86.00,28.33){\line(1,0){4.00}}
2513 % \put(88.00,34.00){\line(0,-1){1.00}}
2514 % \put(88.00,28.33){\line(0,1){1.00}}
2515 % \put(88.00,31.66){\makebox(0,0)[cc]{4\,mm}}
2516 % \end{picture}
2517 % \end{center}
2518 %
2519 % \ifnum\language=\languageNGerman%
2520 % Zu beachten ist, dass die verschiedenen Tasks nicht weiter gegliedert
2521 % werden dürfen.
2522 % \else%
2523 % Note: the tasks are not allowed to get divided by \cs{assign} or so. If
2524 % one needs some finer description of a task, this should be made outside
2525 % of the current structured box chart.%
2526 % \fi%
2527 %
2528 % \changes{v-9.2}{10/01/18}{added example for `inparallel}
2529 % \begin{tExample}[\ifnum\language=\languageNGerman%
2530 % Anwendung von \cs{inparallel}\else Application of \cs{inparallel}\fi]
2531 % \ifnum\language=\languageNGerman%
2532 % \begin{verbatimwrite}{struktex.tmp}
2533 % \begin{struktogramm}(95,40)
2534 % \inparallel[20]{3}{Motor starten}
2535 % \task{Wasser einfüllen}
2536 % \task{Wasser erhitzen}
2537 % \inparallelend
2538 % \end{struktogramm}
2539 % \end{verbatimwrite}
2540 % \begin{quote}
2541 % \verbatiminput{struktex.tmp}
2542 % \end{quote}
2543 % Diese Anweisungen ergeben das folgende Struktogramm:
2544 % \else%
2545 % \begin{verbatimwrite}{struktex.tmp}
2546 % \begin{struktogramm}(95,40)
2547 % \inparallel[20]{3}{start motor}
2548 % \task{fill in water}
2549 % \task{heat water}
2550 % \inparallelend
2551 % \end{struktogramm}
2552 % \end{verbatimwrite}
2553 % \begin{quote}
2554 % \verbatiminput{struktex.tmp}
2555 % \end{quote}
2556 % These instructions produce the following structured box chart:%
2557 % \fi%
2558 % \begin{quote}
2559 % \input{struktex.tmp}
2560 % \end{quote}
2561 % \end{tExample}
2562 %
2563 % \DescribeEnv{centernss}
2564 % \label{sec:centernss}
2565 % \ifnum\language=\languageNGerman%
2566 % Soll ein Struktogramm zentriert dargestellt werden, so wird dazu die
2567 % Umgebung
2568 % \else%
2569 % If a structured box chart shall be represented centered, then the environment%
2570 % \fi%
2571 % \begin{quote}\obeylines
2572 % \envb{centernss}
2573 % ~~~~\meta{Struktogramm}
2574 % \enve{centernss}
2575 % \end{quote}
2576 % \ifnum\language=\languageNGerman%
2577 % benutzt:
2578 % \begin{verbatimwrite}{struktex.tmp}
2579 % \begin{centernss}
2580 % \begin{struktogramm}(90,35)
2581 % \ifthenelse{2}{4}
2582 % {Flag für Drucker-Ausgabe gesetzt?}{\sTrue}{\sFalse}%
2583 % \assign[20]{Ausgabe auf Drucker umleiten}
2584 % \change
2585 % \assign{Ausgabe auf den Bildschirm}
2586 % \ifend
2587 % \end{struktogramm}
2588 % \end{centernss}
2589 % \end{verbatimwrite}
2590 % \else%
2591 % is used:
2592 % \begin{verbatimwrite}{struktex.tmp}
2593 % \begin{centernss}
2594 % \begin{struktogramm}(90,35)
2595 % \ifthenelse{2}{4}
2596 % {Is Flag for Output on Printer set?}{\sTrue}{\sFalse}%
2597 % \assign[20]{Output on Printer diverted}
2598 % \change
2599 % \assign{Output on Screen}
2600 % \ifend
2601 % \end{struktogramm}
2602 % \end{centernss}
2603 % \end{verbatimwrite}%
2604 % \fi%
2605 % \begin{quote}
2606 % \verbatiminput{struktex.tmp}
2607 % \end{quote}
2608 % \ifnum\language=\languageNGerman%
2609 % Das führt zu folgendem:
2610 % \else%
2611 % This leads to the following:%
2612 % \fi%
2613 % \begin{quote}
2614 % \input{struktex.tmp}
2615 % \end{quote}
2616 %
2617 % \DescribeMacro{\CenterNssFile}
2618 % \ifnum\language=\languageNGerman%
2619 % Häufig gibt es den Fall, dass Struktogramme in eigenen Dateien abgelegt
2620 % werden, damit sie für sich allein auf Korrektheit getestet werden
2621 % können oder in anderen Zusammenhängen genutzt werden können.
2622 % Sollen sie zentriert eingebunden werden, kann nicht mit der folgenden
2623 % Konstruktion gearbeitet werden:
2624 % \else%
2625 % In many cases structured box charts are recorded in particular files such, that
2626 % they can be tested seperately, if they are correct, or that they can be used
2627 % in other connections. If they should be included centeredly, then one can not
2628 % use the following construction:%
2629 % \fi%
2630 % \begin{verbatimwrite}{struktex.tmp}
2631 % \begin{center}
2632 % \input{...}
2633 % \end{center}
2634 % \end{verbatimwrite}
2635 % \begin{quote}
2636 % \verbatiminput{struktex.tmp}
2637 % \end{quote}
2638 % \changes{v3.0a}{25/06/20}{corrected last(?) glitches}
2639 % \ifnum\language=\languageNGerman%
2640 % da auf diese Weise der gesamte Text innerhalb des Struktogramms zentriert
2641 % würde. Um diesen Fall einfach und korrekt abhandeln zu können, kann das
2642 % Makro \cs{CenterNssFile} eingesetzt werden, das auch in der Schreibweise
2643 % |centernssfile| definert ist. Voraussetzung ist, dass die Datei,
2644 % die die Anweisungen für das Struktogramm enthält, die
2645 % Dateinamenserweiterung |.nss| hat, der Name der einzubindenden Datei
2646 % \emph{muss} demzufolge ohne Erweiterung angegeben werden. Wenn die Datei
2647 % \sFile{struktex-tst-00.nss} das in \vref{sec:sample}, Zeile 61--68 gezeigte
2648 % Aussehen hat, so führt die Anweisung
2649 % \else%
2650 % since this way the whole text in structured box chart would be centered.
2651 % To deal with this case in a simple and correct way the macro \cs{CenterNssFile}
2652 % can be used. It is also defined in the style |centernssfile|. This requires, that the
2653 % file containing the instructions for the structured box chart has the file name
2654 % extension |.nss|. That is why the name of the file, that has to be tied in,
2655 % \emph{must} be stated without extension. If the file \sFile{struktex-tst-00.nss} has the shape
2656 % shown in \vref{sec:sample}, line 61--68 the instruction%
2657 % \fi%
2658 % \begin{quote}
2659 % |\centernssfile{struktex-tst-00}|
2660 % \end{quote}
2661 % \ifnum\language=\languageNGerman%
2662 % zu folgendem Aussehen des formatierten Textes:
2663 % \else%
2664 % leads to the following shape of the formatted text:%
2665 % \fi%
2666 % \bgroup\catcode`\%=14\centernssfile{struktex-tst-00}\egroup%
2667 % \label{sec:centernssfile}
2668 %
2669 % \DescribeMacro{\openstrukt}
2670 % \DescribeMacro{\closestrukt}
2671 % \ifnum\language=\languageNGerman%
2672 % Diese beiden Makros sind nur der Kompatibilität zu vorherigen Versionen
2673 % von \StrukTeX\ willen noch erhalten. Von der Bedeutung her entsprechen sie
2674 % \cs{struktogramm} und \cs{endstruktogramm}. Die Syntax ist
2675 % \else%
2676 % These two macros are only preserved because of compatibility reasons with
2677 % previous versions of \StrukTeX. Their meaning is the same as \cs{struktogramm}
2678 % and \cs{endstruktogramm}. The syntax is%
2679 % \fi%
2680 % \begin{quote}
2681 % \cs{openstrukt}\marg{\ifnum\language=\languageNGerman Breite \else width
2682 % \fi}\marg{\ifnum\language=\languageNGerman Höhe \else height \fi}
2683 % \end{quote}
2684 % \ifnum\language=\languageNGerman%
2685 % und
2686 % \else%
2687 % and%
2688 % \fi%
2689 % \begin{quote}
2690 % \cs{closestrukt}.
2691 % \end{quote}
2692 %
2693 %
2694 % \DescribeMacro{\assert}%
2695 % \ifnum\language=\languageNGerman%
2696 % Der Makro \cs{assert} wurde eingeführt, um die Verifikation von
2697 % Algorithmen zu unterstützen, er ist aber nur aktiv, wenn die Stil-Option
2698 % |verification| gesetzt wurde. Er dient dazu, an ausgewählten Stellen
2699 % Zusicherungen über den Zustand von Variablen zu markieren, die Syntax
2700 % entspricht dem \cs{assign}:
2701 % \begin{quote}
2702 % \cs{assert}\oarg{Höhe}\marg{Zusicherung},
2703 % \end{quote}
2704 % Sein Einsatz ergibt sich aus dem folgenden:
2705 % \begin{verbatimwrite}{struktex.tmp}
2706 % \begin{struktogramm}(70,20)[Zusicherungen in Struktogrammen]
2707 % \assign{\(a\gets a^2\)}
2708 % \assert{\(a\ge0\)}
2709 % \end{struktogramm}
2710 % \end{verbatimwrite}
2711 % \begin{quote}
2712 % \verbatiminput{struktex.tmp}
2713 % \end{quote}
2714 % Das dazugehörige Struktogramm sieht folgendermaßen aus:
2715 % \begin{quote}
2716 % \input{struktex.tmp}
2717 % \end{quote}%
2718 % \else%
2719 % The macro \cs{assert} was introduced to support the verification of
2720 % algorithms. It is active only if the option |verification| is set. It
2721 % serves the purpose to assert the value of a variable at one point of the
2722 % algorithm. The syntax corresponds to the syntax of \cs{assign}:
2723 % \begin{quote}
2724 % \cs{assert}\oarg{height}\marg{assertion},
2725 % \end{quote}
2726 % It's usage can be seen from the following:
2727 % \begin{verbatimwrite}{struktex.tmp}
2728 % \begin{struktogramm}(70,20)[Assertions in structured box charts]
2729 % \assign{\(a\gets a^2\)}
2730 % \assert{\(a\ge0\)}
2731 % \end{struktogramm}
2732 % \sProofOff
2733 % \end{verbatimwrite}
2734 % \begin{quote}
2735 % \verbatiminput{struktex.tmp}
2736 % \end{quote}
2737 % The resulting structured box chart looks like
2738 % \begin{quote}
2739 % \input{struktex.tmp}
2740 % \end{quote}%
2741 % \fi
2742 %
2743 %
2744 % \subsection{\ifnum\language=\languageNGerman Spezielle Zeichen und Textdarstellung
2745 % \else Specific characters and text representation
2746 % \fi}
2747 % \label{sec:spez-zeichen}
2748 %
2749 % \changes{v3.0}{25/06/19}{extended documentation of the use of the package struktxf}
2750 %
2751 % \DescribeMacro{\nat}
2752 % \DescribeMacro{\integer}
2753 % \DescribeMacro{\real}
2754 % \DescribeMacro{\complex}
2755 % \DescribeMacro{\emptyset}
2756 % \ifnum\language=\languageNGerman%
2757 % Wegen ihres häufigen Auftretens sind die Mengen der natürlichen,
2758 % ganzen, rationalen,
2759 % reellen und komplexen Zahlen (\(\nat\), \(\integer\), \(\rational\), \(\real\) und \(\complex\))
2760 % im Mathematik-Modus über
2761 % die folgenden Makros erreichbar: \cs{nat}, \cs{integer}, \cs{real} und \cs{complex}.
2762 % Ebenso ist das mit \cs{emptyset} erzeugte
2763 % "`\(\emptyset\)"' als Zeichen für die leere Anweisung auffälliger als
2764 % das standardmäßige Zeichen "`$\mathchar"023B$"'
2765 % Andere Mengensymbole wie \(\mathbb L\) (für Lösungsmenge) sind über
2766 % |\(\mathbb L\)| zu
2767 % erzeugen.
2768 % \else%
2769 % Since sets of natural, whole, real and complex numbers (\(\nat\), \(\integer\),
2770 % \(\real\) and \(\complex\)) occur often in the Mathematics Mode they can be
2771 % reached by the macros \cs{nat}, \cs{integer}, \cs{real} and \cs{complex}.
2772 % Similarly ``\(\emptyset\)'', which is generated by \cs{emptyset}, is the more
2773 % remarkable symbol for the empty statement than the standard symbol
2774 % ``$\mathchar"023B$''.
2775 % Other set symbols like \(\mathbb L\) (for solution space) have to be
2776 % generated by |\(\mathbb L\)|.%
2777 % \fi%
2778 %
2779 % \DescribeMacro{\MathItalics}
2780 % \DescribeMacro{\MathNormal}
2781 %
2782 % \changes{v3.0}{25/06/19}{documented the incompatibility of `MathItalics
2783 % and `bm}
2784 %
2785 % \ifnum\language=\languageNGerman%
2786 % Mit diesen beiden Makros kann die Darstellung von Variablennamen beeinflusst
2787 % werden:
2788 % \else%
2789 % One can influence the descriptions of variable names by these macros.%
2790 % \fi%
2791 % \ifnum\language=\languageNGerman%
2792 % \begin{example}
2793 % \MathNormal
2794 % \begin{equation}
2795 % NeuerWert = AlterWert + Korrektur
2796 % \label{eq:-neuerwert-N}
2797 % \end{equation}
2798 % \end{example}
2799 % und
2800 % \begin{example}
2801 % \MathItalics
2802 % \begin{equation}
2803 % NeuerWert = AlterWert + Korrektur
2804 % \label{eq:-neuerwert-I}
2805 % \end{equation}
2806 % \end{example}
2807 % \else%
2808 % \begin{example}
2809 % \MathNormal
2810 % \begin{equation}
2811 % NewValue = OldValue + Correction
2812 % \label{eq:-neuerwert-N}
2813 % \end{equation}
2814 % \end{example}
2815 % and
2816 % \begin{example}
2817 % \MathItalics
2818 % \begin{equation}
2819 % NewValue = OldValue + Correction
2820 % \label{eq:-neuerwert-I}
2821 % \end{equation}
2822 % \end{example}%
2823 % \fi%
2824 % \ifnum\language=\languageNGerman%
2825 % Diese Kommandos sind in einem eigenen Paket \textsf{struktxf.sty}
2826 % definiert, das wie üblich geladen werden kann:
2827 % \begin{quote}
2828 % |\usepackage[|\meta{Optionen}|]{struktxf}|
2829 % \end{quote}
2830 % \else%
2831 % These commands are defined in a separate package \textsf{struktxf.sty},
2832 % which can be loaded as usual:
2833 % \begin{quote}
2834 % |\usepackage[|\meta{options}|]{struktxf}|
2835 % \end{quote}%
2836 % \fi%
2837 % \ifnum\language=\languageNGerman%
2838 % Die folgenden Optionen stehen zur Verfügung:
2839 % \begin{enumerate}
2840 % \item |iso|:
2841 %
2842 % Diese Option legt die Darstellung von Zahlenmengen in Übereinstimmung
2843 % mit ISO 80\,000-2 fest. Ist sie gesetzt,
2844 % werden die Zahlenmengen durch fette Großbuchstaben wie \(\mathbf{Q}\)
2845 % dargestellt, ansonsten durch Zeichen aus dem |\mathbb| Zeichensatz
2846 % wie \(\rational\). Der Standardwert ist |iso=false|.
2847 % \item |mathitalics|:
2848 %
2849 % Das Setzen dieser Option führt dazu, dass Zuweisungen, wie sie bei
2850 % der Beschreibung von Algorithmen auftreten, statt wie in
2851 % \vref{eq:-neuerwert-N} so wie in
2852 % \vref{eq:-neuerwert-I} dargestellt werden.
2853 %
2854 % Es muss darauf hingewiesen werden, dass diese Option mit den
2855 % Befehlen |\boldsymbol{...}| (aus \textsf{amsmath.sty})
2856 % bzw. |\bm{...}| (aus \textsf{bm.sty}) inkompatibel ist, vor diesen
2857 % Befehlen |\MathNormal| aktiviert werden muss.
2858 % \end{enumerate}
2859 % \else%
2860 % The following options are available:
2861 % \begin{enumerate}
2862 % \item |iso|:
2863 %
2864 % This option specifies the representation of numerical quantities
2865 % in accordance with ISO 80\,000-2. If it is set, the numerical
2866 % quantities are represented by bold capital letters such as
2867 % \(\mathbf{Q}\), otherwise by characters from the |\mathbb|
2868 % character set such as \(\rational\). The default value is
2869 % |iso=false|.
2870 % \item |mathitalics|:
2871 %
2872 % Setting this option results in assignments, such as those
2873 % occurring in of the description of algorithms, being displayed as
2874 % in \vref{eq:-newvalue-N} instead of \vref{eq:-newvalue-I}.
2875 %
2876 % It should be noted that this option is incompatible with the
2877 % commands |\boldsymbol{...}| (from \textsf{amsmath.sty}) or
2878 % |\bm{...}| (from \textsf{bm.sty}) and therefore |\MathNormal|
2879 % must be activated before these commands.
2880 % \end{enumerate}
2881 % \fi%
2882 %
2883 %
2884 % \subsection{\ifnum\language=\languageNGerman Makros zur Darstellung von
2885 % Variablen, Schlüsselwörtern und anderen programmierspezifischen
2886 % Details \else Macros for representing variables, keywords and other
2887 % programming-specific details\fi% }
2888 % \label{sec:makros-variablen}
2889 %
2890 % \DescribeMacro{\pVariable}
2891 % \DescribeMacro{\pVar}
2892 % \ifnum\language=\languageNGerman%
2893 % \changes{v-2.0n}{94/03/31}{Dokumentation überarbeitet}
2894 % \else%
2895 % \changes{v-2.0n}{94/03/31}{documentation changed}%
2896 % \fi%
2897 % \DescribeMacro{\pKeyword}
2898 % \DescribeMacro{\pKey}
2899 % \DescribeMacro{\pComment}
2900 % \changes{v131}{10/09/21}{changed location of documentation of new use of
2901 % struktxp.sty}
2902 % \changes{v130}{10/09/21}{enhanced the description of using source code}
2903 % \ifnum\language=\languageNGerman%
2904 % Struktogramme enthalten manchmal direkt zu programmierenden Code.
2905 % Um hier ein einheitliches Aussehen zu erreichen, sind die hier
2906 % aufgeführten Makros definiert worden. Um diese Makros auch in anderem
2907 % Zusammenhang nutzen zu können, sind sie zu einem eigenen
2908 % \foreign{package} \sFile{struktxp.sty} zusammengefasst worden. Dabei
2909 % wird ab Version 122 zur Darstellung von Code auf das Paket
2910 % "`\sFile{url.sty}"' von Donald Arsenau zurückgegriffen, das es
2911 % ermöglicht, verbatim gesetzte Texte als Parameter an ein anderes Makro zu
2912 % übergeben. Wenn diese Texte ein Leerzeichen enthalten, das erhalten
2913 % bleiben soll, muss der Benutzer vor dem Laden von \sFile{url.sty},
2914 % typischerweise also vor der Anweisung
2915 % \begin{quote}
2916 % |\usepackage{struktex}|
2917 % \end{quote}
2918 % die Anweisung
2919 % \begin{quote}
2920 % |\PassOptionsToPackage{obeyspaces}{url}|
2921 % \end{quote}
2922 % setzen.
2923 % \else%
2924 % Structured box charts sometimes include code, that has to be programmed
2925 % directly. For achieving a homogenous appearance the mentioned macros have
2926 % been defined. They have been collected in a separate package
2927 % \sFile{struktxp.sty} to be able to use them in another context. From
2928 % version 122 on \sFile{struktxp.sty} is based on "\sFile{url.sty}" of
2929 % Donald Arsenau. This package makes allows to pass verbatim texts as
2930 % parameters to other macros. If this verbatim stuff contains blank spaces,
2931 % which should be preserved, the user has to execute the command
2932 % \begin{quote}
2933 % |\PassOptionsToPackage{obeyspaces}{url}|
2934 % \end{quote}
2935 % before \sFile{url.sty} is loaded, that is in most of the cases before
2936 % the command
2937 % \begin{quote}
2938 % |\usepackage{struktex}|
2939 % \end{quote}%
2940 % \fi%
2941 %
2942 % \ifnum\language=\languageNGerman%
2943 % Mit |\pVariable{|\meta{Variablenname}|}| wird ein Variablenname gesetzt.
2944 % \meta{Variablenname} ist dabei ein Bezeichner eine Variable, wobei der
2945 % Unterstrich "`|_|"', das kaufmännische Und "`|&|"' und das Dach "`|^|"'
2946 % als Teile des Variablennamens erlaubt sind:
2947 % \else%
2948 % Variable names are set by |\pVariable{|\meta{VariableName}|}|.
2949 % There \meta{VariableName} is an identifier of a variable, whereby the underline
2950 % ``|_|'', the ampersand ``|&|'' and the hat ``|^|'' are allowed to be parts
2951 % of variables:%
2952 % \fi%
2953 % \ifnum\language=\languageNGerman%
2954 % \pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}
2955 % \begin{example}\obeylines
2956 % \renewcommand{\pLanguage}{C}
2957 % \pVariable{cEineNormaleVariable}
2958 % \pVariable{c_eine_normale_Variable}
2959 % \pVariable{&iAdresseEinerVariablen}
2960 % \renewcommand{\pLanguage}{Pascal}
2961 % \pVariable{zZeigerAufEineVariable^.sInhalt}
2962 % \end{example}
2963 % \else%
2964 % \pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}
2965 % \begin{example}\obeylines
2966 % \pVariable{cANormalVariable}
2967 % \pVariable{c_a_normal_variable}
2968 % \pVariable{&iAddressOfAVariable}
2969 % \pVariable{pPointerToAVariable^.sContent}
2970 % \end{example}%
2971 % \fi%
2972 % \ifnum\language=\languageNGerman%
2973 % Leerzeichen werden beachtet, so dass ganze Anweisungen geschrieben werden
2974 % können.
2975 % Es darf als Abkürzung \cs{pVar} benutzt werden.
2976 % \else%
2977 % Blanks are considered such, that whole statements can be written.
2978 % For abbreviation it is allowed to use \cs{pVar}.%
2979 % \fi%
2980 %
2981 % \ifnum\language=\languageNGerman%
2982 % Entsprechend wird mit |\pKeyword{|\meta{Schlüsselwort}|}| ein Schlüsselwort
2983 % gesetzt.
2984 % Dabei ist \meta{Schlüsselwort} ein Schlüsselwort in einer
2985 % Programmiersprache, wobei der Unterstrich "`|_|"' und das
2986 % \foreign{hash}-Zeichen "`|#|"' als Teil des Schlüsselwortes
2987 % erlaubt ist. Damit lässt sich setzen:
2988 % \else%
2989 % A keyword is set by |\pKeyword{|\meta{keyword}|}| respectively.
2990 % There \meta{keyword} is a keyword in a programming language, whereby
2991 % the underline ``|_|'' and the number sign ``|#|'' are allowed to be
2992 % parts of keywords. Therewith the following can be set:%
2993 % \fi%
2994 % \begin{example}\obeylines
2995 % \pKeyword{begin}
2996 % \renewcommand{\pLanguage}{Pascal}
2997 % \pKeyword{program}
2998 % \renewcommand{\pLanguage}{C}
2999 % \pKeyword{#include}
3000 % \end{example}
3001 % \ifnum\language=\languageNGerman%
3002 % Auch \cs{pKeyword} darf
3003 % abgekürzt werden: \cs{pKey}. Damit erzeugt dann der Quelltext
3004 % \else%
3005 % \cs{pKeyword} is also allowed to be abbreviated by \cs{pKey}. With that the
3006 % source code%
3007 % \fi%
3008 % \begin{verbatimwrite}{struktex.tmp}
3009 % \renewcommand{\pLanguage}{Pascal}
3010 % \pKey{begin} \pExp{iVar := iVar + 1;} \pKey{end}
3011 % \end{verbatimwrite}
3012 % \begin{quote}
3013 % \verbatiminput{struktex.tmp}
3014 % \end{quote}
3015 % \ifnum\language=\languageNGerman%
3016 % als Ausgabe dieses Ergebnis:
3017 % \else%
3018 % generates the following result as output:%
3019 % \fi%
3020 % \begin{quote}
3021 % \input{struktex.tmp}
3022 % \end{quote}
3023 %
3024 % \ifnum\language=\languageNGerman%
3025 % In ähnlicher Weise dient \cs{pComment} zur Darstellung von Kommentar.
3026 % Das Argument darf nur Zeichen der \TeX-Kategorie \foreign{letter}
3027 % haben, Zeichen, die einen Kommentar einleiten, müssen geschrieben
3028 % werden. \cs{pComment} kann nicht abgekürzt werden.
3029 % Beispielsweise ergibt
3030 % \else%
3031 % In a similar way \cs{pComment} is of representation purposes of comments.
3032 % The argument is only allowed to consist of characters of the
3033 % category \foreign{letter}. Characters, that start a comment, have to be written.
3034 % \cs{pComment} can't be abbreviated. For instance%
3035 % \fi%
3036 % \begin{verbatimwrite}{struktex.tmp}
3037 % \pExp{a = sqrt(a);} \pComment{// Iteration}
3038 % \end{verbatimwrite}
3039 % \begin{quote}
3040 % \verbatiminput{struktex.tmp}
3041 % \end{quote}
3042 % \ifnum\language=\languageNGerman%
3043 % die Zeile
3044 % \else%
3045 % results in the line%
3046 % \fi%
3047 % \begin{quote}
3048 % \input{struktex.tmp}
3049 % \end{quote}
3050 %
3051 % \DescribeMacro{\pTrue}
3052 % \DescribeMacro{\pFalse}
3053 % \ifnum\language=\languageNGerman%
3054 % Logische Werte spielen in der Programmierung eine wesentliche Rolle.
3055 % Mit \cs{pTrue} und \cs{pFalse} sind entsprechende Werte vorgegeben:
3056 % \pTrue\ und \pFalse.
3057 % \else%
3058 % Boolean values play an importand role in programming. There are given
3059 % adequate values by \cs{pTrue} and \cs{pFalse}: \pTrue\ and \pFalse.%
3060 % \fi%
3061 %
3062 % \DescribeMacro{\pFonts}
3063 % \DescribeMacro{\pBoolValue}
3064 % \ifnum\language=\languageNGerman%
3065 % Der Makro \cs{pFonts} dient der Auswahl von Fonts zur Darstellung von
3066 % Variablen, Schlüsselwörtern und Kommentar:
3067 % \begin{quote}
3068 % |\pFonts{|\meta{Variablenfont}|}{|\meta{Schlüsselwortfont}|}|%
3069 % |{|\meta{Kommentarfont}|}|
3070 % \end{quote}
3071 % \else%
3072 % The macro \cs{pFonts} is used for the choice of fonts for representation of
3073 % variables, keywords and comments:
3074 % \begin{quote}
3075 % |\pFonts{|\meta{variablefont}|}{|\meta{keywordfont}|}|%
3076 % |{|\meta{commentfont}|}|
3077 % \end{quote}%
3078 % \fi%
3079 % \ifnum\language=\languageNGerman%
3080 % Vorbesetzt sind die einzelnen Fonts mit
3081 % \begin{itemize}
3082 % \item \meta{Variablenfont} als |\small\sffamily|,
3083 %
3084 % \item \meta{Schlüsselwortfont} als |\small\sffamily\bfseries| und
3085 %
3086 % \item \meta{Kommentarfont} als |\small\sffamily\slshape|.
3087 %
3088 % \end{itemize}
3089 % \else%
3090 % The default values for the certain fonts are
3091 % \begin{itemize}
3092 % \item \meta{variablefont} as |\small\sffamily|,
3093 %
3094 % \item \meta{keywordfont} as |\small\sffamily\bfseries| and
3095 %
3096 % \item \meta{commentfont} as |\small\sffamily\slshape|.
3097 %
3098 % \end{itemize}%
3099 % \fi%
3100 % \ifnum\language=\languageNGerman%
3101 % Damit wird die obige Zeile nach
3102 % \else%
3103 % With that the above line%
3104 % \fi%
3105 % \ifnum\language=\languageNGerman%
3106 % \begin{verbatimwrite}{struktex.tmp}
3107 % \pFonts{\itshape}{\sffamily\bfseries}{\scshape}
3108 % \pVar{a = }\pKey{sqrt}\pVar{(a);} \pComment{// Iteration}
3109 % \end{verbatimwrite}
3110 % \begin{quote}
3111 % \verbatiminput{struktex.tmp}
3112 % \end{quote}
3113 % zu
3114 % \else%
3115 % becomes%
3116 % \fi%
3117 % \begin{quote}
3118 % \input{struktex.tmp}
3119 % \end{quote}
3120 %
3121 % \changes{v130}{10/09/21}{removed unnecessary math mode}
3122 % \ifnum\language=\languageNGerman%
3123 % Entsprechend können durch den Makro
3124 % \begin{quote}
3125 % |\sBoolValue{|\meta{Ja-Wert}|}{|\meta{Nein-Wert}|}|
3126 % \end{quote}
3127 % die Werte von \cs{pTrue} und \cs{pFalse} umdefiniert werden. Somit
3128 % liefern die Zeilen
3129 % \begin{verbatimwrite}{struktex.tmp}
3130 % \renewcommand{\pLanguage}{Pascal}
3131 % \sBoolValue{\textit{ja}}{\textit{nein}}
3132 % \pFalse{} = \pKey{not} \pTrue
3133 % \end{verbatimwrite}
3134 % \else%
3135 % Similarly the values of \cs{pTrue} and \cs{pFalse} can be redefined by
3136 % the macro
3137 % \begin{quote}
3138 % |\sBoolValue{|\meta{Yes-Value}|}{|\meta{No-Value}|}|
3139 % \end{quote}
3140 % So the lines
3141 % \begin{verbatimwrite}{struktex.tmp}
3142 % \renewcommand{\pLanguage}{Pascal}
3143 % \sBoolValue{\textit{yes}}{\textit{no}}
3144 % \pFalse = \pKey{not} \pTrue
3145 % \end{verbatimwrite}%
3146 % \fi%
3147 % \begin{quote}
3148 % \verbatiminput{struktex.tmp}
3149 % \end{quote}
3150 % \ifnum\language=\languageNGerman%
3151 % das folgende Ergebnis:
3152 % \else%
3153 % result in the following:%
3154 % \fi%
3155 % \begin{quote}
3156 % \input{struktex.tmp}
3157 % \end{quote}
3158 %
3159 % \DescribeMacro{\sVar}
3160 % \DescribeMacro{\sKey}
3161 % \DescribeMacro{\sTrue}
3162 % \DescribeMacro{\sFalse}
3163 % \ifnum\language=\languageNGerman%
3164 % Die Makros \cs{sVar} und \cs{sKey} sind mit den Makros \cs{pVar} und \cs{pKey}
3165 % identisch, sie werden hier nur definiert, um Kompatibilität mit
3166 % früheren Versionen des \StrukTeXSty{} zu gewährleisten.
3167 % Dasselbe gilt auch für die Makros \cs{sTrue} und \cs{sFalse}.
3168 % \else%
3169 % The macros \cs{sVar} and \cs{sKey} are the same as the macros |pVar| and |pKey|.
3170 % Here they are just described for compatibility reasons with former versions
3171 % of \StrukTeXSty. The same rule shall apply to the macros \cs{sTrue} and
3172 % \cs{sFalse}.%
3173 % \fi%
3174 %
3175 %
3176 % \subsection{\ifnum\language=\languageNGerman%
3177 % Makros zur Erstellung der Dokumentation des \StrukTeXSty-Paketes
3178 % \else%
3179 % Macros for generating the documentation of the package \StrukTeXSty
3180 % \fi}
3181 %
3182 % \ifnum\language=\languageNGerman%
3183 % Um die Formatierung der Dokumentation ein wenig zu erleichtern, werden ein
3184 % paar Makros benutzt, die in einer eigenen \sFile{.sty}-Datei
3185 % zusammengefasst wurden. Ein wesentlicher Teil beruht auf einer
3186 % Modifikation der \texttt{newtheorem}-Umgebung aus \sFile{latex.sty} zur
3187 % Auszeichnung der Beispiele, die Implementation der Abkürzungen wurde in
3188 % \cite{Neubauer:MikrotypographieI} vorgeschlagen.
3189 % \else%
3190 % To simplify the formatting of the documentation some macros are used,
3191 % which are collected in a particular \sFile{.sty} file. An essential part
3192 % is based on a modification of the \texttt{newtheorem} environment out of
3193 % \sFile{latex.sty} for distinguishing examples. The implementation of
3194 % abbreviations has been proposed in \cite{Neubauer:MikrotypographieI}.%
3195 % \fi%
3196 %
3197 % \ifnum\language=\languageNGerman%
3198 % Dazu wurden aus dem \sFile{verbatim.sty} einige Kommandos übernommen
3199 % und modifiziert, damit das Schreiben und Lesen von Dateien im
3200 % |verbatim|-Modus auch im Zusammenhang mit dem |docstrip|-Paket
3201 % funktioniert. Schließlich wurde auch noch eine Idee von Tobias Oetiker
3202 % aus seinem \sFile{layout.sty}, der im Zusammenhang mit
3203 % \foreign{lshort2e.tex - The not so short introduction to LaTeX2e}
3204 % entstand, zum parallelen Setzen von Quelle und formatiertem Text genutzt.
3205 % \else%
3206 % Therefore some instructions of \sFile{verbatim.sty} have been adopted and
3207 % modified, so that writing and reading by the |docstrip| package works.
3208 % Finally an idea of Tobias Oetiker out of \sFile{layout.sty} also has
3209 % been used, which has been developed in connection with ``|lshort2e.tex| --
3210 % The not so short introduction to LaTeX2e''.%
3211 % \fi%
3212 % \changes{v-8.0e}{05/05/17}{nun wird die .pdf-Ausgabe sauber abgefangen}
3213 % \begin{macrocode}
3214 %<*strukdoc>
3215 \RequirePackage{ifpdf}
3216 \newif\ifcolor
3217 \IfFileExists{color.sty}{\colortrue}{}
3218 \RequirePackage{varioref}
3219 \ifpdf
3220 \RequirePackage[colorlinks]{hyperref}
3221 \else
3222 \def\href#1{\texttt}
3223 \fi
3224 \RequirePackage{cleveref}
3225 \ifcolor
3226 \RequirePackage{color}
3227 \fi
3228 \RequirePackage{url}
3229 \renewcommand\ref{\protect\T@ref}
3230 \renewcommand\pageref{\protect\T@pageref}
3231 \@ifundefined{zB}{}{\endinput}
3232 \providecommand\pparg[2]{%
3233 {\ttfamily(}\meta{#1},\meta{#2}{\ttfamily)}}
3234 \providecommand\envb[1]{%
3235 {\ttfamily\char`\\begin\char`\{#1\char`\}}}
3236 \providecommand\enve[1]{%
3237 {\ttfamily\char`\\end\char`\{#1\char`\}}}
3238 \newcommand{\zBspace}{z.\,B.}
3239 \let\zB=\zBspace
3240 \newcommand{\dhspace}{d.\,h.}
3241 \let\dh=\dhspace
3242 \let\foreign=\textit
3243 \newcommand\Abb[1]{Abbildung~\ref{#1}}
3244 \newcommand\sFile[1]{\textsf{#1}}
3245 \def\newexample#1{%
3246 \@ifnextchar[{\@oexmpl{#1}}{\@nexmpl{#1}}}
3247 \def\@nexmpl#1#2{%
3248 \@ifnextchar[{\@xnexmpl{#1}{#2}}{\@ynexmpl{#1}{#2}}}
3249 \def\@xnexmpl#1#2[#3]{%
3250 \expandafter\@ifdefinable\csname #1\endcsname
3251 {\@definecounter{#1}\@newctr{#1}[#3]%
3252 \expandafter\xdef\csname the#1\endcsname{%
3253 \expandafter\noexpand\csname the#3\endcsname \@exmplcountersep
3254 \@exmplcounter{#1}}%
3255 \global\@namedef{#1}{\@exmpl{#1}{#2}}%
3256 \global\@namedef{end#1}{\@endexample}}}
3257 \def\@ynexmpl#1#2{%
3258 \expandafter\@ifdefinable\csname #1\endcsname
3259 {\@definecounter{#1}%
3260 \expandafter\xdef\csname the#1\endcsname{\@exmplcounter{#1}}%
3261 \global\@namedef{#1}{\@exmpl{#1}{#2}}%
3262 \global\@namedef{end#1}{\@endexample}}}
3263 \def\@oexmpl#1[#2]#3{%
3264 \@ifundefined{c@#2}{\@nocounterr{#2}}%
3265 {\expandafter\@ifdefinable\csname #1\endcsname
3266 {\global\@namedef{the#1}{\@nameuse{the#2}}%
3267 \global\@namedef{#1}{\@exmpl{#2}{#3}}%
3268 \global\@namedef{end#1}{\@endexample}}}}
3269 \def\@exmpl#1#2{%
3270 \refstepcounter{#1}%
3271 \@ifnextchar[{\@yexmpl{#1}{#2}}{\@xexmpl{#1}{#2}}}
3272 \def\@xexmpl#1#2{%
3273 \@beginexample{#2}{\csname the#1\endcsname}\ignorespaces}
3274 \def\@yexmpl#1#2[#3]{%
3275 \@opargbeginexample{#2}{\csname the#1\endcsname}{#3}\ignorespaces}
3276 \def\@exmplcounter#1{\noexpand\arabic{#1}}
3277 \def\@exmplcountersep{.}
3278 \def\@beginexample#1#2{%
3279 \@nobreaktrue\list{}{\setlength{\rightmargin}{\leftmargin}}%
3280 \item[{\bfseries #1\ #2}]\mbox{}\\\sf}
3281 \def\@opargbeginexample#1#2#3{%
3282 \@nobreaktrue\list{}{\setlength{\rightmargin}{\leftmargin}}%
3283 \item[{\bfseries #1\ #2}\ (#3)]\mbox{}\\\sf}
3284 \def\@endexample{\endlist}
3285
3286 \newexample{tExample}{\ifnum\language=\languageNGerman Beispiel\else Example\fi}
3287
3288 \newwrite\struktex@out
3289 \newenvironment{example}%
3290 {\begingroup% Lets keep the changes local
3291 \@bsphack
3292 \immediate\openout \struktex@out \jobname.tmp
3293 \let\do\@makeother\dospecials\catcode`\^^M\active
3294 \def\verbatim@processline{%
3295 \immediate\write\struktex@out{\the\verbatim@line}}%
3296 \verbatim@start}%
3297 {\immediate\closeout\struktex@out\@esphack\endgroup%
3298 %
3299 % And here comes the part of Tobias Oetiker
3300 %
3301 \par\small\addvspace{3ex plus 1ex}\vskip -\parskip
3302 \noindent
3303 \makebox[0.45\linewidth][l]{%
3304 \begin{minipage}[t]{0.45\linewidth}
3305 \vspace*{-2ex}
3306 \setlength{\parindent}{0pt}
3307 \setlength{\parskip}{1ex plus 0.4ex minus 0.2ex}
3308 \begin{trivlist}
3309 \item\input{\jobname.tmp}
3310 \end{trivlist}
3311 \end{minipage}}%
3312 \hfill%
3313 \makebox[0.5\linewidth][l]{%
3314 \begin{minipage}[t]{0.50\linewidth}
3315 \vspace*{-1ex}
3316 \verbatiminput{\jobname.tmp}
3317 \end{minipage}}
3318 \par\addvspace{3ex plus 1ex}\vskip -\parskip
3319 }
3320
3321 \newtoks\verbatim@line
3322 \def\verbatim@startline{\verbatim@line{}}
3323 \def\verbatim@addtoline#1{%
3324 \verbatim@line\expandafter{\the\verbatim@line#1}}
3325 \def\verbatim@processline{\the\verbatim@line\par}
3326 \def\verbatim@finish{\ifcat$\the\verbatim@line$\else
3327 \verbatim@processline\fi}
3328
3329 \def\verbatimwrite#1{%
3330 \@bsphack
3331 \immediate\openout \struktex@out #1
3332 \let\do\@makeother\dospecials
3333 \catcode`\^^M\active \catcode`\^^I=12
3334 \def\verbatim@processline{%
3335 \immediate\write\struktex@out
3336 {\the\verbatim@line}}%
3337 \verbatim@start}
3338 \def\endverbatimwrite{%
3339 \immediate\closeout\struktex@out
3340 \@esphack}
3341
3342 \@ifundefined{vrb@catcodes}%
3343 {\def\vrb@catcodes{%
3344 \catcode`\!12\catcode`\[12\catcode`\]12}}{}
3345 \begingroup
3346 \vrb@catcodes
3347 \lccode`\!=`\\ \lccode`\[=`\{ \lccode`\]=`\}
3348 \catcode`\~=\active \lccode`\~=`\^^M
3349 \lccode`\C=`\C
3350 \lowercase{\endgroup
3351 \def\verbatim@start#1{%
3352 \verbatim@startline
3353 \if\noexpand#1\noexpand~%
3354 \let\next\verbatim@
3355 \else \def\next{\verbatim@#1}\fi
3356 \next}%
3357 \def\verbatim@#1~{\verbatim@@#1!end\@nil}%
3358 \def\verbatim@@#1!end{%
3359 \verbatim@addtoline{#1}%
3360 \futurelet\next\verbatim@@@}%
3361 \def\verbatim@@@#1\@nil{%
3362 \ifx\next\@nil
3363 \verbatim@processline
3364 \verbatim@startline
3365 \let\next\verbatim@
3366 \else
3367 \def\@tempa##1!end\@nil{##1}%
3368 \@temptokena{!end}%
3369 \def\next{\expandafter\verbatim@test\@tempa#1\@nil~}%
3370 \fi \next}%
3371 \def\verbatim@test#1{%
3372 \let\next\verbatim@test
3373 \if\noexpand#1\noexpand~%
3374 \expandafter\verbatim@addtoline
3375 \expandafter{\the\@temptokena}%
3376 \verbatim@processline
3377 \verbatim@startline
3378 \let\next\verbatim@
3379 \else \if\noexpand#1
3380 \@temptokena\expandafter{\the\@temptokena#1}%
3381 \else \if\noexpand#1\noexpand[%
3382 \let\@tempc\@empty
3383 \let\next\verbatim@testend
3384 \else
3385 \expandafter\verbatim@addtoline
3386 \expandafter{\the\@temptokena}%
3387 \def\next{\verbatim@#1}%
3388 \fi\fi\fi
3389 \next}%
3390 \def\verbatim@testend#1{%
3391 \if\noexpand#1\noexpand~%
3392 \expandafter\verbatim@addtoline
3393 \expandafter{\the\@temptokena[}%
3394 \expandafter\verbatim@addtoline
3395 \expandafter{\@tempc}%
3396 \verbatim@processline
3397 \verbatim@startline
3398 \let\next\verbatim@
3399 \else\if\noexpand#1\noexpand]%
3400 \let\next\verbatim@@testend
3401 \else\if\noexpand#1\noexpand!%
3402 \expandafter\verbatim@addtoline
3403 \expandafter{\the\@temptokena[}%
3404 \expandafter\verbatim@addtoline
3405 \expandafter{\@tempc}%
3406 \def\next{\verbatim@!}%
3407 \else \expandafter\def\expandafter\@tempc\expandafter
3408 {\@tempc#1}\fi\fi\fi
3409 \next}%
3410 \def\verbatim@@testend{%
3411 \ifx\@tempc\@currenvir
3412 \verbatim@finish
3413 \edef\next{\noexpand\end{\@currenvir}%
3414 \noexpand\verbatim@rescan{\@currenvir}}%
3415 \else
3416 \expandafter\verbatim@addtoline
3417 \expandafter{\the\@temptokena[}%
3418 \expandafter\verbatim@addtoline
3419 \expandafter{\@tempc]}%
3420 \let\next\verbatim@
3421 \fi
3422 \next}%
3423 \def\verbatim@rescan#1#2~{\if\noexpand~\noexpand#2~\else
3424 \@warning{Characters dropped after `\string\end{#1}'}\fi}}
3425
3426 \newread\verbatim@in@stream
3427 \def\verbatim@readfile#1{%
3428 \verbatim@startline
3429 \openin\verbatim@in@stream #1\relax
3430 \ifeof\verbatim@in@stream
3431 \typeout{No file #1.}%
3432 \else
3433 \@addtofilelist{#1}%
3434 \ProvidesFile{#1}[(verbatim)]%
3435 \expandafter\endlinechar\expandafter\m@ne
3436 \expandafter\verbatim@read@file
3437 \expandafter\endlinechar\the\endlinechar\relax
3438 \closein\verbatim@in@stream
3439 \fi
3440 \verbatim@finish
3441 }
3442 \def\verbatim@read@file{%
3443 \read\verbatim@in@stream to\next
3444 \ifeof\verbatim@in@stream
3445 \else
3446 \expandafter\verbatim@addtoline\expandafter{\expandafter\check@percent\next}%
3447 \verbatim@processline
3448 \verbatim@startline
3449 \expandafter\verbatim@read@file
3450 \fi
3451 }
3452 \def\verbatiminput{\begingroup\MacroFont
3453 \@ifstar{\verbatim@input\relax}%
3454 {\verbatim@input{\frenchspacing\@vobeyspaces}}}
3455 \def\verbatim@input#1#2{%
3456 \IfFileExists {#2}{\@verbatim #1\relax
3457 \verbatim@readfile{\@filef@und}\endtrivlist\endgroup\@doendpe}%
3458 {\typeout {No file #2.}\endgroup}}
3459 %</strukdoc>
3460 % \end{macrocode}
3461 %
3462 %
3463 % \section{\ifnum\language=\languageNGerman%
3464 % Verschiedene Beispieldateien
3465 % \else%
3466 % Several sample files
3467 % \fi}
3468 %
3469 %
3470 % \subsection[\ifnum\language=\languageNGerman%
3471 % Test des Paketes \sFile{struktxf.sty}\else Testing
3472 % the package \sFile{struktxf.sty}\fi]{%
3473 % \ifnum\language=\languageNGerman%
3474 % Datei zum Austesten der Makros des Paketes \sFile{struktxf.sty}%
3475 % \else%
3476 % File for testing the macros of the package \sFile{struktxf.sty}%
3477 % \fi}
3478 %
3479 %
3480 % \begin{macrocode}
3481 %<*struktxf-00>
3482 \documentclass[fleqn, 12pt, english]{article} % 12pt for better readability
3483
3484 \usepackage{babel}
3485 \usepackage[iso, mathitalics]{struktxf} % the options could be omitted,
3486 % they represent the default
3487
3488 \nofiles
3489
3490 \begin{document}
3491
3492 \section*{Mathematical Sets:}
3493
3494 \begin{itemize}
3495 \item natural numbers: \(\nat\)
3496 \item integer numbers: \(\integer\)
3497 \item rational numbers: \(\rational\)
3498 \item real numbers: \(\real\)
3499 \item complex numbers: \(\complex\)
3500 \end{itemize}
3501 To compare the fonts visually, should not be done in real documents:
3502 \begin{verbatim}
3503 \makeatletter\@nss@isofalse\makeatother
3504 \end{verbatim}
3505 \makeatletter\@nss@isofalse\makeatother
3506 \begin{itemize}
3507 \item natural numbers: \(\nat\)
3508 \item integer numbers: \(\integer\)
3509 \item rational numbers: \(\rational\)
3510 \item real numbers: \(\real\)
3511 \item complex numbers: \(\complex\)
3512 \end{itemize}
3513 or (with \verb|\@nss@isotrue|)
3514 \makeatletter\@nss@isotrue\makeatother
3515 \begin{itemize}
3516 \item natural numbers: \(\nat\)
3517 \item integer numbers: \(\integer\)
3518 \item rational numbers: \(\rational\)
3519 \item real numbers: \(\real\)
3520 \item complex numbers: \(\complex\)
3521 \end{itemize}
3522
3523 \section*{Assignments:}
3524
3525 \begin{itemize}
3526 \item Default settings:
3527 \begin{equation}
3528 \label{eq:def}
3529 NewValue = OldValue + Correction
3530 \end{equation}
3531 \item \verb|MathNormal| settings: \MathNormal
3532 \begin{equation}
3533 \label{eq:norm}
3534 NewValue = OldValue + Correction
3535 \end{equation}
3536 \item \verb|MathItalics| settings: \MathItalics
3537 \begin{equation}
3538 \label{eq:ital}
3539 NewValue = OldValue + Correction
3540 \end{equation}
3541 \end{itemize}
3542
3543 \end{document}
3544 %</struktxf-00>
3545 % \end{macrocode}
3546 %
3547 %
3548 % \subsection[\ifnum\language=\languageNGerman Test des Paketes
3549 % \sFile{struktxp.sty}\else File for testing the package
3550 % \sFile{struktxp.sty}\fi]{%
3551 % \ifnum\language=\languageNGerman%
3552 % Datei zum Austesten der Makros des Paketes \sFile{struktxp.sty}%
3553 % \else%
3554 % File for testing the macros of the package \sFile{struktxp.sty}%
3555 % \fi}
3556 %
3557 % \changes{v2.4}{20/01/28}{better preamble for the sample files}
3558 % \ifnum\language=\languageNGerman%
3559 % Die folgenden Zeilen bilden eine Musterdatei, die zum Austesten
3560 % der Makros des \sFile{struktxp.sty} benutzt werden kann. Zum Testen
3561 % sollten auch die Kommentarzeichen vor der Zeile
3562 % |\usepackage[T1]{fontenc}| gelöscht werden. Der Text ist nur in Englisch
3563 % vorgegeben.
3564 % \else%
3565 % The following lines build a sample file, which can be used for testing
3566 % the macros of \sFile{struktxp.sty}. For testing one should delete the
3567 % comment characters before the line |\usepackage[T1]{fontenc}|.%
3568 % \fi%
3569 % \changes{v121}{10/08/31}{added babel package to the test of struktxp}
3570 % \begin{macrocode}
3571 %<*example3>
3572 \documentclass[english]{article}
3573
3574 \usepackage{babel}
3575 \usepackage{struktxf}
3576 \usepackage{struktxp}
3577
3578 \nofiles
3579
3580 \begin{document}
3581
3582 \pLanguage{Pascal}
3583 \section*{Default values (Pascal):}
3584
3585 {\obeylines
3586 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3587 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3588 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3589 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3590 }
3591
3592 \paragraph{After changing the boolean values with}
3593 \verb-\pBoolValue{yes}{no}-:
3594
3595 {\obeylines
3596 \pBoolValue{yes}{no}
3597 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3598 }
3599
3600 \paragraph{after changing the fonts with}
3601 \verb-\pFonts{\itshape}{\sffamily\bfseries}{}-:
3602
3603 {\obeylines
3604 \pFonts{\itshape}{\sffamily\bfseries}{}
3605 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3606 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3607 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3608 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3609 }
3610
3611 \paragraph{after changing the fonts with}
3612 \verb-\pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}-:
3613
3614 {\obeylines
3615 \pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}
3616 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3617 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3618 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3619 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3620 }
3621
3622 \paragraph{after changing the fonts with}
3623 \verb-\pFonts{\itshape}{\bfseries\itshape}{}-:
3624
3625 {\obeylines
3626 \pFonts{\itshape}{\bfseries\itshape}{}
3627 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3628 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3629 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3630 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3631
3632 \vspace{15pt}
3633 Without \textit{italic correction}:
3634 M \pVar{M} M \pKey{M} M. \pVar{M}. M. \pKey{M}. M.
3635 }
3636
3637 \pLanguage{C}
3638 \pBoolValue{\texttt{WAHR}}{\texttt{FALSCH}}
3639 \section*{Default values (C):}
3640
3641 {\obeylines
3642 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3643 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3644 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3645 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3646 }
3647
3648 \paragraph{After changing the boolean values with}
3649 \verb-\pBoolValue{\texttt{yes}}{\texttt{no}}-:
3650
3651 {\obeylines
3652 \pBoolValue{\texttt{yes}}{\texttt{no}}
3653 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3654 }
3655
3656 \paragraph{after changing the fonts with}
3657 \verb-\pFonts{\itshape}{\sffamily\bfseries}{}-:
3658
3659 {\obeylines
3660 \pFonts{\itshape}{\sffamily\bfseries}{}
3661 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3662 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3663 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3664 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3665 }
3666
3667 \paragraph{after changing the fonts with}
3668 \verb-\pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}-:
3669
3670 {\obeylines
3671 \pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}
3672 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3673 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3674 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3675 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3676 }
3677
3678 \paragraph{after changing the fonts with}
3679 \verb-\pFonts{\itshape}{\bfseries\itshape}{}-:
3680
3681 {\obeylines
3682 \pFonts{\itshape}{\bfseries\itshape}{}
3683 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3684 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3685 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3686 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3687
3688 \vspace{15pt}
3689 Without \textit{italic correction}:
3690 M \pVar{M} M \pKey{M} M. \pVar{M}. M. \pKey{M}. M.
3691 }
3692
3693 \pLanguage{Java}
3694 \pBoolValue{\texttt{WAHR}}{\texttt{FALSCH}}
3695 \section*{Default values (Java):}
3696
3697 {\obeylines
3698 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3699 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3700 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3701 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3702 }
3703
3704 \paragraph{After changing the boolean values with}
3705 \verb-\pBoolValue{\texttt{yes}}{\texttt{no}}-:
3706
3707 {\obeylines
3708 \pBoolValue{\texttt{yes}}{\texttt{no}}
3709 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3710 }
3711
3712 \paragraph{after changing the fonts with}
3713 \verb-\pFonts{\itshape}{\sffamily\bfseries}{}-:
3714
3715 {\obeylines
3716 \pFonts{\itshape}{\sffamily\bfseries}{}
3717 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3718 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3719 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3720 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3721 }
3722
3723 \paragraph{after changing the fonts with}
3724 \verb-\pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}-:
3725
3726 {\obeylines
3727 \pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}
3728 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3729 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3730 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3731 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3732 }
3733
3734 \paragraph{after changing the fonts with}
3735 \verb-\pFonts{\itshape}{\bfseries\itshape}{}-:
3736
3737 {\obeylines
3738 \pFonts{\itshape}{\bfseries\itshape}{}
3739 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3740 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3741 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3742 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3743
3744 \vspace{15pt}
3745 Without \textit{italic correction}:
3746 M \pVar{M} M \pKey{M} M. \pVar{M}. M. \pKey{M}. M.
3747 }
3748
3749 \pLanguage{Python}
3750 \pBoolValue{\texttt{WAHR}}{\texttt{FALSCH}}
3751 \section*{Default values (Python):}
3752
3753 {\obeylines
3754 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3755 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3756 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3757 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3758 }
3759
3760 \paragraph{After changing the boolean values with}
3761 \verb-\pBoolValue{\texttt{yes}}{\texttt{no}}-:
3762
3763 {\obeylines
3764 \pBoolValue{\texttt{yes}}{\texttt{no}}
3765 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3766 }
3767
3768 \paragraph{after changing the fonts with}
3769 \verb-\pFonts{\itshape}{\sffamily\bfseries}{}-:
3770
3771 {\obeylines
3772 \pFonts{\itshape}{\sffamily\bfseries}{}
3773 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3774 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3775 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3776 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3777 }
3778
3779 \paragraph{after changing the fonts with}
3780 \verb-\pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}-:
3781
3782 {\obeylines
3783 \pFonts{\ttfamily}{\ttfamily\bfseries}{\ttfamily\slshape}
3784 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3785 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3786 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3787 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3788 }
3789
3790 \paragraph{after changing the fonts with}
3791 \verb-\pFonts{\itshape}{\bfseries\itshape}{}-:
3792
3793 {\obeylines
3794 \pFonts{\itshape}{\bfseries\itshape}{}
3795 Variables: \pVar{iV_g}, \sVar{zV^}, \pVariable{&i}
3796 Keywords: \pKeyword{begin}, \pKey{while}, \sKey{__CPP__}
3797 in math mode: \(\pVar{a}+\pVar{iV_g}\)
3798 boolean values: \sTrue, \sFalse, \pTrue, \pFalse
3799
3800 \vspace{15pt}
3801 Without \textit{italic correction}:
3802 M \pVar{M} M \pKey{M} M. \pVar{M}. M. \pKey{M}. M.
3803 }
3804
3805 \end{document}
3806 %</example3>
3807 % \end{macrocode}
3808 %
3809 %
3810 % \changes{v2.4}{20/01/28}{corrected number of examples}
3811 % \subsection[\ifnum\language=\languageNGerman Positionierung von Struktogrammen
3812 % mit \cs{centernss}/\cs{input}\else Positioning of structured box charts
3813 % with \cs{centernss}/\cs{input}\fi]{%
3814 % \ifnum\language=\languageNGerman%
3815 % Beipieldatei zum Einbinden in die Dokumentation: Positionierung von
3816 % Struktogrammen mit \cs{centernss}/\cs{input}%
3817 % \else%
3818 % Sample file for including into the documentation: Positioning of
3819 % structured box charts with \cs{centernss}/\cs{input}%
3820 % \fi}
3821 % \label{sec:sample}
3822 %
3823 % \changes{v2.4}{20/01/28}{better preamble for the sample files}
3824 % \ifnum\language=\languageNGerman%
3825 % Die folgenden Zeilen bilden eine Beispieldatei, die bei der Erstellung
3826 % dieser Dokumentation (siehe S.~\pageref{sec:centernss}) benötigt wird.
3827 % \else%
3828 % The following lines build up a sample file, which is needed for the
3829 % preparation of this documentation (see p.~\pageref{sec:centernss}); there
3830 % is only a german version of this file.%
3831 % \fi%
3832 % \begin{macrocode}
3833 %<*nss-sample>
3834 \begin{struktogramm}(95,40)[Text]
3835 \case[10]{3}{3}{Signum(x)}{-1}
3836 \assign{\(z \gets - \frac{1}{x}\)}
3837 \switch{0}
3838 \ifnum\language=\languageNGerman%
3839 \assign{Ausgabe: Division durch 0}
3840 \else
3841 \assign{Output: Division by 0}
3842 \fi
3843 \switch[r]{1}
3844 \assign{\(z \gets \frac{1}{x}\)}
3845 \caseend
3846 \end{struktogramm}
3847 %</nss-sample>
3848 % \end{macrocode}
3849 %
3850 %
3851 % \subsection[\ifnum\language=\languageNGerman %
3852 % Vordefinierte Steigung von Fallunterscheidungen\else %
3853 % Predefined slopes at selections\fi]{%
3854 % \ifnum\language=\languageNGerman%
3855 % Darstellung von Fallunterscheidungen mit vordefinierten Steigungen
3856 % ohne die Benutzung optionaler Pakete
3857 % \else%
3858 % Display of selections with predefined slopes without the
3859 % use of optional packages
3860 % \fi}
3861 %
3862 % \changes{v2.4}{20/01/28}{better preamble for the sample files}
3863 % \changes{v-4.1c}{95/07/24}{Eigene Datei zum Austesten der Makros
3864 % integriert}%
3865 % \ifnum\language=\languageNGerman%
3866 % Die folgenden Zeilen bilden eine Beispieldatei, die zum Austesten der
3867 % Makros benutzt werden kann. Es wird gezeigt, wie die Steigung von
3868 % Fallunterscheidungen ohne optionale Zusatzpakete aussehen kann. Der Inhalt
3869 % ist nur in Englisch vorhanden.%
3870 % \else%
3871 % The following lines build up a sample file, that can be used for testing
3872 % the macros. The slope used at the \cs{ifthenelse} macro is one of the
3873 % six cases defined in \LaTeXe{}, because no optional package is loaded.%
3874 % \fi%
3875 % \begin{macrocode}
3876 %<*example1>
3877 \documentclass[draft]{article}
3878 \usepackage{struktex}
3879
3880 \begin{document}
3881
3882 \begin{struktogramm}(90,137)
3883 \assign%
3884 {
3885 \begin{declaration}[]
3886 \description{\(a, b, c\)}{three variables which are to be sorted}
3887 \description{\(tmp\)}{temporary variable for the circular swap}
3888 \end{declaration}
3889 }
3890 \ifthenelse{1}{2}{\(a\le c\)}{j}{n}
3891 \change
3892 \assign{\(tmp\gets a\)}
3893 \assign{\(a\gets c\)}
3894 \assign{\(c\gets tmp\)}
3895 \ifend
3896 \ifthenelse{2}{1}{\(a\le b\)}{j}{n}
3897 \ifthenelse{1}{1}{\(b\le c\)}{j}{n}
3898 \change
3899 \assign{\(tmp\gets c\)}
3900 \assign{\(c\gets b\)}
3901 \assign{\(b\gets tmp\)}
3902 \ifend
3903 \change
3904 \assign{\(tmp\gets a\)}
3905 \assign{\(a\gets b\)}
3906 \assign{\(b\gets tmp\)}
3907 \ifend
3908 \end{struktogramm}
3909
3910 \end{document}
3911 %</example1>
3912 % \end{macrocode}
3913 %
3914 % \subsection[\ifnum\language=\languageNGerman %
3915 % Variable Steigung von Fallunterscheidungen\else %
3916 % Variable slopes at selections\fi]{%
3917 % \ifnum\language=\languageNGerman%
3918 % Darstellung von Fallunterscheidungen mit variablen Steigungen
3919 % mit dem Paket \sFile{pict2e.sty}
3920 % \else%
3921 % Display of case distinctions with variable slopes
3922 % with the package \sFile{pict2e.sty}
3923 % \fi}
3924 %
3925 % \changes{v2.4}{20/01/28}{better preamble for the sample files}
3926 % \changes{v-4.1c}{95/07/24}{Eigene Datei zum Austesten der Makros
3927 % integriert}%
3928 % \ifnum\language=\languageNGerman%
3929 % Die folgenden Zeilen bilden eine Musterdatei, die zum Austesten der
3930 % Makros benutzt werden kann. Es wird gezeigt, wie die Steigung automatisch
3931 % berechnet wird, wenn das Pakete \sFile{pict2e} geladen wird. Der Inhalt
3932 % ist nur in Englisch vorhanden.%
3933 % \else%
3934 % The following lines build up a template file, that can be used for
3935 % testing the macros. It is shown, how the slope gets automatically
3936 % calculated after loading the package \sFile{pict2e}.%
3937 % \fi%
3938 % \begin{macrocode}
3939 %<*example2>
3940 \documentclass{article}
3941 \usepackage[pict2e, verification]{struktex}
3942
3943 \begin{document}
3944 \def\StruktBoxHeight{7}
3945 %\sProofOn{}
3946 \begin{struktogramm}(90,137)
3947 \assign%
3948 {
3949 \begin{declaration}[]
3950 \description{\(a, b, c\)}{three variables which are to be sorted}
3951 \description{\(tmp\)}{temporary variable for the circular swap}
3952 \end{declaration}
3953 }
3954 \assert[\StruktBoxHeight]{\sTrue}
3955 \ifthenelse[\StruktBoxHeight]{1}{2}{\(a\le c\)}{j}{n}
3956 \assert[\StruktBoxHeight]{\(a\le c\)}
3957 \change
3958 \assert[\StruktBoxHeight]{\(a>c\)}
3959 \assign[\StruktBoxHeight]{\(tmp\gets a\)}
3960 \assign[\StruktBoxHeight]{\(a\gets c\)}
3961 \assign[\StruktBoxHeight]{\(c\gets tmp\)}
3962 \assert[\StruktBoxHeight]{\(a<c\)}
3963 \ifend
3964 \assert[\StruktBoxHeight]{\(a\le c\)}
3965 \ifthenelse[\StruktBoxHeight]{2}{1}{\(a\le b\)}{j}{n}
3966 \assert[\StruktBoxHeight]{\(a\le b \wedge a\le c\)}
3967 \ifthenelse[\StruktBoxHeight]{1}{1}{\(b\le c\)}{j}{n}
3968 \assert[\StruktBoxHeight]{\(a\le b \le c\)}
3969 \change
3970 \assert[\StruktBoxHeight]{\(a \le c<b\)}
3971 \assign[\StruktBoxHeight]{\(tmp\gets c\)}
3972 \assign[\StruktBoxHeight]{\(c\gets b\)}
3973 \assign[\StruktBoxHeight]{\(b\gets tmp\)}
3974 \assert[\StruktBoxHeight]{\(a\le b<c\)}
3975 \ifend
3976 \change
3977 \assert[\StruktBoxHeight]{\(b < a\le c\)}
3978 \assign[\StruktBoxHeight]{\(tmp\gets a\)}
3979 \assign[\StruktBoxHeight]{\(a\gets b\)}
3980 \assign[\StruktBoxHeight]{\(b\gets tmp\)}
3981 \assert[\StruktBoxHeight]{\(a<b\le c\)}
3982 \ifend
3983 \assert[\StruktBoxHeight]{\(a\le b \le c\)}
3984 \end{struktogramm}
3985
3986 \end{document}
3987 %</example2>
3988 % \end{macrocode}
3989 %
3990 %
3991 % \subsection[\ifnum\language=\languageNGerman %
3992 % Dokumentation von Java Programmen\else%
3993 % Documentation of Java programs\fi]{%
3994 % \ifnum\language=\languageNGerman%
3995 % Dokumentation von Java Methoden im Vorspann eines Struktogramms mit
3996 % dem Paket \sFile{struktxp.sty}
3997 % \else%
3998 % Documentation of Java methods in the header of a structure chart with
3999 % the package \sFile{struktxp.sty}
4000 % \fi}
4001 %
4002 % \changes{v2.4}{20/01/28}{better preamble for the sample files}
4003 % \ifnum\language=\languageNGerman%
4004 % Der folgende Code wird in einem anderen Zusammenhang benutzt, nämlich um
4005 % Java-Methoden zu dokumentieren. An dieser Stelle wird ein eigener Weg
4006 % gewählt, da das sonst übliche Arbeiten mit \cs{lstinline} aus dem
4007 % \sFile{listings} Paket zu Fehlern führt.
4008 %
4009 % Der Code zeigt zusätzlich, wie die dokumentierten Methoden im Index
4010 % aufgeführt werden können.
4011 % \else%
4012 % The following code serves as a sample for documenting Java methods. Here
4013 % a special method is used, because the common use of \cs{lstinline} from
4014 % the \sFile{listings} package leads to errors.
4015 %
4016 % The code also shows how the documented methods can be listed in the
4017 % index.
4018 % \fi%
4019 % \begin{macrocode}
4020 %<*struktxp-00>
4021 \documentclass{article}
4022
4023 \usepackage{index} % produce the index afterwards with the command
4024 % makeindex -o struktxp-tst-00.ind struktxp-tst-00.idx
4025 \usepackage{struktxp}
4026
4027 \makeindex
4028
4029 \makeatletter
4030 \newlength{\fdesc@len}
4031 \newcommand{\fdesc@label}[1]%
4032 {%
4033 \settowidth{\fdesc@len}{{\fdesc@font #1}}%
4034 \advance\hsize by -2em
4035 \ifdim\fdesc@len>\hsize% % term > labelwidth
4036 \parbox[b]{\hsize}%
4037 {%
4038 \fdesc@font #1%
4039 }\\%
4040 \else% % term < labelwidth
4041 \ifdim\fdesc@len>\labelwidth% % term > labelwidth
4042 \parbox[b]{\labelwidth}%
4043 {%
4044 \makebox[0pt][l]{{\fdesc@font #1}}\\%
4045 }%
4046 \else% % term < labelwidth
4047 {\fdesc@font #1}%
4048 \fi\fi%
4049 \hfil\relax%
4050 }
4051 \newenvironment{fdescription}[1][\tt]%
4052 {%
4053 \def\fdesc@font{#1}
4054 \begin{quote}%
4055 \begin{list}{}%
4056 {%
4057 \renewcommand{\makelabel}{\fdesc@label}%
4058 \setlength{\labelwidth}{120pt}%
4059 \setlength{\leftmargin}{\labelwidth}%
4060 \addtolength{\leftmargin}{\labelsep}%
4061 }%
4062 }%
4063 {%
4064 \end{list}%
4065 \end{quote}%
4066 }
4067 \makeatother
4068
4069 \pLanguage{Java}
4070
4071 \begin{document}
4072
4073 \begin{fdescription}
4074 \item[\index{Methods!drawImage(Image img,
4075 int dx1,
4076 int dy1,
4077 int dx2,
4078 int dy2,
4079 int sx1,
4080 int sy1,
4081 int sx2,
4082 int sy2,
4083 ImageObserver observer)@%
4084 \pExp{\pKey{public} \pKey{abstract} \pKey{boolean} drawImage(Image img,
4085 \pKey{int} dx1,
4086 \pKey{int} dy1,
4087 \pKey{int} dx2,
4088 \pKey{int} dy2,
4089 \pKey{int} sx1,
4090 \pKey{int} sy1,
4091 \pKey{int} sx2,
4092 \pKey{int} sy2,
4093 ImageObserver observer)}}%
4094 \pExp{public abstract boolean drawImage(Image img, int dx1, int
4095 dy1, int dx1, int dy2, int sx1, int sy1, int sx2, int sy2,
4096 ImageObserver observer)}]%
4097 \ldots
4098 \end{fdescription}
4099
4100 \printindex
4101 \end{document}
4102 %</struktxp-00>
4103 % \end{macrocode}
4104 %
4105 %
4106 % \section[\ifnum\language=\languageNGerman%
4107 % Prüfen und Erstellen des Pakets \StrukTeXSty\else%
4108 % Checking and building the package \StrukTeXSty\fi]{%
4109 % \ifnum\language=\languageNGerman%
4110 % Prüfen und Erstellen des Pakets \StrukTeXSty{} mit \textsf{l3build} \else%
4111 % Checking and building the package \StrukTeXSty{} with \textsf{l3build}\fi}
4112 % \label{sec:lbuild_lua}
4113 %
4114 % \changes{v3.0a}{25/06/20}{corrected last(?) glitches}
4115 % \changes{v2.4}{20/01/28}{replaced Makefile by lbuild.lua}
4116 % \changes{v2.1b}{17/06/17}{added tds-zip as new target}
4117 % \changes{v2.1b}{17/06/17}{changed basic formatting engine to pdflatex}
4118 % \changes{v2.1a}{17/06/11}{Makefile now reflects git git aware}
4119 % \changes{v101}{10/06/25}{changed Makefile according to subversion
4120 % revision numbers}
4121 % \changes{v061}{10/05/31}{corrected some more typos}
4122 % \changes{v056}{10/01/21}{corrected Makefile once more}
4123 % \changes{v-9.2}{10/01/18}{corrected the Makefile}
4124 % \changes{v-8.0e}{05/05/17}{Tippfehler korrigiert: \$\$\$f $\rightarrow$ \$\$f}
4125 % \changes{v-8.0e}{05/05/17}{\& mit Fluchtzeichen versehen}
4126 % \changes{v-8.0b}{04/07/14}{.pdf-Ausgabe eingeführt}
4127 % \changes{v-8.2a}{06/01/19}{HOMETEXMF $\rightarrow$ TEXMFHOME}
4128 %
4129 % \ifnum\language=\languageNGerman%
4130 % Der Umgang mit \sFile{.dtx}-Paketen ist wesentlich einfacher, wenn ein
4131 % Werkzeug für die Automatisierung der wesentlichen Schritte vorliegt. Ein
4132 % solches Werkzeug ist mit dem Paket \sFile{l3build} plattformübergreifend
4133 % gegeben \cite{LaTeX3:l3build}.
4134 %
4135 % Die Anpassung an die Gegebenheiten für ein spezielles Projekt erfolgt
4136 % durch ein \sFile{build.lua}-Skript, das bei Bedarf durch eine
4137 % Konfigurationsdatei \sFile{build-config.lua} begleitet wird. Beide
4138 % Dateien sind hier in die Dokumentation integriert, auf ihre Benutzung
4139 % wird hier nicht weiter eingegangen, sie ist in \cite{LaTeX3:l3build}
4140 % nachzulesen.%
4141 % \else%
4142 % Working with \sFile{.dtx} packages is much easier when working with a
4143 % well suited tool like \sFile{l3build} which can be used on all platforms
4144 % \cite{LaTeX3:l3build}.
4145 %
4146 % For a special project there must exist a \sFile{build.lua} script to
4147 % adapt the behaviour to its needs. This script is accomplished by a
4148 % settings file \sFile{build-config.lua}. Both files are integrated in this
4149 % documentation, their usage isn't described here, it can be read in
4150 % \cite{LaTeX3:l3build}.%
4151 % \fi
4152 %
4153 % \begin{macrocode}
4154 %<*lbuild>
4155 #!/usr/bin/env texlua
4156
4157 -- Build script for "StrukTeX" files
4158
4159 -- Identify the bundle and module: the module may be empty in the case where
4160 -- there is no subdivision
4161 bundle = ""
4162 module = "struktex"
4163
4164 -- Location of main directory: use Unix-style path separators
4165 -- Should match that defined by the bundle.
4166 maindir = "."
4167
4168 -- the files to be installed
4169 installfiles = {"*.sty"}
4170
4171 -- the files which should not be installed
4172 excludefiles = {"*/TODO.md"}
4173
4174 -- these files are to copy for unpackaging
4175 sourcefiles = {"*.dtx", "*.ins", "build.lua", "build-config.lua"}
4176
4177 -- these files are part of the documentation
4178 docfiles = {"struktex.drv", "struktex.sty"}
4179
4180 -- these files get tags
4181 tagfiles = {"*.sty"}
4182
4183 -- this file must be TeXed to unpack all
4184 unpackfiles = {"struktex.dtx"}
4185 -- unpackopts = "-interaction=batchmode"
4186
4187 -- create a TDS-suited .zip-file
4188 packtdszip = true
4189
4190 -- Files to copy to unpacking when typesetting
4191 typesetsourcefiles = {"struktex.sty"}
4192
4193 -- Files needed to support typesetting when "sandboxed"?
4194 typesetsuppfiles = {"tex-bib.bib"}
4195
4196 -- only using the following engines for testing the code
4197 checkengines = checkengines or {"latex", "pdftex"}
4198
4199 -- install also documentation (doesn't work, because
4200 -- there are no *.pdf-files in the unpacked directory
4201 installfiles = installfiles or {"*.pdf", "*.sty"}
4202
4203 -- Load the common build code
4204 dofile(maindir .. "/build-config.lua")
4205
4206 -- specific settings for the StrukTeX development repo, used by l3build script
4207
4208 function prepare_contents(file)
4209 -- can't be set locally, so: set it back later on!
4210 typesetopts = "--output-format=dvi"
4211 tex(file)
4212
4213 -- create .pdf-file from .dvi-source
4214 name = stripext(file)
4215 dvitopdf(name, typesetdir, typesetexe, true)
4216 run(typesetdir, "pdfcrop " .. name .. pdfext)
4217 ren(typesetdir, name .. "-crop" .. pdfext, name .. pdfext)
4218 end
4219
4220 function print_log(log_message)
4221 print(log_message)
4222 return 0
4223 end
4224
4225 function typeset(file)
4226 local name = jobname(file)
4227
4228 typesetopts = "--output-format=pdf"
4229 local errorlevel = tex(file, typesetdir)
4230
4231 print("\ntypeset.errorlevel:", errorlevel, "\n")
4232
4233 if errorlevel == 0 then
4234 -- Return a non-zero errorlevel if anything goes wrong
4235 print("prepare additional information")
4236 errorlevel = (
4237 print_log("file: " .. file .. ", name: " .. name) +
4238 print_log("going to bibtex with >" .. name .. "<") +
4239 bibtex(name, typesetdir) +
4240 print_log("\nbibtex done\n") +
4241 tex(file, typesetdir) +
4242 print_log("going to makeindex with", name) +
4243 makeindex(name, typesetdir, ".idx", ".ind", ".ilg", "gind.ist") +
4244 makeindex(name, typesetdir, ".glo", ".gls", ".glg", "gglo.ist") +
4245 print_log("\nmakeindex done\n") +
4246 tex(file, typesetdir)
4247 )
4248 print_log("\ntypesetting done\n")
4249 ren(typesetdir, "struktex.pdf", "struktex." .. targetlanguage .. ".pdf")
4250 print_log("\nrenaming to struktex." .. targetlanguage .. ".pdf done\n")
4251 end
4252
4253 return errorlevel
4254 end
4255
4256 function setversion_update_line(line, date, release)
4257 local function get_date_release()
4258 -- get version information from git
4259 local f = io.popen("git describe", "r")
4260 local release = {}
4261 for entry in f:lines() do
4262 release[#release + 1] = entry
4263 end
4264 return os.date("%Y/%m/%d", os.time()), release[1]:sub(2, -1)
4265 end
4266
4267 date, release = get_date_release()
4268
4269 for _,i in pairs({"Class", "File", "Package"}) do
4270 if string.match(
4271 line,
4272 "^\\ProvidesExpl" .. i .. " *{[a-zA-Z0-9%-%.]+}"
4273 ) then
4274 line = string.gsub(
4275 line,
4276 "{%d%d%d%d/%d%d/%d%d}( *){[^}]*}",
4277 "{" .. string.gsub(date, "%-", "/") .. "}%1{" .. release .. "}"
4278 )
4279 break
4280 end
4281 end
4282 return line
4283 end
4284
4285 --### doc_init_hook begin ############################################
4286 --[[
4287 The git informations (commit name, commit date, commit author)
4288 must be included in the .sty files. This is done here.
4289 1. git describe --long HEAD: returns the most recent tag (HEAD
4290 can be omitted, it's the default), that's the commit name
4291 2. git --no-pager show -s --format=format:"<format>": returns
4292 the needed commit date and commit author. <format> is set
4293 up so that the three lines below are generated
4294
4295 These informations replace the line
4296 %% git revision information
4297 by someting like
4298 \@git@ $Date: <commit date> $%
4299 $Revision: <commit name> $
4300 %% $Author: <commit author> $
4301
4302 <commit date> has the format "yyyy-mm-dd hh:mm:ss +nnnn"
4303 <commit name> has the format as described in the git describe
4304 man page
4305 --]]
4306 function docinit_hook()
4307 print("now set git data")
4308 local f = io.popen('git describe --long HEAD', 'r')
4309 local commit_name = f:read "*all"
4310 commit_name = string.sub(commit_name, 1, #commit_name - 1)
4311
4312 f = io.popen('git --no-pager show -s --format=format:"%n ' ..
4313 '\\@git@ \\$Date: %ci \\$%%%%%n \\$Revision: ' ..
4314 '<commit name> \\$%n %%%%%%%% \\$Author: %cn \\$%n"')
4315 local revision_information = f:read "*all"
4316 revision_information = string.sub(revision_information, 1,
4317 #revision_information - 1)
4318
4319 print("commit_name: >>" .. commit_name .. "<<, Länge: " ..
4320 tostring(string.len(commit_name)))
4321 print("revision_information: " .. revision_information)
4322
4323 revision_information = revision_information:gsub("<commit name>", commit_name)
4324 print("revision_information: " .. revision_information)
4325
4326 filenames = {"strukdoc.sty", "struktex.sty", "struktxf.sty", "struktxp.sty"}
4327
4328 for _, file in ipairs(filenames) do
4329 file = unpackdir .. "/" .. file
4330 print(file)
4331
4332 local f = assert(io.open(file,"rb"))
4333 local content = f:read("*all")
4334 f:close()
4335
4336 content = content:gsub("%%%% git revision information",
4337 revision_information)
4338 print(content)
4339
4340 f = assert(io.open(file,"w"))
4341 f:write(content)
4342 f:close()
4343
4344 if file == unpackdir .."/" .. "struktex.sty" then
4345 file = file:gsub(unpackdir, typesetdir)
4346 f = assert(io.open(file,"w"))
4347 f:write(content)
4348 f:close()
4349 end
4350 end
4351
4352 -- this file is needed for the documentation but isn't automatically
4353 -- copied
4354 cp("struktex-tst-00.nss", unpackdir, typesetdir)
4355
4356 return 0
4357 end
4358 --### doc_init_hook end ##############################################
4359
4360 -- Find and run the build system
4361 kpse.set_program_name("kpsewhich")
4362 if not release_date then
4363 dofile(kpse.lookup("l3build.lua"))
4364 end
4365
4366 %</lbuild>
4367 % \end{macrocode} ^^A$
4368 %
4369 % \ifnum\language=\languageNGerman%
4370 % Die folgende Zeilen, die nach Ausführen des Befehls |pdftex struktex.dtx| als Datei
4371 % \sFile{build-config.lua} vorliegen, dienen der Umschaltung der
4372 % Dokumentationssprache zwischen Deutsch und Englisch.%
4373 % \else%
4374 % The file \sFile{lbuild-config.lua} consists of the following lines and is
4375 % generated by executing the command |tex struktex.ins|. Its purpose is the
4376 % switching between English and german documentation.%
4377 % \fi%
4378 % \begin{macrocode}
4379 %<*config>
4380 -- configuration file for the StrukTeX package
4381
4382 % \end{macrocode}
4383 % \ifnum\language=\languageNGerman%
4384 % "`\cs{z}"' ermöglicht den Umbruch von Zeichenketten.
4385 % \else%
4386 % ``\cs{z}'' allows breaking strings.
4387 % \fi%
4388 % \begin{macrocode}
4389 print("This is the additional configuration for setting \z
4390 the documentation language")
4391
4392 % \end{macrocode}
4393 % \ifnum\language=\languageNGerman%
4394 % An dieser Stelle kann die Zielsprache die Dokumentation eingestellt werden,
4395 % erlaubt ist "`de"' oder "`en"'. |targetlanguage| muss global gelten, da
4396 % der Wert am Ende des Dokumentationslaufes benötigt wird.%
4397 % \else%
4398 % At this point the language of the documentation can be configured: one
4399 % can choose between ``de'' and ``en''. |targetlanguage| must be global, because
4400 % the value is referenced at the end of the documentation step.%
4401 % \fi%
4402 % \begin{macrocode}
4403 targetlanguage = targetlanguage or "de"
4404 print("target language: >" .. targetlanguage .. "<")
4405
4406 local exit = os.exit
4407
4408 if targetlanguage == "de" then
4409 typesetcmds = "\\def\\primarylanguage{ngerman}" ..
4410 "\\def\\secondarylanguage{english}"
4411 elseif targetlanguage == "en" then
4412 typesetcmds = "\\def\\primarylanguage{english}" ..
4413 "\\def\\secondarylanguage{ngerman}"
4414 else
4415 print("Illegal language")
4416 exit(1)
4417 end
4418 %</config>
4419 % \end{macrocode}
4420 %
4421 %
4422 % \changes{v2.3a}{18/03/07}{struktex.el: added package option fixedindent}
4423 % \changes{v055}{10/01/21}{added "declaration" to LaTeX-item-list again
4424 % (previously removed unintentionally)}
4425 % \changes{v055}{10/01/21}{corrected "task" entry}
4426 % \changes{v055}{10/01/21}{corrected lisp comments "\texttt{\char92}"
4427 % $\rightarrow$ "\texttt{\char92}\texttt{\char92}"}
4428 % \changes{v055}{10/01/21}{corrected format entry}
4429 % \changes{v-9.2}{10/01/18}{extended .el-file: `inparallel, `task, `inparallelend}
4430 % \changes{v-8.3}{06/08/18}{struktex.el erweitert, so dass die Parameter
4431 % alle Kommandos automatisch abgefragt werden.}
4432 % \section{\ifnum\language=\languageNGerman%
4433 % Stil-Datei zur einfachen
4434 % Eingabe von Struktogrammen beim Arbeiten mit dem Emacs und AUC\TeX
4435 % \else%
4436 % Style file for easier input while working with the Emacs
4437 % and AUC\TeX%
4438 % \fi%
4439 % }
4440 % \label{sec:auctex}
4441 %
4442 % \ifnum\language=\languageNGerman%
4443 % Der (X)emacs und das Paket AUC\TeX{}
4444 % (\url{http://www.gnu.org/software/auctex/}) bilden ein mächtiges Werkzeug
4445 % beim Erstellen von \TeX/\LaTeX-Dateien. Wenn es eine passende Stildatei
4446 % für ein \LaTeX-Paket wie das hier vorliegende \StrukTeX{} gibt,
4447 % wird die Eingabe von Quelltext durch automatisiertes Vervollständigen
4448 % und viele andere Hilfsmittel sehr erleichtert. Im folgenden wird eine
4449 % derartige Stildatei bereitgestellt; sie muss nach ihrer Erzeugung noch an
4450 % eine entsprechende Stelle kopiert werden.
4451 %
4452 % Diese Datei ist zum jetzigen Zeitpunkt noch in der Entwicklungsphase,
4453 % d.\,h. man kann mit ihr arbeiten, aber es fehlen noch ein paar Dinge wie
4454 % das \textit{font locking}, die Anzahl der automatisch eingefügten \cs{switch}
4455 % Kommandos sollte nicht fest gleich eins sein, sondern von der Anzahl der
4456 % eingegebenen Fälle abhängig sein.
4457 % \else%
4458 % The (X)emacs and the package AUC\TeX{}
4459 % (\url{http://www.gnu.org/software/auctex/}) form a powerful tool for
4460 % creating and editing of \TeX/\LaTeX{} files. If there is a suitable
4461 % AUCTeX style file for a \LaTeX{} package like the hereby provided
4462 % \StrukTeX{} package, then there is support for many common operations
4463 % like creating environments and so on. The following part provides such a
4464 % style file; it must be copied to a place, where (X)emacs can find it
4465 % after its creation.%
4466 %
4467 % This file is still in a development phase, i.\,e. one can work with it,
4468 % but there is a couple of missing things as for example font locking or
4469 % the automatic insertion of \cs{switch} commands according to the user's
4470 % input.%
4471 % \fi%
4472 % \begin{macrocode}
4473 %<*auctex>
4474 ;;; struktex.el -*-coding: utf-8; lexical-binding: t-*-
4475 ;;; AUCTeX style for `struktex.sty'
4476
4477 ;; Copyright (C) 2006 - 2025 Free Software Foundation, Inc.
4478
4479 ;; Author: J. Hoffmann <j.hoffmann_(at)_fh-aachen.de>
4480 ;; Maintainer: j.hoffmann_(at)_fh-aachen.de
4481 ;; Created: 2017/06/06
4482 ;; Keywords: tex
4483
4484 ;;; Commentary:
4485 ;; This file adds support for `struktex.sty'
4486
4487 ;;; Code:
4488
4489 (TeX-add-style-hook
4490 "struktex"
4491 (lambda ()
4492 ;; Add declaration to the list of environments which have
4493 ;; an optional argument for each item.
4494 (add-to-list 'LaTeX-item-list
4495 '("declaration" . LaTeX-item-argument))
4496 (LaTeX-add-environments
4497 "centernss"
4498 '("struktogramm" LaTeX-env-struktogramm)
4499 '("declaration" LaTeX-env-declaration))
4500 (TeX-add-symbols
4501 '("PositionNSS" 1)
4502 '("assert" [ "Height" ] "Assertion")
4503 '("assign" [ "Height" ] "Statement")
4504 "StrukTeX"
4505 '("case" TeX-mac-case)
4506 "switch" "Condition"
4507 "caseend"
4508 '("declarationtitle" "Title")
4509 '("description" "Name" "Meaning")
4510 "emptyset"
4511 '("exit" [ "Height" ] "What" )
4512 '("forever" TeX-mac-forever)
4513 "foreverend"
4514 '("forallin" TeX-mac-forallin)
4515 "forallin"
4516 '("ifthenelse" TeX-mac-ifthenelse)
4517 "change"
4518 "ifend"
4519 '("inparallel" TeX-mac-inparallel)
4520 '("task" "Description")
4521 "inparallelend"
4522 "sProofOn"
4523 "sProofOff"
4524 '("until" TeX-mac-until)
4525 "untilend"
4526 '("while" TeX-mac-while)
4527 "whileend"
4528 '("return" [ "Height" ] "Return value")
4529 '("sub" [ "Height" ] "Task")
4530 '("CenterNssFile" TeX-arg-file)
4531 '("centernssfile" TeX-arg-file))
4532 (TeX-run-style-hooks
4533 "pict2e"
4534 "emlines2"
4535 "curves"
4536 "struktxp"
4537 "struktxf"
4538 "ifthen")
4539 ;; Filling
4540 ;; Fontification
4541 ))
4542
4543 (defun LaTeX-env-struktogramm (environment)
4544 "Insert ENVIRONMENT with width, height specifications and
4545 optional title."
4546 (let ((width (read-string "Width: "))
4547 (height (read-string "Height: "))
4548 (title (read-string "Title (optional): ")))
4549 (LaTeX-insert-environment environment
4550 (concat
4551 (format "(%s,%s)" width height)
4552 (if (not (zerop (length title)))
4553 (format "[%s]" title))))))
4554
4555 (defun LaTeX-env-declaration (environment)
4556 "Insert ENVIRONMENT with an optional title."
4557 (let ((title (read-string "Title (optional): ")))
4558 (LaTeX-insert-environment environment
4559 (if (not (zerop (length title)))
4560 (format "[%s]" title)))))
4561
4562 (defun TeX-mac-case (macro)
4563 "Insert \\case with all arguments, the needed \\switch(es) and
4564 the final \\caseend. These are optional height and the required
4565 arguments slope, number of cases, condition, and the texts for
4566 the different cases"
4567 (let ((height (read-string "Height (optional): "))
4568 (slope (read-string "Slope: "))
4569 (number (read-string "Number of cases: "))
4570 (condition (read-string "Condition: "))
4571 (text (read-string "Case no. 1: "))
4572 (count 1)
4573 )
4574 (setq number-int (string-to-number number))
4575 (insert (concat (if (not (zerop (length height)))
4576 (format "[%s]" height))
4577 (format "{%s}{%s}{%s}{%s}"
4578 slope number condition text)))
4579 (while (< count number-int)
4580 (end-of-line)
4581 (newline-and-indent)
4582 (newline-and-indent)
4583 (setq prompt (format "Case no. %d: " (+ 1 count)))
4584 (insert (format "\\switch{%s}" (read-string prompt)))
4585 (setq count (1+ count)))
4586 (end-of-line)
4587 (newline-and-indent)
4588 (newline-and-indent)
4589 (insert "\\caseend")))
4590
4591 (defun TeX-mac-forallin (macro)
4592 "Insert \\forallin-block with all arguments.
4593 This is the optional height and the description of the loop"
4594 (let ((height (read-string "Height (optional): "))
4595 (loop-description (read-string "Description of loop: ")))
4596 (insert (concat (if (not (zerop (length height)))
4597 (format "[%s]" height))
4598 (format "{%s}"
4599 loop-description)))
4600 (end-of-line)
4601 (newline-and-indent)
4602 (newline-and-indent)
4603 (insert "\\forallinend")))
4604
4605 (defun TeX-mac-forever (macro)
4606 "Insert \\forever-block with all arguments.
4607 This is only the optional height"
4608 (let ((height (read-string "Height (optional): ")))
4609 (insert (if (not (zerop (length height)))
4610 (format "[%s]" height)))
4611 (end-of-line)
4612 (newline-and-indent)
4613 (newline-and-indent)
4614 (insert "\\foreverend")))
4615
4616 (defun TeX-mac-ifthenelse (macro)
4617 "Insert \\ifthenelse with all arguments.
4618 These are optional height and the required arguments
4619 left slope, right slope, condition, and the possible
4620 values of the condition"
4621 (let ((height (read-string "Height (optional): "))
4622 (lslope (read-string "Left slope: "))
4623 (rslope (read-string "Right slope: "))
4624 (condition (read-string "Condition: "))
4625 (conditionvl (read-string "Condition value left: "))
4626 (conditionvr (read-string "Condition value right: ")))
4627 (insert (concat (if (not (zerop (length height)))
4628 (format "[%s]" height))
4629 (format "{%s}{%s}{%s}{%s}{%s}"
4630 lslope rslope condition conditionvl
4631 conditionvr)))
4632 (end-of-line)
4633 (newline-and-indent)
4634 (newline-and-indent)
4635 (insert "\\change")
4636 (end-of-line)
4637 (newline-and-indent)
4638 (newline-and-indent)
4639 (insert "\\ifend")))
4640
4641 (defun TeX-mac-inparallel (macro)
4642 "Insert \\inparallel with all arguments, the needed \\task(s)
4643 and the final \\inparallelend. These are optional height and the
4644 required arguments number of tasks and the descriptions for the
4645 parallel tasks"
4646 (let ((height (read-string "Height (optional): "))
4647 (number (read-string "Number of parallel tasks: "))
4648 (text (read-string "Task no. 1: "))
4649 (count 1)
4650 )
4651 (setq number-int (string-to-number number))
4652 (insert (concat (if (not (zerop (length height)))
4653 (format "[%s]" height))
4654 (format "{%s}{%s}" number text)))
4655 (while (< count number-int)
4656 (end-of-line)
4657 (newline-and-indent)
4658 (newline-and-indent)
4659 (setq prompt (format "Task no. %d: " (+ 1 count)))
4660 (insert (format "\\task{%s}" (read-string prompt)))
4661 (setq count (1+ count)))
4662 (end-of-line)
4663 (newline-and-indent)
4664 (newline-and-indent)
4665 (insert "\\inparallelend")))
4666
4667 (defun TeX-mac-until (macro)
4668 "Insert \\until with all arguments.
4669 These are the optional height and the required argument condition"
4670 (let ((height (read-string "Height (optional): "))
4671 (condition (read-string "Condition: ")))
4672 (insert (concat (if (not (zerop (length height)))
4673 (format "[%s]" height))
4674 (format "{%s}" condition)))
4675 (end-of-line)
4676 (newline-and-indent)
4677 (newline-and-indent)
4678 (insert "\\untilend")))
4679
4680 (defun TeX-mac-while (macro)
4681 "Insert \\while with all arguments.
4682 These are the optional height and the required argument condition"
4683 (let ((height (read-string "Height (optional): "))
4684 (condition (read-string "Condition: ")))
4685 (insert (concat (if (not (zerop (length height)))
4686 (format "[%s]" height))
4687 (format "{-%s-}" condition)))
4688 (end-of-line)
4689 (newline-and-indent)
4690 (newline-and-indent)
4691 (insert "\\whileend")))
4692
4693 (defvar LaTeX-struktex-package-options '("curves" "debug"
4694 "draft" "emlines" "final"
4695 "fixedindent" "nofiller"
4696 "outer" "pict2e" "verification")
4697 "Package options for the struktex package.")
4698
4699 ;;; struktex.el ends here.
4700 %</auctex>
4701 % \end{macrocode}
4702 %
4703 %
4704 % \changes{v2.4}{20/01/28}{added l3build}
4705 % \StopEventually{
4706 % \begin{thebibliography}{MDB01}
4707 %
4708 % \bibitem[Fut89]{Futschek:Programmentwicklung}
4709 % Gerald Futschek.
4710 % \newblock {\em Programmentwicklung und Verifikation}.
4711 % \newblock Springer Verlag, Wien -- New York, 1989.
4712 %
4713 % \bibitem[GMS94]{GoossensMittelbachSamarin:Companion}
4714 % Michel Goossens, Frank Mittelbach and Alexander Samarin.
4715 % \newblock {\em The \LaTeX-Companion}.
4716 % \newblock Addison-Wesley Publishing Company, Reading, Massachusetts, 1994.
4717 %
4718 % \bibitem[GMS04]{MittelbachGoossens:Companion2}
4719 % Frank Mittelbach and Michel Goossens.
4720 % \newblock {\em The \LaTeX-Companion}.
4721 % \newblock Addison-Wesley Publishing Company, Reading,
4722 % Massachusetts, second edition, 2004.
4723 %
4724 % \bibitem[Knu86]{Knuth:TeXBook}
4725 % D.~E. Knuth.
4726 % \newblock {\em {The \TeX-Book}}.
4727 % \newblock Addison-Wesley, Reading, Massachusetts, 1986.
4728 %
4729 % \bibitem[LaT20]{LaTeX3:l3build}
4730 % The \LaTeX{3} Project.
4731 % \newblock {\em {The {\sf l3build} package---Checking and building
4732 % packages}}, Januar 2020.
4733 %
4734 % \bibitem[MDB94]{MittelbachDuchierBraams:DocStrip}
4735 % Frank Mittelbach, Denys Duchier and Johannes Braams.
4736 % \newblock {\em {The {\sf DocStrip} program}}, Dezember 1994.
4737 %
4738 % \bibitem[MDB01]{MittelbachDuchierBraams:DocStrip-V-2.5b}
4739 % Frank Mittelbach, Denys Duchier, Johannes Braams,
4740 % Marcin Woli\'nski and Mark Wooding
4741 % \newblock {\em {The {\sf DocStrip} program}}, September 2001.
4742 %
4743 % \bibitem[Mit94]{FM:TheDocAndShortvrbPackages}
4744 % Frank Mittelbach.
4745 % \newblock {\em {The {\sf doc} and {\sf shortvrb} Packages}}, Oktober 1994.
4746 %
4747 % \bibitem[Mit01]{FM:TheDocAndShortvrbPackages-V-2.0}
4748 % Frank Mittelbach.
4749 % \newblock {\em {The {\sf doc} and {\sf shortvrb} Packages}}, September 2001.
4750 %
4751 % \bibitem[Neu96]{Neubauer:MikrotypographieI}
4752 % Marion Neubauer.
4753 % \newblock {Feinheiten bei wissenschaftlichen Publikationen --
4754 % Mikrotypographie-Regeln, Teil I}.
4755 % \newblock {\em Die \TeX{}nische Komödie}, 8(4):23--40, Februar 1996.
4756 %
4757 % \bibitem[Rah92]{Rahtz:OZ.STY}
4758 % Sebastian Rahtz.
4759 % \newblock {\em The {\sf oz} package}, 1999.
4760 %
4761 % \end{thebibliography}
4762 %
4763 % \ifmulticols
4764 % \addtocontents{toc}{\protect\end{multicols}}
4765 % \fi
4766 % } ^^A end of \StopEventually
4767 %
4768 % \clearpage
4769 %
4770 % \section{\ifnum\language=\languageNGerman Die Implementation \else The implementation \fi}
4771 %
4772 % \ifnum\language=\languageNGerman%
4773 % Der \StrukTeXSty{} stellt eine einfache Implementation der beschriebenen
4774 % Makros dar; er sollte prinzipiell mit anderen Makropaketen verträglich sein.
4775 % Die Gültigkeit von Makros wurde im Regelfall auf einen
4776 % möglichst kleinen Bereich beschränkt. Um Seiteneffekte mit anderen
4777 % \foreign{packages} so weit wie möglich zu vermeiden, werden alle
4778 % intern genutzten Makros mit dem Suffix |@nss| versehen.
4779 % \else%
4780 % The \StrukTeXSty{} shows a simple implementation of the described macros.
4781 % On principal it should be compatible with other macro packages.
4782 % The validity of macros has been normally reduced to a range as small as possible.
4783 % All internally used macros are supplied by the suffix |@nss| for avoiding
4784 % sideeffects with other \foreign{packages} as far as possible.%
4785 % \fi%
4786 %
4787 % \subsection{\ifnum\language=\languageNGerman Allgemeines \else General
4788 % information\fi}
4789 %
4790 % \changes{v084}{10/06/24}{removed flag preventing double load of the package}
4791 % \ifnum\language=\languageNGerman%
4792 % Dies ist ein Paket, das für \LaTeX2e entwickelt wurde, es wird daher
4793 % eine entsprechende Fehlermeldung ausgegeben, wenn ein anderes Format
4794 % benutzt wird,
4795 % was nicht zu Fehlern führen sollte; zusätzlich wird das Paket
4796 % \sFile{ifthen.sty} geladen, falls es noch nicht anderweitig angefordert
4797 % wurde.
4798 % \else%
4799 % This is a package, that has been developed for \LaTeX2e. Hence it will be
4800 % print an adequate error message, if another format is used, which should
4801 % not lead to any errors. In addition the package \sFile{ifthen.sty} will
4802 % be loaded, if not already done.%
4803 % \fi%
4804 % \changes{v-4.4b}{96/03/13}{`RequirePackage umgestellt wg. korrekter
4805 % Versionsmeldung}
4806 % \ifnum\language=\languageNGerman%
4807 % Nun wird das Einlesen des Makropakets mit der aktuellen
4808 % Versionsnummer gemeldet.
4809 % \else%
4810 % Now loading of the macro package with the actual version number will
4811 % be messaged.%
4812 % \fi%
4813 % \begin{macrocode}
4814 %<*struktex>
4815 % \end{macrocode}
4816 %
4817 % \begin{macrocode}
4818 \RequirePackage{ifthen}
4819 % \end{macrocode}
4820 % \ifnum\language=\languageNGerman%
4821 % Der |\ifthenelse|-Makro muss unter einem anderen Namen verfügbar bleiben,
4822 % da \StrukTeX{} einen gleichnamigen Makro mit einer anderen Bedeutung
4823 % bereitstellt.%
4824 % \else%
4825 % The |\ifthenelse| must be mapped to |\@ifthenelse| to prevent overloading it by
4826 % the command from the current package with the same name.%
4827 % \fi%
4828 % \begin{macrocode}
4829 \let\@ifthenelse\ifthenelse
4830 % \end{macrocode}
4831 % \ifnum\language=\languageNGerman%
4832 % \StrukTeX{} benötigt zwei weitere Pakete, die zum Lieferumfang gehören.
4833 % Diese werden hier geladen.%
4834 % \else%
4835 % \StrukTeX{} uses two additional packages which are included in the
4836 % package,these are loaded here.%
4837 % \fi
4838 % \begin{macrocode}
4839 \RequirePackage{struktxf}
4840 \RequirePackage{struktxp}
4841 % \end{macrocode}
4842 %
4843 % \changes{v075}{10/06/23}{added markers to make debug code removeable}
4844 % \ifnum\language=\languageNGerman%
4845 % Zu Entwicklungszwecken werden hier ein paar Makros definiert, die
4846 % Hilfsausgaben erzeugen (Option: |debug|, für die Veröffentlichung
4847 % sollte diese Option nicht gesetzt werden).%
4848 % \else%
4849 % For developing purposes there are some debugging macros (option: |debug|,
4850 % for the release
4851 % version this option shouldn't be set at all); .%
4852 % \fi%
4853 % \changes{v061}{10/05/31}{added some debugging macros}
4854 % \begin{macrocode}
4855 \newcommand{\dbgArgs@nss}[1]{\typeout{===> dbg Args:\space\space\space#1}}
4856 \newcommand{\dbgCond@nss}[1]{%
4857 \@ifthenelse{\boolean{#1}}{
4858 \typeout{===> dbg Cond:\space #1 = true}
4859 }{
4860 \typeout{===> dbg Cond:\space #1 = false}
4861 }
4862 }
4863 \newcommand{\dbgCount@nss}[2][]{%
4864 \def\argI{#1}% ^^A dbg
4865 \typeout{===> dbg Count:\space\space\ifx\argI\empty\else(#1)\space\fi%
4866 \string#2 = \the#2}}
4867 \newcommand{\dbgCoord@nss}[3][]{%
4868 \def\argI{#1}% ^^A dbg
4869 \typeout{===> dbg Coord:\space\space\ifx\argI\empty\else(#1)\space\fi%
4870 (\string#2, \string#3) = (\the#2, \the#3)}}% ^^A dbg
4871 \newcommand{\dbgMark@nss}[3][]{%
4872 \def\argI{#1}% ^^A dbg
4873 \put(#2,#3){\makebox(0,0)[cc]{\ifx\argI\empty$\bullet$\else#1\fi%
4874 }}}% ^^A dbg
4875 \newcommand{\dbgString@nss}[1]{\typeout{===> dbg String:\space#1}}
4876 % \end{macrocode}
4877 % \changes{v075}{10/06/23}{added some more documentation about options}
4878 % \changes{v-5.3a}{98/11/27}{Option \texttt{emlines} eingeführt}
4879 % \ifnum\language=\languageNGerman%
4880 % Ab der Version v-5.3a kennt \StrukTeX{} eine Option "`|emlines|"', die es
4881 % ermöglicht, Geraden beliebiger Steigung zu zeichnen; später kann auch
4882 % das Paket \sFile{curves} (Option "`|curves|"') zum Zeichnen beliebiger
4883 % Steigungen eingesetzt werden, ab der Version v-8.0a wird auch das Paket
4884 % \sFile{pict2e} (Option "`|pict2e|"') unterstützt, das dazugehörige
4885 % Paket wird hier geladen.%
4886 % \else%
4887 % From version v-5.3a on there is the option ``|emlines|'' which makes it
4888 % possible to draw lines with any slope; later on one can use the package
4889 % \sFile{curves} (Option ``|curves|'') and from version v-8.0a on
4890 % \sFile{pict2e} (option ``|pict2e|'') is supported, these packages are
4891 % loaded here.%
4892 % \fi
4893 % \changes{v3.0}{25/06/19}{replaced gradient by slope}
4894 % \changes{v104}{10/08/15}{some editorial changes}
4895 % \begin{macrocode}
4896 \newboolean{curves}
4897 \newboolean{emlines}
4898 \newboolean{pictIIe}
4899 \newboolean{anyslope}
4900 \DeclareOption{curves}{%
4901 \setboolean{anyslope}{true}
4902 \setboolean{curves}{true}
4903 \setboolean{emlines}{false}
4904 \setboolean{pictIIe}{false}
4905 }
4906 \DeclareOption{emlines}{%
4907 \setboolean{anyslope}{true}
4908 \setboolean{curves}{false}
4909 \setboolean{emlines}{true}
4910 \setboolean{pictIIe}{false}
4911 }
4912 \DeclareOption{pict2e}{%
4913 \setboolean{anyslope}{true}
4914 \setboolean{curves}{false}
4915 \setboolean{emlines}{false}
4916 \setboolean{pictIIe}{true}
4917 }
4918 % \end{macrocode}
4919 %
4920 % \ifnum\language=\languageNGerman%
4921 % Zur Unterstützung der Internationalisierung werden feste Texte in der
4922 % jeweilig benutzten Sprache (beispielsweise als |babel|-Option definiert)
4923 % hier vorbereitet.
4924 % \else%
4925 % To support i18n as provided by |babel| here are some common fixed texts:%
4926 % \fi%
4927 % \changes{v121}{10/08/31}{added some more translations}
4928 % \changes{v104}{10/08/15}{first steps to babel support}
4929 % \begin{macrocode}
4930 \DeclareOption{english}{%
4931 \def\declarationtitlename@nss{providing memory space:}%
4932 \def\pTruename@nss{true}%
4933 \def\pFalsename@nss{false}%
4934 }
4935 \DeclareOption{german}{%
4936 \def\declarationtitlename@nss{Speicherplatz bereitstellen:}
4937 \def\pTruename@nss{WAHR}%
4938 \def\pFalsename@nss{FALSCH}%
4939 }
4940 \DeclareOption{ngerman}{%
4941 \def\declarationtitlename@nss{Speicherplatz bereitstellen:}
4942 \def\pTruename@nss{WAHR}%
4943 \def\pFalsename@nss{FALSCH}%
4944 }
4945 % \end{macrocode}
4946 %
4947 % \changes{v-7.0a}{04/01/05}{Option \texttt{verification} eingeführt}
4948 % \ifnum\language=\languageNGerman%
4949 % Ab der Version v-7.0a kennt \StrukTeX{} eine Option "`|verification|"', die
4950 % ein zusätzliches Element definiert: die \cs{assert}-Box, die in
4951 % \cite{Futschek:Programmentwicklung} eingeführt wird.
4952 % \else%
4953 % From version v-7.0a on \StrukTeX{} knows the option ``|verification|'', which
4954 % defines an additional element: the \cs{assert}-box, which is introduced
4955 % in \cite{Futschek:Programmentwicklung}.%
4956 % \fi%
4957 % \begin{macrocode}
4958 \newboolean{verification}
4959 \DeclareOption{verification}%
4960 {%
4961 \setboolean{verification}{true}
4962 }
4963 % \end{macrocode}
4964 %
4965 % \changes{v-8.2a}{06/01/17}{Option \texttt{nofiller} eingeführt}
4966 % \ifnum\language=\languageNGerman%
4967 % Ab der Version v-8.2a kennt \StrukTeX{} eine Option ``|nofiller|'', die
4968 % die Darstellung von Leerraum beeinflusst: ohne diese Option wird in
4969 % Alternativen ein \(\emptyset\)-Zeichen ausgegeben, wenn der Platz
4970 % ausreichend ist. Dies führt zu einer uneinheitlichen Darstellung im
4971 % Vergleich mit dem Leerraum, der von einem \cs{case}-Block erzeugt wird,
4972 % da hier der Leerraum nicht in entsprechende Weise angezeigt wird -- dies
4973 % wäre nur mit einer aufwendigen Listenverwaltung möglich. Angabe der
4974 % Option führt dazu, dass das \(\emptyset\)-Zeichen einheitlich weggelassen
4975 % wird.
4976 % \else%
4977 % From version v-8.2a on \StrukTeX{} knows the option ``|nofiller|'', which
4978 % makes the \(\emptyset\)-character vanishing in alternatives.%
4979 % \fi%
4980 % \begin{macrocode}
4981 \newboolean{filler}
4982 \setboolean{filler}{true}
4983 \DeclareOption{nofiller}%
4984 {%
4985 \setboolean{filler}{false}
4986 }
4987 % \end{macrocode}
4988 %
4989 % \changes{v-8.3}{06/08/17}{Optionen \texttt{draft} und \texttt{final} eingeführt}
4990 % \ifnum\language=\languageNGerman%
4991 % Ab der Version v-8.3 kennt \StrukTeX{} die Optionen "`|draft|"' und
4992 % "`|final|"', die zwischen dem Entwurf und der endgültigen Version des
4993 % Struktogramms umschalten. Entwurfsmodus ist |\sProofOn| gesetzt, für die
4994 % endgültige Version wird |\sProofOff| gesetzt.%
4995 % \else%
4996 % From version v-8.3 on \StrukTeX{} knows the options ``|draft|'' and
4997 % ``|final|'', which differentiate between the draft (|\sProofOn|) and the
4998 % final (|\sProofOff|) version of the structured box chart makes the
4999 % \(\emptyset\)-character vanishing in alternatives.%
5000 % \fi
5001 % \begin{macrocode}
5002 \let\ifdraft@nss\iffalse
5003 \let\iffinal@nss\iftrue
5004 \DeclareOption{draft}%
5005 {%
5006 \let\ifdraft@nss\iftrue
5007 \let\iffinal@nss\iffalse
5008 }
5009 \DeclareOption{final}%
5010 {%
5011 \let\ifdraft@nss\iffalse
5012 \let\iffinal@nss\iftrue
5013 }
5014 % \end{macrocode}
5015 %
5016 % \begin{macrocode}
5017 \newboolean{debug}
5018 \DeclareOption{debug}%
5019 {%
5020 \setboolean{debug}{true}
5021 }
5022 \DeclareOption{nodebug}%
5023 {%
5024 \setboolean{debug}{false}
5025 }
5026 % \end{macrocode}
5027 %
5028 % \begin{macrocode}
5029 \newboolean{outer}
5030 \DeclareOption{outer}%
5031 {%
5032 \setboolean{outer}{true}
5033 }
5034 % \end{macrocode}
5035 %
5036 % \changes{v2.3}{17/11/17}{introduced option \texttt{fixedindent}}
5037 % \ifnum\language=\languageNGerman%
5038 % Ab der Version v2.3 kennt \StrukTeX{} eine Option "`|fixedindent|"', die
5039 % den Einzug von Blöcken in |while|- und |until|-Schleifen
5040 % beeinflusst. Standardmäßig ist dieser Einzug gleich dem vertikalen
5041 % Abstand zum umgebenden Block, was bei mehrzeiligen Bedingungen zu einem
5042 % großen, unschönen Einzug führt. Wenn |fixedindent| gesetzt ist, entspricht
5043 % der Einzug (ungefähr) dem Zeilenabstand, was einer einzeiligen Bedingung
5044 % entspricht. Der Makrobefehl |\dimtomm| stammt aus
5045 % \url{https://tex.stackexchange.com/questions/223740/convert-dimension-to-integer-number-of-mm}.%
5046 % \else%
5047 % From version v2.3 on \StrukTeX{} has an option ``|fixedindent|'', which affects
5048 % the indentation of blocks in |while| and |until| loops. By default, this
5049 % indentation is the same as the vertical distance to the surrounding
5050 % block, which leads in multi-line conditions to a large, ugly
5051 % indentation. If |fixedindent| is set, the indentation (approximately)
5052 % corresponds to the line spacing, which is equivalent to a one-line
5053 % condition. The macro |\dimtomm| comes from
5054 % \url{https://tex.stackexchange.com/questions/223740/convert-dimension-to-integer-number-of-mm}.%
5055 % \fi%
5056 % \begin{macrocode}
5057 \def\dimtomm #1{\the\numexpr \dimexpr #1\relax*635000/118407168\relax }
5058 % \end{macrocode}
5059 % \begin{macrocode}
5060 \newboolean{fixedindent@nss}
5061 \DeclareOption{fixedindent}%
5062 {%
5063 \setboolean{fixedindent@nss}{true}
5064 \gdef\xindent@nss{\dimtomm{\baselineskip}}
5065 }
5066 % \end{macrocode}
5067 %
5068 %% \ifnum\language=\languageNGerman%
5069 % Nun werden andere Pakete geladen und die Optionen verarbeitet.%
5070 % \else%
5071 % Now load additional packages and process the options.%
5072 % \fi
5073 % \changes{v141}{12/04/10}{added `ExecuteOptions call for settings default
5074 % values}
5075 % \changes{v104}{10/08/15}{corrected `ProcessOptions call}
5076 % \begin{macrocode}
5077 \ExecuteOptions{pict2e,english,final}
5078 \ProcessOptions*\relax
5079 \ifcurves%
5080 \RequirePackage{curves}
5081 \else\ifemlines
5082 \RequirePackage{emlines2}
5083 \else\ifpictIIe
5084 \RequirePackage{pict2e}
5085 \fi\fi\fi
5086 \ifthenelse{\boolean{debug}}{
5087 \typeout{debug active}}{
5088 \typeout{debug inactive}
5089 \renewcommand{\dbgCond@nss}[1]{}
5090 \renewcommand{\dbgCount@nss}[2][]{}
5091 \renewcommand{\dbgCoord@nss}[3][]{}
5092 \renewcommand{\dbgMark@nss}[3][]{}
5093 \renewcommand{\dbgString@nss}[1]{}
5094 }
5095 % \end{macrocode}
5096 %
5097 % \begin{macro}{\StrukTeX}
5098 % \ifnum\language=\languageNGerman%
5099 % Das Logo des Paketes:%
5100 % \else%
5101 % The logo of package:%
5102 % \fi%
5103 % \begin{macrocode}
5104 \def\StrukTeX{S\kern-.05emt\kern-.05em\raise.5ex\hbox{r}%
5105 \kern-.1667emu\kern-.05em\lower.5ex\hbox{k}%
5106 \kern-.2emT\kern-.1667em\lower.7ex\hbox{E}\kern-.125emX}
5107 % \end{macrocode}
5108 % \end{macro}
5109 %
5110 % \begin{macrocode}
5111 %</struktex>
5112 % \end{macrocode}
5113 %
5114 %
5115 % \subsection{\ifnum\language=\languageNGerman Das \textsf{struktxf} Paket
5116 % \else The \textsf{struktxf} Package
5117 % \fi}
5118 %
5119 % \changes{v-4.1c}{95/07/24}{Eigene Datei für spezielle Fonts anlegen}
5120 % \ifnum\language=\languageNGerman%
5121 % Um eine einheitliche Darstellung von Zuweisungen und Zeichen über
5122 % verschiedene Dokumente hinweg gewährleisten zu können, wird hier ein
5123 % eigenes Paket bereitgestellt
5124
5125 % Zunächst werden zusätzlich benötigte Fonts und ein paar Glyphen bereitgestellt. Da diese
5126 % Fonts auch in anderem Zusammenhang benötigt werden, wird hierfür ein
5127 % eigenes Paket definiert.
5128 % \else%
5129 % First the additionally needed fonts are provided. Since these fonts are also used
5130 % in another connection, therefore an own package is defined.%
5131 % \fi%
5132 % \begin{macrocode}
5133 %<*struktxf>
5134 % \end{macrocode}
5135 %
5136 % \begin{macrocode}
5137 \DeclareKeys{
5138 iso.if = @nss@iso,
5139 mathbb.ifnot = @nss@iso,
5140 mathitalics.if = @nss@mathitalics,
5141 mathnormal.ifnot = @nss@mathitalics
5142 }
5143
5144 \ProcessKeyOptions
5145 \SetKeys{iso=false, mathitalics=true} % the default values for use with struktex.sty
5146
5147 \DeclareSymbolFont{italics}{\encodingdefault}{\rmdefault}{m}{it}%
5148 \DeclareSymbolFont{AMSb}{U}{msb}{m}{n}
5149 \DeclareSymbolFontAlphabet{\mathbb}{AMSb}
5150 % \end{macrocode}
5151 %
5152 % \begin{macro}{\nat}
5153 % \begin{macro}{\integer}
5154 % \begin{macro}{\rational}
5155 % \begin{macro}{\real}
5156 % \begin{macro}{\complex}
5157 % \changes{v-4.1b}{95/07/23}{`complex eingeführt}
5158 % \changes{v-4.1a}{95/07/17}{`nat, `integer und `real eingeführt}
5159 % \ifnum\language=\languageNGerman%
5160 % Die folgenden Makros dienen dem vereinfachten Schreiben von Mengen:
5161 % \else%
5162 % The following macros contribute to easier writing of sets:%
5163 % \fi%
5164 % \begin{macrocode}
5165 \newcommand{\naturalNumber}{\if@nss@iso\mathbf{N}\else\mathbb{N}\fi}
5166 \newcommand{\integerNumber}{\if@nss@iso\mathbf{Z}\else\mathbb{Z}\fi}
5167 \newcommand{\rationalNumber}{\if@nss@iso\mathbf{Q}\else\mathbb{Q}\fi}
5168 \newcommand{\realNumber}{\if@nss@iso\mathbf{R}\else\mathbb{R}\fi}
5169 \newcommand{\complexNumber}{\if@nss@iso\mathbf{C}\else\mathbb{C}\fi}
5170 \let\nat\naturalNumber
5171 \let\integer\integerNumber
5172 \let\rational\rationalNumber
5173 \let\real\realNumber
5174 \let\complex\complexNumber
5175 % \end{macrocode}
5176 % \end{macro}
5177 % \end{macro}
5178 % \end{macro}
5179 % \end{macro}
5180 % \end{macro}
5181 %
5182 % \begin{macro}{\btt}
5183 % \changes{v-4.1a}{95/07/17}{`btt auf NFSS umgestellt}
5184 % \changes{v-8.0b}{04/07/14}{Hinweis auf Luxi Mono als Ersatz fuer cmbtt}
5185 % \ifnum\language=\languageNGerman%
5186 % Um fetten Schreibmaschinensatz erzeugen zu können, gibt es den Font \cs{btt},
5187 % der als Erweiterung der \textsf{cmtt}-Font-Familie definiert ist. Um
5188 % auf diesen Font auch ohne zusätzliches Einbinden dieses \foreign{packages}
5189 % zugreifen zu können, kann man die entsprechenden Deklarationen in den
5190 % Dateien |ot1cmtt.fd| bzw.\ |t1cmtt.fd| durch die folgende
5191 % ersetzen.\footnote{Eine Alternative ist die Benutzung des Luxi Mono Fonts.}
5192 % \else%
5193 % For generating bold face typescript there's the font \cs{btt}, that is defined as
5194 % an extension of the \textsf{cmtt} font family. For access to these
5195 % \foreign{packages} without supplementary tieing up one can exchange the
5196 % adequate declaration in the files |ot1cmtt.fd| or |t1cmtt.fd|
5197 % respectively by the following:\footnote{An alternative is using the font
5198 % Luxi Mono.}%
5199 % \fi%
5200 % \begin{macrocode}
5201 \DeclareFontFamily{OT1}{cmbtt}{}
5202 \DeclareFontShape{OT1}{cmtt}{bx}{n}{
5203 <-8> cmbtt8 <9> cmbtt9 <10-> cmbtt10
5204 }{}
5205
5206 \def\btt{%
5207 \fontencoding{\encodingdefault}\fontfamily{cmbtt}\fontseries{bx}%
5208 \fontshape{n}\selectfont%
5209 }
5210 % \end{macrocode}
5211 % \end{macro}
5212 %
5213 % \begin{macro}{\MathItalics}
5214 % \begin{macro}{\MathNormal}
5215 % \changes{v-4.1a}{95/07/17}{`MathItalics und `MathNormal eingeführt}
5216 % \ifnum\language=\languageNGerman%
5217 % Die folgenden Makros dienen dem Umschalten zwischen verschiedenen Formen
5218 % der \foreign{italics} im Mathematik-Modus. Sie wurden aus
5219 % \cite{Rahtz:OZ.STY} übernommen. Als Standard wird \cs{MathItalics}
5220 % genommen, um eine schönere Darstellung von langen Variablennamen zu
5221 % erzielen.
5222 % \else%
5223 % The following macros contribute to the switch of the different forms of
5224 % \foreign{italics} in math mode. They have been taken over from
5225 % \cite{Rahtz:OZ.STY}. As a standard there will be taken \cs{MathItalics} to
5226 % generate a nicer representation of long variable names.%
5227 % \fi%
5228 % \begin{macrocode}
5229 \def\@setmcodes#1#2#3{{\count0=#1 \count1=#3
5230 \loop \global\mathcode\count0=\count1 \ifnum \count0<#2
5231 \advance\count0 by1 \advance\count1 by1 \repeat}}
5232 \def\MathItalics%
5233 {%
5234 \@setmcodes{`A}{`Z}{"7\hexnumber@\symitalics41}
5235 \@setmcodes{`a}{`z}{"7\hexnumber@\symitalics61}
5236 }
5237 \def\MathNormal%
5238 {%
5239 \@setmcodes{`A}{`Z}{"7141}
5240 \@setmcodes{`a}{`z}{"7161}
5241 }
5242
5243 \AtBeginDocument{
5244 \if@nss@mathitalics\typeout{!!! switch to
5245 italics}\MathItalics\else\typeout{!!! switch to normal}\MathNormal\fi
5246 }
5247 % \end{macrocode}
5248 % \end{macro}
5249 % \end{macro}
5250 %
5251 % \begin{macrocode}
5252 %</struktxf>
5253 % \end{macrocode}
5254 %
5255 % \subsection[\ifnum\language=\languageNGerman Darstellung von Variablen
5256 % etc.\else Representation of variables etc.\fi]{%
5257 % \ifnum\language=\languageNGerman%
5258 % Makros zur Darstellung von Variablen, Schlüsselwörtern und anderen
5259 % programmierspezifischen Details%
5260 % \else%
5261 % Macros for representing of variables, keywords and other specific details
5262 % of programming%
5263 % \fi%
5264 % }
5265 %
5266 % \changes{v121}{10/08/31}{removed unnecessary test to prevent double
5267 % loading of package}
5268 % \changes{v121}{10/08/31}{added package url as an requirement}
5269 % \begin{macrocode}
5270 %<*struktxp>
5271 % \end{macrocode}
5272 %
5273 % \begin{macrocode}
5274 \RequirePackage{url}
5275 % \end{macrocode}
5276 %
5277 % \begin{macro}{\pExpFont@nss}
5278 % \changes{v-5.4a}{99/11/16}{neu eingeführt, ersetzt `pVarFont@nss}
5279 % \begin{macro}{\pKeyFont@nss}
5280 % \changes{v-4.5a}{96/03/15}{neu eingeführt}
5281 % \begin{macro}{\pCommentFont@nss}
5282 % \changes{v-4.5a}{96/03/15}{neu eingeführt}
5283 % \ifnum\language=\languageNGerman%
5284 % Die drei Makros |\pExpFont@nss|, |\pKeyFonts@nss| und |\pCommentFont@nss|
5285 % dienen der Vorbesetzung der Fonts zur Formatierung von Variablen,
5286 % Schlüsselwörtern und Kommentar. Diese kann mit dem Kommando \cs{pFonts}
5287 % umdefiniert werden.
5288 % \else%
5289 % The three macros |\pExpFont@nss|, |\pKeyFonts@nss| and |\pCommentFonr@nss|
5290 % contribute to the default of fonts which serve to formatting variables,
5291 % keywords and comments. These can be redefined by the command \cs{pFonts}.%
5292 % \fi%
5293 % \begin{macrocode}
5294 \newcommand{\pExpFont@nss}{\small\sffamily}
5295 \newcommand{\pKeyFont@nss}{\small\sffamily\bfseries}
5296 \newcommand{\pCommentFont@nss}{\small\sffamily\slshape}
5297 % \end{macrocode}
5298 % \end{macro}
5299 % \end{macro}
5300 % \end{macro}
5301 %
5302 % \begin{macro}{\pFonts}
5303 % \changes{v-4.5a}{96/03/15}{neu eingeführt}
5304 % \ifnum\language=\languageNGerman%
5305 % Der Makro \cs{pFonts} dient dem Umsetzen der Vorbesetzungen der Fonts
5306 % zum Setzen von Variablennamen, Schlüsselwörtern und Kommentar:
5307 % \else%
5308 % The macro \cs{pFonts} serves to the change of default of fonts for
5309 % setting variable names, keywords and comments:%
5310 % \fi%
5311 % \begin{macrocode}
5312 \newcommand{\pFonts}[3]{%
5313 \def\argi@nss{#1} \def\argii@nss{#2} \def\argiii@nss{#3}%
5314 \ifx\argi@nss\empty\else%
5315 \renewcommand{\pExpFont@nss}{#1}%
5316 \fi%
5317 \ifx\argii@nss\empty\else%
5318 \renewcommand{\pKeyFont@nss}{#2}%
5319 \fi%
5320 \ifx\argiii@nss\empty\else%
5321 \renewcommand{\pCommentFont@nss}{#3}%
5322 \fi%
5323 }
5324 % \end{macrocode}
5325 % \end{macro}
5326 %
5327 % \ifnum\language=\languageNGerman%
5328 % Zum Setzen von Programmtexten innerhalb von Struktogrammen wird
5329 % unterschieden zwischen Ausdrücken und (Schlüssel-)Wörtern. Ein Ausdruck
5330 % (zu verstehen im Sinne eines Ausdrucks einer Programmiersprache) wird in
5331 % einem festen Font gesetzt, der durch |\pExpFont@nss| aktuell
5332 % bestimmt wird. Dieses gilt in gleicher Weise für (Schlüssel-)Wörter,
5333 % dabei werden aber die Schlüsselwörter, die in einer entsprechenden
5334 % Liste definiert sind, fett gedruckt. Sowohl Ausdrücke als auch
5335 % (Schlüssel-)wörter dürfen Sonderzeichen enthalten:
5336 % \begin{enumerate}
5337 % \item der Unterstrich "`|_|"',
5338 % \item das Dach "`|^|"',
5339 % \item das kaufmännische Und "`|&|"' und
5340 % \item das Doppelkreuz "`|#|"'.
5341 % \end{enumerate}
5342 % \else%
5343 % To set program texts within structure charts, a distinction is made
5344 % between expressions and (key-)words. An expression (to be understood in
5345 % the sense of an expression of a programming language) is set in
5346 % a fixed font, which is determined by |\pExpFont@nss| currently. This
5347 % applies in the same way to (key) words, but the keywords defined in a
5348 % corresponding list are printed in bold. Both expressions and
5349 % (key-)words may contain special characters:
5350 % \begin{enumerate}
5351 % \item the underscore ``|_|'',
5352 % \item the hat ``|^|'',
5353 % \item the ampersand ``|&|'' and
5354 % \item the number sign ``|#|''.
5355 % \end{enumerate}
5356 % \fi%
5357 % \begin{macro}{\pExpression}
5358 % \changes{v-5.4a}{99/11/16}{neu eingeführt, ersetzt `pVariable}
5359 % \begin{macro}{\pExp}
5360 % \changes{v-5.4a}{99/11/16}{`pExp als Abkürzung definiert}
5361 % \ifnum\language=\languageNGerman%
5362 % Leerzeichen werden beachtet, so dass ganze Anweisungen geschrieben werden
5363 % können. Das Argument kann erst nach der Umdefinition der \foreign{catcodes}
5364 % von einem internen Makro ausgewertet werden.
5365 % \else%
5366 % Blank characters are considered, such that whole statements can be written.%
5367 % \fi%
5368 %
5369 % \ifnum\language=\languageNGerman%
5370 % Zur Erleichterung des Schreibens wird mit \cs{let} ein alternativer Zugriff
5371 % auf \cs{pVariable} geschaffen.
5372 % \else%
5373 % For easier writing there is brought about an alternative access by
5374 % \cs{pVariable}.%
5375 % \fi%
5376 % \begin{macrocode}
5377 \newcommand{\pExpression}{%
5378 \bgroup%
5379 % \end{macrocode}
5380 % \ifnum\language=\languageNGerman%
5381 % Zunächst werden die benötigten \foreign{catcodes} auf Sonstige --
5382 % \foreign{other} -- umgesetzt, zur Erinnerung:
5383 % \else%
5384 % First the needed \foreign{catcodes} will be changed to \foreign{other}.
5385 % Recall:%
5386 % \fi%
5387 %
5388 % \ifnum\language=\languageNGerman%
5389 % \DeleteShortVerb{\|}
5390 % \begin{tabular}{r|l}
5391 % \foreign{catcode} & Bedeutung \\\hline
5392 % 1 & Gruppenanfang \\
5393 % 2 & Gruppenende \\
5394 % 4 & Tabulatorzeichen \\
5395 % 8 & Index \\
5396 % 12& Sonstige \\
5397 % \end{tabular}
5398 % \MakeShortVerb{\|}
5399 % \else%
5400 % \DeleteShortVerb{\|}
5401 % \begin{tabular}{r|l}
5402 % \foreign{catcode} &Meaning \\\hline
5403 % 1 & Group Begin \\
5404 % 2 & Group End \\
5405 % 4 & Tabulator Character \\
5406 % 8 & Index \\
5407 % 12& Other \\
5408 % \end{tabular}
5409 % \MakeShortVerb{\|}%
5410 % \fi%
5411 %
5412 % \ifnum\language=\languageNGerman%
5413 % In einer Variablen sind die folgenden Sonderzeichen erlaubt:
5414 % \begin{enumerate}
5415 % \item der Unterstrich "`|_|"',
5416 % \item das Dach "`|^|"' und
5417 % \item das kaufmännische Und "`|&|"'.
5418 % \end{enumerate}
5419 % \else%
5420 % In a variable the following special characters are allowed:
5421 % \begin{enumerate}
5422 % \item the Underline `|_|',
5423 % \item the Hat `|^|' and
5424 % \item the Ampersand `|&|'.
5425 % \end{enumerate}%
5426 % \fi%
5427 %
5428 % \begin{macrocode}
5429 \catcode`\_=13 \let\_\textunderscore%
5430 \catcode`\^=12 \catcode`\&=12 %
5431 \pUseExpFont@nss%
5432 }
5433 \let\pExp=\pExpression
5434 % \end{macrocode}
5435 % \end{macro}
5436 % \end{macro}
5437 %
5438 % \begin{macro}{\pVariable}
5439 % \changes{v-5.4a}{99/11/16}{neu definiert}
5440 % \changes{v-2.0n}{94/03/31}{Neuimplementation gemäß `TeXnischer Komödie'}
5441 % \begin{macro}{\pVar}
5442 % \changes{v-2.0c}{93/12/09}{`pVar als Abkürzung definiert}
5443 % \begin{macro}{\pKeyword}
5444 % \changes{v-5.4a}{99/11/16}{auf `pVariable zurückgeführt}
5445 % \changes{v-2.0n}{94/03/31}{Neuimplementation gemäß `TeXnischer Komödie'}
5446 % \changes{v-2.0c}{93/12/09}{`pKeyword und `pKey definiert}
5447 % \begin{macro}{\pKey}
5448 % \changes{v-5.4a}{99/11/16}{auf `pVariable zurückgeführt}
5449 % \changes{v-2.0c}{93/12/09}{neu definiert}
5450 % \ifnum\language=\languageNGerman%
5451 % Die Implementation von \cs{pKeyword} entspricht der von \cs{pVariable}.
5452 % Die hier neu benutzten Fonts (cmbtt\ldots) werden durch den
5453 % \sFile{struktxf.sty} bereitgestellt.
5454 % Ansonsten wird wie bei \cs{pVariable} verfahren.
5455 % Zusätzlich werden Makros \cs{pVar} sowie \cs{pKeyword} und \cs{pKey} mit
5456 % der gleichen Bedeutung definiert. Diese dienen allein der
5457 % Rückwärtskompatibilität.
5458 % \else%
5459 % The implementation of \cs{pKeyword} coincides with the one of \cs{pVariable}.
5460 % The hereby newly used fonts (cmbtt\ldots) are provided by \sFile{struktxf.sty}.
5461 % Apart from that it will be proceded as with \cs{pVariable}:%
5462 % In addition, macros \cs{pVar} as well as \cs{pKeyword} and \cs{pKey} with
5463 % the same meaning are defined. These are used solely for
5464 % backwards compatibility.%
5465 % \fi%
5466 % \begin{macrocode}
5467 \newcommand{\pVariable}{%
5468 \begingroup%
5469 \catcode`\_=13 \let\_\textunderscore
5470 \catcode`\#=12 \catcode`\^=12 \catcode`\&=12 %
5471 \pVariabl@%
5472 }
5473 \let\pVar=\pVariable
5474 \let\pKeyword=\pVariable
5475 \let\pKey=\pVariable
5476 % \end{macrocode}
5477 % \end{macro}
5478 % \end{macro}
5479 % \end{macro}
5480 % \end{macro}
5481 %
5482 % \begin{macro}{\pVariabl@}
5483 % \changes{v-5.4a}{99/11/16}{neu definiert}
5484 % \changes{v-8.0d}{04/12/27}{Python-Schlüsselwörter neu eingeführt}
5485 % Die Liste der Schlüsselwörter wird nach den verschiedenen
5486 % Anwendungsgebieten unterschieden.\footnote{Die Python-Erweiterung
5487 % erfolgte nach einem Hinweis von Ludger Humbert, Universität Dortmund, von
5488 % dem auch die Liste der Schlüsselwörter stammt, vielen Dank!}
5489 % \begin{macrocode}
5490 \newcommand{\pVariabl@}[1]{%
5491 \def\arg{#1}%
5492 \ifx\pLanguage@nss\Cee@nss%
5493 \CheckForKeyword@nss{auto,break,case,char,const,continue,default,do,double,%
5494 else,enum,extern,float,for,goto,if,int,long,register,return,%
5495 short,signed,sizeof,static,struct,switch,typedef,union,unsigned,%
5496 void,volatile,while}%
5497 \else\ifx\pLanguage@nss\Java@nss%
5498 \CheckForKeyword@nss{abstract,boolean,break,byte,case,catch,char,class,const,%
5499 continue,default,do,double,else,extends,final,finally,float,for,%
5500 goto,if,implements,import,instanceof,int,interface,long,native,%
5501 new,null,package,private,protected,public,return,short,static,%
5502 super,switch,synchronized,this,throw,throws,transient,try,void,%
5503 volatile,while,true,false}%
5504 \else\ifx\pLanguage@nss\Pascal@nss%
5505 \CheckForKeyword@nss{alfa,and,array,begin,boolean,byte,case,char,const,div,do,%
5506 downto,else,end,false,file,for,function,get,goto,if,in,integer,%
5507 label,maxint,mod,new,not,of,or,pack,packed,page,program,put,%
5508 procedure,read,readln,real,record,repeat,reset,rewrite,set,text,%
5509 then,to,true,type,unpack,until,var,while,with,write,writeln}%
5510 \else\ifx\pLanguage@nss\Python@nss%
5511 \CheckForKeyword@nss{and,assert,break,class,continue,def,del,elif,else,%
5512 except,exec,finally,for,from,global,if,import,in,is,lambda,not,or,%
5513 pass,print,raise,return,try,while,yield}%
5514 \else\ifx\pLanguage@nss\LaTeX@nss%
5515 \CheckForKeyword@nss{center,description,enumerate,figure,itemize,
5516 list,quote,tabbing,tabular,table,}%
5517 \else%
5518 \CheckForKeyword@nss{}%
5519 \fi\fi\fi\fi\fi%
5520 \url{#1}
5521 \endgroup%
5522 }
5523 % \end{macrocode}
5524 % \end{macro}
5525 %
5526 % \begin{macro}{\pLanguage}
5527 % \changes{v-5.4a}{99/11/16}{neu definiert}
5528 % \begin{macro}{\Cee@nss}
5529 % \changes{v-5.4a}{99/11/16}{neu definiert}
5530 % \begin{macro}{\Java@nss}
5531 % \changes{v-5.4a}{99/11/16}{neu definiert}
5532 % \begin{macro}{\Pascal@nss}
5533 % \changes{v-5.4a}{99/11/16}{neu definiert}
5534 % \begin{macro}{\LaTeX@nss}
5535 % \changes{v-5.4a}{99/11/16}{neu definiert}
5536 % \begin{macro}{\Python@nss}
5537 % \changes{v-8.0d}{04/12/27}{Python als zulässige Sprache neu definiert}
5538 % Die Liste der Schlüsselwörter wird nach den verschiedenen
5539 % Anwendungsgebieten unterschieden.
5540 % \begin{macrocode}
5541 \newcommand{\pLanguage}[1]{\gdef\pLanguage@nss{#1}}
5542 \def\Cee@nss{C}
5543 \def\Java@nss{Java}
5544 \def\Pascal@nss{Pascal}
5545 \def\LaTeX@nss{LaTeX}
5546 \def\Python@nss{Python}
5547 \def\OSII@nss{OS/2}
5548 % \end{macrocode}
5549 % \end{macro}
5550 % \end{macro}
5551 % \end{macro}
5552 % \end{macro}
5553 % \end{macro}
5554 % \end{macro}
5555 %
5556 % \begin{macro}{\CheckForKeyword@nss}
5557 % \changes{v130}{10/09/21}{selection of the font is now done by a macro
5558 % from url.sty}
5559 % \changes{v-5.4a}{99/11/16}{neu definiert}
5560 % Die Liste der Schlüsselwörter wird der Reihe nach durchlaufen und mit
5561 % dem aktuellen Argument \cs{arg} verglichen.
5562 % \begin{macrocode}
5563 \def\CheckForKeyword@nss#1%
5564 {%
5565 \let\exec\pExpFont@nss%
5566 \def\endList{!}%
5567 \def\yyI##1,%
5568 {%
5569 \def\token{##1}%
5570 \ifx\token\endList%
5571 \def\UrlFont{\exec}
5572 \else%
5573 \ifx\token\arg%
5574 \let\exec\pKeyFont@nss%
5575 \fi%
5576 \expandafter\yyI%
5577 \fi%
5578 }%
5579 \yyI#1,!,%
5580 }
5581 % \end{macrocode}
5582 % \end{macro}
5583 %
5584 % \begin{macro}{\pComment}
5585 % \ifnum\language=\languageNGerman%
5586 % Zur Auszeichnung von Kommentar.
5587 % \else%
5588 % For marking up comments.%
5589 % \fi%
5590 % \begin{macrocode}
5591 \def\pComment{%
5592 \bgroup%
5593 \pCommentFont@nss%
5594 \let\next=%
5595 }
5596 % \end{macrocode}
5597 % \end{macro}
5598 %
5599 % \begin{macro}{\pUseKeyFont@nss}
5600 % \begin{macro}{\pUseExpFont@nss}
5601 % \changes{v-5.4a}{99/11/16}{neu eingeführt, ersetzt `pUseVarFont@nss}
5602 % \ifnum\language=\languageNGerman%
5603 % Damit Unterstriche und ähnliche Sonderzeichen korrekt dargestellt werden
5604 % können, ist vor der Benutzung eines bestimmten Fonts zu überprüfen,
5605 % ob die gewünschten Zeichen in dem betreffenden Font überhaupt zur
5606 % Verfügung stehen.
5607 % \else%
5608 % In order to represent underlines and similar special characters it has to be
5609 % checked, if the wanted characters are provided in a certain font, before
5610 % using that font.%
5611 % \fi%
5612 %
5613 % \ifnum\language=\languageNGerman%
5614 % Es wird stets auf den Textmodus umgeschaltet, was unter Einsatz des
5615 % \sFile{amstex}-Paketes noch besser durch das Kommando \cs{text}
5616 % geschehen könnte. Es können Probleme mit dem Zeichen
5617 % \texttt{\char94\char94 T}\footnote{Dies funktioniert auf einem
5618 % Linux-System} auftreten, in diesem Fall ist das Zeichen durch
5619 % \texttt{\char94\char94 Y}\footnote{getestet unter OS/2}.
5620 % zu ersetzen
5621 % \else%
5622 % It will be always switched to the text mode, what could be done even better
5623 % by the command \cs{text} of the \sFile{amstex} package. There may be some
5624 % problems using the character \texttt{\char94\char94 T}\footnote{This one
5625 % works under Linux}, in this case it should be replaced by
5626 % \texttt{\char94\char94 Y}\footnote{tested under OS/2}.%
5627 % \fi%
5628 % \errorstopmode
5629 % \begin{macrocode}
5630 {%
5631 \catcode`\#=6%
5632 \gdef\pUseKeyFont@nss#1{%
5633 \ifmmode\else\let\mbox=\relax\fi%
5634 \mbox{\pKeyFont@nss{#1}}\egroup%
5635 }
5636 \gdef\pUseExpFont@nss#1{%
5637 \ifmmode\else\let\mbox=\relax\fi%
5638 \mbox{\pExpFont@nss{#1}}\egroup%
5639 }
5640 }
5641 % \end{macrocode}
5642 % \end{macro}
5643 % \end{macro}
5644 %
5645 % \begin{macro}{\pTrue@nss}
5646 % \changes{v-4.5a}{96/03/15}{neu definiert}
5647 % \begin{macro}{\pFalse@nss}
5648 % \changes{v-4.5a}{96/03/15}{neu definiert}
5649 % \ifnum\language=\languageNGerman%
5650 % Die Vorbesetzungen der logischen Werte \cs{pTrue} und \cs{pFalse}:
5651 % \else%
5652 % The default of the boolean values \cs{pTrue} and \cs{pFalse}:%
5653 % \fi%
5654 % \begin{macrocode}
5655 \newcommand{\pTrue@nss}{\texttt{\pTruename@nss}}
5656 \newcommand{\pFalse@nss}{\texttt{\pFalsename@nss}}
5657 % \end{macrocode}
5658 % \end{macro}
5659 % \end{macro}
5660 %
5661 % \begin{macro}{\pTrue}
5662 % \changes{v-4.5a}{96/03/15}{neu definiert über `pTrue@nss}
5663 % \changes{v-3.5b}{94/01/19}{umbenannt von `true zur Vermeidung von Interferenzen}
5664 % \changes{v-3.3c}{94/09/14}{Beschreibung eingeführt}
5665 % \begin{macro}{\pFalse}
5666 % \changes{v-4.5a}{96/03/15}{neu definiert über `pTrue@nss}
5667 % \changes{v-3.5b}{94/01/19}{umbenannt von `false zur Vermeidung von Interferenzen}
5668 % \changes{v-3.3c}{94/09/14}{Beschreibung eingeführt}
5669 % \ifnum\language=\languageNGerman%
5670 % Um einheitliches Aussehen logischer Werte zu erzielen, werden entsprechende
5671 % Makros mit den obigen Vorbesetzungen definiert.
5672 % \else%
5673 % For achieving homogenous appearance of boolean values adequate macros
5674 % with the above defaults are defined.%
5675 % \fi%
5676 % \begin{macrocode}
5677 \newcommand{\pTrue}{\pTrue@nss}
5678 \newcommand{\pFalse}{\pFalse@nss}
5679 % \end{macrocode}
5680 % \end{macro}
5681 % \end{macro}
5682 %
5683 % \begin{macro}{\pBoolValue}
5684 % \changes{v-4.5a}{96/03/15}{neu definiert}
5685 % \ifnum\language=\languageNGerman%
5686 % Mit \cs{pBoolValue} können die voreingestellten Werte von \cs{pTrue} und
5687 % \cs{pFalse} verändert werden; \cs{sBoolValue} ist der alternative Aufruf
5688 % zwecks Kompatibilität mit alten Struktogrammen.
5689 % \else%
5690 % The default values of \cs{pTrue} and \cs{pFalse} can be changed by \cs{pBoolValue}.
5691 % |sBoolValue| is the alternative command for compatibility reasons with old
5692 % structured box charts.%
5693 % \fi%
5694 % \begin{macrocode}
5695 \newcommand{\pBoolValue}[2]{%
5696 \renewcommand{\pTrue@nss}{#1}%
5697 \renewcommand{\pFalse@nss}{#2}%
5698 }
5699 \let\sBoolValue=\pBoolValue
5700 % \end{macrocode}
5701 % \end{macro}
5702 %
5703 % \begin{macro}{\sVar}
5704 % \changes{v-3.5b}{94/01/19}{umbenannt von `Var zur Vermeidung von Interferenzen}
5705 % \changes{v-2.5}{93/09/09}{eingeführt durch Jhf}
5706 % \begin{macro}{\sKey}
5707 % \changes{v-4.1a}{95/07/17}{`btt bereits anderweitig definiert}
5708 % \changes{v-3.5b}{94/01/19}{neu eingeführt}
5709 % \begin{macro}{\sTrue}
5710 % \begin{macro}{\sFalse}
5711 % \ifnum\language=\languageNGerman%
5712 % Zur Darstellung von Variablen. Hier nur noch zwecks Kompatibilität zu
5713 % früheren Versionen des \StrukTeXSty{} aufgeführt.
5714 % \else%
5715 % For representation of variables. Here only mentioned for compatibility
5716 % reasons with former versions of \StrukTeXSty.%
5717 % \fi%
5718 % \begin{macrocode}
5719 \let\sVar=\pVariable
5720 \let\sKey=\pKeyword
5721 \let\sTrue=\pTrue
5722 \let\sFalse=\pFalse
5723 % \end{macrocode}
5724 % \end{macro}
5725 % \end{macro}
5726 % \end{macro}
5727 % \end{macro}
5728 %
5729 % \begin{macrocode}
5730 %</struktxp>
5731 % \end{macrocode}
5732 %
5733 %
5734 % \subsection{\ifnum\language=\languageNGerman Belegung von Registern \else Reservation of registers \fi}
5735 %
5736 % \begin{macrocode}
5737 %<*struktex>
5738 % \end{macrocode}
5739 %
5740 % \begin{macro}{\savelength@nss}
5741 % \changes{v-4.0b}{95/05/02}{umbenannt von `s@velength}
5742 % \changes{v-2.5}{93/09/09}{`VarDeclWd eingeführt}
5743 % \ifnum\language=\languageNGerman%
5744 % |\savelength@nss|
5745 % dient dazu, die vor dem Struktogramm gültige Längeneinheit
5746 % zwischenzuspeichern, um nach dem Struktogramm den alten Wert
5747 % wiederherstellen zu können.
5748 % \else%
5749 % |\savelength@nss| contributes to intermediate storing of the unit of length,
5750 % which was valid before the structured box chart, for recovering the old value
5751 % after the box chart.%
5752 % \fi%
5753 % \begin{macrocode}
5754 \newdimen\savelength@nss
5755 % \end{macrocode}
5756 % \end{macro}
5757 %
5758 % \begin{macro}{\gx@nss}
5759 % \changes{v061}{10/05/31}{enhanced the documentation}
5760 % \changes{v-4.0b}{95/05/02}{umbenannt von `gx}
5761 % \changes{v-3.2a}{94/09/14}{Beschreibung eingeführt}
5762 % \changes{v-3.2a}{94/09/14}{Beschreibung eingeführt}
5763 % \begin{macro}{\gy@nss}
5764 % \changes{v-4.0b}{95/05/02}{umbenannt von `gy}
5765 % \begin{macro}{\gsize@nss}
5766 % \changes{v-4.0b}{95/05/02}{umbenannt von `gsize}
5767 % \changes{v-3.2a}{94/09/14}{Beschreibung eingeführt}
5768 % \ifnum\language=\languageNGerman%
5769 % |\gx@nss|, |\gy@nss| und |\gsize@nss| enthalten die \emph{globalen} Werte für die
5770 % x- und y-Koordinate und die Breite des Struktogramms;
5771 % zur Vereinfachung der Anwendung wird in allen Fällen
5772 % mit Zählregistern gearbeitet. Um eine hinreichend feine Auflösung zu
5773 % erzielen, wird intern mit der \cs{unitlength} von 0.001\,mm gearbeitet.
5774 %
5775 % Die linke untere Koordinate eines Struktogramms ist (0, 0), die rechte
5776 % obere Koordinate (\cs{gxsize@nss}, \cs{gy@nss}).
5777 % \else%
5778 % |\gx@nss|, |gy@nss| and |\gsize@nss| contain the \emph{global} values for the
5779 % x- and y-coordinate and the width of the structured box chart. For simplification
5780 % of the application in all cases it is worked with counter registers. To
5781 % have an adequate resolution the \cs{unitlength} for a structured box
5782 % chart is set to 0.001\,mm.
5783 %
5784 % The lower left corner of a structured box chart has the coordinate (0, 0),
5785 % the upper right corner the coordinate (\cs{gxsize@nss}, \cs{gy@nss}).%
5786 % \fi%
5787 % \begin{macrocode}
5788 \newcount\gx@nss \newcount\gy@nss \newcount\gsize@nss
5789 % \end{macrocode}
5790 % \end{macro}
5791 % \end{macro}
5792 % \end{macro}
5793 %
5794 % \begin{macro}{\param@nss}
5795 % \changes{v-4.0b}{95/05/02}{umbenannt von `param}
5796 % \changes{v-3.2a}{94/09/14}{Beschreibung eingeführt}
5797 % \ifnum\language=\languageNGerman%
5798 % |\param@nss| enthält den Wert, der als optionales Argument für die Breite
5799 % oder Höhe eines Struktogramms angegeben wird.
5800 % \else%
5801 % |\param@nss| contains the value, which is given as an optional argument for
5802 % the width or the height of the structured box chart.%
5803 % \fi%
5804 % \begin{macrocode}
5805 \countdef\param@nss=199
5806 % \end{macrocode}
5807 % \end{macro}
5808 %
5809 % \begin{macro}{\x@nss}
5810 % \changes{v-4.0b}{95/05/02}{umbenannt von `x}
5811 % \changes{v-3.3c}{94/09/14}{Beschreibung eingeführt}
5812 % \begin{macro}{\y@nss}
5813 % \changes{v-4.0b}{95/05/02}{umbenannt von `y}
5814 % \changes{v-3.3c}{94/09/14}{Beschreibung eingeführt}
5815 % \begin{macro}{\xsize@nss}
5816 % \changes{v-4.0b}{95/05/02}{umbenannt von `xsize}
5817 % \changes{v-3.3c}{94/09/14}{Beschreibung eingeführt}
5818 % \begin{macro}{\xx@nss}
5819 % \changes{v-4.0b}{95/05/02}{umbenannt von `xx}
5820 % \begin{macro}{\yy@nss}
5821 % \changes{v-4.0b}{95/05/02}{umbenannt von `yy}
5822 % \begin{macro}{\tempx@nss}
5823 % \changes{v-4.0b}{95/05/02}{umbenannt von `tempx}
5824 % \begin{macro}{\tempxx@nss}
5825 % \changes{v-4.0b}{95/05/02}{umbenannt von `tempxx }
5826 % \begin{macro}{\tempxxx@nss}
5827 % \changes{v-7.2}{04/07/13}{eingeführt für die Unterstützung von pict2e}
5828 % \begin{macro}{\tempy@nss}
5829 % \changes{v-4.0b}{95/05/02}{umbenannt von `tempy}
5830 % \begin{macro}{\tempyy@nss}
5831 % \changes{v-7.2}{04/07/13}{umbenannt von `tempyy}
5832 % \begin{macro}{\tempyyy@nss}
5833 % \changes{v-7.2}{04/07/04}{eingeführt für die Unterstützung von pict2e}
5834 % \begin{macro}{\ydepth@nss}
5835 % \changes{v-4.0b}{95/05/02}{umbenannt von `ydepth}
5836 % \changes{v-3.2a}{94/09/14}{Beschreibung fehlt noch}
5837 % \ifnum\language=\languageNGerman%
5838 % Es werden einige weitere Variablen benötigt, die alle zentral an dieser
5839 % Stelle definiert werden: |\x@nss|, |\y@nss| und |\xsize@nss| als lokale
5840 % Werte für die $x$- und $y$-Koordinate und die Breite eines
5841 % (Unter-)Struktogramms; |\ydepth@nss| gibt die "`Tiefe"' eines
5842 % Struktogrammelementes an. Die Variablen |\xx@nss|, |\yy@nss|,
5843 % |\tempx@nss|, |\tempxx@nss|, |\tempxxx@nss|, |\tempy@nss|, |\tempyy@nss|
5844 % und |\tempyyy@nss| haben unterschiedliche temporäre Bedeutungen, im
5845 % Regelfall deutet ein |x| im Namen auf horizontalen und ein |y| auf
5846 % vertikalen Zusammenhang hin.
5847 % \else%
5848 % There are needed some more variables. All those will be defined here:
5849 % |\x@nss|, |\y@nss| and |\xsize@nss| as local values for the $x$- and
5850 % $y$-coordinate and for the width of a structured subbox chart.
5851 % |\ydepth@nss| represents the ``depth'' of an element of a structured box
5852 % chart. The variables |\xx@nss|, |\yy@nss|, |\tempx@nss|, |\tempxx@nss|,
5853 % |\tempy@nss|, |\tempyy@nss| have different temporary meanings. Normally
5854 % an |x| in the name points at a horizontal connection and a |y| in the
5855 % name at a vertical connection.%
5856 % \fi%
5857 % \begin{macrocode}
5858 \countdef\x@nss=220 \countdef\y@nss=221 \countdef\xsize@nss=222
5859 \countdef\ydepth@nss=223
5860 \countdef\xx@nss=224 \countdef\yy@nss=225
5861 \countdef\tempx@nss=226 \countdef\tempxx@nss=227
5862 \countdef\tempy@nss=229 \countdef\tempyy@nss=230
5863 \ifpictIIe%
5864 \countdef\tempxxx@nss=228 \countdef\tempyyy@nss=231
5865 \fi
5866 % \end{macrocode}
5867 % \end{macro}
5868 % \end{macro}
5869 % \end{macro}
5870 % \end{macro}
5871 % \end{macro}
5872 % \end{macro}
5873 % \end{macro}
5874 % \end{macro}
5875 % \end{macro}
5876 % \end{macro}
5877 % \end{macro}
5878 % \end{macro}
5879 %
5880 % \begin{macro}{\TextBox@nss}
5881 % \changes{v-4.1a}{95/07/18}{umbenannt von `nss@Box}
5882 % \begin{macro}{\TextBoxHt@nss}
5883 % \changes{v-4.1a}{95/07/18}{umbenannt von `nss@BoxHt}
5884 % \changes{v-3.2a}{94/09/09}{Beschreibung eingeführt}
5885 % \ifnum\language=\languageNGerman%
5886 % |\TextBox@nss| ist die Box, die den Text in einem Struktogrammblock enthält,
5887 % ihre tatsächliche Höhe, Überlänge und Unterlänge wird in |\TextBoxHt@nss|
5888 % abgelegt.
5889 % \else%
5890 % |\TextBox@nss| is the box which contains the text in a structured box chart.
5891 % Its real height, ascender and descender are distributed in |\TextBoxHt@nss|.%
5892 % \fi%
5893 % \begin{macrocode}
5894 \newbox\TextBox@nss \newdimen\TextBoxHt@nss
5895 % \end{macrocode}
5896 % \end{macro}
5897 % \end{macro}
5898 %
5899 % \subsection{\ifnum\language=\languageNGerman Die einzelnen Makros \else The single macros \fi}
5900 %
5901 % \begin{macro}{\filler@nss}
5902 % \changes{v-8.2a}{06/01/17}{`ifmmode $\rightarrow$ `ensuremath}
5903 % \changes{v-4.1a}{95/07/18}{umbenannt von `filler}
5904 % \changes{v-4.1a}{95/07/17}{`emptyset wird als AMS-Schrift geladen}
5905 % \changes{v-2.5}{93/09/09}{Leerraum von `% auf `emptyset umgestellt}
5906 % \ifnum\language=\languageNGerman%
5907 % Beim Setzen eines Struktogrammes entsteht teilweise Leerraum,
5908 % der mit |\filler@nss| aufgefüllt wird: "`$\emptyset$"'. Eine
5909 % Alternative wäre "`$\mathchar"023B$"', was mit "`|\mathchar"023B|"'
5910 % erzeugt wird. Der Leerraum wird allerdings nicht gefüllt, wenn die Option
5911 % |nofiller| gesetzt wird. Will man die globale Einstellung lokal umgehen,
5912 % so kann man einfach die boolesche Variable |filler| auf |true| setzen:
5913 % \cs{fillertrue}.
5914 % \else%
5915 % While setting a structured box chart there arises partly empty space, that
5916 % will be filled up with |\filler@nss|: ``$\emptyset$''. An alternative would be
5917 % ``$\mathchar"023B$'', which is generated by
5918 % ``|\mathchar"023B|''. ``$\emptyset$'' will not be set, if the option
5919 % |nofiller| is set.%
5920 % \fi%
5921 % \begin{macrocode}
5922 \DeclareMathSymbol\varnothing{\mathord}{AMSb}{"3F}
5923 \let\emptyset\varnothing
5924 \def\filler@nss{%
5925 \iffiller\ensuremath{\emptyset}\fi%
5926 }
5927 % \end{macrocode}
5928 % \end{macro}
5929 %
5930 % \begin{macro}{\c@nter@nss}
5931 % \changes{v-4.0b}{95/05/02}{umbenannt von `c@nter}
5932 % \changes{v-3.1}{94/09/09}{Beschreibung eingeführt}
5933 % \ifnum\language=\languageNGerman%
5934 % Der folgende Makro setzt verschiedene Parameter, die zum Zentrieren eines
5935 % Textes gebraucht werden.
5936 % \else%
5937 % The following macro sets different parameters, which are used for centering
5938 % a text.%
5939 % \fi%
5940 % \begin{macrocode}
5941 \def\c@nter@nss{%
5942 \leftskip=0pt plus 2em \rightskip=\leftskip \parfillskip=0pt
5943 \spaceskip=.333em \xspaceskip=.5em
5944 \pretolerance=9999 \tolerance=9999
5945 \hyphenpenalty=9999 \exhyphenpenalty=9999%
5946 }
5947 % \end{macrocode}
5948 % \end{macro}
5949 %
5950 % \begin{macro}{\PositionNSS}
5951 % \changes{v-4.5c}{96/05/01}{neu eingeführt zur Positionierung der Struktogramme}
5952 % \ifnum\language=\languageNGerman%
5953 % Struktogramme werden intern als |minipage| verwaltet. Das Kommando
5954 % \cs{PositionNSS} ermöglicht die Positionierung, es erwartet die Werte,
5955 % die die |minipage|-Umgebung akzeptiert: |t|, |b| und keine Parameterangabe.
5956 % Die Parameter werden nicht überprüft und gelten global ab Aufruf des
5957 % Kommandos.
5958 % \else%
5959 % Structured box charts are internally managed as |minipage|. The instruction
5960 % \cs{PositionNSS} enables the positioning. It expects the values, that the |minipage|
5961 % environment accepts: |t|, |b| and no parameter option. The parameters
5962 % are not checked and are valid globally from the call of instruction on.%
5963 % \fi%
5964 % \begin{macrocode}
5965 \def\Position@nss{}%
5966 \newcommand{\PositionNSS}[1]{%
5967 \def\Position@nss{#1}%
5968 }
5969 % \end{macrocode}
5970 % \end{macro}
5971 %
5972 % \begin{macro}{\struktogramm}
5973 % \changes{v061}{10/05/31}{added missing translations}
5974 % \changes{v-4.4b}{96/03/13}{Optionaler Parameter über `empty statt `relax getestet}
5975 % \changes{v-4.4a}{96/02/29}{`ifthenelse als internes Kommando definiert}
5976 % \changes{v-3.1a}{94/09/09}{optionaler Parameter eingeführt}
5977 % \ifnum\language=\languageNGerman%
5978 % \cs{struktogramm} beginnt ein Struktogramm
5979 % \else%
5980 % \cs{struktogramm} starts a structured box chart%
5981 % \fi%
5982 % \begin{macrocode}
5983 \def\struktogramm(#1,#2){%
5984 % \end{macrocode}
5985 % \ifnum\language=\languageNGerman%
5986 % Zunächst werden die internen Kommandos aktiviert:
5987 % \else%
5988 % First the internal instructions are activated:%
5989 % \fi%
5990 % \begin{macrocode}
5991 \let\ifthenelse=\ifthenelse@nss%
5992 \let\ifend=\ifend@nss%
5993 % \end{macrocode}
5994 % \ifnum\language=\languageNGerman%
5995 % Falls die Option |draft| gesetzt wurde, wird für jedes Struktogramm
5996 % grundsätzlich auf den Entwurfsmodus umgeschaltet.
5997 % \else%
5998 % If the option |draft| is set we switch to the draft mode for every single
5999 % structured box chart.%
6000 % \fi%
6001 % \begin{macrocode}
6002 \ifdraft@nss\let\struktogramm@nss=\struktogramm@Proof\fi%
6003 % \end{macrocode}
6004 % \ifnum\language=\languageNGerman%
6005 % Um den optionalen Parameter zu behandeln, wird in Abhängigkeit vom
6006 % nächsten Zeichen ein internes Makro aufgerufen.
6007 % \else%
6008 % An internal macro depending on the next character will be called to treat the
6009 % optional parameter.%
6010 % \fi%
6011 % \begin{macrocode}
6012 \@ifnextchar [{\struktogramm@nss(#1,#2)}{\struktogramm@nss(#1,#2)[]}%
6013 }
6014 % \end{macrocode}
6015 % \end{macro}
6016 %
6017 % \begin{macro}{\endstruktogramm}
6018 % \ifnum\language=\languageNGerman%
6019 % \cs{endstruktogramm} beendet das Struktogramm. Offene Gruppen und Umgebungen
6020 % werden geschlossen, lokale Definitionen globaler Werte werden rückgängig
6021 % gemacht.
6022 % \else%
6023 % \cs{endstruktogramm} finishes the structured box chart. Open groups and
6024 % environments will be closed, local definitions of global values will be returned.%
6025 % \fi%
6026 % \begin{macrocode}
6027 \def\endstruktogramm{%
6028 \endstr@kt%
6029 \end{picture}%
6030 \end{minipage}%
6031 \setlength{\unitlength}{\savelength@nss}%
6032 }
6033 % \end{macrocode}
6034 % \end{macro}
6035 %
6036 % \begin{macro}{\struktogramm@NoProof}
6037 % \changes{v061}{10/05/31}{enhanced the documentation}
6038 % \changes{v-4.5b}{96/03/26}{Positionierung des Struktogramms über [t] bei der minipage}
6039 % \changes{v-4.4b}{96/03/13}{Optionaler Parameter über `empty statt `relax getestet}
6040 % \changes{v-4.2b}{95/10/15}{umbenannt von `struktogramm@nss}
6041 % \changes{v-4.0c}{95/05/09}{umbenannt von `nss@struktogramm}
6042 % \changes{v-3.1a}{94/09/09}{als internes Makro zur Behandlung optionaler Parameter neu}
6043 % \changes{v-3.3a}{94/09/21}{`baselineskip=0pt innerhalb von Struktogrammen korrigiert}
6044 % \ifnum\language=\languageNGerman%
6045 % |\struktogramm@NoProof| leitet ein Struktogramm ein. Die drei Parameter
6046 % sind:
6047 % \begin{itemize}
6048 % \item |#1|: die Breite des Struktogramms,
6049 % \item |#2|: seine (voraussichtliche) Höhe und
6050 % \item |#3|: sein Titel.
6051 % \end{itemize}
6052 % \else%
6053 % |\struktogramm@NoProof| opens a structured box chart. The three
6054 % parameters are:
6055 % \begin{itemize}
6056 % \item |#1|: the width of the structured box chart,
6057 % \item |#2|: its (estimated) height and,
6058 % \item |#3|: its title.
6059 % \end{itemize}%
6060 % \fi%
6061 % \begin{macrocode}
6062 \def\struktogramm@NoProof(#1,#2)[#3]{%
6063 % \end{macrocode}
6064 % \ifnum\language=\languageNGerman%
6065 % Zunächst wird die aktuelle \cs{unitlength} zwischengespeichert, da mit einer
6066 % eigenen Größe gearbeitet wird.
6067 % \else%
6068 % First the actual \cs{unitlength} will be stored intermediately, since it is worked
6069 % with an own entity.%
6070 % \fi%
6071 % \begin{macrocode}
6072 \def\next{#3}
6073 \setlength{\savelength@nss}{\unitlength}
6074 \setlength{\unitlength}{0.001mm}
6075 % \end{macrocode}
6076 % \ifnum\language=\languageNGerman%
6077 % Wenn der dritte Parameter nicht \cs{relax} ist, wird die Bezeichnung
6078 % geschrieben und es muss ein bisschen zusätzlicher Platz geschaffen werden.
6079 % \else%
6080 % If the third parameter is not \cs{relax}, then the name will be written and it has to
6081 % be created some new space in addition.%
6082 % \fi%
6083 % \begin{macrocode}
6084 \begin{minipage}[\Position@nss]{#1mm}
6085 \ifx\next\empty\else #3\\[\smallskipamount]\fi%
6086 % \end{macrocode}
6087 % \ifnum\language=\languageNGerman%
6088 % Um die Verwaltung des benötigten Raumes möglichst einfach zu machen,
6089 % wird eine \cs{picture}-Umgebung geöffnet, in der eine weitere
6090 % Gruppe durch den Aufruf von |\str@kt| geöffnet wird.
6091 % \else%
6092 % For easier management of the needed space the \cs{picture} environment will be
6093 % opened, in which an own other group will be opened by call of |str@kt|.%
6094 % \fi%
6095 % \begin{macrocode}
6096 \begin{picture}(#1000,#2000)%
6097 \str@kt{0}{#2000}{#1000}%
6098 }
6099 % \end{macrocode}
6100 % \end{macro}
6101 %
6102 % \begin{macro}{\struktogramm@Proof}
6103 % \changes{v-4.5b}{96/03/26}{Positionierung des Struktogramms über [t] bei der minipage}
6104 % \changes{v-4.4b}{96/03/13}{Optionaler Parameter über `empty statt `relax getestet}
6105 % \changes{v-4.2b}{95/10/15}{neu eingeführt}
6106 % \ifnum\language=\languageNGerman%
6107 % |\struktogramm@proof| öffnet ein Struktogramm im \foreign{proof}-Modus.
6108 % Der Ablauf entspricht im wesentlichen |\struktogramm@NoProof|.
6109 % \else%
6110 % |\struktogramm@proof| opens a structured box chart in the \foreign{proof} mode.
6111 % Progress is essentially equivalent to |\struktogramm@NoProof|.%
6112 % \fi%
6113 % \begin{macrocode}
6114 \def\struktogramm@Proof(#1,#2)[#3]{%
6115 \def\next{#3}%
6116 \setlength{\savelength@nss}{\unitlength}%
6117 \setlength{\unitlength}{0.001mm}%
6118 \begin{minipage}[\Position@nss]{#1mm}%
6119 \ifx\next\empty\else #3\\[\smallskipamount]\fi%
6120 \begin{picture}(#1000,#2000)%
6121 \put(0,0){\makebox(0,0)[cc]{$\bullet$}}%
6122 \put(0,#2000){\makebox(0,0)[cc]{$\bullet$}}%
6123 \put(#1000,0){\makebox(0,0)[cc]{$\bullet$}}%
6124 \put(#1000,#2000){\makebox(0,0)[cc]{$\bullet$}}%
6125 \str@kt{0}{#2000}{#1000}%
6126 }
6127 % \end{macrocode}
6128 % \end{macro}
6129 %
6130 % \begin{macro}{\sProofOn}
6131 % \begin{macro}{\sProofOff}
6132 % \changes{v-4.2b}{95/10/15}{neu eingeführt}
6133 % \ifnum\language=\languageNGerman%
6134 % Die Schalter zum Umschalten zwischen \foreign{proof}- und
6135 % \foreign{non proof}-Modus. Abschließend wird in den \foreign{non proof}-Modus
6136 % umgeschaltet.
6137 % \else%
6138 % The switches for changing from \foreign{proof} to \foreign{non proof} mode and
6139 % back. Finally it will be switched to \foreign{non proof} mode.%
6140 % \fi%
6141 % \begin{macrocode}
6142 \def\sProofOn%
6143 {%
6144 \let\struktogramm@nss=\struktogramm@Proof%
6145 }
6146 \def\sProofOff%
6147 {%
6148 \let\struktogramm@nss=\struktogramm@NoProof%
6149 }
6150 \let\struktogramm@nss=\struktogramm@NoProof%
6151 % \end{macrocode}
6152 % \end{macro}
6153 % \end{macro}
6154 %
6155 % \changes{v-4.3a}{96/01/26}{Dokumentation verbessert und korrigiert}
6156 % \ifnum\language=\languageNGerman%
6157 % Um Kompatibilität mit älteren Versionen von Struktogrammen zu erhalten,
6158 % sind die Makros \cs{openstrukt} und \cs{closestrukt} weiterhin in diesem
6159 % \foreign{package} erhalten. Diese sollten aber nicht weiter benutzt werden.
6160 % \else%
6161 % To achieve compatibility with older versions of structured box charts the
6162 % macros \cs{openstrukt} and \cs{closestrukt} are still included in this package.
6163 % But they should'nt be used any longer.%
6164 % \fi%
6165 % \begin{macro}{\openstrukt}
6166 % \ifnum\language=\languageNGerman%
6167 % \cs{openstrukt} beginnt ein Struktogramm
6168 % \else%
6169 % \cs{openstrukt} begins a structured box chart.%
6170 % \fi%
6171 % \begin{macrocode}
6172 \def\openstrukt#1#2{%
6173 % \end{macrocode}
6174 % \ifnum\language=\languageNGerman%
6175 % Die aktuelle \cs{unitlength} wird zwischengespeichert, da mit einer eigenen
6176 % Größe gearbeitet wird.%
6177 % \else%
6178 % The current \cs{unitlength} will be stored intermediately, since it is worked with
6179 % an own entity.%
6180 % \fi%
6181 % \begin{macrocode}
6182 \setlength{\savelength@nss}{\unitlength}
6183 \setlength{\unitlength}{0.001mm}
6184 % \end{macrocode}
6185 % \ifnum\language=\languageNGerman%
6186 % Um die Verwaltung des benötigten Raumes möglichst einfach zu machen,
6187 % wird eine \cs{picture}-Umgebung geöffnet, in der eine eigene weitere
6188 % Gruppe durch den Aufruf von |\str@kt| geöffnet wird.
6189 % \else%
6190 % For easier management of the needed space the \cs{picture} environment will be
6191 % opened, in which an own other group will be opened by the call of |\str@kt|.%
6192 % \fi%
6193 % \begin{macrocode}
6194 \begin{picture}(#1000,#2000)
6195 \str@kt{0}{#2000}{#1000}%
6196 }
6197 % \end{macrocode}
6198 % \end{macro}
6199 % \ifnum\language=\languageNGerman%
6200 % Es ist zu beachten, dass es kein optionales Argument gibt.
6201 % \else%
6202 % One has to pay attention that there's no optional argument.%
6203 % \fi%
6204 %
6205 % \begin{macro}{\closestrukt}
6206 % \ifnum\language=\languageNGerman%
6207 % \cs{closestrukt} beendet das Struktogramm. Offene Gruppen und Umgebungen
6208 % werden geschlossen, lokale Definitionen globaler Werte werden rückgängig
6209 % gemacht.
6210 % \else%
6211 % \cs{closestrukt} finishes the structured box chart. Open groups and environments
6212 % will be closed. Local definitions of global values will be reversed.%
6213 % \fi%
6214 % \begin{macrocode}
6215 \def\closestrukt%
6216 {%
6217 \endstr@kt
6218 \end{picture}
6219 \setlength{\unitlength}{\savelength@nss}%
6220 }
6221 % \end{macrocode}
6222 % \end{macro}
6223 %
6224 % \begin{macro}{\getoption}
6225 % \ifnum\language=\languageNGerman%
6226 % \cs{getoption} überprüft, ob ein optionales Argument angegeben wurde. Dies
6227 % geschieht, indem das nächste Zeichen getestet wird.
6228 % \else%
6229 % \cs{getoption} checks, if an optional argument is given. This happens by
6230 % testing the next character.%
6231 % \fi%
6232 % \begin{macrocode}
6233 \def\getoption{\@ifnextchar [{\getnum}{\param@nss=0\next}}
6234 % \end{macrocode}
6235 % \end{macro}
6236 %
6237 % \begin{macro}{\getnum}
6238 % \ifnum\language=\languageNGerman%
6239 % \cs{getnum} weist den Parameter dem globalen Zähler |\param@nss| zu und ruft
6240 % den auf \cs{next} gesetzten Makro auf.
6241 % \else%
6242 % \cs{getnum} assigns the parameter to the global counter |\param@nss| and calls
6243 % the macro set on \cs{next}.%
6244 % \fi%
6245 % \begin{macrocode}
6246 \def\getnum[#1]{\param@nss=#1\next}
6247 % \end{macrocode}
6248 % \end{macro}
6249 %
6250 % \begin{macro}{\str@kt}
6251 % \changes{v2.3}{17/12/04}{enhanced documentation}
6252 % \changes{v061}{10/05/31}{added some debug code}
6253 % \ifnum\language=\languageNGerman%
6254 % |\str@kt| setzt globale Werte: |\gx@nss| als x-Koordinate (|#1|),
6255 % |\gy@nss| als y-Koordinate (|#2|) der linken oberen Ecke und
6256 % |\gsize@nss| als Breite des aktuellen Struktogramms (|#3|). Das
6257 % Struktogramm selbst wird dann in ein Rechteck mit der unteren linken
6258 % Ecke (0,0) und der oberen Ecke (|\gx@nss|, |\gy@nss|) gezeichnet.
6259 %
6260 % Gleichzeitig wird eine Gruppe geöffnet, in der mit lokalen Kopien
6261 % dieser Werte (|\x@nss|, |\y@nss| und |\xsize@nss|) gearbeitet werden
6262 % kann. Diese Gruppe kann dann Unterstruktogramme enthalten (Sequenzen,
6263 % Schleifen und Entscheidungen).%
6264 % \else%
6265 % |\str@kt| sets global values: |\gx@nss| as x-coordinate (|#1|),
6266 % |\gy@nss| as y-coordinate (|#2|) of the upper left corner and
6267 % |\gsize@nss| as width of the actual structured box chart (|#3|). The
6268 % actual structured box chart will be drawn in a recangular region with
6269 % lower left corner (0, 0) and upper right corner at (|\gx@nss|,
6270 % |\gy@nss|).
6271 %
6272 % At the same time a group will be opened, in which one can work with
6273 % local copies of these values (|\x@nss|, |\y@nss| and
6274 % |\xsize@nss|). This group may contain further (sub) structured box
6275 % charts (e.\,g. for loops or selections).%
6276 % \fi%
6277 % \begin{macrocode}
6278 \def\str@kt#1#2#3{%
6279 \dbgString@nss{Beginn \string\str@kt}
6280 \dbgArgs@nss{#1, #2, #3}
6281 \global\gx@nss=#1\global\gy@nss=#2\global\gsize@nss=#3%
6282 \begingroup%
6283 \x@nss=\gx@nss\y@nss=\gy@nss\xsize@nss=\gsize@nss%
6284 \dbgString@nss{rectangle size}
6285 \dbgCoord@nss[Ursprung]{\x@nss}{\y@nss}
6286 \dbgCount@nss[Breite]{\xsize@nss}
6287 }
6288 % \end{macrocode}
6289 % \end{macro}
6290 %
6291 % \begin{macro}{\endstr@kt}
6292 % \ifnum\language=\languageNGerman%
6293 % schließt die oben geöffnete Gruppe, die aktuelle $y$-Koordinate wird global
6294 % umgesetzt, um den (weiter unten liegenden) Ansatzpunkt für das nächste
6295 % Element des Struktogramms zu erhalten.
6296 % \else%
6297 % closes the above opened group. The actual $y$-coordinate will be globally
6298 % changed to get the point of attachment (which lies further down) for the next
6299 % element of the structured box chart.%
6300 % \fi%
6301 % \changes{v061}{10/05/31}{added some debug code}
6302 % \begin{macrocode}
6303 \def\endstr@kt{%
6304 \global\gy@nss=\y@nss%
6305 \endgroup%
6306 \ydepth@nss=\gy@nss%
6307 \dbgString@nss{Ende \string\str@kt}
6308 }
6309 % \end{macrocode}
6310 % \end{macro}
6311 %
6312 % \changes{v-7.0b}{2004/03/09}{ersetzt durch `tempxx@nss}
6313 % \changes{v-4.0b}{95/05/08}{umbenannt von `xin}
6314 % \changes{v-3.2a}{94/09/14}{Beschreibung eingeführt}
6315 % \begin{macro}{\set@nss}
6316 % \changes{v2.3}{17/12/04}{corrected documentation}
6317 % \changes{v061}{10/05/31}{enhanced the documentation and added some
6318 % debug code}%
6319 % \changes{v-4.0b}{95/05/08}{umbenannt von `set}%
6320 % \ifnum\language=\languageNGerman%
6321 % |\set@nss| setzt den als ersten Parameter |#1| übergebenen Text in
6322 % eine horizontale Box |\TextBox@nss|. Die Breite der Box ist die
6323 % aktuelle Breite \cs{xsize@nss} vermindert um die Größe des
6324 % Parameters |#2|. Ist die Breite dieser Box größer als die genannte
6325 % Breite, wird der Text in eine vertikale Box gesetzt.%
6326 % \else%
6327 % |\set@nss| sets the text, which is given as parameter |#1|, into a
6328 % horizontal box |\TextBox@nss|. The width of this box is the current
6329 % width \cs{xsize@nss} decremented by |#2|. If this value is less than
6330 % the natural width of the first parameter the text will be set into a
6331 % vertical box.%
6332 % \fi%
6333 % \changes{v104}{10/08/15}{corrected position of texts in `set@nss}
6334 % \begin{macrocode}
6335 \def\set@nss#1#2{%
6336 \dbgString@nss{Beginn \string\set@nss}
6337 \setbox\TextBox@nss=\hbox{#1}%
6338 \tempxx@nss=\xsize@nss\advance\tempxx@nss by-#2%
6339 \ifdim\wd\TextBox@nss>\tempxx@nss\unitlength%
6340 \setbox\TextBox@nss=\vbox{\hsize=\tempxx@nss\unitlength\noindent#1}%
6341 \else
6342 \setbox\TextBox@nss=\hbox to \tempxx@nss\unitlength{#1\hss}%
6343 \fi%
6344 \dbgString@nss{Ende \string\set@nss}
6345 }
6346 % \end{macrocode}
6347 % \end{macro}
6348 %
6349 % \begin{macro}{\block@nss}
6350 % \changes{v061}{10/05/31}{enhanced the documentation and added some
6351 % debug code}%
6352 % \changes{v-7.0a}{04/01/04}{umbenannt von `bl@ck}%
6353 % \ifnum\language=\languageNGerman%
6354 % |\block@nss| setzt die Box |\TextBox@nss| entsprechend dem zweiten
6355 % Parameter. Ist dieser 2, wird ..., für den Wert 1 wird eine Box mit
6356 % Rahmen gesetzt, ist dieser 0, wird eine Box ohne Rahmen gesetzt. Bei
6357 % allen anderen Werten wird nur die Größe des Struktogramms, gegeben
6358 % durch |\y@nss|, vergrößert. der erste Parameter |#1| gibt die
6359 % (optionale) Höhe des Kastens an.%
6360 % \else%
6361 % |\block@nss| sets the box |\TextBox@nss| corresponding to the second
6362 % parameter. If this parameter is 1, the box will be set in a frame,
6363 % and if it is 0, a box without frame will be set. In all other cases
6364 % only the size of the structured box chart given by |\y@nss| will be
6365 % changed. Parameter |#1| gives the (optional) height of the box.%
6366 % \fi%
6367 % \begin{macrocode}
6368 \def\block@nss#1#2{%
6369 \dbgString@nss{Beginn \string\block@nss}
6370 \tempy@nss=#1%
6371 % \end{macrocode}
6372 % At first we compute the height of the text (in pt):
6373 % \begin{macrocode}
6374 \dbgCount@nss{\ydepth@nss}
6375 \TextBoxHt@nss=\ht\TextBox@nss%
6376 \advance\TextBoxHt@nss by\dp\TextBox@nss%
6377 \advance\TextBoxHt@nss by 2mm%
6378 \dbgCount@nss[original]{\TextBoxHt@nss}
6379 \ifdim\TextBoxHt@nss<\tempy@nss\unitlength%
6380 \TextBoxHt@nss=\tempy@nss\unitlength%
6381 \fi%
6382 \dbgCount@nss[korrigiert]{\TextBoxHt@nss}
6383 % \end{macrocode}
6384 % \ifnum\language=\languageNGerman%
6385 % \else%
6386 % Because of we have to convert a box's height into mm, we have to multiply
6387 % the height by 0.00536 (\(1\;mm=186467\;bp\equiv0.00536\;mm=\;bp\),
6388 % dimensions are internally stored as bp).%
6389 % \fi%
6390 % \begin{macrocode}
6391 \TextBoxHt@nss=0.00536\TextBoxHt@nss%
6392 \dbgCount@nss[skaliert]{\TextBoxHt@nss}
6393 % \end{macrocode}
6394 % \ifnum\language=\languageNGerman%
6395 % Wegen der Orientierung des Koordinatensystems wird der Ursprung des zu
6396 % zeichnenden Objektes um \cs{ydepth@nss} nach unten verschoben, danach
6397 % wird das Objekt mit der Höhe \cs{ydepth@nss} gezeichnet.
6398 % \else%
6399 % Because of the orientation of the coordinate system, we go down by
6400 % \cs{ydepth@nss} and draw from that point the box of height
6401 % \cs{ydepth@nss}.%
6402 % \fi%
6403 % \begin{macrocode}
6404 \ydepth@nss=\TextBoxHt@nss\advance\y@nss by-\ydepth@nss%
6405 \dbgCoord@nss[Ursprung]{\x@nss}{\y@nss}
6406 \dbgCoord@nss[Breite, Hoehe]{\xsize@nss}{\ydepth@nss}
6407 \ifx#21%
6408 \put(\x@nss,\y@nss){%
6409 \framebox(\xsize@nss,\ydepth@nss){\box\TextBox@nss}%
6410 }%
6411 \else\ifx#20%
6412 \put(\x@nss,\y@nss){%
6413 \makebox(\xsize@nss,\ydepth@nss){\box\TextBox@nss}%
6414 }%
6415 \else%
6416 \advance\y@nss by \ydepth@nss%
6417 \fi\fi%
6418 \dbgString@nss{Ende \string\block@nss}
6419 }
6420 % \end{macrocode}
6421 % \end{macro}
6422 %
6423 % \begin{macro}{\declarationtitle}
6424 % \ifnum\language=\languageNGerman%
6425 % Der Makro \cs{declarationtitle} legt den Inhalt der optionalen Überschrift
6426 % bei Deklarationen fest. Er kann global vorgegeben werden, um eine
6427 % einheitliche Darstellung zu erhalten.
6428 % \else%
6429 % The macro \cs{declarationtitle} determines the content of the optional titel of
6430 % declarations. It can be globally given in order to receive a homogeneous
6431 % representation.%
6432 % \fi%
6433 % \begin{macrocode}
6434 \def\declarationtitle{\declarationtitlename@nss}
6435 % \end{macrocode}
6436 % \end{macro}
6437 %
6438 % \begin{macro}{\descriptionindent}
6439 % \changes{v-4.5a}{96/03/14}{an \LaTeX2e angepasst}
6440 % \changes{v-3.3a}{94/09/16}{neu eingeführt}
6441 % \begin{macro}{\descriptionwidth}
6442 % \changes{v-4.5a}{96/03/14}{an \LaTeX2e angepasst}
6443 % \changes{v-3.3a}{94/09/16}{neu eingeführt}
6444 % \begin{macro}{\descriptionwidth@nss}
6445 % \changes{v-4.5a}{96/03/14}{neu eingeführt}
6446 % \begin{macro}{\descriptionsep}
6447 % \changes{v-4.5a}{96/03/14}{an \LaTeX2e angepasst}
6448 % \changes{v-3.3a}{94/09/16}{neu eingeführt}
6449 % \ifnum\language=\languageNGerman%
6450 % Die folgenden Variablen (\foreign{dimen-register}) wurden eingeführt,
6451 % um das Layout der Variablenbeschreibung frei gestalten zu können.
6452 % \else%
6453 % The following variables (\foreign{dimen-register}) have been introduced to
6454 % be able to freely arrange the layout of variable description.%
6455 % \fi%
6456 % \begin{macrocode}
6457 \newlength{\descriptionindent} \setlength{\descriptionindent}{1.5em}
6458 \newlength{\descriptionwidth} \setlength{\descriptionwidth}{40pt}
6459 \newlength{\descriptionsep} \setlength{\descriptionsep}{\tabcolsep}
6460 \newlength{\descriptionwidth@nss}
6461 % \end{macrocode}
6462 % \end{macro}
6463 % \end{macro}
6464 % \end{macro}
6465 % \end{macro}
6466 %
6467 % \begin{macro}{\descriptionlabel@nss}
6468 % \changes{v-5.2a}{97/12/03}{Vorbesetzung des Fonts entfällt}
6469 % \changes{v-4.5a}{96/03/14}{neu eingeführt}
6470 % \ifnum\language=\languageNGerman%
6471 % Internes Kommando nach
6472 % \else%
6473 % internal command according to%
6474 % \fi%
6475 % \cite[Abs. 3.3.5]{GoossensMittelbachSamarin:Companion}
6476 % \ifnum\language=\languageNGerman zur Definition
6477 % der Marke bei der Liste der Variablenbeschreibungen
6478 % \else%
6479 % for the definition of label on the list of variable definitions%
6480 % \fi%
6481 % \begin{macrocode}
6482 \newcommand{\descriptionlabel@nss}[1]%
6483 {%
6484 \settowidth{\descriptionwidth@nss}{#1}%
6485 \ifnum\descriptionwidth@nss>\descriptionwidth% % term > labelwidth
6486 \parbox[b]{\descriptionwidth}%
6487 {%
6488 \makebox[0pt][l]{#1}\\%
6489 }%
6490 \else% % term < labelwidth
6491 #1%
6492 \fi%
6493 \hfil\relax%
6494 }
6495 % \end{macrocode}
6496 % \end{macro}
6497 %
6498 % \begin{macro}{declaration}
6499 % \changes{v-4.5a}{96/03/14}{neu eingeführt}
6500 % \ifnum\language=\languageNGerman%
6501 % Die Beschreibung von Variablen basiert nun auf der allgemeinen
6502 % |list|-Umgebung, die entsprechend modifiziert wurde. Insbesondere
6503 % wurden alle Abstände auf 0pt gesetzt.
6504 % \else%
6505 % Now the description of variables is based on the common |list|-environment,
6506 % which has been modified correspondingly. Especially all distances have been set
6507 % on 0pt.%
6508 % \fi%
6509 % \begin{macrocode}
6510 \newenvironment{declaration}[1][\declarationtitle]%
6511 {%
6512 \def\next{#1}%
6513 \ifx\next\empty\else #1\\\fi
6514 \let\description=\description@nss
6515 \tempxx@nss=\xsize@nss\advance\tempxx@nss by -\tempx@nss%
6516 \begin{minipage}[t]{\tempxx@nss\unitlength}
6517 \begin{list}{}%
6518 {%
6519 \renewcommand{\makelabel}{\descriptionlabel@nss}%
6520 \setlength{\labelwidth}{\descriptionwidth}%
6521 \setlength{\itemsep}{0pt} \setlength{\topsep}{0pt}%
6522 \setlength{\parsep}{0pt} \setlength{\partopsep}{0pt}
6523 \setlength{\leftmargin}{\descriptionwidth}%
6524 \addtolength{\leftmargin}{\descriptionsep}%
6525 \addtolength{\leftmargin}{\descriptionindent}%
6526 }%
6527 }%
6528 {%
6529 \end{list}%
6530 \end{minipage}
6531 }
6532 % \end{macrocode}
6533 % \end{macro}
6534 %
6535 % \begin{macro}{\description@nss}
6536 % \changes{v-4.5a}{96/03/14}{neu eingeführt}
6537 % \ifnum\language=\languageNGerman%
6538 % Um keine Schwierigkeiten mit der |description|-Umgebung zu haben,
6539 % wird das Kommando |\description@nss| mit der Erweiterung |@nss|
6540 % eingeführt. Seine Gültigkeit wird
6541 % mit einem \cs{let} auf die |declaration|-Umgebung beschränkt
6542 % \else%
6543 % In order to avoid difficulties with the |description|-environment the command
6544 % |\description@nss| with the extension |@nss| will be introduced. Its validity will be
6545 % restricted to |declaration|-environment by a \cs{let}.%
6546 % \fi%
6547 % \begin{macrocode}
6548 \newcommand{\description@nss}[2]{\item[#1] \{#2\}}
6549 % \end{macrocode}
6550 % \end{macro}
6551 %
6552 % \begin{macro}{\assign}
6553 % \changes{v061}{10/05/31}{enhanced the documentation and added some debug code}
6554 % \changes{v-3.2a}{94/09/14}{Beschreibung eingeführt}
6555 % \ifnum\language=\languageNGerman%
6556 % Einfache Anweisungen werden über \cs{assign} geschrieben. \cs{assign}
6557 % kennt einen zwei Parameter: die Höhe des Kastens (optional) und den Text,
6558 % der die Aktion angibt. Die Höhe des Kastens wird in \cs{param@nss} gespeichert.
6559 % \else%
6560 % Simple commands are written by \cs{assign}. \cs{assign} knows two
6561 % parameters: the height of the box (optional) and the text, whichs
6562 % describes the action. The height of the box gets stored in \cs{param@nss}.%
6563 % \fi%
6564 % \begin{macrocode}
6565 \def\assign{\let\next=\@assign\getoption}%
6566 \def\@assign#1{%
6567 \dbgString@nss{Beginn \string\@assign}
6568 \dbgCoord@nss[Ursprung]{\x@nss}{\y@nss}
6569 \dbgCount@nss[Breite]{\xsize@nss}
6570 % \end{macrocode}
6571 % \ifnum\language=\languageNGerman%
6572 % Das Setzen einer Zuweisung enthält Schritte, die immer wieder
6573 % auftreten. Deshalb werden diese Schritte an dieser Stelle genauer
6574 % beschrieben.
6575 %
6576 % Der aktuelle Kasten wird mit einer Breite von \cs{xsize@nss} gesetzt, und
6577 % der Text soll mit einer vernünftigen Breite dahinein gesetzt werden. Nach
6578 % Augenschein sehen Ränder von \(\frac{1}{12}\) der Gesamtbreite gut aus, somit
6579 % nimmt der Text \(\frac{5}{6}\) der Gesamtbreite ein.
6580 % \else%
6581 % The following is repeated many times, so it is good to describe it one
6582 % time. \cs{xsize@nss} ist the width of the box to be constructed now. The
6583 % text of the action must be placed into the box with left and right
6584 % margins. The width of one margin is \(\frac{1}{12}\) of the current width,
6585 % so the text covers \(\frac{5}{6}\) of the width.%
6586 % \fi%
6587 % \begin{macrocode}
6588 \tempx@nss=\xsize@nss\divide\tempx@nss by 6%
6589 % \end{macrocode}
6590 % \ifnum\language=\languageNGerman%
6591 % Zuerst wird der Text behandelt, \ldots
6592 % \else%
6593 % At first the text ist formatted, \ldots{}%
6594 % \fi%
6595 % \begin{macrocode}
6596 \set@nss{#1}{\tempx@nss}%
6597 % \end{macrocode}
6598 % \ifnum\language=\languageNGerman%
6599 % dann wird die Höhe der Box in \cs{tempy@nss} zwischengespeichert \ldots{}
6600 % \else%
6601 % the the height of the box gets intermediately stored in \cs{tempy@nss}, \ldots{}%
6602 % \fi%
6603 % \begin{macrocode}
6604 \tempy@nss=\number\param@nss000%
6605 % \end{macrocode}
6606 % \ifnum\language=\languageNGerman%
6607 % und als letztes wird der Kasten mit dem vorbereiteten Text gesetzt:
6608 % \else%
6609 % and at last the box with the previous prepared text gets set:%
6610 % \fi%
6611 % \begin{macrocode}
6612 \block@nss{\tempy@nss}{1}%
6613 \dbgString@nss{Ende \string\@assign}
6614 \dbgCoord@nss[Ursprung]{\x@nss}{\y@nss}
6615 }
6616 % \end{macrocode}
6617 % \end{macro}
6618 %
6619 % \begin{macro}{\sub}
6620 % \changes{v-4.5a}{96/03/14}{Beschreibung eingeführt}
6621 % \ifnum\language=\languageNGerman%
6622 % Der Aufruf eines Unterprogrammes wird mit \cs{sub} gekennzeichnet:
6623 % \else%
6624 % The call of a subprogram is signed by \cs{sub}:%
6625 % \fi%
6626 % \begin{macrocode}
6627 \def\sub{\let\next=\@sub\getoption}
6628 \def\@sub#1%
6629 {%
6630 \@assign{#1}\tempx@nss=\xsize@nss\divide\tempx@nss by 20%
6631 \tempxx@nss=\x@nss\advance\tempxx@nss by \tempx@nss%
6632 \put(\tempxx@nss,\y@nss){\line(0,1){\ydepth@nss}}%
6633 \tempxx@nss=\x@nss\advance\tempxx@nss by \xsize@nss%
6634 \advance\tempxx@nss by -\tempx@nss%
6635 \put(\tempxx@nss,\y@nss){\line(0,1){\ydepth@nss}}%
6636 }
6637 % \end{macrocode}
6638 % \end{macro}
6639 %
6640 % \begin{macro}{\exit}
6641 % \changes{v061}{10/05/31}{added missing translation}
6642 % \changes{v-3.3c}{94/09/27}{Fehler mit der Breite korrigiert}
6643 % \changes{v-2.5}{93/09/09}{Änderungen an der Darstellung}
6644 % \changes{v-2.0}{92/01/17}{Eingeführt durch D. Rieger}
6645 % \ifnum\language=\languageNGerman%
6646 % Verlassen einer Schleife an einer bestimmten Stelle.
6647 % \else%
6648 % Leaving the loop at a certain point.%
6649 % \fi%
6650 % \begin{macrocode}
6651 \def\exit{\let\next=\@exit\getoption}
6652 \def\@exit#1%
6653 {%
6654 \tempx@nss=\xsize@nss\divide\tempx@nss by 6%
6655 \set@nss{#1}{\tempx@nss}%
6656 \tempy@nss=\number\param@nss000%
6657 \block@nss{\tempy@nss}{1}%
6658 \divide\ydepth@nss by 2%
6659 \advance\y@nss by \ydepth@nss%
6660 \ifnum\ydepth@nss<3500%
6661 % \end{macrocode}
6662 % \ifnum\language=\languageNGerman%
6663 % Eigene Gruppe bilden, um Änderung an |\ydepth@nss| lokal zu halten
6664 % \else%
6665 % Build of an own group to keep change of |\ydepth@nss| local%
6666 % \fi%
6667 % \begin{macrocode}
6668 {%
6669 \multiply\ydepth@nss by 2%
6670 \put(\x@nss,\y@nss){\line(2,1){\ydepth@nss}}%
6671 \put(\x@nss,\y@nss){\line(2,-1){\ydepth@nss}}%
6672 }%
6673 \else%
6674 \put(\x@nss,\y@nss){\line(1,1){\ydepth@nss}}%
6675 \put(\x@nss,\y@nss){\line(1,-1){\ydepth@nss}}%
6676 \fi%
6677 \advance\y@nss by-\ydepth@nss%
6678 }
6679 % \end{macrocode}
6680 % \end{macro}
6681 %
6682 % \begin{macro}{\return}
6683 % \changes{v-4.5a}{96/03/14}{Beschreibung eingeführt}
6684 % \ifnum\language=\languageNGerman%
6685 % Die Rückkkehr aus einem Unterprogramm wird mit \cs{return} gekennzeichnet:
6686 % \else%
6687 % The return from a subprogram is signed by \cs{return}:%
6688 % \fi%
6689 % \begin{macrocode}
6690 \def\return{\let\next=\@return\getoption}
6691 \def\@return#1%
6692 {%
6693 \tempy@nss=\number\param@nss000%
6694 \ifnum\tempy@nss<7000 \tempy@nss=7000 \fi%
6695 \set@nss{#1}{\tempy@nss} \block@nss{\tempy@nss}{1}%
6696 \divide\ydepth@nss by 2%
6697 \advance\y@nss by \ydepth@nss%
6698 \put(\x@nss,\y@nss){\line(1,1){\ydepth@nss}}%
6699 \put(\x@nss,\y@nss){\line(1,-1){\ydepth@nss}}%
6700 \tempx@nss=\x@nss\advance\tempx@nss by \xsize@nss%
6701 \put(\tempx@nss,\y@nss){\line(-1,1){\ydepth@nss}}%
6702 \put(\tempx@nss,\y@nss){\line(-1,-1){\ydepth@nss}}%
6703 \advance\y@nss by-\ydepth@nss%
6704 }
6705 % \end{macrocode}
6706 % \end{macro}
6707 %
6708 % \begin{macro}{\condindent@nss}
6709 % \changes{v-4.1b}{95/07/19}{umbenannt von `w@rt@nss}
6710 % \changes{v-4.0b}{95/05/08}{umbenannt von `w@rt}
6711 % \begin{macro}{\index@nss}
6712 % \changes{v-4.1b}{95/07/19}{umbenannt von `zaehler@nss}
6713 % \changes{v-4.0b}{95/05/08}{umbenannt von `zaehler}
6714 % \begin{macro}{\anzzeilen@nss}
6715 % \changes{v-4.1b}{95/07/19}{umbenannt von `zeilen@nss}
6716 % \changes{v-4.0b}{95/05/08}{umbenannt von `zeilen}
6717 % \changes{v-3.1}{94/09/09}{Beschreibung eingeführt}
6718 % \ifnum\language=\languageNGerman%
6719 % |\index@nss|, |\anzzeilen@nss| und |\condindent@nss| werden benötigt, um
6720 % den Umbruch der Bedingung in einer \cs{if}-Abfrage geeignet durchführen
6721 % zu können:
6722 % \begin{quote}
6723 % \DeleteShortVerb{\|}
6724 % \begin{tabular}{|l|p{6cm}|}\hline
6725 % \verb-\index@nss- & ein Schleifenindex \\\hline
6726 % \verb-\anzzeilen@nss- & die Anzahl von
6727 % Zeilen, in die der Bedingungstext maximal zerlegt wird \\\hline
6728 % \verb-\condindent@nss- & enthält den jeweiligen Wert des Einzugs, um den
6729 % Bedingungstext an das Dreieck anzupassen \\\hline
6730 % \end{tabular}
6731 % \MakeShortVerb{\|}
6732 %\end{quote}
6733 % Die Höhe der Zeilen wird bei der Berechnung mit 5mm angenommen.
6734 % \else%
6735 % |\index@nss|, |\anzzeilen@nss| and |\condindent@nss| are used for suitable
6736 % making up of \cs{if}-conditions:
6737 % |\index@nss| is a loopindex, |\anzzeilen@nss| gives the number of lines the
6738 % conditioning text can be analyzed at most and |\condindent@nss| consists
6739 % the value of insertion to adapt the conditioning text to the triangle.
6740 % In this evaluation the height of lines is 5mm.%
6741 % \fi%
6742 % \begin{macrocode}
6743 \countdef\condindent@nss=232 \countdef\index@nss=233%
6744 % \end{macrocode}
6745 % \end{macro}
6746 % \end{macro}
6747 % \end{macro}
6748 %
6749 % \begin{macro}{\gindhelp@nss}
6750 % \changes{v-7.0ba}{04/03/09}{umbenannt von `indhelp@nss}
6751 % \begin{macro}{\indentmeasure@nss}
6752 % \changes{v-5.3a}{98/11/27}{neu eingeführt}
6753 % \begin{macro}{\indentmeasureleft@nss}
6754 % \changes{v-5.3a}{98/11/27}{neu eingeführt}
6755 % \begin{macro}{\thisindent@nss}
6756 % \changes{v-5.3a}{98/11/27}{neu eingeführt}
6757 % \begin{macro}{\thisindentleft@nss}
6758 % \changes{v-5.3a}{98/11/27}{neu eingeführt}
6759 % \begin{macro}{\thislength@nss}
6760 % \changes{v-5.3a}{98/11/27}{neu eingeführt}
6761 % \ifnum\language=\languageNGerman%
6762 % Um die Textform (\cs{parshape}) an beliebige Steigungen anpassen zu können,
6763 % sind einige Rechenoperationen mit Hilfsgrößen erforderlich.
6764 % Die folgenden |dimen|-Variablen wurden eingeführt, um die Textform
6765 % (\cs{parshape}) an beliebige Steigungen anpassen zu können, die Bedeutungen
6766 % sind im einzelnen:
6767 % \begin{quote}
6768 % \DeleteShortVerb{\|}
6769 % \begin{tabular}{|l|p{6cm}|}\hline
6770 % \verb-\indentmeasure@nss-: & Einheit des Einzugs (links)\\\hline
6771 % \verb-\indentmeasureright@nss-:& Einheit des Einzugs (rechts) \\\hline
6772 % \verb-\thisindent@nss-: & aktueller Einzug (links) \\\hline
6773 % \verb-\thisindentright@nss-: & aktueller Einzug (rechts) \\\hline
6774 % \verb-\thislength@nss-: & Länge der aktuellen Zeile, ergibt
6775 % sich aus der Zeilenlänge \verb-\xsize@nss-
6776 % vermindert um \verb-\thisindent@nss-
6777 % und \verb-\thisindentright@nss-\\\hline
6778 % \end{tabular}
6779 % \MakeShortVerb{\|}
6780 %\end{quote}
6781 % |\gindhelp@nss| ist eine einfache Hilfsvariable zur temporären Speicherung
6782 % numerischer Werte.
6783 % \else%
6784 % |\gindhelp@nss| is a simple helper variable for storing a numerical value
6785 % temporarily.%
6786 % \fi%
6787 % \begin{macrocode}
6788 \newdimen\indentmeasure@nss \newdimen\indentmeasureright@nss
6789 \newdimen\thisindent@nss \newdimen\thisindentright@nss
6790 \newdimen\thislength@nss
6791 \countdef\gindhelp@nss=234
6792 % \end{macrocode}
6793 % \end{macro}
6794 % \end{macro}
6795 % \end{macro}
6796 % \end{macro}
6797 % \end{macro}
6798 % \end{macro}
6799 %
6800 % \begin{macro}{\ifthenelse@nss}
6801 % \changes{v-8.0a}{04/07/13}{Paket \sFile{pict2e.sty} wird unterstützt}
6802 % \changes{v-4.4a}{96/02/29}{Kommando intern gemacht, um benannt von `ifthenelse}
6803 % \changes{v-4.1d}{95/10/04}{Tippfehler korrigiert}
6804 % \changes{v-4.0d}{95/04/12}{Tippfehler korrigiert}
6805 % \changes{v-3.1}{94/09/09}{Beschreibung eingeführt}
6806 % \ifnum\language=\languageNGerman%
6807 % |\ifthenelse@nss| leitet eine einfache Verzweigung ein. Um Konflikte
6808 % mit anderen Makropaketen zu vermeiden, wird eine Schreibweise benutzt,
6809 % die auf Grund des Klammeraffens nicht direkt aufrufbar ist. Erst ein \cs{let}
6810 % in der Definition der Umgebung |struktogramm| macht dieses Kommando aktiv.
6811 % \else%
6812 % |\ifthenelse@nss| introduces a simple branch. In order to avoid conflicts with
6813 % other macro packages a style is used, which can't be directly called because
6814 % of the at. Only a \cs{let} in the definition of environment |struktogramm|
6815 % activates the command.%
6816 % \fi%
6817 % \begin{macrocode}
6818 \def\ifthenelse@nss{\let\next=\@ifthenelse@nss\getoption}
6819 \def\@ifthenelse@nss#1#2#3#4#5{%
6820 \dbgString@nss{Beginn \string\@ifthenelse@nss}
6821 % \end{macrocode}
6822 % \ifnum\language=\languageNGerman%
6823 % Die 5 Parameter sind:
6824 % \else%
6825 % The 5 parameters are:%
6826 % \fi%
6827 % \ifnum\language=\languageNGerman%
6828 % \begin{enumerate}
6829 % \item Die Steigung (negativ, invers) des linken Zweiges,
6830 % \item die Steigung (positiv, invers) des rechten Zweiges,
6831 % \item die Bedingung, die getestet wird,
6832 % \item Fall des linken Zweiges (üblicherweise "`ja"') und
6833 % \item Fall des rechten Zweiges (üblicherweise "`nein"').
6834 % \end{enumerate}
6835 % \else%
6836 % \begin{enumerate}
6837 % \item the slope (negative, inverse) of the left branch,
6838 % \item the slope (positive, inverse) of the right branch,
6839 % \item the condition, that is tested,
6840 % \item case of the left branch (normally ``yes'') and
6841 % \item case of the right branch (normally ``no'').
6842 % \end{enumerate}%
6843 % \fi%
6844 % \ifnum\language=\languageNGerman%
6845 % Als erstes werden die schrägen Linien gezeichnet. |\tempx@nss| ist die
6846 % Breite des linken Zweiges, |\tempxx@nss| die des rechten Zweiges.
6847 % \else%
6848 % First the slanting lines are drawn. |\tempx@nss| is the width of the left branch,
6849 % |\tempxx@nss| the width of the right branch.%
6850 % \fi%
6851 % \begin{macrocode}
6852 \ifanyslope
6853 % \end{macrocode}
6854 % \ifnum\language=\languageNGerman%
6855 % Wenn \cs{anyslope} nicht wahr ist, werden schräge Linien mit \cs{line}
6856 % erzeugt. \cs{xx@nss} ist die Anzahl von Einheiten, in die aktuelle Breite
6857 % zerlegt wird.
6858 % \else%
6859 % If \cs{anyslope} isn't true, the slanting lines are generated by
6860 % \cs{line}. \cs{xx@nss} is the number of unit, into which the current
6861 % width is divided.%
6862 % \fi%
6863 % \begin{macrocode}
6864 \xx@nss=#1 \advance\xx@nss by #2%
6865 \ifnum\number\param@nss000>0%
6866 % \end{macrocode}
6867 % \ifnum\language=\languageNGerman%
6868 % \cs{tempyy@nss} ist die Höhe des "`Bedingungsvierecks"', \cs{tempx@nss}
6869 % die linke und \cs{tempxx@nss} die rechte Breite.
6870 % \else%
6871 % \cs{tempyy@nss} is the height of the box including the condition,
6872 % \cs{tempx@nss} it's left and \cs{tempxx@nss} it's right width.%
6873 % \fi%
6874 % \begin{macrocode}
6875 \tempyy@nss=\number\param@nss000%
6876 \tempx@nss=\xsize@nss%
6877 \multiply\tempx@nss by #1 \divide\tempx@nss by \xx@nss%
6878 \tempxx@nss=\xsize@nss%
6879 \multiply\tempxx@nss by #2 \divide\tempxx@nss by \xx@nss%
6880 \else%
6881 \tempyy@nss=\xsize@nss \divide\tempyy@nss by \xx@nss%
6882 \tempx@nss=\tempyy@nss \multiply\tempx@nss by #1%
6883 \tempxx@nss=\tempyy@nss \multiply\tempxx@nss by #2%
6884 \fi%
6885 \xx@nss=\tempx@nss \advance\xx@nss by \x@nss%
6886 \tempy@nss=\y@nss \advance\tempy@nss by -\tempyy@nss%
6887 \ifemlines%
6888 \emline{\x@nss}{\y@nss}{}{\xx@nss}{\tempy@nss}{}%
6889 \else\ifcurves%
6890 \curve(\x@nss, \y@nss, \xx@nss, \tempy@nss)%
6891 \else\ifpictIIe%
6892 % \end{macrocode}
6893 % \ifnum\language=\languageNGerman%
6894 % Die Steigungen dürfen jetzt fast beliebige Werte annehmen, Zähler und
6895 % Nenner müssen jedoch im Intervall \([-1000, 1000]\) liegen, die
6896 % Skalierung mit dem Faktor 1000 muss daher wieder rückgängig gemacht werden.
6897 % \else%
6898 % The slope arguments must lie in the intervall \([-1000, 1000]\), so scale
6899 % them appropriately.%
6900 % \fi%
6901 % \begin{macrocode}
6902 \tempyyy@nss=\tempyy@nss
6903 \divide\tempyyy@nss by 1000
6904 \tempxxx@nss=\tempx@nss
6905 \divide\tempxxx@nss by 1000
6906 \put(\x@nss,\y@nss){\line(\tempxxx@nss, -\tempyyy@nss){\tempx@nss}}
6907 \fi\fi\fi%
6908 \advance\x@nss by \xsize@nss%
6909 \ifemlines%
6910 \emline{\x@nss}{\y@nss}{}{\xx@nss}{\tempy@nss}{}%
6911 \else\ifcurves%
6912 \curve(\x@nss, \y@nss, \xx@nss, \tempy@nss)
6913 \else\ifpictIIe%
6914 \tempxxx@nss=\tempxx@nss
6915 \divide\tempxxx@nss by 1000
6916 \put(\x@nss,\y@nss){\line(-\tempxxx@nss, -\tempyyy@nss){\tempxx@nss}}
6917 \fi\fi\fi%
6918 % \end{macrocode}
6919 % \ifnum\language=\languageNGerman%
6920 % Die Koordinaten werden auf die linke untere Ecke des
6921 % "`Bedingungsrechteckes"' gesetzt:
6922 % \else%
6923 % The coordinates are set on the left lower angle of the ``conditioning rectangle'':%
6924 % \fi%
6925 % \begin{macrocode}
6926 \advance\x@nss by -\xsize@nss \advance\y@nss by -\tempyy@nss%
6927 % \end{macrocode}
6928 % \ifnum\language=\languageNGerman%
6929 % Nun wird die Form des Bedingungstextes berechnet (vgl.
6930 % \else%
6931 % Now the form of the conditioning text will be calculated (cf.%
6932 % \fi%
6933 % \cite[Kap.~14, S.~101--102]{Knuth:TeXBook}):
6934 % \begin{macrocode}
6935 \tempy@nss=\tempyy@nss\divide\tempy@nss by 5000%
6936 % \end{macrocode}
6937 % \ifnum\language=\languageNGerman%
6938 % Wenn die Höhe des "`Bedingungsrechteckes"' zu gering ist, muss dennoch
6939 % eine Zeile hineingeschrieben werden, ansonsten führt \cs{parshape} zu einem
6940 % Fehler.
6941 % \else%
6942 % If the height of the ``conditioning rectangle'' is too low, a line has to
6943 % be written though. Otherwise \cs{parshape} causes a mistake.%
6944 % \fi%
6945 % \changes{v-8.0e}{05/05/17}{Fehlermeldung erweitert, nun auch Hinweis auf
6946 % curves und pict2e}
6947 % \begin{macrocode}
6948 \ifnum\tempy@nss<1 \tempy@nss=1\fi%
6949 \indentmeasure@nss=\xsize@nss\unitlength%
6950 \gindhelp@nss=#1\advance\gindhelp@nss by #2%
6951 \divide\indentmeasure@nss by \gindhelp@nss%
6952 \indentmeasureright@nss = \indentmeasure@nss%
6953 \multiply\indentmeasure@nss by #1%
6954 \multiply\indentmeasureright@nss by #2%
6955 \divide\indentmeasure@nss by \tempyy@nss%
6956 \divide\indentmeasureright@nss by \tempyy@nss%
6957 \phantom{\vbox{\hsize=0pt\global\gindhelp@nss=\the\baselineskip}}%
6958 \multiply\gindhelp@nss by 360%
6959 \multiply\indentmeasure@nss by \gindhelp@nss%
6960 \multiply\indentmeasureright@nss by \gindhelp@nss%
6961 \xdef\shape{}\index@nss=0%
6962 \loop%
6963 \advance\index@nss by 1% %Zahl der Zeile
6964 \thisindent@nss=\indentmeasure@nss%
6965 \multiply\thisindent@nss by \index@nss%
6966 \advance\thisindent@nss by 0.175cm%
6967 \xdef\shape{\shape\the\thisindent@nss}%
6968 \thisindentright@nss=\indentmeasureright@nss%
6969 \multiply\thisindentright@nss by \index@nss%
6970 \advance\thisindentright@nss by 0.175cm%
6971 \thislength@nss=\xsize@nss\unitlength%
6972 \advance\thislength@nss by -\thisindent@nss
6973 \advance\thislength@nss by -\thisindentright@nss
6974 \xdef\shape{\shape\the\thislength@nss}%
6975 \ifnum\index@nss<\tempy@nss%
6976 \repeat%
6977 \else %\ifanyslope
6978 \ifnum\number\param@nss000>0%
6979 \typeout{struktex warning:}%
6980 \typeout{[...] not supplied without curves, emlines2, or pict2e}%
6981 \fi%
6982 \tempx@nss=#1 \advance\tempx@nss by #2%
6983 \tempyy@nss=\xsize@nss \divide\tempyy@nss by \tempx@nss%
6984 \tempx@nss=\tempyy@nss \multiply\tempx@nss by #1%
6985 \put(\x@nss,\y@nss){\line(#1,-1){\tempx@nss}}%
6986 \tempxx@nss=\tempyy@nss \multiply\tempxx@nss by #2%
6987 \advance\x@nss by \xsize@nss%
6988 \put(\x@nss,\y@nss){\line(-#2,-1){\tempxx@nss}}%
6989 \advance\x@nss by -\xsize@nss \advance\y@nss by -\tempyy@nss%
6990 \tempy@nss=\tempyy@nss\divide\tempy@nss by 5000%
6991 \ifnum\tempy@nss<1 \tempy@nss=1\fi%
6992 \xdef\shape{}\index@nss=0%
6993 \loop%
6994 \advance\index@nss by 1%
6995 \condindent@nss=#1\multiply\condindent@nss by\index@nss%
6996 \multiply\condindent@nss by 5000%
6997 \xdef\shape{\shape\the\condindent@nss\unitlength}%
6998 \condindent@nss=#1\advance\condindent@nss by #2%
6999 \multiply\condindent@nss by\index@nss%
7000 \multiply\condindent@nss by -5000%
7001 \advance\condindent@nss by \xsize@nss%
7002 \xdef\shape{\shape\the\condindent@nss\unitlength}%
7003 \ifnum\index@nss<\tempy@nss%
7004 \repeat%
7005 \fi %\ifanyslope
7006 \put(\x@nss,\y@nss){%
7007 \framebox(\xsize@nss,\tempyy@nss)[tl]{%
7008 \vbox{%
7009 \hsize=\xsize@nss\unitlength%
7010 \parshape=\tempy@nss \shape \c@nter@nss%
7011 %dies sorgt für den Einzug
7012 \noindent\vrule width0pt height12pt \relax #3%
7013 %hier wird der Text ausgegeben
7014 }%
7015 }%
7016 }%
7017 \divide\tempyy@nss by 2%
7018 \xx@nss=\xsize@nss\advance\xx@nss by-\tempx@nss%
7019 \advance\xx@nss by-\tempxx@nss%
7020 \ifodd\xx@nss\advance\tempxx@nss by 1\fi%
7021 \divide\xx@nss by 2\advance\tempxx@nss by \xx@nss%
7022 \advance\tempx@nss by \xx@nss%
7023 \ifouter%
7024 \put(\x@nss,\y@nss){\makebox(\tempx@nss,\tempyy@nss)[l]{\hspace{1em}#4}}%
7025 \else%\outer
7026 \put(\x@nss,\y@nss){\makebox(\tempx@nss,\tempyy@nss){#4}}%
7027 \fi %\outer
7028 \xx@nss=\x@nss\advance\xx@nss by \tempx@nss%
7029 \ifouter%
7030 \put(\xx@nss,\y@nss){\makebox(\tempxx@nss,\tempyy@nss)[r]{#5\hspace{1em}}}%
7031 \else%\outer
7032 \put(\xx@nss,\y@nss){\makebox(\tempxx@nss,\tempyy@nss){#5}}%
7033 \fi %\outer
7034 \str@kt{\x@nss}{\y@nss}{\tempx@nss}%
7035 \dbgString@nss{Ende \string\@ifthenelse@nss}
7036 }
7037 % \end{macrocode}
7038 % \end{macro}
7039 %
7040 % \begin{macro}{\change}
7041 % \changes{v-4.5b}{96/03/28}{Beschreibung eingeführt}
7042 % \ifnum\language=\languageNGerman%
7043 % \cs{change} trennt die Zweige beim |\ifthenelse@nss|
7044 % \else%
7045 % \cs{change} seperates the branches in |\ifthenelse@nss|%
7046 % \fi%
7047 % \changes{v061}{10/05/31}{added debug code}
7048 % \begin{macrocode}
7049 \def\change{%
7050 \dbgString@nss{\string\change}
7051 \endstr@kt\str@kt{\xx@nss}{\y@nss}{\tempxx@nss}%
7052 }
7053 % \end{macrocode}
7054 % \end{macro}
7055 %
7056 % \begin{macro}{\ifend@nss}
7057 % \changes{v-4.5b}{96/03/28}{Beschreibung eingeführt}
7058 % \ifnum\language=\languageNGerman%
7059 % |\ifend@nss| beendet |\ifthenelse@nss|, wird in |struktogramm| intern
7060 % gemacht.
7061 % \else%
7062 % |\ifend@nss| terminates |\ifthenelse@nss|, which is internally done in
7063 % |struktogramm|.%
7064 % \fi%
7065 % \changes{v061}{10/05/31}{added debug code}
7066 % \begin{macrocode}
7067 \def\ifend@nss{%
7068 \dbgString@nss{Beginn \string\ifend@nss}
7069 \global\gy@nss=\y@nss\endgroup\tempy@nss=\gy@nss%
7070 \ifnum\tempy@nss<\ydepth@nss%
7071 \y@nss=\tempy@nss\advance\ydepth@nss by-\tempy@nss%
7072 \put(\x@nss,\y@nss){%
7073 \framebox(\tempx@nss,\ydepth@nss){%
7074 \ifnum\ydepth@nss>5000\filler@nss\fi%
7075 }%
7076 }%
7077 \else%
7078 \ifnum\tempy@nss>\ydepth@nss%
7079 \y@nss=\ydepth@nss\advance\tempy@nss by-\ydepth@nss%
7080 \put(\xx@nss,\y@nss){%
7081 \framebox(\tempxx@nss,\tempy@nss){%
7082 \ifnum\tempy@nss>5000\filler@nss\fi%
7083 }%
7084 }%
7085 \else%
7086 \y@nss=\ydepth@nss%
7087 \fi%
7088 \fi%
7089 \dbgString@nss{Ende \string\ifend@nss}
7090 }
7091 % \end{macrocode}
7092 % \end{macro}
7093 %
7094 % \begin{macro}{\forloop@nss}
7095 % \changes{v2.0a}{17/06/02}{introduced a generic name}
7096 % \changes{v2.0}{17/06/02}{`forall: introduced loop over a set}
7097 % \begin{macro}{\forloopend@nss}
7098 % \changes{v2.0a}{17/06/02}{introduced a generic name}
7099 % \changes{v2.0}{17/06/02}{`forallend: introduced loop over a set}
7100 % \ifnum\language=\languageNGerman%
7101 % Beginn und Ende einer Schleife, die über alle Elemente einer Menge
7102 % läuft. Die Beschreibung der Schleife wird als Parameter übergeben.
7103 % \else%
7104 % Begin and end of a loop which traverses all elements of a set. The
7105 % description of the loop is passed as parameter.%
7106 % \fi%
7107 % \begin{macrocode}
7108 \def\forloop@nss{\let\next=\@forloop@nss\getoption}
7109 \def\@forloop@nss#1{
7110 \def\argi{#1}
7111 \dbgString@nss{Beginn \string\@forloop}
7112 \tempx@nss=\xsize@nss
7113 \divide\tempx@nss by 6
7114 \ifx\argi\empty%
7115 \set@nss{\mbox{\rule{0mm}{2ex}}}{\tempx@nss}%
7116 \else%
7117 \set@nss{#1\hskip\xsize@nss\unitlength}{\tempx@nss}%
7118 \fi%
7119 \tempy@nss=\number\param@nss000
7120 \block@nss{\tempy@nss}{0}
7121 \advance\x@nss by \ydepth@nss
7122 \tempxx@nss=\xsize@nss
7123 \advance\tempxx@nss by -\ydepth@nss
7124 \tempy@nss=\ydepth@nss
7125 \str@kt{\x@nss}{\y@nss}{\tempxx@nss}
7126 }
7127 \def\forloopend@nss{
7128 \endstr@kt
7129 \advance\x@nss by-\tempy@nss
7130 \advance\ydepth@nss by -\tempy@nss
7131 \tempyy@nss=\ydepth@nss
7132 \ydepth@nss=-\ydepth@nss
7133 \advance\ydepth@nss by \y@nss
7134 \advance\ydepth@nss by \tempy@nss
7135 \y@nss=\tempyy@nss
7136 \put(\x@nss,\y@nss){\framebox(\xsize@nss,\ydepth@nss){}}
7137 \dbgString@nss{Ende \string\@forloop@nss}
7138 }
7139 % \end{macrocode}
7140 % \end{macro}
7141 % \end{macro}
7142 %
7143 % \begin{macro}{\forallin}
7144 % \changes{v2.0b}{17/06/02}{renamed from `foreach: conflict with tikz}
7145 % \changes{v2.0a}{17/06/02}{mapped the generic name onto the name for the user's interface}
7146 % \begin{macro}{\forallinend}
7147 % \changes{v2.0b}{17/06/02}{renamed from `foreach: conflict with tikz}
7148 % \changes{v2.0a}{17/06/02}{mapped the generic name the name for onto the user's interface}
7149 % \changes{v2.0a}{17/06/02}{introduced a generic name}
7150 % \begin{macrocode}
7151 \let\forallin=\forloop@nss
7152 \let\forallinend=\forloopend@nss
7153 % \end{macrocode}
7154 % \end{macro}
7155 % \end{macro}
7156 %
7157 % \begin{macro}{\forever}
7158 % \changes{v2.0a}{17/06/02}{mapped the generic name onto the name for the user's interface}
7159 % \changes{v-3.5a}{94/11/22}{übernommen von J. Dietel}
7160 % \changes{v-2.0}{92/01/17}{Eingeführt durch D. Rieger}
7161 % \begin{macro}{\foreverend}
7162 % \changes{v2.0a}{17/06/02}{mapped the generic name onto the name for the user's interface}
7163 % \changes{v-3.5a}{94/11/22}{übernommen von J. Dietel}
7164 % \changes{v-2.0}{92/01/17}{Eingeführt durch D. Rieger}
7165 % \ifnum\language=\languageNGerman%
7166 % Beginn und Ende einer Endlosschleife.
7167 % \else%
7168 % Begin and end of an endless loop%
7169 % \fi%
7170 % \begin{macrocode}
7171 \def\forever{\let\next=\@forever\getoption}
7172 \def\@forever{%
7173 \@forloop@nss{}%
7174 }
7175 \let\foreverend=\forloopend@nss
7176 % \end{macrocode}
7177 % \end{macro}
7178 % \end{macro}
7179 %
7180 % \begin{macro}{\dfr}
7181 % \changes{v-4.5b}{96/03/28}{Beschreibung eingeführt}
7182 % \begin{macro}{\dfrend}
7183 % \changes{v-4.5b}{96/03/28}{Beschreibung eingeführt}
7184 % \ifnum\language=\languageNGerman%
7185 % Aus Kompatibilitätsgründen werden für \cs{forever} und \cs{foreverend} noch
7186 % die folgenden Abkürzungen bereitgestellt.
7187 % \else%
7188 % For reasons of compatibility the following abbreviations for \cs{forever} and
7189 % \cs{foreverend} are provided.%
7190 % \fi%
7191 % \begin{macrocode}
7192 \let\dfr\forever
7193 \let\dfrend\foreverend
7194 % \end{macrocode}
7195 % \end{macro}
7196 % \end{macro}
7197 %
7198 % \begin{macro}{\while}
7199 % \begin{macro}{\whileend}
7200 % \changes{v061}{10/05/31}{added missing translation and added debug code}
7201 % \ifnum\language=\languageNGerman%
7202 % Beginn und Ende einer kopfgesteuerten Schleife.
7203 % \else%
7204 % Begin and end of a loop with a pre test.%
7205 % \fi%
7206 % \begin{macrocode}
7207 \def\while{\let\next=\@while\getoption}
7208 \def\@while#1{%
7209 \dbgString@nss{Beginn \string\@while}
7210 \dbgCond@nss{fixedindent@nss}
7211 \tempx@nss=\xsize@nss\divide\tempx@nss by 6
7212 \set@nss{#1\hskip\xsize@nss\unitlength}{\tempx@nss}
7213 \tempy@nss=\number\param@nss000 \block@nss{\tempy@nss}{0}
7214 \tempy@nss=\y@nss\advance\y@nss by \ydepth@nss
7215 \@ifthenelse{\boolean{fixedindent@nss}}{%
7216 \tempx@nss=\x@nss\advance\tempx@nss by \xindent@nss
7217 \tempxx@nss=\xsize@nss\advance\tempxx@nss by -\xindent@nss
7218 }{%
7219 \tempx@nss=\x@nss\advance\tempx@nss by \ydepth@nss
7220 \tempxx@nss=\xsize@nss\advance\tempxx@nss by -\ydepth@nss
7221 }
7222 \str@kt{\tempx@nss}{\tempy@nss}{\tempxx@nss}%
7223 }
7224 \def\whileend{%
7225 \endstr@kt\tempy@nss=\y@nss\advance\tempy@nss by-\ydepth@nss
7226 \y@nss=\ydepth@nss
7227 \put(\x@nss,\y@nss){\framebox(\xsize@nss,\tempy@nss){}}%
7228 \dbgString@nss{Ende \string\whileend}
7229 }
7230 % \end{macrocode}
7231 % \end{macro}
7232 % \end{macro}
7233 %
7234 % \begin{macro}{\until}
7235 % \begin{macro}{\untilend}
7236 % \ifnum\language=\languageNGerman%
7237 % Beginn und Ende einer fußgesteuerten Schleife.
7238 % \else%
7239 % Begin and end of a loop with a post test.%
7240 % \fi%
7241 % \begin{macrocode}
7242 \def\until{\let\next=\@until\getoption}
7243 \def\@until#1{\tempx@nss=\xsize@nss\divide\tempx@nss by 6
7244 \dbgString@nss{Beginn \string\@until}
7245 \dbgCoord@nss[Ursprung]{\x@nss}{\y@nss}
7246 \dbgCount@nss[Breite]{\xsize@nss}
7247 \set@nss{#1\hskip\xsize@nss\unitlength}{\tempx@nss}
7248 \tempy@nss=\number\param@nss000 \block@nss{\tempy@nss}{2}
7249 \@ifthenelse{\boolean{fixedindent@nss}}{%
7250 \advance\x@nss by \xindent@nss\tempxx@nss=\xsize@nss
7251 \advance\tempxx@nss by -\xindent@nss \tempy@nss=\ydepth@nss
7252 % \advance\x@nss by \xindent@nss\tempxx@nss=\xsize@nss
7253 % \advance\tempxx@nss by -\xindent@nss \tempy@nss=\ydepth@nss
7254 }{
7255 \advance\x@nss by \ydepth@nss\tempxx@nss=\xsize@nss
7256 \advance\tempxx@nss by -\ydepth@nss \tempy@nss=\ydepth@nss
7257 }
7258 \str@kt{\x@nss}{\y@nss}{\tempxx@nss}
7259 }
7260 \def\untilend{\endstr@kt%
7261 \advance\ydepth@nss by -\tempy@nss
7262 \tempyy@nss=\ydepth@nss\ydepth@nss=-\ydepth@nss%
7263 \advance\ydepth@nss by \y@nss
7264 \y@nss=\tempyy@nss
7265 \@ifthenelse{\boolean{fixedindent@nss}}{%
7266 \advance\x@nss by -\xindent@nss
7267 \put(\x@nss,\y@nss){\framebox(\xsize@nss,\ydepth@nss){}}
7268 \put(\x@nss,\y@nss){\makebox(\xsize@nss,\tempy@nss)
7269 {\box\TextBox@nss}}
7270 }{%
7271 \advance\x@nss by-\tempy@nss
7272 \put(\x@nss,\y@nss){\framebox(\xsize@nss,\ydepth@nss){}}
7273 \put(\x@nss,\y@nss){\makebox(\xsize@nss,\tempy@nss)
7274 {\box\TextBox@nss}}
7275 }%
7276 \dbgString@nss{Ende \string\untilend}%
7277 }
7278 % \end{macrocode}
7279 % \end{macro}
7280 % \end{macro}
7281 %
7282 % \begin{macro}{\cases@nss}
7283 % \changes{v-7.0b}{2004/03/09}{ersetzt durch `tempxx@nss}
7284 % \changes{v-4.2a}{95/10/06}{neu eingeführt}
7285 % \ifnum\language=\languageNGerman%
7286 % |\cases@nss| wird benötigt, um die Anzahl der Fälle im linken Zweig
7287 % des \cs{case}-Konstruktes berechnen zu können. |\cases@nss| nimmt entweder
7288 % die Anzahl der Fälle oder die Anzahl der Fälle $-1$ an.
7289 % \else%
7290 % |\cases@nss| is needed for calculating the number of cases in the left branch of
7291 % the \cs{case}-construct. |\cases@nss| assumes the value either the number of cases
7292 % or the number of cases $-1$.%
7293 % \fi%
7294 % \end{macro}
7295 %
7296 % \begin{macro}{\case}
7297 % \begin{macro}{\caseend}
7298 % \begin{macro}{\switch}
7299 % \changes{v-8.2a}{05/01/17}{Fehlerkorrektur: schräge Linie endet nun an
7300 % der richtigen Stelle (pict2e)}
7301 % \changes{v-8.0d}{04/12/29}{Fehlerkorrektur: senkrechte Trennlinien haben
7302 % nun die richtige Länge}
7303 % \changes{v-8.0a}{04/07/13}{Paket \sFile{pict2e.sty} wird unterstützt}
7304 % \changes{v-4.2a}{95/10/04}{um \foreign{default}-Zweig erweitert}
7305 % \changes{v-4.1d}{95/10/04}{Dokumentation verbessert}
7306 % \changes{v-3.5a}{94/11/22}{übernommen von J. Dietel}
7307 % \ifnum\language=\languageNGerman%
7308 % \cs{case}, \cs{caseend} und \cs{switch} stellen eine Mehrfachverzweigung dar.
7309 % Es sind derzeit noch die alten Versionen \cs{caseold}, \cs{caseoldend} und
7310 % \cs{switchold} zusätzlich enthalten, diese sollten in einer späteren
7311 % Version gestrichen werden.
7312 % \else%
7313 % \cs{case}, \cs{caseend} and \cs{switch} represent a multiple branch. At the moment
7314 % the old versions \cs{caseold}, \cs{caseoldend} and \cs{switchold} are included in addition.
7315 % These should be cancelled in a later version.%
7316 % \fi%
7317 %
7318 % \ifnum\language=\languageNGerman%
7319 % Der Makro hat vier Parameter:
7320 % \begin{enumerate}
7321 % \item Die Steigung (negativ, invers) der schrägen Linie,
7322 % \item die Anzahl der Fälle,
7323 % \item den Text der Bedingung und
7324 % \item den des ersten Falles
7325 % \end{enumerate}
7326 % Zusätzlich gibt es einen optionalen vorangestellten Parameter, der es im
7327 % Falle der Benutzung des \sFile{emlines2.sty} ermöglicht, die schräge
7328 % Linie mit einer beliebigen Steigung zu zeichnen. Wird dieser Parameter
7329 % genutzt, hat der erste Parameter eine geänderte Bedeutung: ist der
7330 % Parameter eine gerade Zahl, wird die Schräge gerade durchgezogen (kein
7331 % \foreign{default}-Zweig), ansonsten wird der letzte Zweig als
7332 % Standardfall angesehen und somit werden die Schrägen entsprechend
7333 % gezeichnet: die ersten $n-1$ Fälle werden im linken Zweig untergebracht,
7334 % der $n$-te Fall wird im rechten Zweig abgehandelt, vgl. dazu auch die
7335 % Abbildungen auf Seite~\pageref{sec:case1} und \pageref{sec:case2}.
7336 % \else%
7337 % The macro has four parameters:
7338 % \begin{enumerate}
7339 % \item the slope (negative, inverse) of a slanted line,
7340 % \item the number of cases,
7341 % \item the text of the condition and
7342 % \item the one of the first case
7343 % \end{enumerate}
7344 % Additionally there is an optional parameter placed in front. In the case
7345 % of using of one of the packages \sFile{curves.sty},
7346 % \sFile{emlines2.sty} or \sFile{pict2e.sty} this parameter enables
7347 % drawing the slanted line with any slope. If this parameter is used,
7348 % the first parameter has a different meaning: if the parameter is an even
7349 % number, the slanted line will be drawn upright (no \foreign{default}
7350 % branch), otherwise the last branch is regarded as standard case and so
7351 % the slanted lines are drawn accordingly: the first \(n-1\) cases are put
7352 % into the left branch, the \(n\)-th case is done in the right branch. For
7353 % a better understanding see the figures on page~\pageref{sec:case1} and
7354 % \pageref{sec:case2}.%
7355 % \fi%
7356 % \changes{v061}{10/05/31}{added debug code}
7357 % \begin{macrocode}
7358 \def\case{\let\next=\@case\getoption}
7359 \def\@case#1#2#3#4{%
7360 \dbgString@nss{Beginn \string\@case}
7361 % \end{macrocode}
7362 % \ifnum\language=\languageNGerman%
7363 % Merken der Anzahl der Fälle
7364 % \else%
7365 % memo of number of cases%
7366 % \fi%
7367 % \begin{macrocode}
7368 \tempxx@nss=\number#2%
7369 % \end{macrocode}
7370 % \ifnum\language=\languageNGerman%
7371 % Zunächst die schräge Linie zeichnen
7372 % \else%
7373 % first drawing the slanted lines%
7374 % \fi%
7375 % \begin{macrocode}
7376 \ifanyslope%
7377 %{%
7378 % \end{macrocode}
7379 % \ifnum\language=\languageNGerman%
7380 % -- wenn \cs{anyslope} nicht wahr ist, werden schräge Linien mit \cs{line}
7381 % erzeugt,
7382 % \else%
7383 % -- if \cs{anyslope} isn't true, the slanted lines are generated by
7384 % \cs{line},%
7385 % \fi%
7386 % \begin{macrocode}
7387 % \end{macrocode}
7388 % \ifnum\language=\languageNGerman%
7389 % wobei die Höhe des Rahmens für die Fallunterscheidungen aus seiner
7390 % Breite und der vorgegebenen Steigung berechnet wird --,
7391 % \else%
7392 % where the height of frame for the different cases is evaluated from
7393 % the width and the given slope --,%
7394 % \fi%
7395 % \begin{macrocode}
7396 \ifnum\number\param@nss000>0
7397 % \end{macrocode}
7398 % \ifnum\language=\languageNGerman%
7399 % Wenn die Höhe des Rahmens vorgegeben ist, nimm diese, ansonsten berechne
7400 % sie wie oben.
7401 % \else%
7402 % If the height of the frame is given, take it, otherwise calculate it like above.%
7403 % \fi%
7404 % \begin{macrocode}
7405 \tempyy@nss=\number\param@nss000%
7406 \ifodd\number#1
7407 \advance\tempxx@nss by -1
7408 \fi
7409 \else
7410 \tempyy@nss=\xsize@nss
7411 \divide\tempyy@nss by #1
7412 \fi
7413 \ifnum\number#2=\tempxx@nss
7414 % \end{macrocode}
7415 % \ifnum\language=\languageNGerman%
7416 % \cs{tempxx@nss} ist unverändert, es wird also die Diagonale (gerade
7417 % Linie) gezeichnet. Die Berechnung der Koordinaten basiert auf:
7418 % \begin{quote}
7419 % \begin{tabular}{r@{:~}l}
7420 % \cs{x@nss} & linke obere x-Koordinate des Kastens\\
7421 % \cs{y@nss} & linke obere y-Koordinate des Kastens\\
7422 % \cs{xsize@nss} & Breite des Kastens\\
7423 % \cs{tempyy@nss} & Höhe des Kastens\\
7424 % \cs{tempxx@nss} & Anzahl der Fälle (evtl. reduziert um 1)\\
7425 % \end{tabular}
7426 % \end{quote}
7427 % \else%
7428 % \cs{tempxx@nss} is unchanged, therefore we draw a diagonal. The internal
7429 % computation bases on
7430 % \begin{quote}
7431 % \begin{tabular}{r@{:~}l}
7432 % \cs{x@nss} & left upper x-coordinate of the case box\\
7433 % \cs{y@nss} & left upper y-coordinate of the case box\\
7434 % \cs{xsize@nss} & width of the case box\\
7435 % \cs{tempyy@nss} & height of the case box\\
7436 % \cs{tempxx@nss} & number of cases (maybe reduced by 1)\\
7437 % \end{tabular}
7438 % \end{quote}%
7439 % \fi%
7440 % \begin{macrocode}
7441 \xx@nss=\x@nss \advance\xx@nss by \xsize@nss
7442 \tempy@nss=\y@nss \advance\tempy@nss by -\tempyy@nss
7443 \ifemlines%
7444 \emline{\x@nss}{\y@nss}{}{\xx@nss}{\tempy@nss}{}%
7445 \else\ifcurves%
7446 \curve(\x@nss, \y@nss, \xx@nss, \tempy@nss)%
7447 \else\ifpictIIe%
7448 \tempxxx@nss=\xx@nss
7449 % \end{macrocode}
7450 % \ifnum\language=\languageNGerman%
7451 % Die Argumente von \cs{line} für die Steigung müssen im Intervall
7452 % \([-1000, 1000]\) liegen, daher
7453 % wird hier der Faktor 1000 wieder wegdividiert. Abschließend wird die
7454 % Länge der Strecke berechnet.
7455 % \else%
7456 % The arguments of \cs{line} for the slope must be in the interval
7457 % \([-1000, 1000]\), so divide by
7458 % the previous introduced factor of 1000. Finally we're computing the
7459 % length of the line.%
7460 % \fi%
7461 % \begin{macrocode}
7462 \advance\tempxxx@nss by -\x@nss
7463 \divide\tempxxx@nss by 1000
7464 \tempyyy@nss=\tempy@nss
7465 \advance\tempyyy@nss by -\y@nss
7466 \divide\tempyyy@nss by 1000
7467 \advance\xx@nss by -\x@nss
7468 \put(\x@nss,\y@nss){\line(\tempxxx@nss, \tempyyy@nss){\xx@nss}}
7469 \fi\fi\fi%
7470 \else
7471 \tempx@nss=\xsize@nss
7472 \multiply\tempx@nss by \tempxx@nss \divide\tempx@nss by #2
7473 \xx@nss=\x@nss \advance\xx@nss by \tempx@nss
7474 \tempy@nss=\y@nss \advance\tempy@nss by -\tempyy@nss
7475 \ifemlines%
7476 \emline{\x@nss}{\y@nss}{}{\xx@nss}{\tempy@nss}{}%
7477 \else\ifcurves%
7478 \curve(\x@nss, \y@nss, \xx@nss, \tempy@nss)%
7479 \else\ifpictIIe%
7480 % \end{macrocode}
7481 % \ifnum\language=\languageNGerman%
7482 % Die Berechnung der Länge muss lokal sein, darum wird hier eine eigene
7483 % Gruppe eingeführt anstatt die letzte Subtraktion rückgängig zu machen.
7484 % \else%
7485 % The calculation of the length of the line must be local, so we're using a
7486 % group here---instead of undoing the \cs{advance} operation.%
7487 % \fi%
7488 % \begin{macrocode}
7489 \begingroup
7490 \tempxxx@nss=\xx@nss
7491 \advance\tempxxx@nss by -\x@nss
7492 \divide\tempxxx@nss by 1000
7493 \tempyyy@nss=\tempy@nss
7494 \advance\tempyyy@nss by -\y@nss
7495 \divide\tempyyy@nss by 1000
7496 \advance\xx@nss by -\x@nss
7497 \put(\x@nss,\y@nss){\line(\tempxxx@nss,
7498 \tempyyy@nss){\xx@nss}}
7499 \endgroup
7500 \fi\fi\fi%
7501 \advance\x@nss by \xsize@nss
7502 \ifemlines%
7503 \emline{\x@nss}{\y@nss}{}{\xx@nss}{\tempy@nss}{}%
7504 \else\ifcurves%
7505 \curve(\x@nss, \y@nss, \xx@nss, \tempy@nss)%
7506 \else\ifpictIIe%
7507 \tempxxx@nss=\x@nss
7508 \advance\tempxxx@nss by -\xx@nss
7509 \divide\tempxxx@nss by 1000
7510 \tempyyy@nss=\tempy@nss
7511 \advance\tempyyy@nss by -\y@nss
7512 \divide\tempyyy@nss by 1000
7513 \xx@nss=-\xx@nss
7514 \advance\xx@nss by \x@nss
7515 \put(\x@nss,\y@nss){\line(-\tempxxx@nss, \tempyyy@nss){\xx@nss}}
7516 \fi\fi\fi%
7517 \advance\x@nss by -\xsize@nss
7518 \fi
7519 %}{
7520 \else% \ifanyslope
7521 \ifnum\number\param@nss000>0
7522 \typeout{struktex warning:}%
7523 \typeout{[...] not supplied without curves, emlines2, or pict2e}%
7524 \fi
7525 \put(\x@nss,\y@nss){\line(#1,-1){\xsize@nss}}
7526 \tempyy@nss=\xsize@nss
7527 \divide\tempyy@nss by #1
7528 %}
7529 \fi% \ifanyslope
7530 % \end{macrocode}
7531 % \ifnum\language=\languageNGerman%
7532 % dann den Bedingungstext in die Mitte des rechten oberen Viertels des
7533 % CASE-Rechtecks schreiben,
7534 % \else%
7535 % then the conditioning text writing into the middle of the upper quarter of
7536 % CASE-rectangle%
7537 % \fi%
7538 % \changes{v-8.0e}{05/05/17}{`tempxxx@nss umbenannt in `tempxx@nss (wir
7539 % befinden uns nicht im Fall pictIIe)}
7540 % \changes{v-8.0f}{05/06/12}{`tempxx@nss umbenannt in `tempx@nss (die Anzahl
7541 % der Fälle wurde versehentlich geändert)}
7542 % \begin{macrocode}
7543 \tempx@nss=\xsize@nss
7544 \divide\tempx@nss by 2
7545 \divide\tempyy@nss by 2
7546 \advance\x@nss by \tempx@nss
7547 \advance\y@nss by -\tempyy@nss
7548 \put(\x@nss,\y@nss){\makebox(\tempx@nss,\tempyy@nss){#3}}
7549 % \end{macrocode}
7550 % \ifnum\language=\languageNGerman%
7551 % schließlich |\x@nss| und |\y@nss| auf den alten Wert zurücksetzen und
7552 % zur späteren Verwendung merken.
7553 % \else%
7554 % finally setting |\x@nss| and |\y@nss| on the old value and remembering for later
7555 % use%
7556 % \fi%
7557 % \begin{macrocode}
7558 \advance\x@nss by -\tempx@nss
7559 \advance\y@nss by \tempyy@nss
7560 \xx@nss=\x@nss
7561 \yy@nss=\y@nss
7562 % \end{macrocode}
7563 % \ifnum\language=\languageNGerman%
7564 % |\tempx@nss| ist die Breite eines Zweiges, die für alle Zweige gleich ist
7565 % -- Gesamtbreite geteilt durch Anzahl der Fälle --,
7566 % |\tempy@nss| die Höhe des Falltextes, die von Zweig zu Zweig kleiner wird,
7567 % |\condindent@nss| ist die Schrittweite, um die sich die Höhe des
7568 % Falltextes bei jedem \cs{switch} verringert. Höhe und Schrittweite hängen
7569 % davon ab, ob ein \foreign{default}-Zweig eingeführt wurde oder nicht, sie
7570 % werden demzufolge durch |\tempxx@nss| gesteuert.
7571 % \else%
7572 % |\tempx@nss| is the width of the branch, that is equal for all
7573 % branches---total width divided by number of cases---,
7574 % |\tempy@nss| is the height of the text of case, that decreases from one case
7575 % to the other, |\condindent@nss| is the step size the height of the text of
7576 % case decreases with each \cs{switch}. Height and step size depend on wether
7577 % or not a \foreign{default}-branch is introduced. Accordingly they are controled by
7578 % |\tempxx@nss|.%
7579 % \fi%
7580 % \begin{macrocode}
7581 \tempx@nss=\xsize@nss
7582 \divide\tempx@nss by #2
7583 \ifnum\number\param@nss000>0
7584 \tempy@nss=\number\param@nss000%
7585 \else
7586 \tempy@nss=\xsize@nss
7587 \divide\tempy@nss by #1
7588 \fi
7589 \condindent@nss=\tempy@nss
7590 \divide \condindent@nss by \tempxx@nss
7591 % \end{macrocode}
7592 % \ifnum\language=\languageNGerman%
7593 % Links oben im linken Zweig den Text des Falles eintragen
7594 % \else%
7595 % Entering the text of case into the left upper part of left branch%
7596 % \fi%
7597 % \changes{v061}{10/05/31}{enhanced the documentation}
7598 % \begin{macrocode}
7599 \advance\y@nss by -\tempy@nss
7600 \put(\x@nss,\y@nss)%
7601 {%
7602 \makebox(\tempx@nss,\tempy@nss)[lb]{\raise3pt\hbox{~#4}}%
7603 }%
7604 % \ifnum\language=\languageNGerman%
7605 % Links oben im linken Zweig den Text des Falles eintragen
7606 % \else%
7607 % To find out the full height of the different cases, we start with a large
7608 % value \cs{ydepth@nss}, which gets smaller by the settings of each
7609 % case. Then the overall group gets opened, this group is closed in \cs{?}%
7610 % \fi%
7611 \ydepth@nss=1000000%
7612 \str@kt{\x@nss}{\y@nss}{\tempx@nss}%
7613 \dbgString@nss{Ende: \string\@case}
7614 \dbgCoord@nss[Ursprung]{\x@nss}{\y@nss}
7615 \dbgCount@nss[Breite]{\tempx@nss}
7616 }
7617 % \end{macrocode}
7618 %
7619 % \ifnum\language=\languageNGerman%
7620 % Der Makro \cs{switch} für die einzelnen Fälle hat zwei Parameter:
7621 % \begin{enumerate}
7622 % \item einen optionalen Parameter, der angibt, wo der Text der Bedingung
7623 % gesetzt wird: |l| oder |r| -- der Standardwert ist |l| --, und
7624 % \item den Bedingungstext
7625 % \end{enumerate}
7626 % \else%
7627 % The macro \cs{switch} for the single cases has two parameters:
7628 % \begin{enumerate}
7629 % \item an optional parameter, which specifies, where the text of condition is set:
7630 % |l| or |r| -- the default value is |l|, and
7631 % \item the text of condition
7632 % \end{enumerate}%
7633 % \fi%
7634 % \changes{v061}{10/05/31}{added debug code and enhanced the documentation}
7635 % \begin{macrocode}
7636 \def\switch{%
7637 \@ifnextchar [{\@switch}{\@switch[l]}%
7638 }
7639 \def\@switch[#1]#2{%
7640 \dbgString@nss{Beginn \string\@switch}
7641 \global\gy@nss=\y@nss\endgroup
7642 \tempyy@nss=\gy@nss
7643 \ifnum\tempyy@nss<\ydepth@nss
7644 \ydepth@nss=\tempyy@nss
7645 \fi
7646 % \end{macrocode}
7647 % \ifnum\language=\languageNGerman%
7648 % Nun in den nächsten Zweig gehen und die Falltexthöhe vermindern.
7649 % \else%
7650 % Now continuing in the next branch and reducing the height of text of case.%
7651 % \fi%
7652 % \begin{macrocode}
7653 \advance\x@nss by \tempx@nss
7654 \advance\tempy@nss by -\condindent@nss
7655 \put(\x@nss,\y@nss)%
7656 {\makebox(\tempx@nss,\tempy@nss)[#1b]{\raise3pt\hbox{~#2~}}}
7657 \str@kt{\x@nss}{\y@nss}{\tempx@nss}
7658 }
7659 \def\caseend{%
7660 \dbgString@nss{Ende: \string\caseend}
7661 \global\gy@nss=\y@nss\endgroup
7662 \tempyy@nss=\gy@nss
7663 \ifnum\tempyy@nss<\ydepth@nss
7664 \ydepth@nss=\tempyy@nss
7665 \fi
7666 \x@nss=\xx@nss
7667 \y@nss=\ydepth@nss
7668 \tempyy@nss=\yy@nss
7669 \advance\tempyy@nss by -\ydepth@nss
7670 \put(\x@nss,\y@nss){\framebox(\xsize@nss,\tempyy@nss){}}
7671 \tempxx@nss=\x@nss
7672 % \end{macrocode}
7673 % \ifnum\language=\languageNGerman%
7674 % Die folgende Schleife ist dafür zuständig, die Trennlinien zwischen den
7675 % Falltexten zu ziehen. Die erste Trennlinie steht nach dem ersten Block.
7676 % \else%
7677 % The following loop is to draw the partitioning lines between the texts of
7678 % cases. The first partitioning line occurs after the first block.%
7679 % \fi%
7680 % \begin{macrocode}
7681 \dbgCount@nss[width?]{\xsize@nss}
7682 \loop
7683 \dbgString@nss{draw vertical line}
7684 \dbgCoord@nss[Ursprung]{\tempxx@nss}{\y@nss}
7685 \dbgCount@nss[Laenge]{\tempyy@nss}
7686 \advance\tempyy@nss by -\condindent@nss
7687 \advance\tempxx@nss by \tempx@nss
7688 \put(\tempxx@nss,\y@nss){\line(0,1){\tempyy@nss}}
7689 % \end{macrocode}
7690 % \ifnum\language=\languageNGerman%
7691 % Die Schleife endet vor dem letzten Block, deshalb wird der Zähler um die
7692 % Blockbreite vor dem Test erhöht. Zusätzlich wird ein kleiner Wert (100)
7693 % addiert, um Rundungsfehler der Integer-Arithmetik auszugleichen.
7694 % \else%
7695 % The loop ends just before the last block, so we advance the counter by
7696 % the width of a block before the test. Also a small value is added to
7697 % compensate rounding errors of the integer arithmetic.%
7698 % \fi%
7699 % \begin{macrocode}
7700 \xx@nss=\tempxx@nss
7701 \advance\xx@nss by -\x@nss
7702 \advance\xx@nss by \tempx@nss
7703 \advance\xx@nss by 100
7704 \dbgCount@nss[loop control]{\xx@nss}
7705 \dbgCount@nss[compare to]{\xsize@nss}
7706 \ifnum \xx@nss<\xsize@nss
7707 \repeat
7708 }
7709 % \end{macrocode}
7710 % \end{macro}
7711 % \end{macro}
7712 % \end{macro}
7713 %
7714 % \changes{v-9.1}{10/01/17}{added stubs for the implementation of `inparallel, `task, and `inparallelend}
7715 % \begin{macro}{\inparallel}
7716 % \changes{v065}{10/06/07}{added some german translations}
7717 % \changes{v061}{10/05/31}{enhanced the documentation and added debug code}
7718 % \changes{v-9.1}{10/01/17}{added}
7719 % \begin{macro}{\inparallelend}
7720 % \changes{v-9.1}{10/01/17}{added} \ifnum\language=\languageNGerman%
7721 % \cs{inparallel} und \cs{inparallelend} stellen Start und Ende
7722 % paralleler Tasks dar.
7723 %
7724 % Der Makro \cs{inparallel} hat drei Parameter:
7725 % \begin{enumerate}
7726 % \item die optionale Höhe des Blocks (diese Höhe dient als gemeinsame
7727 % Höhe der parallelen Tasks)
7728 % \item die Anzahl der parallelen Tasks
7729 % \item die Beschreibung der ersten Task
7730 % \end{enumerate}
7731 % Die Implementation folgt den üblichen Regeln: zuerst wird die
7732 % optionale Höhe verarbeitet, so wird sie in \cs{param@nss} gespeichert
7733 % (wenn der optional Parameter fehlt, wird \cs{param@nss} zu 0
7734 % gesetzt). %
7735 % \else%
7736 % \cs{inparallel} and \cs{inparallelend} represent start and end of
7737 % parallel tasks.
7738 %
7739 % The macro \cs{inparallel} has three parameters:
7740 % \begin{enumerate}
7741 % \item the optional height of the block (this height is used as a
7742 % base for the height of the parallel tasks)
7743 % \item the number of parallel tasks
7744 % \item the description of the first task
7745 % \end{enumerate}
7746 % The implementation follows the common rules: first we process the
7747 % optional height, in this way it is stored in \cs{param@nss} (if the
7748 % optional parameter is missing, \cs{param@nss} has a value of 0). %
7749 % \fi
7750 % \begin{macrocode}
7751 \def\inparallel{\let\next=\@inparallel\getoption}
7752 % \end{macrocode}
7753 % \ifnum\language=\languageNGerman%
7754 % Damit braucht \cs{@inparallel} nur zwei Parameter zu verwalten: %
7755 % \else%
7756 % So \cs{@inparallel} needs to manage only two parameters: %
7757 % \fi
7758 % \begin{macrocode}
7759 \def\@inparallel#1#2{%
7760 \dbgString@nss{Beginn \string\@inparallel}
7761 % \end{macrocode}
7762 % \ifnum\language=\languageNGerman%
7763 % Die Schritte zum Zeichnens des Kastens sind:
7764 % \begin{enumerate}
7765 % \item Berechnen der Höhe der einzelnen Tasks: %
7766 % \else%
7767 % The steps to draw the box are as follows:
7768 % \begin{enumerate}
7769 % \item Calculate the intended height of the tasks:
7770 % \fi%
7771 % \begin{macrocode}
7772 \tempyy@nss=\number\param@nss000%
7773 % \end{macrocode}
7774 % \item %
7775 % \ifnum\language=\languageNGerman%
7776 % Zeichnen der gestrichelten Linien zu Beginn des Blocks; das muss in
7777 % einer eigenen Gruppe geschehen, da der aktuelle Wert von \cs{y@nss}
7778 % später noch gebraucht wird.
7779 %
7780 % Die aktuelle Startposition des Blocks is |(\x@nss, \y@nss)|, die Breite
7781 % ist \cs{xsize@nss}, um die Anzahl \cs{tempxx@css} der Striche in der
7782 % gestrichelten Linie zu bestimmen, wird die Breite durch 3000 geteilt
7783 % (zweimal die Länge eines Striches). %
7784 % \else %
7785 % Draw the two dashed lines at the top; this must happen in a group of
7786 % its own, because we need the current \cs{y@nss} later on.
7787 %
7788 % The current starting position is |(\x@nss, \y@nss)|, the width is
7789 % \cs{xsize@nss}, first divide the width by 3000 (two times the length of
7790 % a dash) to get the number \cs{tempxx@css} of dashes for the dashed
7791 % line. %
7792 % \fi%
7793 % \begin{macrocode}
7794 \dbgCoord@nss[Ursprung inparallel]{\x@nss}{\y@nss}
7795 \dbgMark@nss{\x@nss}{\y@nss}
7796 \tempxx@nss=\xsize@nss
7797 \advance\tempxx@nss by 1500% prevent rounding errors
7798 \divide\tempxx@nss by 3000%
7799 \dbgCount@nss[Number of dashes]{\tempxx@nss}
7800 \yy@nss=\y@nss\advance\yy@nss by -2000%
7801 \dbgCoord@nss[draw top dashed line, origin]{\x@nss}{\yy@nss}
7802 \dbgCount@nss[length based on]{\xsize@nss}
7803 \multiput(\x@nss,\yy@nss)(3000, 0){\tempxx@nss}{\line(1,0){1500}}%
7804 \advance\yy@nss by -2000%
7805 \multiput(\x@nss,\yy@nss)(3000, 0){\tempxx@nss}{\line(1,0){1500}}%
7806 % \end{macrocode}
7807 % \item %
7808 % \ifnum\language=\languageNGerman%
7809 % Berechnen der (gemeinsamen) Breite aller parallelen Tasks (Gesamtbreite
7810 % geteilt durch die Anzahl der Tasks). Zusätzlich wird die Breite der
7811 % beschreibenden Texte für alle Tasks berechnet; sie beträgt
7812 % \(\frac{5}{6}\) der Breite einer Task. %
7813 % \else%
7814 % Calculate the (common) width of all parallel tasks (total width
7815 % divided by number of tasks). Additionally we calculate the text width
7816 % for all tasks, which is \(\frac{5}{6}\) of the task. %
7817 % \fi%
7818 % \begin{macrocode}
7819 \xx@nss=\x@nss%
7820 \advance\xx@nss by \xsize@nss%
7821 \divide\xsize@nss by #1%
7822 \tempx@nss=\xsize@nss\divide\tempx@nss by 6%
7823 % \end{macrocode}
7824 % \item %
7825 % \ifnum\language=\languageNGerman%
7826 % Zeichnen der verschiedenen parallelen Tasts (z.\,Zt. besteht eine Task
7827 % nur aus einer Aktion, wenn sie aus mehreren Aktionen bestände,
7828 % müssten diese durch horizontale Linien getrennt werden, dies könnte
7829 % zu einem späteren Zeitpunkt implementiert werden). Die erste Task wird
7830 % hier gezeichnet, weitere Tasks werden mit dem Makro \cs{task}
7831 % gezeichnet. %
7832 % \else%
7833 % \item Draw the several parallel tasks (the tasks may consist of several
7834 % actions each, if that's the case, they must be divided by horizontal
7835 % lines, but that isn't implemented for now). The first task is drawn
7836 % here, further tasks are drawn by the command \cs{task}. %
7837 % \fi%
7838 % \begin{macrocode}
7839 \begingroup
7840 \y@nss=\yy@nss%
7841 \dbgCoord@nss[Ursprung Task 1]{\x@nss}{\y@nss}
7842 \set@nss{#2}{\tempx@nss}%
7843 \dbgCount@nss[optionale Hoehe der Task]{\tempyy@nss}
7844 \block@nss{\tempyy@nss}{0}%
7845 \tempyy@nss=\TextBoxHt@nss%
7846 \dbgCount@nss[Hoehe der Task]{\tempyy@nss}
7847 % \end{macrocode}
7848 % \end{enumerate}
7849 % \begin{macrocode}
7850 }
7851 % \end{macrocode}
7852 % \end{macro}
7853 % \ifnum\language=\languageNGerman%
7854 % Und nun zur Implementation von \cs{inparallelend}: nach ein paar
7855 % Initialisierungsschritten \ldots{} %
7856 % \else%
7857 % And now for the implementation of \cs{inparallelend}: after some
7858 % initialization steps \ldots{} %
7859 % \fi%
7860 % \changes{v074}{10/06/08}{corrected the calculation of the surrounding box}
7861 % \changes{v061}{10/05/31}{added some documentation}
7862 % \begin{macrocode}
7863 \def\inparallelend{%
7864 \dbgString@nss{Beginn \string\@inparallelend}
7865 \dbgCoord@nss[Endkoordinate]{\x@nss}{\y@nss}
7866 \global\tempy@nss=\y@nss%
7867 \global\tempyy@nss=\tempyy@nss%
7868 \endgroup
7869 % \end{macrocode}
7870 % \ifnum\language=\languageNGerman%
7871 % \ldots{} müssen
7872 % \begin{enumerate}
7873 % \item die senkrechten Linien gezeichnet werden, um die einzelnen Tasks
7874 % sichtbar abzugrenzen (die Linien müssen so lang wie die "`längste"' Task
7875 % sein): die linke x-Koordinate des Kastens ist \cs{x@nss}, die rechte
7876 % \cs{xx@nss}, die Gesamtbreite wird auf \#4 -- in
7877 % \cs{inparallel} gesetzt --Tasks aufgeteilt, somit ist die Breite
7878 % zwischen zwei Linien \cs{xsize@nss}.
7879 % Es gibt \(\#4-1\) Linien, damit beginnt die Schleife zum Zeichnen der
7880 % Linien an der Position
7881 % \(\cs{x@nss}+\cs{xsize@nss}\) und sie endet an der Position
7882 % \(\cs{xx@nss}-\frac{\cs{xsize@nss}}{2}\) um Rundungsfehler zu vermeiden. %
7883 % \else%
7884 % \ldots{} we have to
7885 % \begin{enumerate}
7886 % \item draw the vertical lines to divide the several tasks visual (the
7887 % lines must be as long as the "longest"{} sequence of actions): the
7888 % block's left side is given by \cs{x@nss}, it's right side by
7889 % \cs{xx@nss}, it is divided into \#4 parts---used in
7890 % \cs{inparallel}---so the width between the lines is \cs{xsize@nss}.
7891 % There must be \(\#4-1\) lines, so the loop starts at
7892 % \(\cs{x@nss}+\cs{xsize@nss}\) and it ends at
7893 % \(\cs{xx@nss}-\frac{\cs{xsize@nss}}{2}\) to avoid rounding errors. %
7894 % \fi%
7895 % \begin{macrocode}
7896 \begingroup%
7897 \dbgCoord@nss[left and right limits]{\x@nss}{\xx@nss}
7898 \dbgCount@nss[step size]{\xsize@nss}
7899 \tempx@nss=\xsize@nss%
7900 \divide\tempx@nss by 2%
7901 \advance\xx@nss by -\tempx@nss%
7902 \tempx@nss=\x@nss%
7903 \loop%
7904 \dbgString@nss{draw vertical line}
7905 \advance\tempx@nss by \xsize@nss%
7906 \dbgCoord@nss[Ursprung]{\tempx@nss}{\tempy@nss}
7907 \dbgCount@nss[Laenge]{\tempyy@nss}
7908 \put(\tempx@nss,\tempy@nss){\line(0,1){\tempyy@nss}}%
7909 \tempxx@nss=\tempx@nss%
7910 \advance\tempxx@nss by \xsize@nss%
7911 \dbgCount@nss[loop control]{\tempxx@nss}
7912 \dbgCount@nss[compare to]{\xx@nss}
7913 \ifnum \tempxx@nss<\xx@nss%
7914 \repeat
7915 \endgroup
7916 % \end{macrocode}
7917 % \item %
7918 % \ifnum\language=\languageNGerman%
7919 % Zeichnen der gestrichelten Linien am Ende des Kastens, \else%
7920 % draw the two dashed lines at the bottom, %
7921 % \fi %
7922 % \begin{macrocode}
7923 \dbgCoord@nss[draw bottom, origin]{\x@nss}{\tempy@nss}
7924 \multiput(\x@nss,\tempy@nss)(3000, 0){\tempxx@nss}{\line(1,0){1500}}%
7925 \advance\tempy@nss by -2000%
7926 \multiput(\x@nss,\tempy@nss)(3000, 0){\tempxx@nss}{\line(1,0){1500}}%
7927 % \end{macrocode}
7928 % \item %
7929 % \ifnum\language=\languageNGerman%
7930 % Zeichnen eines Kastens um alle zuvor gezeichneten Elemente. %
7931 % \else %
7932 % draw a box around all the previous drawn elements. \fi %
7933 % \end{enumerate}
7934 % \begin{macrocode}
7935 \advance\tempy@nss by -2000%
7936 \dbgCount@nss{\tempyy@nss}
7937 \advance\tempyy@nss by 8000%
7938 \advance\xx@nss by -\x@nss%
7939 \dbgCoord@nss[Breite, Hoehe]{\xx@nss}{\tempyy@nss}
7940 \put(\x@nss,\tempy@nss){\framebox(\xx@nss,\tempyy@nss){}}%
7941 % \end{macrocode}
7942 % \ifnum\language=\languageNGerman%
7943 % In einem letzten Schritt werden \cs{y@nss} und \cs{xsize@nss} in den
7944 % global genutzten Registern abgelegt: %
7945 % \else%
7946 % In a last step \cs{y@nss} and \cs{xsize@nss} are stored into the
7947 % registers which are used globally: %
7948 % \fi%
7949 % \begin{macrocode}
7950 \xsize@nss=\xx@nss%
7951 \y@nss=\tempy@nss%
7952 \dbgCoord@nss[Endkoordinate inparallel]{\x@nss}{\y@nss}
7953 \dbgCount@nss[Breite]{\xsize@nss}
7954 \dbgString@nss{Ende \string\@inparallelend}
7955 }
7956 % \end{macrocode}
7957 % \end{macro}
7958 %
7959 % \begin{macro}{\task}
7960 % \changes{v061}{10/05/31}{implemented the macro}
7961 % \changes{v-9.1}{10/01/17}{added}
7962 % \ifnum\language=\languageNGerman%
7963 % Der Makro \cs{task} definiert die parallelen
7964 % Tasks, er hat zwei Parameter:
7965 % \begin{enumerate}
7966 % \item die optionale Höhe der Task (dies kann die optionale Höhe des
7967 % umgebenden Blocks überschreiben)
7968 % \item die Beschreibung der Task
7969 % \end{enumerate}
7970 % \else%
7971 % \cs{task} defines the parallel tasks, it has two parameters:
7972 % \begin{enumerate}
7973 % \item the optional height of the task (this may overwrite the
7974 % optional height of the surrounding block)
7975 % \item the description of the task
7976 % \end{enumerate}
7977 % \fi%
7978 % \begin{macrocode}
7979 \def\task{\let\next=\@task\getoption}
7980 \def\@task#1{%
7981 \dbgString@nss{Beginn \string\@task}
7982 \advance\x@nss by \xsize@nss%
7983 \y@nss=\yy@nss%
7984 \dbgCoord@nss[Ursprung parallele Task]{\x@nss}{\y@nss}
7985 \set@nss{#1}{\tempx@nss}%
7986 \ifnum\number\param@nss000>\tempyy@nss%
7987 \tempyy@nss=\number\param@nss000%
7988 \fi%
7989 \dbgCount@nss[Hoehe parallele Task]{\tempyy@nss}
7990 \block@nss{\tempyy@nss}{0}%
7991 }
7992 % \end{macrocode}
7993 % \end{macro}
7994 %
7995 % \begin{macro}{\centerNss}
7996 % \begin{macro}{\endcenterNss}
7997 % \changes{v-4.5d}{97/03/19}{`CenterBox@nss global gemacht}
7998 % \changes{v-3.3e}{94/09/09}{`centerline durch `strut`hfill ... ersetzt}
7999 % \changes{v-3.3e}{94/09/09}{`TmpBox umbenannt in `nss@CenterBox}
8000 % \changes{v-3.1a}{94/09/09}{aus \sFile{JHfMakro.STY} übernommen}
8001 % \changes{v-3.1b}{94/09/09}{erheblich vereinfacht}
8002 % \ifnum\language=\languageNGerman%
8003 % Makro zur Zentrierung von Struktogrammen: da einfaches Zentrieren mit
8004 % \cs{centering} nicht funktioniert, wird mit \cs{hfill} gearbeitet:
8005 % \else%
8006 % Macro for centering the structured box chart: since simple centering with
8007 % \cs{centering} doesn't work, \cs{hfill} is used:%
8008 % \fi%
8009 % \begin{macrocode}
8010 \newbox\CenterBox@nss%
8011 \def\centernss{%
8012 \begin{trivlist}%
8013 \item[] \strut%
8014 \setbox\CenterBox@nss=\hbox%
8015 \bgroup%
8016 }
8017 \def\endcenternss{%
8018 \egroup%
8019 \strut\hfill\box\CenterBox@nss\hfill\strut%
8020 \end{trivlist}%
8021 }
8022 % \end{macrocode}
8023 % \end{macro}
8024 % \end{macro}
8025 %
8026 % \begin{macro}{\CenterNssFile}
8027 % \changes{v-4.5d}{97/03/19}{Belegen von `CenterBox@nss in das `item verlegt}
8028 % \changes{v-3.3e}{94/09/09}{`centerline durch `strut`hfill ... ersetzt}
8029 % \changes{v-3.3e}{94/09/09}{Auf zusätzliche Gruppe um `trivlist verzichtet}
8030 % \changes{v-3.3e}{94/09/09}{`TmpBox umbenannt in `nss@CenterBox}
8031 % \changes{v-3.1a}{94/09/09}{aus \sFile{JHfMakro.STY} übernommen}
8032 % \changes{v-3.1b}{94/09/09}{erheblich vereinfacht}
8033 % \ifnum\language=\languageNGerman%
8034 % Makro zur Zentrierung von Struktogrammen: da einfaches Zentrieren mit
8035 % \cs{centering} nicht funktioniert, wird mit \cs{centerline} gearbeitet:
8036 % \else%
8037 % Macro for centering the structured box charts: since simple centering with
8038 % \cs{centering} does'nt work, it is worked with \cs{centerline}:%
8039 % \fi%
8040 % \begin{macrocode}
8041 \def\CenterNssFile#1{%
8042 \begin{trivlist}%
8043 \item[] \setbox\CenterBox@nss=\hbox{\input{#1.nss}}%
8044 \strut\hfill\box\CenterBox@nss\hfill\strut%
8045 \end{trivlist}%
8046 }
8047 \let\centernssfile=\CenterNssFile
8048 % \end{macrocode}
8049 % \end{macro}
8050 %
8051 % \subsection{\ifnum\language=\languageNGerman Zusätzliche Makros
8052 % (Verifikation) \else Additional macros (verification)\fi}
8053 %
8054 % \begin{macro}{\assert}
8055 % \changes{v-7.0a}{04/01/04}{neu eingeführt}
8056 % \begin{macro}{\assert@nss}
8057 % \changes{v-7.0a}{04/01/04}{neu eingeführt}
8058 % \ifnum\language=\languageNGerman%
8059 % \cs{assert} wird wie \cs{assign} definiert, führt ohne die Option
8060 % |verification| aber nicht zu sichtbaren Ergebnissen:
8061 % \else%
8062 % \cs{assert} is defined just like \cs{assign}:%
8063 % \fi%
8064 % \begin{macrocode}
8065 \newcommand\assert{\let\next=\assert@nss\getoption}%
8066 \newcommand\assert@nss[1]{}%
8067 % \end{macrocode}
8068 % \end{macro}
8069 % \end{macro}
8070 %
8071 % \ifnum\language=\languageNGerman%
8072 % Der folgende Code ist nur gültig, wenn die Option |verification| gesetzt
8073 % wurde:
8074 % \else%
8075 % The following code is valid only, if the option |verification| is set.%
8076 % \fi%
8077 %
8078 % \begin{macrocode}
8079 \ifthenelse{\boolean{verification}}{%
8080 % \end{macrocode}
8081 % \begin{macro}{\xsizeo@nss}
8082 % \changes{v-7.0a}{04/01/05}{neu eingeführt}
8083 % \begin{macro}{\ydeptho@nss}
8084 % \changes{v-7.0a}{04/01/05}{neu eingeführt}
8085 % \ifnum\language=\languageNGerman%
8086 % Da \cs{oval} einen anderen Referenzpunkt als \cs{framebox} hat, brauchen
8087 % wir zusätzliche Zähler, um den anderen Referenzpunkt ansprechen zu können.
8088 % \else%
8089 % Since \cs{oval} has another reference point than \cs{framebox}, we need
8090 % additional counters for the positioning of the \cs{oval}.%
8091 % \fi%
8092 % \begin{macrocode}
8093 \countdef\xsizeo@nss=232%
8094 \countdef\ydeptho@nss=233%
8095 % \end{macrocode}
8096 % \end{macro}
8097 % \end{macro}
8098 %
8099 % \ifnum\language=\languageNGerman%
8100 % Für den Fall, dass die Option |verification| gesetzt wurde, wird der
8101 % intern genutzte Makro \cs{assert@nss} neu definiert.
8102 % \else%
8103 % \fi
8104 % \begin{macrocode}
8105 \renewcommand{\assert@nss}[1]{%
8106 \tempx@nss=\xsize@nss\divide\tempx@nss by 6%
8107 \set@nss{#1}{\tempx@nss}\tempy@nss=\number\param@nss000%
8108 \assertblock@nss{\tempy@nss}{1}%
8109 }
8110 % \end{macrocode}
8111 %%
8112 % \begin{macro}{\assertblock@nss}
8113 % \changes{v-7.0a}{04/01/04}{neu eingeführt}
8114 % \ifnum\language=\languageNGerman%
8115 % |\assertblock@nss| setzt die Box |\TextBox@nss| entsprechend dem zweiten Parameter. Ist dieser
8116 % 1, wird eine Box mit Rahmen gesetzt, ist dieser 0, wird eine Box ohne Rahmen
8117 % gesetzt. Bei allen anderen Werten wird nur die Größe des Struktogramms,
8118 % gegeben durch |\y@nss|, vergrößert.
8119 % \else%
8120 % |\assertblock@nss| sets the box |\TextBox@nss| corresponding to the second parameter.
8121 % If this parameter is 1, the box will be set in a frame, and if it is 0, a box without
8122 % frame will be set. In all other cases only the size of the structured box chart
8123 % given by |\y@nss| will be changed.%
8124 % \fi%
8125 % \begin{macrocode}
8126 \newcommand{\assertblock@nss}[2]{%
8127 \tempy@nss=#1\TextBoxHt@nss=\ht\TextBox@nss%
8128 \advance\TextBoxHt@nss by\dp\TextBox@nss%
8129 \advance\TextBoxHt@nss by 2mm%
8130 \ifdim\TextBoxHt@nss<\tempy@nss\unitlength%
8131 \TextBoxHt@nss=\tempy@nss\unitlength%
8132 \fi%
8133 \TextBoxHt@nss=0.00536\TextBoxHt@nss%
8134 \ydepth@nss=\TextBoxHt@nss\advance\y@nss by-\ydepth@nss%
8135 \xsizeo@nss=\xsize@nss \tempx@nss=\x@nss
8136 \divide\xsizeo@nss by 2%
8137 \advance\tempx@nss by+\xsizeo@nss%
8138 \ydeptho@nss=\ydepth@nss \tempy@nss=\y@nss
8139 \divide\ydeptho@nss by 2%
8140 \advance\tempy@nss by+\ydeptho@nss%
8141 \ifx#21%
8142 \put(\x@nss,\y@nss)%
8143 {%
8144 \framebox(\xsize@nss,\ydepth@nss){\box\TextBox@nss}%
8145 }%
8146 \put(\tempx@nss,\tempy@nss){\oval(\xsize@nss,\ydepth@nss)}%
8147 \else%
8148 \ifx#20%
8149 \put(\x@nss,\y@nss)%
8150 {%
8151 \makebox(\xsize@nss,\ydepth@nss){\box\TextBox@nss}%
8152 }%
8153 \put(\tempx@nss,\tempy@nss){\oval(\xsize@nss,\ydeptho@nss)}%
8154 \else%
8155 \advance\y@nss by \ydepth@nss%
8156 \fi%
8157 \fi%
8158 }
8159 }
8160 {} % end of \ifthenelse{\boolean{verification}}
8161 %</struktex>
8162 % \end{macrocode}
8163 % \end{macro}
8164 %
8165 %
8166 % \Finale
8167 %
8168 % \clearpage
8169 % \PrintIndex
8170 % {\selectlanguage{ngerman}\PrintChanges}
8171 %
8172 \endinput
8173 %% \CharacterTable
8174 %% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
8175 %% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
8176 %% Digits \0\1\2\3\4\5\67\8\9
8177 %% Exclamation \! Double quote \" Hash (number) \#
8178 %% Dollar \$ Percent \% Ampersand \&
8179 %% Acute accent \' Left paren \( Right paren \)
8180 %% Asterisk \* Plus \+ Comma \,
8181 %% Minus \- Point \. Solidus \/
8182 %% Colon \: Semicolon \; Less than \<
8183 %% Equals \= Greater than \> Question mark \?
8184 %% Commercial at \@ Left bracket \[ Backslash \\
8185 %% Right bracket \] Circumflex \^ Underscore \_
8186 %% Grave accent \` Left brace \{ Vertical bar \|
8187 %% Right brace \} Tilde \~}
8188 %%
8189 %
8190 % end of struktex.dtx
8191 %
8192 % \begin{macrocode}
8193 %<*dev/null>
8194 % \end{macrocode}
8195 %%% Local Variables:
8196 %%% ispell-local-dictionary: "deutsch8"
8197 %%% End:
8198 % \begin{macrocode}
8199 %<*dev/null>
8200 % \end{macrocode}
8201 \endinput