%format latexg
%
%                    MultiTeX 5.4 f�r den Atari ST
%                    =============================
%
%  Dies ist die Dokumentation zu MultiTeX 5.4
%  Stand: 22.02.95
%
%  Diese Dokumentation ist in TeX geschrieben, kann aber gegebenenfalls
%  auch direkt als Text gelesen werden. Der Text ist gleichzeitig eine
%  kleine Demonstration der M�glichkeiten von LaTeX.
%
%  Copyright (c) 1992-95 by Christoph Strunk
%  Copyright (c) 1992-95 by MAXON Computer GmbH
%
%  !!!! An diesem Text d�rfen Sie keine Ver�nderungen vornehmen !!!!
%
%%%%%%%%%%%%%%%%% Einige Sachen f�r TeX %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\newcommand{\revisiondate}{Stand: 22.~Februar 1995}

\documentstyle[makeidx,din_a4,german]{article}
\def\indexname{Stichwortverzeichnis}% `Stichwortverzeichnis' statt `Index'
\makeindex

% Layout der Seite festlegen ...
\oddsidemargin 0pt \evensidemargin 0pt
\parskip 5pt plus 2pt minus 2pt \parindent 0pt
\topsep 0pt \partopsep 0pt
\topmargin 0cm \topskip 0pt
\pagestyle{headings}

% Die folgede Definition eines Uppercase-Es-zett ist nur
% in dieser Dokumentation sinnvoll:
\catcode`�=\active \def�{SS}

% Nette logos
\font\logo=logo10
\def\MetaFont{{\logo METAFONT}}
\def\zpcad{{\tt ZPCAD}}
\def\Format{{\tt\%format}}
\def\MultiTeX{Multi\TeX}
\def\TSH{\Datei{TSH}}

% Jetzt wird's ein wenig trickreich
\makeatletter
\def\Datei{\begingroup \tt \catcode`\_=11 \catcode`\\=11 \D@tei}
\def\D@tei#1{#1\endgroup}
\makeatother

\begin{document}

%%%%%%%%%%%%%%%%% Titelseite %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\thispagestyle{empty}
%
\begin{center}{\LARGE\bf
%
          \MultiTeX{} 5.4 f�r den Atari ST/STE/TT/Falcon     }\\[0.5cm]
%
                           von                                \\[0.3cm]
%
                    Christoph Strunk                          \\
                   Beckrather Str.\ 36                        \\
                  D-41189 M�nchengladbach
\end{center}
%
\vspace*{0.5cm}
\begin{center}\revisiondate\end{center}
\vfill
%
%
%%%%%%%%%%%% Inhaltsverzeichnis %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%  Hinweis: Das Inhaltsverzeichnis ist erst nach dem 2. TeX-Lauf korrekt !
%
\tableofcontents\newpage
%
%%%%%%%%%%%% TeX - was ist das ? %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\section{\protect\TeX{} -- was ist das?}

\TeX{} (sprich Tech, von Griechisch: tau, epsilon, chi) ist ein
Textsatzprogramm, das von Donald~E.\ Knuth in Stanford entwickelt wurde.
\TeX{} ist kein normales Textverarbeitungsprogramm und will auch nicht
mit der Schreibmaschine konkurrieren. \TeX{} ist ein Satzprogramm,
und tritt damit in Konkurrenz zum Buchsatz. Besonders geeignet ist es
f�r den Satz mathematischer Texte mit vielen Formeln und Tabellen.
Zum \TeX{} System geh�rt auch \MetaFont, der Font-Generator zu \TeX.
\index{Textverarbeitung}\index{TeX@\TeX!Aussprache}\index{Satzprogramm}

Dieser Text ist keine Anleitung zu \TeX. Um \TeX{} benutzen zu k�nnen, ist
eine Anleitung aber unerl��lich. Wollen Sie, was vermutlich sinnvoll ist,
\TeX{} mit dem MacroPaket \LaTeX{} benutzen, so brauchen Sie auf jeden
Fall eine Anleitung, die speziell auf \LaTeX{}\index{LaTeX@\LaTeX{}}
eingeht.

\index{LaTeX@\LaTeX{}!Kurzanleitung}
Eine kurze Dokumentation zu \LaTeX{} ist im Lieferumfang enthalten. Wenn
Sie von Disk~2 das Archiv \Datei{LKURZ} installiert haben, finden Sie im
Ordner \Datei{LKURZ} eine \LaTeX-Kurzbeschreibung, die f�r den Einstieg
in \LaTeX{} ausreichend ist. Wer sich ernsthaft mit \TeX{} besch�ftigen
will, mu� aber fr�her oder sp�ter auf die Literatur \index{Literatur}
zur�ckgreifen. Sehr gut geeignet ist z.\,B.\ das folgende Buch:

\index{Kopka, Helmut}
\begin{quote}
      Helmut Kopka: LaTeX - eine Einf�hrung. Addison Wesley.
      4.\ Auflage 1992.
\end{quote}

Mittlerweile gibt es auch einen Vertiefungsband, der auch eine Einf�hrung
in \MetaFont{} enth�lt:

\begin{quote}
      Helmut Kopka: LaTeX - Erweiterungsm�glichkeiten. Addison Wesley.
      2.\ Auflage 1991.
\end{quote}

Wer die Original-Dokumentation zu \TeX{} (allerdings ohne \LaTeX) haben
m�chte, und die englische Sprache nicht scheut, mu� sich an das folgende
Buch halten:

\index{Knuth, Donald Erwin}
\begin{quote}
      Donald E. Knuth: The TeXbook. Addison Wesley 1989.
\end{quote}

Da in den B�chern die Besonderheiten der einzelnen Portierungen keine
Beachtung finden k�nnen, beschreibt der folgende Text nun ausschlie�lich
die Besonderheiten dieser Portierung f�r den Atari ST.

%
%%%%%%%%%%%% Das Atari-TeX %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\section{Das \protect\MultiTeX{} 5.4}

Die Implementierung \MultiTeX~5.4 ist kein Public Domain Programm, sondern
unterliegt dem Copyright und mu� von jedem Benutzer/jeder Benutzerin einzeln
k�uf"|lich erworben werden. Der Erwerb berechtigt zum Einsatz des Systems auf
jeweils nur einem Computersystem (eine CPU). Wollen Sie das System auf mehreren
Rechnern gleichzeitig benutzen, so m�ssen Sie auch mehrere Lizenzen erwerben.

\MultiTeX~5.4 ist ein Nachfolger des Public Domain Atari\TeX~2.00 und basiert
auf der \TeX-Version 3.141 // 2.8cs, die zu der bisherigen Version 3.1 // 2.1cs
voll abw�rtskompatibel ist.

\subsection{Copyright und Haftungsausschlu�}
\index{Copyright}\index{Haftungsausschluss@Haftungsausschlu�}

Bei der Erstellung des Programms und der Anleitung wurde mit 
allergr��ter Sorgfalt vorgegangen. Trotzdem k�nnen Fehler nicht 
ausgeschlossen werden. Weder der Autor noch die MAXON Computer GmbH 
�bernehmen irgendeine Haftung f�r eventuell vorhandene Programm- oder 
Dokumentationsfehler sowie deren Folgen.

Die Disketten unterliegen dem Copyright der MAXON Computer GmbH.
Alle Rechte vorbehalten. Mit Ausnahme der in dieser Dokumentation
explizit erw�hnten F�lle darf kein Teil des Programms, der Anleitung
oder der Daten in irgendeiner Form ohne schriftliche Genehmigung der
MAXON Computer GmbH reproduziert oder vervielf�ltigt werden.
Zuwiderhandlungen werden rechtlich verfolgt.

\begin{verse}
Copyright \copyright{} 1992-95 by Christoph Strunk, Beckrather Str.\ 36,
                                  D-41189 M�nchengladbach \\
Copyright \copyright{} 1992-95 by MAXON Computer GmbH, Industriestr.\ 26,
                                  D-65760 Eschborn
\end{verse}

\MultiTeX{} wird von der MAXON Computer GmbH auf Sonderdisks vertrieben.

\subsubsection*{Was Sie kopieren d�rfen}

F�r die unten aufgef�hrten Zugaben gelten eigene Copyright-Bedingungen,
die Sie aus der den Programmen jeweils beiliegenden Dokumentation
entnehmen k�nnen.

Die Standard-Eingabedateien zu den Programmen, also die Quelltexte der
Formate, der Fonts, und die \LaTeX-Styles d�rfen Sie weitergeben.
Beachten Sie aber bitte: Wenn Ihnen die Weitergabe einzelner Dateien
auch gestattet ist, so bleiben doch die Disketten als Ganzes (auch in ihrer
Zusammenstellung) unter dem Copyright.

F�r Ihre privaten Zwecke d�rfen Sie selbstverst�ndlich Sicherheitskopien
anfertigen, Dokumentationen ausdrucken, usw.

\subsection{Systemvoraussetzungen}

Zum Betrieb des \MultiTeX~5.4 brauchen Sie einen Atari ST, ST$^E$, TT oder
Falcon mit mindestens 1~MB~RAM (besser mehr). Das \MultiTeX{}~5.4 funktioniert
problemlos mit allen bekannten Atari-Hardware-Kon"-figurationen,
insbesondere also auch mit Speed-Boards, Gro�bildschirmen, beliebigen
\index{Grafikkarten}\index{OverScan}\index{Grossbildschirme@Gro�bildschirme}%
\index{Hardware-Beschleuniger}\index{Speed-Boards} \index{Atari!STE}%
\index{Atari!TT}\index{STE|see{Atari, STE}}\index{TT|see{Atari, TT}}%
\index{Atari!Falcon}\index{Falcon|see{Atari, Falcon}}%
Grafikkarten, Schwarz"-wei�- und Farbmonitoren, usw.

\MultiTeX~5.4 funktioniert auf allen bekannten TOS-Versionen ab 1986.
Wir empfehlen Ihnen jedoch, mindestens die Version~1.4 von 1989 zu
benutzen, da diese erheblich weniger Fehler hat und auf Festplatten
sehr viel schneller zugreifen kann als die Vorg�ngerversionen.
Falls Sie eine �ltere TOS-Version haben, k�nnen Sie sich auch noch
nachtr�glich die aktuelle TOS-Version von Ihrem H�ndler einbauen
lassen. Die derzeit (Dezember~1992) aktuelle Version hat die
Nummer~2.06 und kostet ohne Einbau etwa 200~DM.

\MultiTeX{} funktioniert auch unter MultiGEM, Mag!X und ab Version~5.4
auch unter dem neuen Atari-MultiTOS~1.0.
\index{MultiGEM}\index{MagiX}\index{MultiTOS}

Zum Betrieb brauchen Sie eine Festplatte mit mindestens 5~MB freiem Platz
f�r \TeX{} -- wir empfehlen Ihnen, \TeX{} auf einer eigenen Partition
von ca.~15~MB unterzubringen. Der Betrieb ohne Festplatte wird nicht
unterst�tzt.\index{Festplatte}

\subsection{Lieferumfang}

Das \MultiTeX~5.4 besteht aus:

\begin{itemize}
\item Einer Implementierung von Donald~E.\ Knuth's \TeX{} 3.141 (da
      "`\TeX{} 3.0"' aber inzwischen schon zu einem festen Begriff geworden ist,
      wird hier gelegentlich noch von \TeX{} 3.0 als Oberbegriff f�r alle
      Versionen mit einer 3 vor dem Komma geredet) in der
      Atari-Version 2.8cs. Dies ist das Herz des Systems.
\item Einer grafischen Shell \Datei{TSH.PRG}, mit der das ganze \TeX-System
      inklusive \MetaFont{} intuitiv per Maus oder Tastatur gesteuert
      werden kann.\index{TSH Shell}
\item Diversen Eingabe-Dateien f�r Ini\TeX, wie PLAIN \TeX, \LaTeX,
      deutsche und englische Trennmuster, usw.
\item Diversen Eingabe-Dateien f�r \TeX, Beispiel-Texten usw.
\item Einer Familie von Druckertreibern (DVI-Treiber) f�r alle g�ngigen
      Drucker. Bei den Treibern ist eine gesonderte Dokumentation, die auch
      die Grafikf�higkeiten beschreibt.
\item Einem automatischen Installationsprogramm, welches das System per
      Knopfdruck komplett installiert.
\item Einem kleinen Satz von g�ngigen Fonts (Zeichens�tzen). Weitere Fonts
      kann jede(r) BenutzerIn selber mit \MetaFont{} erstellen.
\item Diversen Hilfsprogrammen. Zu erw"ahnen sind insbesondere Bib\TeX,
      ein Programm zur Verwaltung von Literaturdatenbanken, und
      MakeIndex, ein Programm zur automatischen Erzeugung eines
      Stichwortregisters.
\end{itemize}

Es wird zusammen mit \MetaFont{} ausgeliefert.
Dieses besteht aus:

\begin{itemize}
\item Einer Implementierung von Donald~E.\ Knuth's \MetaFont~2.7 in der
      Atari-Version~2.8cs.
\item Diversen Eingabe-Dateien f�r \MetaFont.
\item Diversen Hilfsprogrammen f�r \MetaFont.
\end{itemize}

Ferner wird als Zugabe mitgeliefert:

\begin{itemize}
\item Eine Version des MicroEMACS Editors. Durch den mitgelieferten Editor
      ist das System in sich abgeschlossen. Allerdings steht zu vermuten,
      da� der Editor noch etliche kleinere oder gr��ere Fehler enth�lt.
\item Eine Version des \verb|xEdit| GEM-Editors, der speziell an \TeX{}
      angepa�t ist. Ein herzliches Dankesch�n geht an Alexander Gr�pl, der mir
      die Erlaubnis gegeben hat, den Editor hier beizulegen. \verb|xEdit| ist
      ShareWare -- bitte beachten Sie die entsprechende Dokumentation.
\item Eine Version der M-Disk. Dies ist ein n�tzliches Utility, besonders
      bei allen Aktionen, die Daten zwischen Festplatte und Diskette bewegen,
      also auch bei der Installation von Software und bei Backups.
\item Zwei Versionen des \Datei{LHARC} Archivierungs-Programms.
\end{itemize}

F�r die Zugaben gelten besondere Copyright-Bedingungen, die Sie aus den
jeweiligen Dokumentationen entnehmen k�nnen.

Die Version 3.141~//~2.8cs wurde im Dezember~1992 erstellt und verifiziert.

Die \TeX-Portierung erfolgte mit dem GNU C Compiler Version~1.40. Die
Version ist damit doppelt so schnell wie die (ur-)alte Pascal-Variante
2.98~//~1.4cs.\index{GNU C}

Die Drucker- und Bildschirmtreiber sowie die GEM-Shell wurden mit Lattice~C
Version~5.5 �bersetzt.\index{Lattice C}

%%%%%%%%%%%% Bedienung %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{Die Bedienung des \protect\MultiTeX}

\TeX{} ist -- im Gegensatz zu Textverarbeitungen wie \Datei{SIGNUM} oder
DTP-Programmen wie \Datei{CALAMUS} -- kein WYSIWYG-Programm (WYSIWYG =
What you see is what you get). Dies bedeutet, da� Sie bei der Eingabe
am Bildschirm nicht sehen k�nnen, wie das Ergebnis sp�ter aussieht. Vor dem
Ausdrucken k�nnen Sie sich das Ergebnis allerdings mit dem sogenannten
Previewer am Bildschirm anschauen.\index{WYSIWYG}

Der Nachteil bei vielen WYSIWYG-Programmen ist, da� das Layout weitgehend von
Hand vorgenommen werden mu�. Das f�hrt bei Personen, die keine Buchsetzer-Lehre
absolviert haben, meist zu h��lichen bzw.\ typografisch falschen Layouts.
\TeX{} dagegen rechnet z.\,B.\ den optimalen Zeilenumbruch f�r jeden Absatz
einzeln aus. Das Layout sieht einfach oft besser als ein handgestricktes aus.

Dieser Vorteil wird allerdings mit dem Nachteil erkauft, da� man zwischen
Text-Eingabe und -Anschauen auf dem Bildschirm immer einen \TeX-Lauf
einschieben mu�.

\subsection{Eine Beispielsitzung}

Nehmen wir an, Sie haben Ihren Computer eingeschaltet, \TeX{} installiert,
und wollen nun damit arbeiten. Gehen Sie z.\,B.\ wie folgt vor:

\begin{enumerate}
\item Starten Sie \Datei{TSH.PRG}. Lassen Sie alle Einstellungen so, wie sie sind,
      bis auf die folgenden: Stellen Sie unter "`TeX-Projekt::HauptDatei"' den
      Namen ein, unter dem Sie Ihren Text speichern wollen.
\item Stellen Sie eventuell unter "`Parameter::Editor"' den Editor ein, den Sie
      benutzen wollen. Tun Sie das nicht, so ist der MicroEMACS voreingestellt.
\item Dr�"cken Sie 'E'. Nun sind Sie im Editor und k�nnen Ihren Text
      eingeben. Tip: Kopieren Sie sich einen der Beispieltexte, lassen
      Sie den Text-Rahmen unver�ndert und ersetzen Sie nur den Text durch
      Ihren eigenen. Vergessen Sie nicht die "`\Format"'-Zeile.
      Verlassen Sie den Editor; Ihr Text ist jetzt eingegeben.
\item Falls \TeX{} jetzt nicht automatisch startet, dr�cken Sie 'T'.
      \TeX{} setzt nun Ihren Text, und speichert das Ergebnis in einer
      ger�teunabh�ngigen Form als \Datei{DVI}-Datei ab. Eventuell erzeugt
      \TeX{} auch noch weitere Dateien (automatisches Inhaltsverzeichnis usw.),
      die es dann selber im n�chsten Lauf wieder braucht. Das automatische
      Inhaltsverzeichnis sieht man daher erst nach dem zweiten \TeX-Lauf.

      Wie Sie bei Fehlern im \TeX-Lauf vorgehen, erfahren Sie in der
      Datei \Datei{FEHLER.TXT}.
      Wir nehmen nun an, da� \TeX{} fehlerfrei gelaufen ist.

\item Falls der Previewer jetzt nicht automatisch startet, dr�cken Sie 'V'.
      Nun sehen Sie das Ergebnis am Bildschirm. Dr�"cken Sie die
      "`Help"'-Taste, um weitere Hilfestellung zu erhalten.

      Nachdem Sie genug gesehen haben verlassen Sie den Previewer.

\item Sie k�nnen das Ergebnis jetzt ausdrucken. Dazu sollten Sie einen
      Druckertreiber einstellen (4~sind gleichzeitig einstellbar), und
      die zugeh�rigen Zusatzparameter nach Geschmack einstellen.
      F�r den Anfang gen�gt es, die Zeile mit den Zusatzparametern
      leer zu lassen. Nun k�nnen Sie drucken.

      Wenn Sie bis hierher gekommen sind, sollten Sie nun erst einmal
      \Datei{DVI_DOC.DVI}, die Dokumentation zu den Druckern am Bildschirm
      ansehen, ausdrucken und lesen. Wie das geht, steht in der Datei
      \Datei{DVI_INFO}.
\end{enumerate}

\subsection{Die \protect\TeX-Shell}

Die Bedienung des kompletten \TeX-Systems inklusive \MetaFont{} kann �ber
die \Datei{TSH} Shell erfolgen. Die Shell ist so programmiert, da� Sie
ohne weitere Anleitung damit zurechtkommen sollten. Die komplette
Bedienung kann komfortabel mit der Maus oder wahlweise per Tastatur
erfolgen. Weitere Informationen finden Sie im n�chsten Kapitel.

\subsection{Andere Shells}

Grunds�tzlich kann das \TeX-System auch mit fremden Shells wie \Datei{GULAM},
\Datei{MUPFEL} oder \Datei{EDISON} gesteuert werden. Achten Sie auf die
richtige Einstellung des Environments (siehe unten). Eventuell ist es
auch sinnvoll, die Environment-Variable \Datei{SHELL} {\em nicht\/} zu
setzen: Die Druckertreiber warten dann bei Fehlern auf einen Tastendruck.
\index{Gulam}\index{Mupfel}\index{Edison}

Der Aufruf des Editors aus \TeX{} heraus funktioniert nur mit der
\TeX-Shell. Auch sonst wurde viel "`Intelligenz"' in die Shell
integriert -- f�r die Bedienung des \TeX-Systems ist die \TeX-Shell
daher in der Regel besser als alle anderen Shells.
\index{Intelligenz}

%
%%%%%%%%%%%% Die TSH Shell %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\section{Die TSH Shell}
\index{TSH Shell|(}\index{TeX-Shell@\TeX-Shell|see{TSH Shell}}

Die Bedienung des kompletten \TeX-Systems inklusive \MetaFont{} kann �ber
die \TSH{} Shell erfolgen. Die Shell ist so programmiert, da� Sie
ohne weitere Anleitung damit zurechtkommen sollten. Dennoch ist es
sinnvoll, die Anleitung einmal ganz zu lesen. Die komplette Bedienung
kann komfortabel mit der Maus oder wahlweise per Tastatur erfolgen.

\Datei{TSH.PRG} fragt beim Start den eigenen Namen ab. Daher darf
\Datei{TSH.PRG} nicht umbenannt werden. Ebenso d�rfen auch \Datei{TSH.RSC}
und \Datei{TSH.OVL} nicht umbenannt werden.

\subsection{Grundeinstellungen und Editor-Einstellung}

Wenn Sie \TSH{} das erste mal aufrufen erscheint eine Dialogbox,
in der Sie das Laufwerk eintragen m�ssen, auf dem Sie \TeX{} und
\MetaFont{} installiert haben. In der Regel sind die Vorgaben dabei
richtig.

Als n�chstes sollten Sie unter "`Parameter"' den Editor anw�hlen.
Es erscheint eine Dialogbox. Die erste Einstellung zeigt den Zugriffspfad
des Editors, der auf \Datei{ME.TTP} voreingestellt ist. Wollen Sie einen
anderen Editor verwenden, oder haben Sie \Datei{ME.TTP} von Disk~4 nicht
installiert, so k�nnen Sie hier einen anderen Pfad einstellen. Klicken Sie
dazu mit der Maus auf den eingestellten Zugriffspfad und w�hlen Sie dann
mit dem Fileselektor einen anderen Editor aus.\index{Editor}

In der zweiten Zeile k�nnen Sie einstellen, welcher Pfad beim Editor-Aufruf
der "`aktuelle Pfad"' sein soll. Normalerweise ist dies der Pfad der
ArbeitsDatei, sollten Sie aber Probleme damit haben, da"s der Editor
seine Resource- oder Info-Dateien nicht mehr findet, so m�ssen Sie den
Knopf "`Editor braucht beim Start seinen eigenen Pfad"' aktivieren.

Im unteren Feld k�nnen Sie einstellen, welche Parameter an den Editor
�bergeben werden sollen. Auch hier gilt: Die Voreinstellung ist in der
Regel richtig, nur wenn Sie Sonderw�nsche haben (beispielsweise die
LOG-Datei immer mit-edieren wollen), oder einen Editor benutzen, der ein
anderes Kommando zum Anspringen einer Zeile hat, m�ssen Sie hier
etwas �ndern. Verlassen Sie dann die Dialogbox.

Jetzt ist ein guter Zeitpunkt, die Parameter in die Datei \Datei{TSH.INF}
zu speichern. Die getroffenen Einstellungen erscheinen dann beim n�chsten
Start von \TSH{} als Voreinstellungen.

\subsection{Die Men�leiste}

Die Men�leiste kann mit der Maus bedient werden, die wichtigsten Punkte
sind jedoch auch �ber die Tastatur erreichbar. Der Tastaturcode, der
einem Men�punkt entspricht, ist dabei jeweils am rechten Rand des
Men�punktes eingetragen. Steht dort nur ein Buchstabe, so wird
durch Dr�cken dieses Buchstabens der Punkt angew�hlt. Steht aber
vor dem Buchstaben noch ein Pfeil nach oben, so mu� gleichzeitig
die Shift-Taste (Gro�schreibung) gedr�ckt gehalten werden.

Es k�nnen drei verschiedene Men�leisten auftreten: Eine im \TeX-Modus,
eine im \MetaFont-Modus und eine Mini-Men�leiste wenn gerade ein Programm
im Console-Fenster (siehe Absatz~\ref{console-fenster} auf
Seite~\pageref{console-fenster}) l�uft.
\index{Querverweise!Beispiel}

\subsection{Allgemeine Einstellungen f�r \protect\TSH}

W�hlen Sie unter "`Parameter"' den Punkt "`allgemein"' an, so
erhalten Sie eine Dialogbox, in der Sie das allgemeine Verhalten
der \TSH{} Shell nach Ihrem Geschmack einstellen k�nnen. Die
meisten Einstellungen beziehen sich dabei entweder auf MultiGEM
oder sind, als Hilfen bei Speicherplatzmangel, nur auf
\mbox{1-MB-}Rechnern notwendig.

Dar�berhinaus k�nnen Sie einstellen, ob Sie das automatische Abspeichern
aller Parameter bei jedem Verlassen der Shell w�nschen.

\subsubsection{Einstellungen f�r MultiGEM}
\index{MultiGEM}\index{MagiX}\index{MultiTOS}

Dieser Abschnitt ist f�r Sie nur dann interessant, wenn Sie MultiGEM
(�hnliches gilt f�r Mag!X und MultiTOS) besitzen. Aber selbst dann sollten
Sie den Abschnitt beim ersten Lesen der Dokumentation vielleicht zun�chst
�berspringen.

Bevor ich die Einstellungen f�r MultiGEM erl�utere, sei hier eines vorweg
gesagt: In der Regel ist es nicht notwendig, und teilweise sogar unsinnig,
f�r die \TSH{} Shell irgenwelche Einstellungen mit \Datei{MULTICON.PRG}
vorzunehmen. Insbesondere sollte f�r \TSH{} "`ext.~tasks"' {\em nicht\/}
aktiviert werden!\index{MultiGEM!ext.~tasks}

Unter MultiGEM k�nnen (daf�r wurde es ja gemacht) mehrere Programme
quasiparallel laufen. Diese f�r Atari-Besitzer neue Freiheit birgt
einige Gefahren in sich, die von der \TSH{} Shell nur teilweise
umgangen werden k�nnen; auf einige Sachen m�ssen Sie selbst achten.

Auch unter MultiGEM macht die \TSH{} Shell nicht alles und jedes parallel.
Der Editor wird beispielsweise immer "`konventionell"' aufgerufen und
l�uft nicht parallel zur \TSH{} Shell. Der Grund daf�r ist, da� die
Shell auf den ReturnCode vom Editor wartet um gegebenenfalls sofort
\TeX{} zu starten. (Selbstverst�ndlich k�nnen Sie aber unter MultiGEM
vom Desktop aus einen zur Shell parallelen Editor von Hand starten.)

\TeX{} und \MetaFont{} laufen ebenfalls nicht parallel zur \TSH{} Shell.
Leider ist es, aufgrund der Struktur des \Datei{DVI}-Formates und der
internen Arbeitsweise der \Datei{DVI}-Treiber, nicht m�glich, beispielsweise
die erste Seite eines Dokumentes schon anzusehen, w�hrend die zweite gerade
von \TeX{} bearbeitet wird. Der Aufruf des Bildschirm-Treibers mu� also
warten, bis \TeX{} mit der Arbeit fertig ist.

Nun aber endlich einmal etwas Paralleles: Den Bildschirmtreiber k�nnen
Sie in der \TSH{} Shell als "`parallele Anwendung"' anmelden. Er l�uft
dann zur \TSH{} Shell parallel, und Sie k�nnen, w�hrend Sie die Datei
am Bildschirm ansehen, beispielsweise von der Shell aus wieder den
Editor aufrufen und dann gleichzeitig das \TeX-Resultat am Bildschirm
anschauen und den Text im Editor weiter bearbeiten.

Weiterhin besteht beim Ausdrucken unter MultiGEM die M�glichkeit zum
"`drucken im Hintergrund"', d.\,h., das Ausdrucken blockiert nicht mehr
den ganzen Computer.
\index{Hintergrund|see{Drucken, im Hintergrund}}\index{Drucken!im Hintergrund}

Wenn Sie im Hintergrund drucken, oder den Bildschirmtreiber parallel betreiben,
m�ssen Sie darauf achten, da� Sie die \Datei{DVI}-Datei w�hrend dieser
Zeit nicht ver�ndern. Sie k�nnen dann also keinen zweite \TeX-Lauf
f�r die gerade bearbeitete Datei starten, da der Treiber sonst in
arge Schwierigkeiten k�me.

Ich habe die Shell unter MultiGEM Version~1.02 getestet und dabei keine
Abst�rze erlebt. Falls es bei Ihnen Schwierigkeiten gibt, m�ssen Sie
gegebenenfalls kritische Auto-Ordner-Programme und Accessories entfernen,
auf \Datei{GEMINI} verzichten, usw.
\index{Gemini}\index{Bomben}

\subsubsection{Einstellungen bei Speicherplatzmangel}
\index{1-MB-Rechner}

Die \TSH{} Shell ist durch die Anpassung an MultiGEM und die erweiterten
Funktionen so umfangreich geworden, da� sie nicht mehr mit \TeX{} zusammen
in 1~MB~RAM hineinpa�t. Dennoch ist ein Arbeiten auch mit nur 1~MB~RAM
auf die folgende Weise m�glich:

Falls Sie nur 1~MB~RAM haben, m�ssen Sie unter "`Parameter"' beim Punkt
"`allgemein"' das Console-Fenster abschalten und die beiden "`Hilfen bei
Speicherplatzmangel"' einschalten (plus gegebenenfalls gro�e
\Datei{AUTO}-Ordner-Programme und gro�e Accessories entfernen). Dadurch
arbeitet die \TSH{} Shell dann im Overlay-Modus und entfernt sich jedesmal
komplett aus dem Speicher, bevor sie \TeX{} oder \MetaFont{} aufruft.

Es gibt dann auch zwei kleine Einschr�nkungen im Komfort: Die \TSH{} Shell
startet \TeX{} bei aktivem Overlay-Modus immer nur einmal -- egal was Sie
unter "`Anzahl der \TeX-L�ufe"' eingestellt haben. Insbesondere
funktioniert im Overlay-Modus auch die sch�ne Einstellung~"`\verb|*|"'
nicht mehr. Ferner funktioniert der Aufruf des Editors aus \TeX{} heraus
mittels `\verb|e|' nicht mehr.

Der Overlay-Modus funktioniert auch nur dann, wenn Sie \TSH{} direkt
vom Desktop aus gestartet haben. Im Prinzip sollte es auch mit einer
Shell funktionieren, die sich genau wie der Desktop verh�lt (und auf ein
\verb|shel_write| einer Anwendung in der richtigen Weise reagiert), nur
kenne ich leider keine solche. Mit \Datei{GEMINI}~1.2 klappt es
beispielsweise nicht.
\index{Gemini}

\subsubsection{Das Console-Fenster}\label{console-fenster}
\index{Console-Fenster}

Die \TSH{} Shell kann wahlweise mit einem Console-Fenster arbeiten.
Ist dieses aktiv, so startet \TSH{} alle \Datei{TOS}-Programme in
diesem Fenster. Dadurch bleiben die Accessories auch bei TOS-Programmen
verf�gbar und unter MultiGEM wird MultiTasking erst m�glich.

Ist das Console-Fenster abgeschaltet, und MultiGEM nicht aktiv, so
benutzen die Programme wieder wie gew�hnlich den ganzen Bildschirm.

Ist das Console-Fenster abgeschaltet, MultiGEM aber sehr wohl aktiv, so
benutzt die Shell das externe Programm "`MultiGEM-Window"' um die Programme
trotzdem im Fenster ablaufen zu lassen. Sollte Ihnen das mit MultiGEM
ausgelieferte \Datei{MULTIWIN.PRG} nicht gefallen, k�nnen Sie ja einmal
stattdessen mein \Datei{TOS_WIND.PRG} (siehe unten) probieren.

Das Console-Fenster hat Probleme mit einigen Bildschirm-Beschleunigern
wie z.\,B.\ TurboST. Wenn Sie das Console-Fenster benutzen wollen, sollte
die \Datei{GEMDOS}-Ausgabe nicht von irgendwelchen Programmen abgefangen
werden. NVDI und QuickST-II werden jedoch erkannt (und ggf.\ aus dem
\Datei{GEMDOS}-Trap entfernt); diese beiden k�nnen Sie also benutzen.
Kleiner Tip: NVDI bereitet, auch im Zusammenspiel mit anderen Programmen,
normalerweise mit Abstand die wenigsten Probleme.
\index{TurboST}\index{NVDI}\index{QuickST-II}

Ist das Console-Fenster das oberste Fenster, so laufen die Programme darin
besonders schnell. Ist das Console-Fenster aber nicht das oberste Fenster,
so wird relativ viel Rechenzeit an die anderen Prozesse abgegeben. Das
ist besonders unter MultiGEM praktisch: Das Programm im obersten Fenster
ist immer das schnellste.

Auch ohne MultiGEM verbraucht das Console-Fenster ein wenig Rechenzeit.
Ein typischer \TeX-Lauf ist im Fenster ca.\ 5\% langsamer als ohne Fenster.

\subsection{Das Environment und die Suchpfade}
\index{Environment}\index{Suchpfad}

Um das \TeX-System �bersichtlich zu halten wurden die vielen verschiedenen
Eingabe-Dateien in einer Ordner-Struktur gespeichert. Damit \TeX{} und
\MetaFont{} die Dateien trotzdem finden, m�ssen Sie daf�r Suchpfade
einstellen, was �ber sogenannte Environment-Variablen geschieht.

Vorsicht: Die Suchpfade der Druckertreiber werden nicht �ber das Environment
sondern �ber Zusatz-Optionen eingestellt. N�here Informationen dazu finden
Sie in der Datei \Datei{DVI_VIEW.DOC}.

In der Shell k�nnen die folgenden Environments eingestellt werden:
\begin{description}
\item[\tt TEXINPUTS] Hier sucht \TeX{} seine Eingabe-Dateien.
\item[\tt TEXOUTPUTS] Hierher schreibt \TeX{} seine Ausgaben (\Datei{.DVI},
             \Datei{.AUX}, \ldots). Damit die \LaTeX-Hilfsdateien
             (\Datei{.AUX} usw.) beim n�chsten \TeX-Lauf auch wieder
             gefunden werden sucht \TeX{} seine Eingaben zuerst auf
             {\tt TEXOUTPUTS} und dann erst auf {\tt TEXINPUTS}.
\item[\tt TEXFONTS] Hier sucht \TeX{} seine font-metric-files (\Datei{.TFM}).
\item[\tt TEXFORMATS] Ini\TeX{} sucht hier den \TeX{} pool (\Datei{TEX.POO})
             und schreibt hier auch die Format-Dateien, die \TeX{} dann
             wieder hier sucht. Das Large \TeX{} sucht hier auch die Datei
             \Datei{TEX_L.OPT}.
\item[\tt TEXBIB] Wird nur von Bib\TeX{} benutzt.
\item[\tt MFINPUTS] Hier sucht \MetaFont{} seine Eingabe-Dateien.
\item[\tt MFOUTPUTS] Hierher schreibt \MetaFont{} seine Ausgaben
             (\Datei{.GF}, \Datei{.TFM}, \ldots).
\item[\tt MFBASES] IniMF sucht hier den \MetaFont{} pool (\Datei{MF.POO})
             und schreibt hier auch die Base-Dateien, die \MetaFont{} dann
             wieder hier sucht.
\end{description}

Die Suchpfade f�r die Eingaben k�nnen mit einer Besonderheit
ausgestattet werden: Wird an einen Ordnernamen ein '\verb|/*|'
(oder '\verb|\*|') angeh�ngt, so sucht \TeX{}/\MetaFont{} die
Dateien nicht nur in dem angegebenen Ordner,
sondern auch in dessen Unter-Ordnern und wiederum deren Unter-Ordnern usw.;
der Teilbaum wird allerdings nur bis zur Tiefe von drei Ordner-Ebenen
durchsucht. Dies erlaubt eine bessere Sortierung der Eingabe-Dateien bei
gleichzeitig k�rzeren Suchpfaden.

\subsection{Die Bedienung von \protect\TeX}

Neben dem Environment k�nnen unter \verb|TeX-Projekt| noch weitere Einstellungen
vorgenommen werden. Die eingestellte HauptDatei wird jeweils ge`\TeX't,
die ArbeitsDatei, die von der HauptDatei verschieden sein kann, wird in
den Editor geladen.

Ferner k�nnen Sie eine Format-Vorgabe t�tigen, die aber nur dann aktiv wird,
wenn die HauptDatei nicht mit einer \verb|%format|-Zeile beginnt. Bevor Sie
ein bestimmtes \TeX-Format benutzen k�nnen, m�ssen Sie es erst mit
Ini\TeX{} erzeugen.

Da einige Macropakete, insbesondere \LaTeX{}, zum Erstellen eines
Inhaltsverzeichnisses und Stichwortregisters sowie zum Verwalten der
Querverweise mehrere \TeX-L�ufe brauchen, k�nnen Sie die Shell anweisen,
\TeX{} immer gleich mehrfach aufzurufen. Stellen Sie dabei~`\verb|*|' ein,
so werden bis zu vier \TeX-L�ufe durchgef�hrt, wobei allerdings schon
vorher abgebrochen wird, falls sich die \Datei{AUX}-Datei nicht mehr
ge�ndert hat. Dies ist besonders bei \LaTeX{} praktisch, weil dann immer
genau soviele \TeX-L�ufe gemacht werden, wie notwendig sind.
\index{TeX-Laeufe@\TeX-L�ufe}\index{LaTeX@\LaTeX{}}

Weitere Hinweise zur Bedienung von \TeX{} und zu den Macropaketen entnehmen
Sie bitte der Literatur.

\subsection{Die Bedienung von \protect\MetaFont}
\index{METAFONT@\MetaFont}

\MetaFont, den Font-Generator zu \TeX{} k�nnen Sie f�r zwei unterschiedliche
Aufgaben benutzen: Erzeugen von Standard-Fonts f�r Ihren Drucker und
Design eigener Fonts.

Unter dem Men�titel "`Parameter"' finden Sie einen Punkt mit dem Sie
zwischen \TeX- und \MetaFont-Modus hin und her schalten k�nnen.

\subsubsection{Erzeugen von Fonts f�r Ihren Drucker}
\index{METAFONT@\MetaFont!Fonts erzeugen}
\index{Fonts erzeugen}

Zum Erzeugen von Standard-Fonts f�r Ihren Drucker (oder Bildschirm; der
Bildschirm wird hier wie ein Drucker behandelt) m�ssen Sie zun�chst
einmal Ihren Druckertyp unter \verb|MF-Device| einstellen.

Dann k�nnen Sie eine Liste von Fonts abarbeiten lassen und die fehlenden
Fonts werden automatisch erzeugt.

Es besteht auch die M�glichkeit aus dem \TeX-Modus der Shell heraus mit
dem daf�r vorgesehenen Men�punkt nur die fehlenden Fonts f�r ein spezielles
Dokument zu erzeugen. Wenn der Druckertreiber sich also �ber fehlende Fonts
beschwert, k�nnen Sie diese dann sehr bequem erzeugen lassen.

Bevor Sie einen Font f�r einen Drucker erzeugen k�nnen, m�ssen Sie das
\MetaFont-Device richtig, d.\,h.\ passend zu den in der Datei
`\verb|\METAFONT\INPUTS\ATARI\ATARI.MF|' und den von den Druckertreibern
erwarteten Werten einstellen.

Derzeit sind folgende Einstellungen m�glich:

\begin{center}
\begin{tabular}{|l|l|l|}
\hline
 \it mode & \it Hdpi & \it Ordner \\
\hline
 atari           &    96   & fonts \\
\hline
 canon\_bj\_low    &   180   & bj\_lofnt \\
 canon\_bj        &   360   & bj\_fonts \\
\hline
 nec\_p\_six       &   180   & p6\_fonts \\
 nec\_p\_six\_md    &   360   & p6\_mdfnt \\
 nec\_p\_six\_hd    &   360   & p6\_hdfnt \\
\hline
 nec\_p\_two       &   120   & p2\_fonts \\
 nec\_p\_two\_md    &   240   & p2\_mdfnt \\
 nec\_p\_two\_hd    &   240   & p2\_hdfnt \\
\hline
 laserjet        &   300   & lj\_fonts \\
 laserjet\_md    &   600   & lj\_mdfnt \\
 laserjet\_hd    &   600   & lj\_hdfnt \\
\hline
 deskjet         &   300   & dj\_fonts \\
\hline
 fx\_eighty       &   240   & fx\_hdfnt \\
 rx\_eighty       &   120   & rx\_fonts \\
 mx\_eighty       &    60   & mx\_fonts \\
 fx\_fast         &    80   & fx\_fonts \\
\hline
 linotype\_low    &   635   & lt\_lofnt \\
 linotype        &  1270   & lt\_fonts \\
 linotype\_high   &  2540   & lt\_hdfnt \\
\hline
\end{tabular}
\end{center}

Bitte beachten Sie, da� es nicht sinnvoll ist, �nderungen an den einzelnen
Einstellungen vorzunehmen. Wenn Sie andere Parameter brauchen, m�ssen Sie
einen komplett neuen \verb|mode|-Parameter in 
`\verb|\METAFONT\INPUTS\ATARI\ATARI.MF|' eintragen, die dort eingestellte
Aufl�sung inden DPI-Wert �ber"-tragen und die Fonts in einem neuen, eigenen
Ordner ablegen.

\subsubsection{Design eigener Fonts}
\index{METAFONT@\MetaFont!Font-Design}
\index{Font-Design}

Wollen Sie einen eigenen Font entwerfen, so brauchen Sie in jedem Falle
Literatur zu \MetaFont. Die Originaldokumentation ist das folgende Buch:

\index{Knuth, Donald Erwin}
\begin{quote}
      Donald E. Knuth: The METAFONTbook. Addison Wesley 1986.
\end{quote}

Dort erfahren Sie auch, was ein Gray-Font ist, und wie sie ihn bekommen.
\Datei{GFtoDVI} und "`Proof drucken"' funktionieren nur, wenn Sie einen
Gray-Font haben.

Die Einstellungen unter "`HauptDatei"', "`ArbeitsDatei"' und
"`MF-Projekt einstellen"' brauchen Sie nur, wenn Sie Font-Design
betreiben wollen.

\subsection{Die Bedienung der Druckertreiber}

Bevor Sie etwas ausdrucken k�nnen mu� \TeX{} mindestens einmal gelaufen
sein. \TeX{} erzeugt aus Ihren Eingabedateien eine \Datei{DVI}-Datei,
die dann von den Druckertreibern weiter verarbeitet werden kann.

Bevor Sie das erste mal ausdrucken k�nnen, m�ssen Sie den richtigen
Druckertreiber einstellen. Informationen dazu finden Sie in der
Datei \Datei{DVI-INFO} und in \Datei{DVI_DOC.DVI}.

Die Druckertreiber m�ssen au�erdem so konfiguriert werden, da� der Text
auf dem Papier den richtigen Abstand zum Rand hat. Leider sind die
Drucker verschiedener Hersteller hier oft unterschiedlich. Stellen
Sie also den Drucker einmal wie folgt ein:

W�hlen Sie die Testseite \Datei{TESTA4.TEX} (oder \Datei{TESTPAGE.TEX})
als HauptDatei an, und drucken Sie diese aus. Stellen Sie dann den
oberen Rand mit der Option~`\verb|-t|' und den linken rand mit der
Option~`\verb|-l|' so ein, da� oben und links genau ein Rand von 2.54~cm
bleibt. Voreinstellung ist bei allen Treibern \verb|-t=1000| und
\verb|-l=1000|; kleinere Werte verkleinern den Rand, gr��ere vergr��ern
ihn.\index{Druckertreiber!einstellen}\index{Ausdrucken!Einstellungen}%
\index{Rand!einstellen}

Haben Sie den Rand einmal richtig eingestellt, speichern Sie bitte die
Parameter ab und lassen Sie diese Einstellung von da an unver�ndert.
Die endg�ltige Positionierung des Textes auf der Seite sollte dann mit
\TeX-Befehlen bewerkstelligt werden.

Wichtig: Wenn der Rand einmal korrekt eingestellt ist, lassen Sie ihn
in Ruhe. Wenn Sie Ihren Ausdruck bei Querdruck usw.\ anders positionieren
wollen, tun Sie das bitte mit den entsprechenden \TeX-Befehlen. Danke.

\subsubsection{Heftdruck}

Ab \Datei{TSH} Version 1.10 ist es m�glich, mehrere Seiten pro Blatt zu
drucken. Dazu stellen Sie im Druck-Dialog 2~oder 4~Seiten pro Blatt ein.

Mit der Einstellung 2 Seiten pro Blatt k�nnen z.\,B.\ zwei A5-Seiten
nebeneinander auf ein A4-Blatt ausgegeben weden.

Mit der Einstellung 4 Seiten pro Blatt (Heftdruck) k�nnen z.\,B.\ je zwei
A5-Seiten doppelseitig (also insgesamt 4 A5-Seiten) auf ein Blatt gedruckt
werden. Dazu m�ssen dann in einem ersten Lauf die ungeraden Seiten
gedruckt, der Papierstapel erneut eingelegt, und in einem zweiten Lauf
nur die geraden Seiten gedruckt werden.
Probieren Sie doch einfach einmal das Beispiel \Datei{HEFTDEMO.TEX} aus.

N�here Informationen finden Sie auch in der Dokumentation zu den
Druckertreibern unter der Option `\verb|-x|'.

\subsection{Das Hilfsprogramm \protect\Datei{TOS\_WIND.PRG}}

MultiGEM's \Datei{MULTIWIN.PRG} ist (zumindest in der Version, die mit
MultiGEM~1.02 ausgeliefert wird) leider mit einigen Schw�chen behaftet.
\Datei{TOS_WIND.PRG} ist ein Ersatz daf�r und kann \Datei{MULTIWIN.PRG}
bei Bedarf ersetzen. Bitte kopieren Sie \Datei{TOS_WIND.PRG} in den Ordner
\Datei{C:\MULTIGEM\}.

\Datei{TOS_WIND.PRG} fragt beim Aufruf seinen eigenen Namen ab. Dieser darf
nur entweder \Datei{TOS_WIND.PRG} oder \Datei{MULTIWIN.PRG} lauten.
Wird \Datei{TOS_WIND.PRG} anders umbenannt, so erkennt das Programm beim
Aufruf vom Desktop aus die �bergebenen Parameter nicht mehr. "`Anwendung
anmelden"' klappt dann also nicht mehr.

\Datei{TOS_WIND} hat mit Bildschirm-Beschleunigern dieselben Probleme wie
das Console-Fenster von \TSH{}. Beachten Sie also bitte die oben gegebenen
Hinweise.

\subsection{Das Hilfsprogramm \protect\Datei{BATCH\_IT.TTP}}

Das Hilfsprogramm \Datei{BATCH_IT.TTP} wird von der \TSH{} Shell benutzt,
wenn \MetaFont{} im Batch-Modus aufgerufen werden soll. Das Programm ist
sehr primitiv (darum ist es auch sch�n klein) und f�r andere Anwendungen
kaum zu gebrauchen.
\index{TSH Shell|)}

%%%%%%%%%%%% Besonderheiten %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{Besonderheiten des \protect\MultiTeX}

Alle \TeX-Implementationen sind mehr oder weniger gleich. \MultiTeX{} 
kann aber einiges, was Sie nicht �berall finden. Einige �nderungen, durch
die das PD-\TeX{} in einigen Punkten vom �blichen Standard abwich, wurden
im Multi\TeX{} wieder r�ckg�ngig gemacht. Multi\TeX{} erf�llt also meines
Wissens alle offiziellen Standards; das wird auch in Zukunft so bleiben.

\subsection{Dateinamen}
\index{Dateinamen}

Da \TeX{} und \MetaFont{} den Backslash `\verb|\|' als Sonderzeichen
interpretieren, mu� in File-Namen hier ein Slash '\verb|/|' eingegeben werden.
Beispiel: `\Datei{\input a:/ich/du}' liest die Datei `\Datei{a:\ich\du.tex}'.
\index{Backslash}

\TeX{}, \MetaFont{} und die Druckertreiber suchen Ihre Eingaben evtl.\ in
mehreren Ordnern. Dies wird durch Environment-Variablen (\TeX, \MetaFont{})
oder Zusatz-Optionen (Druckertreiber) gesteuert (siehe oben).

Bitte vermeiden Sie -- besonders bei Benutzung der deutschen Formate --
Umlaute und Sonderzeichen in Dateinamen. Da die Umlaute derzeit in \TeX{}
"`active"' sind, machen sie sonst Probleme. Schreiben Sie also
z.\,B.\ "`\Datei{UEBUNG.TEX}"' statt "`\Datei{�BUNG.TEX}"'.
Zuk�nftige Versionen der deutschen Formate, bei denen echte Cork-Fonts
(s.u.) benutzt werden, haben diese Probleme dann nicht mehr.
\index{Umlaute}\index{Uebung.tex@{\tt �BUNG.TEX}}

\subsection{Font-Auswahl}

\LaTeX{} benutzt relativ viele Fonts. Um das System klein zu halten wurde
die Datei `\Datei{lfonts.tex}' manipuliert.

Derzeit werden zwei Versionen von `\Datei{lfonts.tex}' mitgeliefert:
`\Datei{lfonts.min}' ist die kleine Version (ja, ja, die Datei
ist etwas gr��er; sie l�dt aber weniger Fonts und schont so den
Font-Speicherbereich in \TeX), und `\Datei{lfonts.std}' ist die
Standard-Version. Kopieren Sie die Version, die Sie lieber m�gen, nach
`\Datei{lfonts.tex}' und erzeugen Sie danach die \Datei{LATEX} und
\Datei{LATEXG} Formate neu.

Einige Fonts wurden im Laufe der Zeit umbenannt. Wenn Ihnen also \Datei{PK}
oder \Datei{TFM} files fehlen, suchen Sie nach den folgenden �quivalenten:

\begin{verbatim}
                 circle10  = lcircle10
                 circlew10 = lcirclew10
                 manual    = manfnt
\end{verbatim}

\subsection{Ligaturen und Tremata}

Bei den Ligaturen und Tremata gibt in \MultiTeX{} keine Besonderheiten
mehr. Falls Sie aus der Installation von fr�heren PD-Versionen im Ordner
\verb|\METAFONT\INPUTS\ATARI| noch die Dateien \verb|ATARI.DOC|,
\verb|ITALIG.MF| und \verb|ROMLIG.MF| haben, so l�schen Sie diese
bitte umgehend. Danke.

\subsection{Grafik}
\index{Grafik}\index{CSG Level 2}

Das Atari-\TeX{} bietet umfangreiche M�glichkeiten zur Einbindung von
Vektor- und Rastergrafik. Dokumentation und Beispiele zur Grafik-Einbindung
finden Sie im Ordner `\Datei{BILDER}' und in der Beschreibung der
Druckertreiber (\Datei{DVI_DOC.DVI}).

\Datei{DVI_DOC.DVI} enth�lt auch noch viele weitere n�tzliche Informationen,
die hier nicht alle wiederholt werden sollen.

Die Vektorgrafik des \MultiTeX{}  (CSG Level~2) eignet sich besonders gut f�r
die Ausgabe aus eigenen Programmen. Mittlerweile gibt es schon einige CAD- und
Zeichenprogramme, die das CSG-Format auf diese Weise direkt unterst�tzen.
Das Public Domain \zpcad{} (ST-Computer PD~398+399) war eines der ersten
dieser Programme.

\subsection{Sonderzeichen und die \protect"`Cork-Tabelle\protect"'}
\index{Umlaute}\index{Cork-Tabelle}

Alle Zeichen incl.\ Control-Z sind in Eingabe-Dateien erlaubt;
CR allerdings nur vor oder nach LF. Der Code mu� sonst mit drei Zeichen
`\verb|^|\verb|^|\verb|M|' eingegeben werden. Die Zeichen mit
\verb|\catcode|~15 rufen nat�rlich Fehlermeldungen hervor
(siehe \TeX book, Kapitel 7).

\pagebreak[2]
Auf ihrer Tagung in Cork 1990 hat die TUG (\TeX{} Users Group) eine Codierung
f�r die Sonderzeichen in den Fonts festgelegt. Die oberen 128 davon sehen
wie folgt aus:

\nopagebreak
\smallskip
\nopagebreak
\begin{center}
\renewcommand{\arraystretch}{1.6}
\begin{tabular}{*{17}{c|}}
\it Cork\/ & \tt 0 & \tt 1 & \tt 2 & \tt 3 & \tt 4 & \tt 5 & \tt 6 & \tt 7
           & \tt 8 & \tt 9 & \tt A & \tt B & \tt C & \tt D & \tt E & \tt F \\
\hline
\tt 0x80 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0x90 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xA0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xB0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xC0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xD0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xE0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xF0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\end{tabular}
\renewcommand{\arraystretch}{1}
\end{center}

\smallskip
Diese Codierung bezieht sich jedoch nur auf die Fonts, ein Code f�r die
Daten-Eingabe wurde nicht festgelegt !!!
Ab der \TeX-Version 3.1 // 2.0cs k�nnen nun alle diese Zeichen direkt als
je ein einzelnes Zeichen eingegeben werden.

Klar ist aber, da� der Cork-Code auf dem Atari ST als {\em Eingabe\/}-Code
unbrauchbar ist, da z.\,B.\ das es-zet `�' auf dem Atari nicht als {\tt 0xFF}
sondern als {\tt 0x9E} codiert ist. Daher mu� irgendwo eine Umcodierung
vorgenommen werden.

Beim \MultiTeX{}  geschieht das gleich beim Einlesen aller Informationen aus
Dateien oder von der Tastatur, so da� der Benutzer nur den Atari-Code, \TeX\
jedoch nur den Cork-Code sieht.

Dummerweise sind auf dem Atari einige Zeichen der Cork-Tabelle gar nicht im
Standard-Zeichensatz enthalten. F�r diese Zeichen mu� sich jeder
\TeX-Implementierer eigene Codes �berlegen. Was bei mir dabei herausgekommen
ist, steht in der folgenden Tabelle der \TeX-Eingabe-Codes:

\smallskip
\begin{center}
\renewcommand{\arraystretch}{1.6}
\begin{tabular}{*{17}{c|}}
\it Atari\/ & \tt 0 & \tt 1 & \tt 2 & \tt 3 & \tt 4 & \tt 5 & \tt 6 & \tt 7
            & \tt 8 & \tt 9 & \tt A & \tt B & \tt C & \tt D & \tt E & \tt F \\
\hline
\tt 0x80 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0x90 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xA0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xB0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xC0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xD0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xE0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\tt 0xF0 & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � & � \\
\hline
\end{tabular}
\renewcommand{\arraystretch}{1}
\end{center}

\smallskip
Wie gesagt, sind auf dem Atari einige Zeichen der Cork-Tabelle gar nicht im
Standard-Zeichensatz enthalten. Die Festlegung eines Eingabe-Codes dieses
Problem nur zur H�lfte, denn man m�chte ja auch gerne im Editor sehen,
was man gerade so eingibt.

Daf�r gibt es nun das Hilfsprogramm `\Datei{FONT.PRG}'. Wird es aufgerufen,
so installiert das Programm die Datei `\Datei{FONT}' als neuen 
8x16--System-Font in der hohen Auf"-l�sung des ST.
Leider gibt es einige Programme (Gulam usw.), die den Font rauswerfen
und wieder den ROM-Zeichensatz installieren. Bei Tempus sieht man den neu
installierten Zeichensatz erst dann, wenn man 'Systemzeichensatz' angeclickt
hat.
Im mitgelieferten Editor `\Datei{ME.TTP}' sehen Sie alles wie erwartet.
Zur Eingabe der Sonderzeichen k�nnen Sie sich hier selber Tastenkombinationen
definieren.

`\Datei{FONT.PRG}' ist kein weltbewegendes Programm. Wenn Sie etwas besseres
haben, und das der Allgemeinheit zur Verf�gung stellen wollen,
lassen Sie es mich wissen.

\subsection{Large \protect\TeX}
\index{Large \TeX}\index{BigTeX@Big\TeX|see{Large \TeX}}

In letzter Zeit besteht ein starker Trend, die Macropakete f�r \TeX{} mehr
und mehr zu verfeinern und mit Zusatzfunktionen auszustatten. Dadurch
wachsen diese immer mehr an, und es kann vorkommen, da� man an eine der
Speichergrenzen von \TeX{} st��t.

Um dem abzuhelfen gab es ab Dezember~1990 zwei verschiedene Big\TeX-Versionen:
eine f�r 2~MB und eine f�r 4~MB Speicherausbau.

Ab sofort gibt es nur noch eine Big\TeX-Version, die jedoch in ihrem
Speicherbedarf variabel ist und nach Bedarf angepa�t werden kann.

\def\pp{{\tt ++}}%
Hier sind die Daten der \TeX-Version 3.141 // 2.8cs vom Dezember 1992:

\begin{center}
\begin{tabular}{|p{8cm}|c|c|}
\hline
\it Gr��e & \it Normal & \it Large \\
\hline
\hline
Hauptspeicher \hfill \verb|mem_max| & 65534 & 72000 \pp \\
\hline
Platz f�r Trennmuster \hfill \verb|trie_size| & 12000 & 16000 \pp \\
\hline
Komplexit�t der Trennmuster \hfill \verb|trie_op_size| & 500 & 3000 \\
\hline
Komplexit�t der Trennmuster pro \verb|\language| & 255 & 3000 \\
\hline
L�nge der Eingabezeilen \hfill \verb|buf_size| & 2000 & 3000 \\
\hline
Verf�gbare strings \hfill \verb|max_strings| & 6000 & 9500 \\
\hline
Gesamtl�nge aller strings \hfill \verb|pool_size| & 55000 & 60000 \pp \\
\hline
Platz f�r \verb|\global\def|'s \hfill \verb|save_size| & 600 & 3000 \\
\hline
Verf�gbare \TeX-Kommandos \hfill \verb|hash_size| & 3500 & 9500 \\
\hline
Platz f�r fonts \hfill \verb|font_mem_size| & 20500 & 22000 \pp \\
\hline
Ladbare fonts pro \TeX-Lauf \hfill \verb|font_max| & 80 & 255 \\
\hline
Name des \verb|PLAIN| formats & \tt plain.fmt & \tt plain.fml \\
\hline
Gr��e des \verb|PLAIN| formats ca. & 140 k & 230 k \\
\hline
L�uft ab Speicherausbau & 1 MB & 2 MB \\
\hline
\end{tabular}
\end{center}

Die mit "`\pp"' gekennzeichneten Gr��en k�nnen Sie ver�ndern. Dazu tragen
Sie die gew�nschten Werte einfach in der Datei \verb|\TEX\FORMATS\TEX_L.OPT|
ein. Bitte beachten Sie jedoch, da� nach jeder �nderung alle \TeX-Formate
neu erzeugt werden m�ssen.

Bevor Sie wie wild Speichererweiterungen kaufen, bedenken Sie bitte:
Oftmals wird eine Grenze nur durch Fehler in der Eingabe erreicht. Nach
Korrektur des Fehlers l�uft dann alles mit dem normalen \TeX.

Nur wenn das normale und das Large \TeX{} die gleiche Versionsnummer tragen,
k�nnen alle \verb|IniTeX|'s auf das gleiche \verb|TEX.POO| zugreifen, und
ihre Formate im selben Ordner ablegen. Andernfalls m�ssen Sie f�r die
unterschiedlichen Versionen verschiedene Format-Ordner anlegen, in die Sie
das jeweilige \verb|TEX.POO| kopieren, und die Sie dann jeweils im Environment
passend einstellen m�ssen.

\subsection{Spezielle Versionen f�r Atari TT}

Das Large \TeX{} existiert in zwei Versionen: Eine universelle und
eine speziell auf den Atari~TT angepa�te, die auf normalen ST's nicht
lauf"|f�hig ist. Vom Large Ini\TeX{} gibt es dagegen nur eine Version; die
damit erzeugten Formate k�nnen dann wahlweise mit der universellen oder der
TT-Version weiterbenutzt werden.

\index{Atari!TT}\index{FPU 68881/68882}\index{Atari!Falcon}
Die TT-Version braucht mindestens eine 68020/68881-Kombination, kann also
insbesondere auf normalen ST, STE oder Mega-STE-Modellen nicht benutzt
werden. Wenn Sie die TT-Version auf dem Falcon benutzen wollen, m�ssen Sie
ggf.\ erst einen Coprozessor installieren.

Weiterhin existiert eine spezielle \MetaFont-Version f�r den Atari~TT, die
dieselben Eigenschaften aufweist: Auch das TT-\MetaFont{} braucht mindestens
eine 68020/68881-Kombination und das IniMF ist zu allen mitgelieferten
\MetaFont-Versionen passend.

Bitte erwarten Sie von der TT-Version keine Wunderdinge. Schon die
ST-\TeX-Version ist ja auf TT's mit FAST-RAM etwa viermal so schnell
wie auf einem 8-MHz-ST. Die TT-Version ist dann noch einmal etwa 10\%
schneller.

\subsection{Sonstiges}

\TeX{}, \MetaFont{} und die Druckertreiber k�nnen im Lauf durch Dr�"cken von
\verb|CONTROL-C| oder \verb|ESC| unterbrochen werden. Probieren Sie am besten
erst \verb|ESC| und nur in ganz harten F�llen \verb|CONTROL-C|.

Ist in einer Eingabezeile von der {\em Tastatur} das {\em erste} Zeichen ein
Control-D oder Control-Z, so wird die Eingabe beendet und der \TeX-Lauf
hier abgebrochen. Sp�ter in der Zeile haben diese Zeichen keine
Sonderbedeutung mehr. N�tzlich ist dies z.\,B.\ als Notausstieg bei nicht
gefundenen Dateien ('...Please enter file name:').

Die switch-to-editor Option (Eingabe von 'E' nach Fehlermeldung) wird
f�r \TeX{} unterst�tzt, falls Sie \TeX{} von der GEM-Shell aus aufgerufen
haben.

\subsection{Zu beachten beim Upgrade \protect\TeX{} 2.98
           $\protect\longrightarrow$ \protect\TeX{} 3.x}

Das \MultiTeX{}  ist, im Bezug auf Ihre Eingabetexte, voll abw�rtskompatibel
zum PD~AtariTeX~2.0. Dieser Abschnitt betrifft Sie also nur dann, wenn Sie
bislang mit der Uralt-Version 2.98 // 1.4cs gearbeitet haben.

Normalerweise k�nnen Sie Ihre Texte vom \TeX{} 2.98 // 1.4cs so, wie sie sind,
auf \TeX{} 3.x // 2.xcs �bernehmen. Ein paar Besonderheiten sind aber
doch zu beachten:

\begin{enumerate}
\item In den alten Styles war teilweise '\Datei{DIN_A4.TEX}' schon mit
      eingebunden. Aus Kompatibilit�tsgr�nden wird das jetzt nicht mehr
      gemacht. Schreiben Sie also jetzt z.B.

\begin{verbatim}
      \documentstyle[11pt,din_a4,german]{article}
\end{verbatim}

   statt

\begin{verbatim}
      \documentstyle[11pt,german]{article}
\end{verbatim}

      Mit obiger 'german'-Option kommen jetzt, wie man das auch erwartet, die
      deutschen Texte in den �berschriften usw.

\item Ein 'alter Zopf' wurde nun doch abgeschnitten: Bisher wurden GEM Image
      und MetaFile Bilder bei der Einbindung immer um den Faktor~1.4
      verkleinert. Dieser Faktor hat f�r viel Verwirrung gesorgt, und ich habe
      mich daher entschlossen, ab der DVI-Treiber Version 2.9.60 diesen
      Faktor ersatzlos zu streichen.

      Daher m�ssen Sie nun die Gr��e aller eingebundener GEM Bilder neu
      einstellen.

      Andererseits wurde aber wiederum die GEM Image Einbindung stark
      beschleunigt und verbessert. Die Bilder sehen jetzt bei beliebigen
      Vergr��erungen wesentlich besser aus als bisher.

\item Dies betrifft Sie nur dann, wenn Sie \MultiTeX{}  mit einem fremden
      Macro-Paket wie z. B. AMS\TeX{} benutzen wollen: Wie in 'knuth.tex'
      beschrieben, kann \TeX{} 3.0 jetzt Trennmuster f�r mehrere Sprachen
      gleichzeitig einbinden. GERMAN.TEX unterst�tzt dies, und schaltet
      den \verb|\language| Parameter um.

      Daher sind nun in der *.INI-Datei englische Trennmuster vor, deutsche
      jedoch nach der Einbindung von GERMAN.TEX zu laden.

      Schaltet man \TeX{} n�mlich auf eine \verb|\language| um, f�r die keine
      Trennmuster definiert sind, so kann \TeX{} gar nichts mehr trennen, und
      man erh�lt sehr unsch�ne Ergebnisse, viele 'overfull hbox' und
      'underfull hbox'-Warnungen und dergleichen mehr.
\end{enumerate}

\subsection{Fehlermeldungen}

Bei der Benutzung des \TeX-Systems k�nnen verschiedene Fehler auftreten.

Etliche Fehlermeldungen stammen aus dem Bereich des Betriebssystems,
wie z.\,B.\ 'disk full'. Halten Sie auf der Disk immer genug Platz frei.

Weitere Fehler sind in `\Datei{fehler.txt}' dokumentiert.

Seien Sie versichert, da� die Beispiele aus dem Ordner `\Datei{DEMO}'
und die `\Datei{.tex}'-Dateien aus dem Ordner `\Datei{TEX_DOC}'
alle ohne �nderung funktionieren. Wenn Sie jedoch an der Installation
herumpfuschen oder die Beispiele manipulieren, kann es allerdings sein,
da� diese dann nicht mehr laufen.

S�mtliche Einstellungen der \Datei{TSH} Shell sind so vorbelegt, da� Sie
mit dem System sofort arbeiten k�nnen. Die Druckertreiber sind f�r
NEC P6 (180 und 360 dpi), HP LaserJet und PostScript voreingestellt.
Wenn Sie einen anderen Drucker benutzen wollen, m�ssen Sie den passenden
Druckertreiber einstellen und die Zusatzparameter daf�r nach Ihren
W�nschen anpassen.

Sollten Sie Probleme haben (gar nichts funktioniert mehr), so l�schen Sie
einfach \Datei{TSH.INF}. Dann sind wieder die (funktionierenden)
Standard-Einstellungen aktiv.

Fehler suche man zun�chst bei sich selber. Haben die Programme
tats�chlich noch Fehler, so k�nnen Sie mir eine kurze Beschreibung
des Fehlers (1/2 Seite) zukommen lassen, die ich dann pr�fen werde.
Bei Fehlerberichten nennen Sie bitte immer die Versionsnummer des
\MultiTeX-Paketes und der einzelnen Komponenten (\TeX, Druckertreiber,
usw.). Lesen Sie bitte auch `Fehler.txt'.

Sollten Updates notwendig werden, so werden diese in der Regel
�ber MAXON Computer abgewickelt.

\section{Tips und Tricks}

Ich wu�te, da� der Titel dieses Abschnitts Sie interessieren w�rde. Daher
kommt hier gleich der wichtigste Tip zuerst: Lesen Sie die komplette
Dokumentation mindestens einmal komplett durch. Es lohnt sich.

\subsection{Die \protect\Format-Zeile}

Wenn Sie die \Datei{TSH} Shell benutzen, k�nnen Sie am Anfang der
Haupt-Datei eine `\Format'-Zeile angeben. Dadurch m�ssen Sie sich nicht
mehr selber merken, welches Format die einzelnen \TeX{} Dateien brauchen.
Wenn Sie Beispiele aus B�chern oder andere Texte mit \MultiTeX{} 
bearbeiten wollen, empfiehlt es sich, vor der ersten Zeile der HauptDatei
eine \Format-Zeile einzuf�gen.

Die \Format-Zeile beginnt mit `\Format', dann folgt der
Name des Formates, das f�r diesen Text gebraucht wird. Bei \Datei{LATEXG},
dem deutschen \LaTeX{} ('G' steht f�r 'german'), hat die Zeile das Aussehen:

\begin{verbatim}
        %format latexg
\end{verbatim}

wobei vor dem `{\tt\%}' keine Leerzeichen stehen. % (siehe oben !)

\subsection{Verfahren bei langen Texten}

Wer lange Texte bearbeiten will, m�chte nat�rlich nicht jedesmal darauf
warten, da� der ganze Text in \TeX{} durchlaufen wird, um dann endlich
den Fehler ganz am Ende zu finden. Daher ist es sinnvoll, den Text in
verschiedene Abschnitte aufzuteilen.

Dabei wird eine Hauptdatei �hnlich der folgenden erstellt:

\begin{verbatim}
     %format latexg
     \documentstyle[din_a4,german]{article}
     \pagestyle{empty}
     % usw. ...
     \begin{document}
     % \input titelseite.tex    % Die Titel-Seite
     % \tableofcontents         % Das Inhaltsverzeichnis
     % \input kapitel1.tex      % Das 1. Kapitel
       \input kapitel2.tex      % Das 2. Kapitel  (gerade in Arbeit)
     % \input kapitel3.tex      % Das 3. Kapitel
     % \input kapitel4.tex      % Das 4. Kapitel
     % usw. ...
     \end{document}
\end{verbatim}

Diese Datei wird dann in \Datei{TSH} als HauptDatei eingestellt.
ArbeitsDatei ist jeweils ein Kapitel, welches dann gleichzeitig
in der HauptDatei auskommentiert ist. Auf diese Weise wird immer nur
ein Kapitel ediert und von \TeX{} abgearbeitet.

Hat man alles fertig, so macht man einen letzten Lauf, in dem man
alle Kapitel aktiviert, und dann soviele \TeX-L�ufe macht,
bis das Inhaltsverzeichnis stimmt. Anschlie�end kann der Text
ausgedruckt werden.

\subsection{Fu�noten}

Selbstverst�ndlich beherrscht \TeX{} auch Fu�noten\footnote{~Manche Leute
scheinen Fu�noten geradezu zu lieben. Nimmt der Text in den Fu�noten
bei Ihnen allerdings mehr als 80\% des gesamten Textvolumens ein,
so sollten Sie dar�ber nachdenken, ob Sie nicht irgend etwas falsch
machen.}.

\newpage
%
%%%%%%%%%%%% Index %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%  Hinweis: Der Index ist erst nach einem Makeindex-Lauf korrekt !
%
% Kleiner Test: Gibt's den Index schon ?
%
\openin1 \jobname.ind \ifeof1 {\em Hinweis: Nach einem MakeIndex-Lauf erscheint
hier ein Stichwortverzeichnis !}\else\closein1\fi
%
% Index ins Inhaltsverzeichnis eintragen
%
\addtocounter{section}{1}%
\addcontentsline{toc}{section}{\protect\numberline{\thesection}{\indexname}}%
\addtocounter{section}{-1}%
%
\def\onecolumn{}% sonst Leerseite am Ende -- LaTeX bug ?
%
% Jetzt aber: Der Index
%
\printindex
%
%
%%%%%%%%%%%% Ende %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\end{document}
