\documentstyle[german,12pt]{article}

\newcommand{\adjusttextheight}{
\setlength{\textheight}{29.7cm}
\addtolength{\textheight}{-1.7cm}
\addtolength{\textheight}{-1in}
\addtolength{\textheight}{-\topmargin}
\addtolength{\textheight}{-\headheight}
\addtolength{\textheight}{-\headsep}
\addtolength{\textheight}{-\topskip}
\addtolength{\textheight}{-\footheight}
\addtolength{\textheight}{-\footskip}
}

\newcommand{\adjusttextwidth}{
\setlength{\textwidth}{21cm}
\addtolength{\textwidth}{-1in}
\addtolength{\textwidth}{-\oddsidemargin}
\addtolength{\textwidth}{-1in}
\addtolength{\textwidth}{-\evensidemargin}
}

\setlength{\topmargin}{-0.5cm}
\setlength{\footskip}{0cm}
\adjusttextheight
\setlength{\evensidemargin}{0cm}
\setlength{\oddsidemargin}{0cm}
\adjusttextwidth

\newcommand{\Arcgsh}{{\em Arcgsh\/}}
\newcommand{\arc}{{\em arc\/}}
\newcommand{\Arc}{{\em Arc\/}}
\newcommand{\lharc}{{\em lharc\/}}
\newcommand{\Lharc}{{\em Lharc\/}}
\newcommand{\shar}{{\em shar\/}}
\newcommand{\Shar}{{\em Shar\/}}
\newcommand{\tar}{{\em tar\/}}
\newcommand{\Tar}{{\em Tar\/}}
\newcommand{\zoo}{{\em zoo\/}}
\newcommand{\Zoo}{{\em Zoo\/}}
\newcommand{\compress}{{\em compress\/}}
\newcommand{\Compress}{{\em Compress\/}}
\newcommand{\uud}{{\em uud\/}}
\newcommand{\Uud}{{\em Uud\/}}
\newcommand{\uue}{{\em uue\/}}
\newcommand{\Uue}{{\em Uue\/}}

\newcommand{\field}[1]{{\sf "`#1"'}}
\newcommand{\menu}[1]{{\sf "`#1"'}}
\newcommand{\button}[1]{{\setlength{\fboxsep}{1pt}\framebox{\sf #1}}}

\setlength{\parskip}{1ex}
\setlength{\parindent}{0cm}
\pagestyle{headings}
\flushbottom
\frenchspacing
\sloppy

\title{
{\bf ARCGSH}\\
Archiver GEM Shell\\
--- Version 4.0 ---
}

\author{
Dipl.-Inform. Rainer Klute\\
Vinckeplatz 5\\
W--4600 Dortmund 1\\
\normalsize klute@irb.informatik.uni-dortmund.de
}

\date{17. Januar 1992}




\begin{document}

\thispagestyle{empty}

\maketitle

\newpage

\tableofcontents

\newpage




\section{"Anderungen seit Version 3.5}

\begin{itemize}

\item {\Arcgsh} unterst"utzt jetzt {\tar} and {\compress}. Das Manual wurde
entsprechend aktualisiert.

\item {\Arcgsh} unterst"utzt jetzt {\zoo} 2.1, insbesondere die neue Option
"`high performance compression"', die eine besonders hohe Komprimierung
bietet.

\item Die {\lharc}-Benutzung wurde erheblich verbessert. {\Arcgsh} kann
jetzt an jedes beliebige {\lharc} angepa"st werden. Einzelheiten in
Abschnitt \ref{LHarc} (Seite \pageref{LHarc}).

\end{itemize}




\section{Copyright}

\begin{center}
{\large \bf Copyright 1991 Rainer Klute}
\end{center}

{\Arcgsh} und die zugeh"orige Dokumentation darf beliebig genutzt, kopiert
und weitergegeben werden, ohne da"s daf"ur eine Lizenzgeb"uhr zu entrichten
ist, vorausgesetzt, der obige Copyright-Hinweis ist in allen Kopien
enthalten und sowohl der Copyright-Hinweis als auch dieser Absatz sind in
der zu {\Arcgsh} geh"orenden Dokumentation enthalten. Die Datei {\tt
ARCGSH.CFG} darf nicht weitergegeben werden. Der Autor "ubernimmt f"ur
{\Arcgsh} keine Garantien irgendwelcher Art.




\section{Einf"uhrung}

{\Arcgsh} ist eine GEM-Shell, die die Benutzung vieler
Archivierungsprogramme f"ur den Atari ST ({\arc}, {\lharc}, {\shar}, {\tar}
und {\zoo}) erheblich erleichtert. Au"serdem werden die Programme
{\compress}, {\uud} und {\uue} unterst"utzt. ({\compress} komprimiert bzw.
dekomprimiert eine einzelne Datei; {\uud} und {\uue} sind n"utzlich, um
Bin"ardateien --- z.\,B. Archive --- mittels Electronic Mail zu
"ubertragen.) Dar"uber hinaus k"onnen Sie ein Programm zum Anzeigen einer
Datei (Pager) und Ihren Lieblingseditor direkt von {\Arcgsh} aus benutzen,
ohne das Programm verlassen zu m"ussen.

Wenn Sie {\Arcgsh} verwenden, brauchen Sie zum Aufruf eines Archivierers nie
wieder einen Kommandozeileninterpreter zu starten, mittels {\em "`cd"'\/} zu
dem Ordner zu gehen, in dem sich Ihr Archiv befindet oder angelegt werden
soll, sich die diversen Archiviereroptionen ins Ged"achtnis zur"uckzurufen
(jeder Archivierer hat seine eigenen Optionen), die Optionen einzugeben und
schlie"slich das Programm zu starten. Unter {\Arcgsh} haben Sie es nur noch
mit GEM-Objekten zu tun:  In Dialogboxen w"ahlen Sie Programmoptionen durch
Anklicken von Kn"opfen aus, und Dateinamen selektieren Sie komfortabel mit
der GEM-Dateiauswahlbox.

{\Arcgsh} ist eine {\bf Shell}, kein "`Stand-alone"'-Programm. Damit Sie die
verschiedenen Archivierer auch verwenden k"onnen, m"ussen Sie sie zun"achst
auf Ihrem Rechner installiert haben. Sie ben"otigen folgende Programme:

\begin{center}
\begin{tabular}{lll}
{\bf Programm} & {\bf Dateiname}    & {\bf atari.archive} \\
\hline
\arc           & {\tt ARC.TTP}      & /atari/archivers/arc602.ttp \\
\lharc         & {\tt LHARC.TTP}    & /atari/archivers/lzh201i.lzh \\
\shar          & {\tt SHAR\_RK.TTP} & /atari/archivers/shar\_rk.arc \\
\tar           & {\tt GNUTAR.TTP}   & /atari/gnustuff/tos/gnutar/gtarbin.zoo \\
\zoo           & {\tt ZOO.TTP}      & /atari/archivers/zoo21bin.zoo \\
               &                    & \\
\compress      & {\tt COMPRESS.TTP} & /atari/archivers/compress.zoo \\
\uud           & {\tt UUD.TTP}      & /atari/archivers/uux789.zoo \\
\uue           & {\tt UUE.TTP}      & /atari/archivers/uux789.zoo \\
\end{tabular}
\end{center}

{\small

\begin{quotation}

Was bedeutet {\bf atari.archive}? Wer Zugang zum internationalen Internet
besitzt, kann per anonymem FTP Dateien vom FTP-Server
atari.archive.umich.edu der Universit"at in Michigan (USA) holen.
Archivierungsprogramme befinden sich im Verzeichnis {\tt /atari/archivers}.
Die vorstehende Tabelle zeigt, in welchen Dateien auf
atari.archive.umich.edu Sie die Programme finden k"onnen. (Sollten Sie von
diesem Absatz kein Wort verstehen, haben Sie h"ochstwahrscheinlich keinen
Internet-Zugang. Sie k"onnen die Dateien dann von mir auf einer Diskette
bekommen.)

\end{quotation}

}




\section{Arcgsh ist Shareware}\label{Arcgsh ist Shareware}

Sie k"onnen {\Arcgsh} benutzen, kopieren und weitergeben, ohne etwas daf"ur
bezahlen zu m"ussen. Sofern Sie {\Arcgsh} n"utzlich finden und regelm"a"sig
benutzen, sollten Sie jedoch {\bf DM 35,--} auf mein Konto {\bf
4412\,46-300} beim {\bf Postgiroamt Hannover, BLZ 250\,100\,30} "uberweisen
oder mir einen Scheck bzw. Postanweisung zuschicken.

{\Arcgsh} zeigt von Zeit zu Zeit eine Dialogbox an, um Sie an die
"Uberweisung des Shareware-Beitrags zu erinnern. Sie k"onnen diese Box gern
ignorieren (bzw. wegklicken), ohne da"s Sie ein schlechtes Gewissen haben
m"u"sten. Sollten Sie allerdings so freundlich sein, mir den
Shareware-Beitrag zukommen zu lassen, werde ich Ihnen verraten, wie Sie
diese Dialogboxen loswerden k"onnen. Au"serdem werden dadurch die
Parameter"ubergabeverfahren {\em xArgv\/} und {\em ARGV\/} aktiviert. Sie
sind n"utzlich, wenn Sie einem Archivierer eine lange Liste von Dateinamen
"ubergeben wollen; {\em xArgv\/} und {\em ARGV\/} erm"oglichen es n"amlich,
einem gerufenen Programm (Archivierer) einen Parameter-String mit mehr als
125 Zeichen zu "ubergeben.

Bitte vergessen Sie nicht, bei der Zahlung des Shareware-Beitrags Ihren
Namen und Ihre Adresse anzugeben! Andernfalls kann ich mich nicht mit Ihnen
in Verbindung setzen.




\section{Allgemeines}

{\Arcgsh}s Hauptaufgabe ist es, andere Programme aufzurufen, haupts"achlich
Archivierer. Solche Programme werden im folgenden {\bf gerufene Programme}
genannt. Das Aufrufen solcher Programme l"auft nach einem allgemeinen Schema
ab. Hier nur ein kurzer "Uberblick, eine detaillierte Beschreibung finden
Sie weiter unten.

\begin{itemize}

\item W"ahlen Sie das Programm, das Sie starten wollen, aus dem
\menu{File}-Men"u aus, z.\,B. \menu{Zoo ...}.

\item Es wird eine Dialogbox angezeigt, in der Sie die Programmparameter
eingeben k"onnen. Sie k"onnen Kn"opfe anklicken, Dateinamen selektieren oder
Text in Textfelder eingeben.

Viele Textfelder k"onnen einen Datei- oder Ordnernamen enthalten. Wenn Sie
einen Doppelklick auf solch ein Feld ausf"uhren, wird die
GEM-Dateiauswahlbox angezeigt, und Sie k"onnen eine Datei bzw. einen Ordner
ausw"ahlen. Wenn das Textfeld leer ist, reicht auch ein einfacher Klick, um
die Dateiauswahlbox zu aktivieren. Steht bereits Text im Feld, positioniert
ein einfacher Klick den Text-Cursor in das betreffende Feld hinein, und Sie
k"onnen den Text editieren.

Zum Selektieren eines {\bf Ordners} positionieren Sie die Dateiauswahlbox in
den gew"unschten Ordner hinein, w"ahlen eine beliebige Datei aus oder
klicken einfach auf \button{OK}.

Die Dateiauswahlbox erscheint automatisch, wenn ein obligatorischer
Parameter auszuw"ahlen ist, z.\,B. der Name der Archivdatei, die von einem
Archivierer bearbeitet werden soll.

Weitere Einzelheiten finden Sie im Abschnitt \ref{Der Dateiauswahlmanager}
(Seite \pageref{Der Dateiauswahlmanager}).

Die Ausf"uhrung des gerufenen Programms beginnt, wenn Sie den
\button{OK}-Knopf in der Parameter-Dialogbox anklicken. Wenn das gerufene
Programm vom Typ TOS oder TTP ist, wird der Bildschirm vor dem Programmstart
gel"oscht und in den Textmodus umgeschaltet. Falls {\Arcgsh} noch nicht
wei"s, wo das gerufene Programm steht, wird die Dateiauswahlbox angezeigt,
und Sie m"ussen angeben, wo das Programm zu finden ist.

\item Bei Beendigung des gerufenen Programms kann {\Arcgsh} optional ein
akustisches Signal ("`Ping"') ausgeben. Das ist sehr n"utzlich bei
Programmen, die l"angere Zeit laufen. Die Ausgabe des gerufenen Programms
bleibt (optional) so lange auf dem Bildschirm stehen, bis Sie eine Taste
oder den linken Mausknopf dr"ucken.

{\bf Achtung:} Falls das gerufene Programm auf einen Fehler l"auft, kann es
passieren, da"s dieses Programm selbst Sie auffordert, eine Taste zu
dr"ucken. In diesem Fall m"ussen Sie die Taste zweimal dr"ucken: einmal f"ur
das gerufene Programm und einmal f"ur {\Arcgsh}. Falls das gerufene Programm
einen Returncode ungleich Null liefert, wird dieser Wert in einer Dialogbox
angezeigt.

\end{itemize}




\section{Die Arcgsh-Men"us}

Wenn Sie {\Arcgsh} starten, sehen Sie folgende Men"uzeile:

\begin{tabular}{@{}|lllll|}
\hline
{\sf ~ARCGSH~} & {\sf ~File~} & {\sf ~Configuration~} & {\sf ~Utilities~} & {\sf ~Options~} \\
\hline
\end{tabular}

Die folgenden Abschnitte erl"autern die einzelnen Men"us.



\subsection{Das "`Arcgsh"'-Men"u}

\begin{tabular}{@{}l@{}llll@{}}
\hline
\vline {\sf ~ARCGSH~} & {\sf ~File~} & {\sf ~Configuration~} & {\sf ~Utilities~} & {\sf ~Options~} \hfill \vline\\
\hline
\vline {\sf ~About~Arcgsh~...~} \vline & & & &\\
\cline{1-1}\\
\end{tabular}

Dieses Men"u enth"alt an erster Stelle den Eintrag \menu{About Arcgsh ...}.
Wenn Sie diesen Men"ueintrag selektieren, wird eine Dialogbox mit einigen
allgemeine Informationen "uber das Programm {\Arcgsh} und seinen Autor
angezeigt.



\subsection{Das "`File"'-Men"u}

\newlength{\pl}
\settowidth{\pl}{\sf ~Other~program~...  p~}
\begin{tabular}{@{}l@{}l@{}lll@{}}
\hline
\vline {\sf ~ARCGSH~} & {\sf ~File~} & {\sf ~Configuration~} & {\sf ~Utilities~} & {\sf ~Options~} \hfill \vline\\
\hline
& \vline \parbox{\pl}{\sf ~Arc~...           \hfill a~} \hfill \vline & & &\\
& \vline \parbox{\pl}{\sf ~LHarc~...         \hfill l~} \hfill \vline & & &\\
& \vline \parbox{\pl}{\sf ~Shar~...          \hfill  ~} \hfill \vline & & &\\
& \vline \parbox{\pl}{\sf ~Tar~...           \hfill t~} \hfill \vline & & &\\
& \vline \parbox{\pl}{\sf ~Zoo~...           \hfill z~} \hfill \vline & & &\\
\cline{2-2}
& \vline \parbox{\pl}{\sf ~Compress~...      \hfill c~} \hfill \vline & & &\\
\cline{2-2}
& \vline \parbox{\pl}{\sf ~Uud~...           \hfill u~} \hfill \vline & & &\\
& \vline \parbox{\pl}{\sf ~Uue~...           \hfill  ~} \hfill \vline & & &\\
\cline{2-2}
& \vline \parbox{\pl}{\sf ~Other~program~... \hfill p~} \hfill \vline & & &\\
\cline{2-2}
& \vline \parbox{\pl}{\sf ~Show~file~...     \hfill s~} \hfill \vline & & &\\
& \vline \parbox{\pl}{\sf ~Edit~file~...     \hfill e~} \hfill \vline & & &\\
\cline{2-2}
& \vline \parbox{\pl}{\sf ~Quit              \hfill q~} \hfill \vline & & &\\
\cline{2-2}\\
\end{tabular}

"Uber das \menu{File}-Men"u starten Sie die Archivierer. Die Bedeutung der
Men"upunkte im einzelnen:

\begin{description}

\item[\menu{Arc ...}, \menu{LHarc ...}, \menu{Shar ...}, \menu{Tar ...},
\menu{Zoo ...}:]  Dies sind die Namen der Archivierer, die {\Arcgsh}
unterst"utzt. Denjenigen Archivierer, den Sie benutzen wollen, w"ahlen Sie
im \menu{File}-Men"u aus. Es erscheint dann eine archiviererspezifische
Dialogbox, in der Sie Dateinamen ausw"ahlen, Optionen einstellen usw.
Einzelheiten entnehmen Sie bitte Kapitel \ref{Aufruf der Archivierer} (Seite
\pageref{Aufruf der Archivierer}).

\item[\menu{Compress ...}:] Das Programm {\compress} komprimiert bzw.
dekomprimiert eine einzelne Datei. Komprimierte Dateien haben in der Regel
den Buchstaben {\tt Z} als letztes Zeichen im Dateinamen. Einzelheiten
entnehmen Sie bitte Kapitel \ref{Compress} (Seite \pageref{Compress}).

\item[\menu{Uud ...}, \menu{Uue ...}:] Bin"ardateien (z.\,B. Archive oder
Programme) k"onnen in der Regel nicht direkt per Electronic Mail verschickt
werden, sondern m"ussen zun"achst "`uukodiert"' werden. Diese Aufgabe
erledigt das Programm {\uue}. Es kodiert eine Datei derart, da"s sie nur
noch aus druckbaren Zeichen besteht, die durch Electronic Mail "ubertragen
werden k"onnen.

{\Uud} f"uhrt die umgekehrte Konvertierung durch und "`uudekodiert"'
uukodierte Dateien. Es kann eingesetzt werden, wenn man Dateien per News
oder Electronic Mail erhalten hat. Eine einzelne uukodierte Datei besitzt
typischerweise die Endung {\tt .UUE}.

Nach Anw"ahlen von \menu{uud} oder \menu{uue} wird eine Dialogbox angezeigt,
in der Sie die jeweiligen Parameter f"ur {\uud} bzw. {\uue} einstellen
k"onnen.  Einzelheiten entnehmen Sie bitte Kapitel \ref{Uud und uue} (Seite
\pageref{Uud und uue}).

\item[\menu{Other program ...}:] Es erscheint eine Dialogbox, "uber die Sie
ein beliebiges Programm starten k"onnen. Dem Programm k"onnen Parameter
mitgegeben werden, und der Arbeitsordner kann explizit festgelegt werden.
Einzelheiten entnehmen Sie bitte Kapitel \ref{Aufruf weiterer Programme}
(Seite \pageref{Aufruf weiterer Programme}).

\item[\menu{Show file ...}:] Zum Ansehen einer Datei k"onnen Sie diesen
Men"ueintrag selektieren. Allerdings zeigt nicht {\Arcgsh} selbst den
Dateiinhalt an, sondern ruft dazu ein weiteres Programm auf, den
"`benutzerdefinierten Pager"'. Einzelheiten entnehmen Sie bitte Kapitel
\ref{Der benutzerdefinierte Pager} (Seite \pageref{Der benutzerdefinierte
Pager}).

\item[\menu{Edit file ...}:] Zum Editieren einer Datei k"onnen Sie diesen
Men"ueintrag selektieren. Allerdings besitzt {\Arcgsh} keinen eingebauten
Editor, sondern erm"oglicht Ihnen, Ihren eigenen Editor zu benutzen.
Einzelheiten entnehmen Sie bitte Kapitel \ref{Der benutzerdefinierte Editor}
(Seite \pageref{Der benutzerdefinierte Editor}).

\item[\menu{Quit}:] {\Arcgsh} beenden.

\end{description}



\subsubsection{Aufruf von "`File"'-Men"u-Funktionen "uber
Tastaturk"urzel}\label{Aufruf von File-Menue-Funktionen ueber
Tastaturkuerzel}

Die meisten Funktionen aus dem \menu{File}-Men"u k"onnen Sie auch "uber die
Tastatur aufrufen. Dr"ucken Sie einfach die Taste, die rechts im
Men"ueintrag steht, z.\,B. \field{z}, um die {\zoo}-Dialogbox anzuzeigen.



\subsection{Das "`Configuration"'-Men"u}

\begin{tabular}{@{}ll@{}l@{}ll@{}}
\hline
\vline {\sf ~ARCGSH~} & {\sf ~File~} & {\sf ~Configuration~} & {\sf ~Utilities~} & {\sf ~Options~} \hfill \vline\\
\hline
& & \vline {\sf ~Locate~Arc~...~}       \hfill \vline & &\\
& & \vline {\sf ~Locate~LHarc~...~}     \hfill \vline & &\\
& & \vline {\sf ~Locate~Shar~...~}      \hfill \vline & &\\
& & \vline {\sf ~Locate~Tar~...~}       \hfill \vline & &\\
& & \vline {\sf ~Locate~Zoo~...~}       \hfill \vline & &\\
\cline{3-3}
& & \vline {\sf ~Locate~Compress~...~}  \hfill \vline & &\\
\cline{3-3}
& & \vline {\sf ~Locate~Uud~...~}       \hfill \vline & &\\
& & \vline {\sf ~Locate~Uue~...~}       \hfill \vline & &\\
\cline{3-3}
& & \vline {\sf ~Configure~pager~...~}  \hfill \vline & &\\
& & \vline {\sf ~Configure~editor~...~} \hfill \vline & &\\
\cline{3-3}
& & \vline {\sf ~Save~configuration~}   \hfill \vline & &\\
\cline{3-3}\\
\end{tabular}

Bevor {\Arcgsh} ein gerufenes Programm, also z.\,B. einen Archivierer,
ausf"uhren kann, mu"s es wissen, wo sich dieses Programm auf der Festplatte
oder Diskette befindet. Mit Hilfe des \menu{Configuration}-Men"us k"onnen
Sie {\Arcgsh} diese Informationen liefern.

Nehmen wir an, Sie wollen den Archivierer {\zoo} lokalisieren. Dazu w"ahlen
Sie zun"achst den Men"upunkt \menu{Locate~Zoo~...} an. Daraufhin erscheint
die GEM-Dateiauswahlbox mit der Aufforderung \field{Locate program
ZOO.TTP}\footnote{Sofern Sie mindestens TOS 1.4 besitzen, erscheint die
Aufforderung innerhalb der Dateiauswahlbox; falls Sie noch mit einer "alteren
TOS-Version arbeiten, wird er in der Men"uzeile angezeigt.}. Jetzt gehen Sie
mit der Dateiauswahlbox in der Ordner, in dem sich {\tt ZOO.TTP} befindet,
selektieren {\tt ZOO.TTP} und klicken auf \button{OK}. Ab jetzt wei"s
{\Arcgsh}, wo {\tt ZOO.TTP} zu finden ist.

"Uber den Men"upunkt \menu{Configure pager ...} w"ahlen Sie ein Programm
aus, das Sie zum Ansehen von Dateien nutzen wollen (Pager). Entsprechend
wird mit \menu{Configure editor ...} ein Editor ausgew"ahlt.

{\bf Beispiel:} Nehmen wir an, sie wollen 1st Word Plus (Dateiname {\tt
WORDPLUS.PRG}) als Ihren Editor konfigurieren. Wenn Sie \menu{Configure
editor ...} selektieren, erscheint eine Dialogbox und --- falls Sie bis
jetzt noch keinen Editor ausgew"ahlt hatten --- unmittelbar darauf die
GEM-Dateiauswahlbox mit der Aufforderung \field{Locate user-defined editor}.
An der ersten Zeile der Auswahlbox sehen Sie, da"s nur Dateien mit dem Namen
{\tt EDITOR.PRG} angezeigt werden. Das ist zur Auswahl von {\tt WORDPLUS.PRG}
nat"urlich nicht geeignet. Sie "andern daher {\tt EDITOR.PRG} ab in {\tt
WORDPLUS.PRG} (oder in {\tt *.*}, um alle Dateien zu sehen).  Die Auswahlbox
zeigt nun alle Dateien mit dem Namen {\tt WORDPLUS.PRG} an, und Sie k"onnen
durch Ihr Dateisystem navigieren und {\tt WORDPLUS.PRG} selektieren, wie
oben f"ur {\tt ZOO.TTP} beschrieben.

Nachdem Sie den Editor ausgew"ahlt haben, k"onnen Sie das Kommando noch
modifizieren, mit dem {\Arcgsh} den Editor aufruft. Die Voreinstellung ist
so gew"ahlt, da"s der Editor mit nur einem Parameter aufgerufen wird:  dem
Namen der Datei, die editiert werden soll. Dieser Dateiname wird durch durch
{\tt \%f} im Feld \field{Parameters ...} repr"asentiert. Nehmen wir an, Sie
wollen au"serdem die Optionen {\tt -l} und {\tt -w} an den Editor
"ubergeben.  Um das zu erreichen, brauchen Sie nur das Feld \field{Parameters
...} in  {\tt -l~-w~\%f} abzu"andern.

Nat"urlich wollen Sie nicht jedesmal, wenn Sie {\Arcgsh} starten, die
verwendeten Programme wieder neu lokalisieren. Vielmehr k"onnen diese
Informationen auf Diskette bzw. Festplatte gespeichert werden. Klicken Sie
dazu den Men"upunkt \menu{Save configuration} an!  {\Arcgsh} legt daraufhin
die Datei {\tt ARCGSH.CFG} im gleichen Ordner wie {\tt ARCGSH.PRG} an und
speichert darin alle n"otigen Informationen.



\subsection{Das "`Utilities"'-Men"u}

\begin{tabular}{@{}lll@{}l@{}l@{}}
\hline
\vline {\sf ~ARCGSH~} & {\sf ~File~} & {\sf ~Configuration~} & {\sf ~Utilities~} & {\sf ~Options~} \hfill \vline\\
\hline
& & & \vline {\sf ~Copy~file~...~}     \hfill \vline &\\
& & & \vline {\sf ~Move~file~...~}     \hfill \vline &\\
& & & \vline {\sf ~Delete~file~...~}   \hfill \vline &\\
\cline{4-4}
& & & \vline {\sf ~Create~folder~...~} \hfill \vline &\\
& & & \vline {\sf ~Delete~folder~...~} \hfill \vline &\\
\cline{4-4}\\
\end{tabular}

{\Arcgsh} besitzt einige sehr simple Funktionen f"ur einfache
Dateioperationen: Dateien kopieren, verschieben\footnote{Kopieren und
L"oschen des Originals} und l"oschen sowie Ordner erzeugen und l"oschen.
Datei- bzw.  Ordnernamen werden "uber die Dateiauswahlbox erfragt.

\begin{description}

\item[\menu{Copy file}, \menu{Move file}:]  Diese Funktionen erfragen mit
Hilfe der Dateiauswahlbox den Namen der Datei, die kopiert oder verschoben
werden soll. Anschlie"send wird --- ebenfalls mit der Dateiauswahlbox ---
nach dem Namen der Zieldatei gefragt. (Wie gesagt, sehr simpel.)

Falls die Datei in einen anderen Ordner kopiert oder verschoben werden soll,
aber ansonsten den gleichen Namen behalten soll, reicht es aus, statt des
kompletten Dateinamens nur den Zielordner zu spezifizieren. Bewegen Sie dazu
die Auswahlbox in den Zielordner und klicken Sie \button{OK}! Sie brauchen
keinen Dateinamen anzuklicken oder einzutippen.

Durch \menu{Copy file} und \menu{Move file} werden sowohl Erstellungsdatum
und -uhrzeit der Originaldatei als auch die "ubrigen Dateiattribute
(Schreib-Lese-Zugriff oder Nur-Lese-Zugriff usw.) "ubernommen.

Noch ein Wort zur \menu{Move file}-Funktion: Das Verschieben einer Datei in
einen anderen Ordner auf {\bf demselben} Laufwerk (Diskette oder
Festplattenpartition) l"auft sehr effizient ab, da der Dateiinhalt selbst
nicht kopiert werden mu"s.\footnote{Es wird die GEMDOS-Funktion {\tt Frename}
verwendet.}

\item[\menu{Delete file}, \menu{Create folder}, \menu{Delete folder}:] Diese
Funktionen f"uhren das aus, was ihr Name angibt:

\begin{quote}
\begin{tabular}{ll}
\menu{Delete file}   & L"oschen einer Datei \\
\menu{Create folder} & Anlegen eines Ordners \\
\menu{Delete folder} & L"oschen eines (leeren) Ordners \\
\end{tabular}
\end{quote}

Mit Hilfe der GEM-Dateiauswahlbox wird jeweils nach dem Datei- bzw.
Ordnernamen gefragt.

\end{description}



\subsection{Das "`Options"'-Men"u}\label{Options-Menue}

\begin{tabular}{@{}llll@{}l@{}}
\hline
\vline {\sf ~ARCGSH~} & {\sf ~File~} & {\sf ~Configuration~} & {\sf ~Utilities~} & {\sf ~Options~} \hfill \vline\\
\hline
& & & & \vline {\sf ~Show~command~line~}     \hfill \vline \\
& & & & \vline {\sf ~Hold upon termination~} \hfill \vline \\
& & & & \vline {\sf ~Beep upon termination~} \hfill \vline \\
\cline{5-5}
& & & & \vline {\sf ~Repeat last dialog~}    \hfill \vline \\
& & & & \vline {\sf ~Zoom boxes~}            \hfill \vline \\
\cline{5-5}\\
\end{tabular}

Mit Hilfe dieses Men"us k"onnen Sie steuern, wie {\Arcgsh} sich beim
Ausf"uhren eines gerufenen Programms --- z.\,B. eines Archivierer ---
verhalten soll. Alle Optionen k"onnen entweder {\bf gesetzt} oder {\bf nicht
gesetzt} sein. Eine gesetzte Option kann man an einem H"akchen im
Men"ueintrags links neben dem Optionstext erkennen. Die Optionen haben
folgende Bedeutungen:

\begin{description}

\item[\menu{Show command line}:] Wenn diese Option gesetzt ist, zeigt
{\Arcgsh} die Kommandozeile an, die zum Aufruf des gerufenen Programms
verwendet wird. Diese Option wird bei Programmen mit den Endungen {\tt .PRG}
oder {\tt .APP} ignoriert.

\item[\menu{Hold upon termination}:] Wenn diese Option gesetzt ist, zeigt
{\Arcgsh} nach Beendigung eines gerufenen Programms nicht sofort wieder den
{\Arcgsh}-Desktop an, sondern l"a"st den Bildschirminhalt stehen, bis Sie
eine beliebige Taste oder den linken Mausknopf dr"ucken. Dieses Verhalten
ist sinnvoll, wenn Sie die Bildschirmausgaben des gerufenen Programms sehen
wollen.  Diese Option wird bei Programmen mit den Endungen {\tt .PRG} oder
{\tt .APP} ignoriert.

\item[\menu{Beep upon termination}:] Wenn diese Option gesetzt ist, ert"ont
bei Beendigung eines gerufenen Programms ein akustisches Signal. Das ist
sinnvoll bei l"anger laufenden Programmen, bei denen man nicht st"andig auf
den Bildschirm starren will, um mitzubekommen, wann das Programm fertig ist.

\item[\menu{Repeat last dialog}:] Wenn diese Option gesetzt ist, zeigt
{\Arcgsh} nach Ausf"uhrung einer bestimmten Funktion automatisch sofort
wieder diejenige Dialogbox an, "uber die die gerade ausgef"uhrte Funktion
aufgerufen wurde. Dieses Verhalten ist besonders dann n"utzlich, wenn ein
bestimmter Archivierer mehrmals hintereinander aufgerufen werden soll. Durch
\button{Cancel} wird das wiederholte Anzeigen der Dialogbox beendet.

\item[\menu{Zoom boxes}:] Wenn diese Option gesetzt ist, wird beim "Offnen
eines Fensters eine sich vergr"o"sernde Box gezeichnet und eine sich
verkleinernde Box, wenn es geschlossen wird.  Wenn Sie diese Option
r"ucksetzen, werden die Zoom-Boxen nicht gezeichnet, und die Dialogboxen
erscheinen ein wenig schneller auf dem Bildschirm.

\end{description}

Die aktuellen Optionen k"onnen mit \menu{Save configuration} im
\menu{Configuration}-Men"u abgespeichert werden.




\section{Aufruf der Archivierer}\label{Aufruf der Archivierer}

Der Aufruf der Archivierer l"auft einheitlich nach dem gleichen Muster ab:
Zun"achst selektieren Sie den gew"unschten Archivierer aus dem
\menu{File}-Men"u, worauf eine speziell f"ur diesen Archivierer entworfene
Dialogbox angezeigt wird. Sie k"onnen dann die Archiviererparameter durch
Anklicken von Kn"opfen, Eingeben von Dateinamen per Auswahlbox oder Tastatur
usw.  spezifizieren. Nachdem Sie alle Parameter eingestellt haben, klicken
Sie auf \button{OK}. Daraufhin l"oscht {\Arcgsh} den Bildschirm und startet
das Programm mit Ihren Parametern.\footnote{Die Parameter"ubergabe an einen
Archivierer oder "uberhaupt an ein gerufene Programm kann auf
unterschiedlichem Weg erfolgen. Einzelheiten finden Sie in Kapitel
\ref{Parameteruebergabe an gerufene Programme} (Seite
\pageref{Parameteruebergabe an gerufene Programme}).} Sollten Sie es sich
anders "uberlegt haben und den Archivierer nicht starten wollen, klicken Sie
auf \button{CANCEL}.

Im folgenden werden wir die verschiedenen Archivierer anhand einiger
Beispiele etwas n"aher betrachten. Allerdings: Dies ist ein {\Arcgsh}-
und kein Archivierer-Manual. Ich rate dazu, unbedingt die jeweilige
originale Archivierer-Dokumentation zu lesen!




\subsection{Zoo}\label{Zoo}

{\Zoo} ist der Archivierer, der Ihnen die meisten M"oglichkeiten bietet.
{\Arcgsh} arbeitet mit der {\zoo}-2.1-Portierung f"ur den Atari-ST von Bill
Shroka zusammen.



\subsubsection{Alle Dateien aus einem zoo-Archiv extrahieren}

Als ersten Beispiel wollen wir eine {\zoo}-Archivdatei komplett auspacken.
Der Name des Archivs soll {\tt EX1.ZOO} sein.

Nachdem wir den Men"ueintrag \menu{Zoo ...} aus dem \menu{File}-Men"u
selektiert haben, erscheint die {\zoo}-Dialogbox, und wir k"onnen
{\zoo}-Parameter eingeben. Der erste dieser Parameter ist der Name des
{\zoo}-Archivs; er kann mit der GEM-Dateiauswahlbox, die automatisch
erscheint, selektiert werden. Wir positionieren die Auswahlbox in den
Ordner, der {\tt EX1.ZOO} enth"alt und selektieren diese Datei. Die
Auswahlbox verschwindet, und der Name der Archivdatei wird im
\field{Archive}-Feld angezeigt.

Zum Extrahieren aller Dateien aus einem Archiv selektieren wir
\button{e~~extract files}. Sie werden bemerken, das daraufhin auf der
rechten Seite der Dialogbox eine ganze Reihe \field{Zoo modifiers}
erscheinen. Durch diese Modifikatoren k"onnen wir {\zoo}s Verhalten beim
Auspacken beeinflussen.

Wir verwenden jetzt noch keinen Modifikator, sondern klicken einfach auf
\button{OK}. {\Zoo} wird gestartet, extrahiert jede einzelne Datei aus dem
Archiv und schreibt sie in den gleichen Ordner, in dem sich {\tt EX1.ZOO}
befindet.



\subsubsection{Einzelne Dateien aus einem zoo-Archiv extrahieren}

Nun wollen wir nicht {\bf alle} Dateien aus {\tt EX1.ZOO} extrahieren,
sondern nur diejenigen mit einem bestimmten Namen oder Namensbestandteil,
z.\,B.  alle mit der Endung {\tt .C}.

"Uber den Men"ueintrag \menu{Zoo ...}\ rufen wir erneut die {\zoo}-Dialogbox
auf. Durch den vorigen Aufruf ist das {\zoo}-Archiv noch immer selektiert
und die GEM-Dateiauswahlbox erscheint diesmal nicht. Die zu extrahierenden
Dateien geben wir im Feld \field{Filename} an: Bewegen Sie die Schreibmarke
mit den Cursor-Tasten auf dieses Feld, geben Sie {\tt *.C} ein und klicken
Sie auf \button{OK}.

In vielen F"allen ist es ausreichend, die zu extrahierenden Datei im
\field{Filename}-Feld anzugeben. Wenn Sie jedoch mehrere Dateien oder
Auswahlmuster spezifizieren wollen, klicken Sie auf \button{more files...}.
Daraufhin erscheint eine weitere Dialogbox, der Dateiauswahlmanager. Hier
steht Ihnen eine ganze Reihe von Feldern zur Verf"ugung, in die Sie
Dateinamen eingeben k"onnen. Dar"uber hinaus k"onnen Sie die Standardeingabe
und -ausgabe umlenken sowie einen aktuellen Ordner f"ur {\zoo} festlegen.
Eine genaue Beschreibung des Dateiauswahlmanagers finden Sie im Abschnitt
\ref{Der Dateiauswahlmanager} (Seite \ref{Der Dateiauswahlmanager}).



\subsubsection{Extrahieren aus einem zoo-Archiv in einen anderen Ordner}

In den obigen Beispielen wurden die ausgepackten Dateien immer in demjenigen
Ordner angelegt, in dem sich das Archiv selbst befand. Jetzt wollen wir die
Dateien beim Auspacken in einen anderen Ordner schreiben.

{\Zoo} kennt W"ahrend seiner Ausf"uhrung einen {\bf aktuellen Ordner} oder
auch {\bf Arbeitsordner}. Dateien ohne Laufwerks- und Pfadangabe\footnote{In
{\tt A:$\backslash$FOO$\backslash$BAR$\backslash$EX1.ZOO} ist {\tt
A:$\backslash$} die Laufwerksangabe und {\tt FOO$\backslash$BAR$\backslash$}
die Pfadangabe.} werden relativ zu diesem Ordner adressiert. Wenn {\zoo}
Dateien extrahiert, werden diese (normalerweise) relativ zum aktuellen
Ordner angelegt.\footnote{Der Spezialfall, Dateien mit einem absoluten Pfad
(ohne Laufwerksangabe) in einem Archiv abzulegen, sollte vermieden werden.}
Die Voreinstellung f"ur den Arbeitsordner ist der Ordner, in dem sich das
Archiv befindet. Wenn wir Dateien aus dem Archiv in einen anderen Ordner
hinein auspacken wollen, m"ussen wir den Arbeitsordner "andern.  Dies
erreichen wir, indem wir zun"achst auf den Knopf \button{more files...} in
der {\zoo}-Dialogbox klicken und den Dateiauswahlmanager aufrufen.

An dieser Stelle interessiert uns nur das Feld \field{Working directory}.
Wir klicken dieses Feld an, die GEM-Dateiauswahlbox taucht auf, wir bewegen
sie {\bf in} denjenigen Ordner {\bf hinein,} in dem die ausgepackten Dateien
angelegt werden sollen, und klicken auf \button{OK}. 

Ein weiterer Klick auf \button{OK} im Dateiauswahlmanager bringt ihn zum
Verschwinden. Jetzt k"onnen wir wie oben beschrieben fortfahren.



\subsubsection{Dateien in ein zoo-Archiv aufnehmen}

Zum Aufnehmen von Dateien in ein bereits bestehendes oder neu anzulegendes
{\zoo}-Archiv selektieren wir \button{a~~add~files}. Wenn das {\zoo}-Archiv
noch nicht existiert, wird es angelegt. Die Dateien, die in das Archiv
aufgenommen werden sollen, k"onnen mit Hilfe von "`Wildcards"'
(Dateiauswahlmustern) im Feld \field{Files} oder im Dateiauswahlmanager
spezifiziert werden. Wenn z.\,B. alle Dateien mit der Endung {\tt .C}
archiviert werden sollen, gehen Sie mit der Dateiauswahlbox in den
entsprechenden Ordner, geben {\tt *.C} ein und klicken auf \button{OK}.

Seit Version 2.1 kann {\zoo} Dateien mit einer neuen Packmethode
komprimieren, der sogenannten "`high performance compression"', die zu
deutlich kleineren Archivdateien f"uhrt. {\Zoo} verwendet die "`high
performance compression"' allerdings nicht automatisch, sondern Sie m"ussen
dazu den {\zoo}-Modifikator \button{h~~high performance compression}
selektieren.

Wenn Sie Dateien mit der GEM-Dateiauswahlbox selektieren, erhalten Sie immer
den vollen Namen einschlie"slich Laufwerkskennung und Ordnerbezeichnung. In
den meisten F"allen ist es allerdings weder erw"unscht noch sinnvoll, eine
Datei mit ihrem kompletten Pfadnamen zu archivieren. Nehmen wir einmal an,
Sie h"atten einen Ordner {\tt BRIEFE} irgendwo tief unten in ihrem
Dateisystem und wollten alle diese Briefe in einem {\zoo}-Archiv {\tt
BRIEFE.ZOO} ablegen.  Vermutlich wollen Sie sie im Archiv nur unter ihren
eigentlichen Dateinamen speichern, z.\,B. {\tt THOMAS.DOC, SUSI.DOC} und
{\tt ANNETTE.DOC}, und nicht unter den vollen Pfadnamen.

Nun, {\Arcgsh} denkt genauso und versucht, zu raten, was wohl der beste
Arbeitsordner f"ur einen {\zoo}-Lauf sein k"onnte. Oben haben wir ja gesagt,
da"s {\zoo} auf Dateien ohne absolute Pfadbezeichnung relativ zu seinem
Arbeitsordner zugreift. Das gilt nat"urlich auch beim {\bf Aufnehmen} von
Dateien in ein Archiv. Im obigen Beispiel w"urde {\Arcgsh} als
{\zoo}-Arbeitsordner automatisch den Ordner mit den Briefen, also {\tt
...$\backslash$BRIEFE}, verwenden, sofern Sie als aufzunehmende Dateien {\tt
...$\backslash$BRIEFE$\backslash$*.*} angegeben haben.

Wie geht {\Arcgsh} nun vor, um einen geeigneten Arbeitsordner zu finden?
Zun"achst betrachtet {\Arcgsh} alle Dateinamen, die mit ihrem vollst"andigen
Pfadnamen (also mit Laufwerkskennung und Pfadbezeichnung) angegeben wurden,
und bestimmt deren gemeinsamen Pr"afix. Beispielsweise besitzen die Dateien
{\tt A:$\backslash$FOO$\backslash$FILE1, A:$\backslash$FOO$\backslash$FILE2}
und {\tt A:$\backslash$FOO$\backslash$BAR$\backslash$FILE1} den gemeinsamen
Pr"afix {\tt A:$\backslash$FOO$\backslash$}. Diesen gemeinsamen Pr"afix
w"ahlt {\Arcgsh} als Arbeitsordner f"ur {\zoo}. Die einzelnen Dateinamen
werden {\zoo} dann ohne den Pr"afix "ubergeben. In unserem Beispiel wirkt
sich das so aus, da"s die Dateien im Archiv als {\tt FILE1, FILE2} und {\tt
BAR$\backslash$FILE1} abgespeichert werden.

Allerdings ist dieser Mechanismus nicht immer geeignet. Nehmen wir an, wir
wollen alle Dateien im Ordner {\tt A:$\backslash$FOO$\backslash$BAR}
archivieren, aber so, da"s der Ordnername {\tt BAR} vor dem eigentlichen
Dateinamen erhalten bleibt. Dies k"onnen wir erreichen, indem wir im
Dateiauswahlmanager explizit einen Arbeitsordner bestimmen. Im Beispiel
setzen wir den Arbeitsordner auf {\tt A:$\backslash$FOO$\backslash$} und
geben als zu archivierende Dateien {\tt BAR$\backslash$*.*} an.  {\bf Immer
dann, wenn der Benutzer selbst einen Arbeitsordner festgelegt hat, l"a"st
{\Arcgsh} alle Dateinamen exakt so, wie Sie sie angegeben haben.}



\subsubsection{Archivieren eines kompletten Dateisystems mit {\zoo}}

Ein vollst"andiges Dateisystem wird mit Hilfe des {\zoo}-Modifikators
\button{//~~create dirs $|$ add complete dirs} archiviert. Dieser
Modifikator ist in der {\zoo}-Originalversion (noch) nicht enthalten,
sondern nur in der Atari-Portierung. Er wird beim Archivieren mit
\button{a~~add~files} angegeben und bewirkt folgendes: Wenn es sich bei
einer zu archivierenden Datei um einen Ordner handelt, werden
rekursiv\footnote{{\bf Rekursiv} bedeutet hier, da"s s"amtliche Unterordner
archiviert werden, alle darin enthaltenen Unter-Unterordner usw.} alle darin
enthaltenen Dateien und Unterordner archiviert.

Wenn \button{//~~create dirs $|$ add complete dirs} nicht selektiert ist,
werden Ordner von {\zoo} "ubergangen.



\subsubsection{Zoo-Modifikatoren}

Die Wirkungsweise von {\zoo}-Kommandos kann durch die {\bf
{\zoo}-Modifikatoren} beeinflu"st werden. Wenn ein bestimmtes {\zoo}-Kommando
ausgew"ahlt wurde, werden rechts in der Dialogbox die zu diesem Kommando
geh"orenden Modifikatoren angezeigt.

Im Prinzip k"onnen Sie jede beliebige Kombination von Modifikatoren w"ahlen;
allerdings gibt es F"alle, in denen sich einzelne Modifikatoren gegenseitig
ausschlie"sen oder aber entweder zusammen oder "uberhaupt nicht angegeben
werden m"ussen. {\Arcgsh} selbst "uberpr"uft die semantische Korrektheit der
Modifikatoren nicht, sondern "uberl"a"st {\zoo} diese Aufgabe.

Unter den Modifikatoren besitzt das Feld \field{Numbers} eine spezielle
Bedeutung. Hier k"onnen Sie numerische {\zoo}-Parameter spezifizieren. Dies
ist im Zusammenhang mit Generations-Limits und fehlerhaften Archiven
wichtig. Einzelheiten entnehmen Sie bitte dem {\zoo}-Reference-Manual.



\subsubsection{Das TMPDIR-Feld}

Im Feld \field{TMPDIR} k"onnen Sie einen Ordner spezifizieren, in dem {\zoo}
w"ahrend des Packens eines Archivs tempor"are Dateien anlegt.\footnote{Der
Inhalt des \field{TMPDIR}-Feldes wird {\zoo} in der Environment-Variablen
TMPDIR "ubergeben.} Dieser Ordner sollte auf einem schnellen Medium liegen,
z.\,B. auf einer RAM-Disk oder Festplatte.



\subsection{Arc}

{\Arcgsh} arbeitet mit {\arc} 6.02 zusammen. Es ist auch m"oglich, {\arc}
5.21 zu verwenden, da die wirklich wichtigen Funktionen auch hier vorhanden
sind.

Die {\arc}-Dialogbox erscheint, wenn Sie im \menu{File}-Men"u den Men"upunkt
\menu{Arc~...} anklicken. Der Umgang mit dieser Dialogbox ist "ahnlich dem
mit der {\zoo}-Dialogbox --- er ist sogar einfacher. Aus diesem Grund ist
die Anleitung in diesem Kapitel wesentlich knapper gefa"st. Falls Sie also
irgendwo Verst"andnisschwierigkeiten haben sollten, k"onnen Sie den
entsprechenden Absatz in der {\zoo}-Anleitung in Kapitel \ref{Zoo} (ab Seite
\pageref{Zoo}) nachlesen.



\subsubsection{Alle Dateien aus einem arc-Archiv extrahieren}

\begin{itemize}

\item Selektieren Sie das Archiv, das ausgepackt werden soll (Endung {\tt
.ARC}), im \field{Archive}-Feld.

\item Selektieren Sie \button{Extract} im Feld \field{Arc commands}.

\item Bei Bedarf selektieren Sie eine oder mehrer Optionen aus dem Feld
\field{Arc options}.

\item Klicken Sie auf \button{OK}. {\tt ARC.TTP} wird aufgerufen und
extrahiert alle archivierten Dateien in denselben Ordner hinein, in dem sich
auch das Archiv befindet.

\end{itemize}



\subsubsection{Einzelne Dateien aus einem arc-Archiv extrahieren}

Wenn Sie nicht alle, sondern nur einzelne Dateien aus einem Archiv
extrahieren wollen, m"ussen Sie die Namen der auszupackenden Dateien
angeben. Dazu k"onnen Sie das Feld \field{Filename} verwenden oder --- durch
Anklicken von \button{more~files...} --- den Dateiauswahlmanager aufrufen.

Dateinamen k"onnen mit Hilfe von Auswahlmustern (Wildcards) angegeben
werden. Beispielsweise kann man als Dateinamen {\tt *.C} angeben, um alle
Dateien mit der Endung {\tt .C} zu extrahieren. Dadurch ist es nicht n"otig,
alle diese Dateien einzeln zu spezifizieren, z.\,B. {\tt FOO.C, BAR.C} usw.



\subsubsection{Extrahieren aus einem arc-Archiv in einen anderen Ordner}

Zum Extrahieren in einen anderen Ordner m"ussen Sie zus"atzlich zu den oben
angegebenen Schritten den Zielordner festlegen.

Eine M"oglichkeit dazu bietet das Feld \field{Working directory} im
Dateiauswahlmanager. Alternativ k"onnen Sie die Namen der zu extrahierenden
Dateien mit einer kompletten Pfadangabe einschlie"slich Laufwerkskennung
angeben. So k"onnen Sie beispielsweise {\tt
A:$\backslash$FOO$\backslash$BAR} als Arbeitsordner und {\tt *.C} als zu
extrahierende Dateien angeben oder aber einfach {\tt
A:$\backslash$FOO$\backslash$BAR$\backslash$*.C} als zu extrahierende
Dateien spezifizieren.



\subsubsection{Dateien in einem arc-Archiv archivieren}

Selektieren Sie \button{Add}, um Dateien in ein {\arc}-Archiv aufzunehmen.
Wenn das Archiv noch nicht existiert, wird es angelegt. Die Dateien, die
archiviert werden sollen, k"onnen auch "uber Wildcards spezifiziert werden.
{\Arc} speichert Dateien immer {\bf ohne} Laufwerks- und Pfadangaben,
gleichg"ultig, was Sie angegeben haben.



\subsubsection{Archivieren eines kompletten Dateisystems}

Das Archivieren von Unterordnern ist erst ab {\arc}-Version 6.02 m"oglich.
Wenn Sie die Option \button{Include subdirectories} selektieren, wird ein
{\bf kompletter} Dateibaum mit allen Unterordnern in das Archiv aufgenommen.
Der Ordner, der archiviert werden soll, wird wie ein normaler Dateiname
angegeben. {\bf Achtung:} {\Arc} erlaubt nicht, nur einzelne Dateien aus
einem Unterordner zu archivieren. Ebenso k"onnen Sie einen archivierten
Ordner nur komplett mit allen Dateien extrahieren.



\subsubsection{Das ARCTEMP-Feld}

Im Feld \field{ARCTEMP} k"onnen Sie einen Ordner spezifizieren, in dem
{\arc} tempor"are Dateien anlegt.\footnote{Der Inhalt des
\field{ARCTEMP}-Feldes wird {\arc} in der Environment-Variablen ARCTEMP
"ubergeben.} Dieser Ordner sollte auf einem schnellen Medium liegen, z.\,B.
auf einer RAM-Disk oder Festplatte.




\subsection{LHarc}\label{LHarc}

Wenn Sie mit {\lharc} arbeiten wollen, sollten Sie sich auf eine Reihe von
Problemen einstellen:

\begin{itemize}

\item Das Format von {\lharc}-Archivdateien\footnote{{\lharc}-Archives sind
an ihrer Endung {\tt .LZH} zu erkennen.} ist nicht einheitlich. Ich selbst
habe mindestens drei verschiedene inkompatible {\lharc}-Archivformate
kennengelernt. Die Lage ist noch schlimmer, wenn Sie {\lharc}-Archive mit
anderen Computersystemen --- z.\,B. UNIX-Rechnern --- austauschen wollen.

\item Es ist eine ganze Menge von Programmen mit dem Namen {\tt LHARC.TTP}
verf"ugbar. Sie haben verschiedene Kommandos, verschiedene Optionen,
verschiedene Kommandozeilenformate, und das {\tt LHARC.TTP}, das Sie
besitzen, k"onnte sich als ungeeignet erweisen, um ein bestimmtes
{\lharc}-Archiv zu entpacken.

\item Die meisten {\lharc}-Implementierungen sind nicht gerade schnell.

\end{itemize}



\subsubsection{Vordefinierte LHarc-Konfigurationen}

Das erste, das Sie zum Arbeiten mit {\lharc} tun sollten, ist {\Arcgsh} so
zu konfigurieren, da"s es auf das {\lharc}-Programm abgestimmt ist, das Sie
benutzen m"ochten. {\Arcgsh} mu"s wissen, welche {\lharc}-Kommandos und
-Options verwendet werden, um bestimmte Aktionen auszul"osen. Da diese
Angaben von {\lharc} zu {\lharc} unterschiedlich sind, kann {\Arcgsh} dazu
leider keine allgemeing"ultigen Vorgaben machen.

Damit Sie es leichter haben, kennt {\Arcgsh} jedoch bereits eine ganze Reihe
von {\lharc}s und besitzt daf"ur vorgegebene Konfigurationsinformationen. In
der {\lharc}-Dialogbox --- sie wird angezeigt, wenn Sie den Men"upunkt
\menu{LHarc ...}\ selektieren --- sehen Sie auf der rechten Seite im Feld
\field{LHarcs} diejenigen {\lharc}s, die {\Arcgsh} bereits bekannt sind.
Sofern "`Ihr"' {\lharc} dabei ist, klicken Sie auf den entsprechenden Knopf,
und {\Arcgsh} stellt sich entsprechend ein. Mittels \menu{Save
configuration} im
\menu{Configuration}-Men"u k"onnen Sie die gew"ahlte Einstellung in
{\Arcgsh}s Konfigurationsdatei abspeichern.

In der {\lharc}-Dialogbox k"onnen --- je nach dem, f"ur welches {\lharc} Sie
{\Arcgsh} konfiguriert haben --- nur eine Auswahl der Kommandos und Optionen
selektiert werden. Diejenigen, die nicht selektiert werden k"onnen, sind
grau dargestellt.



\subsubsection{Erstellen einer eigenen lharc-Konfiguration}

Wenn das von Ihnen verwendete {\lharc} mit keiner der vorgegebenen
Konfigurationen zusammenarbeitet, wird die Sache etwas aufwendiger. In
diesem Fall m"ussen Sie zun"achst herausfinden, welche {\lharc}-Kommandos
welche Aktionen ausl"osen, z.\,B. ein "`a"' wie "`add"', um Dateien in ein
Archiv aufzunehmen. Diese Informationen sollte in der Dokumentation zu Ihrem
{\lharc} zu finden sein. Alternativ Sie k"onnen auch versuchen, {\lharc}
ohne Parameter aufzurufen, beispielsweise "uber die {\Arcgsh}-Funktion
\menu{Other program}. Viele {\lharc}s geben dann einen Hilfstext mit den
verf"ugbaren Kommandos aus.

Mit dieser Liste von Kommandos und Optionen bewaffnet rufen Sie
\menu{LHarc~...} im \menu{File}-Men"u auf und selektieren \button{Edit}.
Daraufhin werden s"amtliche Texte in den Feldern \field{LHarc commands} und
\field{LHarc options} schwarz. Jetzt k"onnen Sie zu den einzelnen
Beschreibungen der Kommandos und Optionen angeben, welcher Text (in der
Regel ein einzelner Buchstabe) an {\lharc} "ubergeben werden soll, um die
jeweilige Aktion auszul"osen. Jeder Eintrag verf"ugt dazu "uber ein
editierbares Textfeld.  Bei Kommandos oder Optionen, die Ihr {\lharc} nicht
unterst"utzt, sollten Sie den Inhalt des Textfeldes l"oschen. Das Feld
\field{option separator} besitzt eine besondere Bedeutung: Bei der
Parameter"ubergabe an {\lharc} wird dieser String jeder einzelnen
spezifizierten Option vorangestellt.

Nachdem Sie alle Einstellungen vorgenommen haben, klicken Sie erneut auf
\button{Edit}.  Die Textfelder k"onnen nun nicht mehr editiert werden, und
die nicht verf"ugbaren Kommandos und Optionen werden in grauer Schrift
angezeigt. Mittels \menu{Save configuration} im \menu{Configuration}-Men"u
k"onnen Sie die gew"ahlte Einstellung in {\Arcgsh}s Konfigurationsdatei
abspeichern.




\subsection{Shar}

Unter dem Betriebssystem UNIX gibt es sogenannte Shell-Archive. Sie werden
vom Programm {\shar} angelegt und enthalten in der Regel reine Textdateien.
Zum Auspacken solcher Archive wird die Bourne-Shell {\em /bin/sh\/}
verwendet. Das ist auf dem Atari ST unter TOS nat"urlich nicht m"oglich. Aus
diesem Grund habe ich ein eigenes {\shar}-Programm f"ur den ST
zusammengestellt, das auch einen "`unshar"'-Modul enth"alt.

Die {\shar}-Dialogbox erscheint, wenn Sie den Men"ueintrag \menu{Shar ...}
im \menu{File}-Men"u anw"ahlen. Sie besteht aus folgenden Feldern:

\begin{description}

\item[\field{Archive}:] Hier wird der Name des {\shar}-Archivs angegeben.
Die voreingestellte Endung ist {\tt .SH}, aber Sie k"onnen sie nach Belieben
"andern.

\item[\button{Create}, \button{extract}, \button{overwrite}:] W"ahlen Sie
aus, ob sie ein neues Shell-Archiv erzeugen wollen {\bf (create)} (das ist
die Voreinstellung), oder ob Sie ein bestehendes Archiv auspacken m"ochten
{\bf (extract)}. {\bf Overwrite} funktioniert "ahnlich wie {\bf extract},
"uberschreibt aber bereits bestehende Dateien.

\item[\field{Filename}:] Dateien, die in das Shell-Archiv aufgenommen werden
sollen, werden hier oder im Dateiauswahlmanager angegeben. Es ist auch
m"oglich, Ordnernamen anzugeben; dabei ist aber darauf zu achten, da"s diese
Namen am Ende keinen Backslash ({\tt $\backslash$}) haben.

\item[\button{more files ...}:] Wenn Sie dieses Feld anklicken, wird der
Dateiauswahlmanager aufgerufen. Das ist besonders beim Entpacken eines
Shell-Archivs wichtig, da Sie dabei einen Arbeitsordner angeben m"ussen.
Dateien ohne eine absolute Pfadspezifikation werden in diesen Ordner
geschrieben.

\item[\button{clear ...}:] l"oscht alle Eintr"age im Dateiauswahlmanager.

\item[\field{Shar options}:] Hier k"onnen Sie {\shar}-Optionen ausw"ahlen.
Einzelheiten dazu finden Sie in Ihrer {\shar}-Dokumentation.

\end{description}



\subsection{Tar}\label{Tar}

Weit verbreitet in der UNIX-Welt sind auch {\tar}-Archive, da {\tar}
standardm"a"sig zu jeder UNIX-Implementierung geh"ort. {\Tar} steht f"ur
"`{\bf T}ape {\bf Ar}chive"' und wird dazu verwendet, ganze Directory-B"aume
in einer einzelnen Datei (z.\,B. auf Magnetband) abzuspeichern. Ein
Datenkompression wird dabei zwar nicht durchgef"uhrt, doch besteht die
M"oglichkeit, die erzeugte {\tar}-Datei mittels {\compress} (siehe Kapitel
\ref{Compress} auf Seite \pageref{Compress}) nachtr"aglich zu komprimieren.

{\Arcgsh} arbeitet mit GNUTAR zusammen, einer kostenlos verf"ugbaren
{\tar}-Version.

Hier eine Kurzanleitung f"ur die wichtigsten Funktionen:



\subsubsection{Inhalt eines tar-Archivs anzeigen}

\begin{enumerate}

\item W"ahlen Sie im \menu{File}-Men"u den Eintrag \menu{Tar...} aus.

\item Tragen Sie den Namen des {\tar}-Archivs in das Feld \field{Archive}
ein.

\item Selektieren Sie aus den \field{Tar commands} den Knopf
\button{t~~list}.

\item Klicken Sie auf \button{OK}. {\Tar} zeigt den Inhalt des Archivs an.

\end{enumerate}



\subsubsection{Tar-Archiv auspacken}

\begin{enumerate}

\item W"ahlen Sie im \menu{File}-Men"u den Eintrag \menu{Tar...} aus.

\item Tragen Sie den Namen des {\tar}-Archivs in das Feld \field{Archive}
ein.

\item Selektieren Sie aus den \field{Tar commands} den Knopf
\button{x~~extract}.

\item Gegebenenfalls w"ahlen Sie mit Hilfe des Dateiauswahlmanagers (Aufruf
durch \button{more files...}) einen Ordner aus, in den hinein das
{\tar}-Archiv ausgepackt werden soll. Ansonsten werden die Dateien in den
Ordner, in dem das Archiv steht, geschrieben.

\item Falls Sie nicht das gesamte Archiv auspacken wollen, k"onnen Sie im
Feld \field{Filename} und/oder mit Hilfe des Dateiauswahlmanagers angeben,
welche Dateien extrahiert werden sollen.

\item Klicken Sie auf \button{OK}. Jetzt wird {\tar} gestartet und packt das
Archiv aus. Dabei werden Directory-Strukturen nach Bedarf erzeugt.

\end{enumerate}



\subsubsection{Dateien in Tar-Archiv aufnehmen}

\begin{enumerate}

\item W"ahlen Sie im \menu{File}-Men"u den Eintrag \menu{Tar...} aus.

\item Tragen Sie den Namen des anzulegenden {\tar}-Archivs in das Feld
\field{Archive} ein.

{\bf Achtung:} Es wird immer ein neues {\tar}-Archiv angelegt. Eine evtl.
bereits bestehende Datei wird also "uberschrieben!

\item Selektieren Sie aus den \field{Tar commands} den Knopf
\button{c~~create}.

\item Geben Sie im Feld \field{Filename} und/oder mit Hilfe des
Dateiauswahlmanagers an, welche Dateien in das Archiv aufgenommen werden
sollen. {\Tar} archiviert stets komplette Directory-Strukturen, d.\,h., wenn
ein Ordner angegeben ist, wird er automatisch mit s"amtlichen Dateien und
Unterordnern aufgenommen.

\item Klicken Sie auf \button{OK}; {\tar} wird gestartet.

\end{enumerate}




\section{Compress}\label{Compress}

{\Compress} dient dazu, einzelne Dateien zu komprimieren oder zu
dekomprimieren. Es werden also nicht mehrere Dateien zu einem Archiv
zusammengepackt. Der umgekehrte Vorgang ist ebenfalls m"oglich, n"amlich das
Dekomprimieren einer komprimierten Datei.

Beim Komprimieren h"angt {\compress} an den urspr"unglichen Dateinamen den
Buchstaben {\tt .Z} an, soweit m"oglich als Endung. Bei der Dekomprimierung
wird das {\tt Z} wieder entfernt. Die folgenden Beispiele m"ogen das
verdeutlichen:

\begin{quote}
\begin{tabular}{l@{ $\longrightarrow$ }l@{ $\longrightarrow$ }ll}
{\bf Originaldatei} & {\bf komprimieren} & {\bf dekomprimieren} & \\
\cline{1-3}
FOO	& FOO.Z   & FOO    & \\
FOO.C   & FOO.CZ  & FOO.C  & \\
FOO.CC  & FOO.CCZ & FOO.CC & \\
FOO.CCC & FOO.CCZ & FOO.CC & $\leftarrow${\bf Achtung!} \\
\end{tabular}
\end{quote}

Bitte beachten Sie, da"s beim Komprimieren einer Datei mit einer Endung von
drei Zeichen das letzte Zeichen der Endung verlorengeht!

Falls eine Datei durch die Komprimierung nicht kleiner wird, bleibt sie
unver"andert --- nat"urlich auch ihr Name. Solche Dateien sind
beispielsweise bereits komprimierte oder sehr kleine Dateien.

{\Arcgsh} arbeitet mit der {\compress} 4.3-Portierung von Dale Schumacher
(dal@syntel.uucp) zusammen.



\subsection{Komprimieren einer Datei}

\begin{enumerate}

\item W"ahlen Sie im \menu{File}-Men"u den Eintrag \menu{Compress...} aus.

\item Geben Sie im Feld \field{Filename} und/oder mit Hilfe des
Dateiauswahlmanagers an, welche Dateien komprimiert werden sollen.

\item Achten Sie darauf, da"s im Feld \field{Compress options} der Knopf
\button{d~~decompress} nicht selektiert ist; deselektieren Sie ihn
gegebenenfalls.

\item Klicken Sie auf \button{OK}; {\compress} wird gestartet.

\end{enumerate}



\subsection{Dekomprimieren einer Datei}

\begin{enumerate}

\item W"ahlen Sie im \menu{File}-Men"u den Eintrag \menu{Compress...} aus.

\item Geben Sie im Feld \field{Filename} und/oder mit Hilfe des
Dateiauswahlmanagers an, welche Dateien dekomprimiert werden sollen.

\item Selektieren Sie im Feld \field{Compress options} den Knopf
\button{d~~decompress}.

\item Klicken Sie auf \button{OK}; {\compress} wird gestartet.

\end{enumerate}




\section{Uud und uue}\label{Uud und uue}

Das Programmpaar {\uud} und {\uue} erleichtern es, beliebige Dateien durch
Computernetze --- namentlich per Electronic Mail oder News --- zu
"ubertragen. Vielfach k"onnen n"amlich lediglich druckbare Zeichen und keine
Steuerzeichen "ubertragen werden. Au"serdem gibt es teilweise Beschr"ankungen
hinsichtlich der Dateigr"o"se.

{\Uue} nun liest eine Eingabedatei und erzeugt daraus eine oder mehrere
Ausgabedateien. Diese Dateien bestehen nur noch aus druckbaren Zeichen und
k"onnen problemlos per Mail oder News "ubertragen werden. Der Empf"anger
einer "`uukodierten"' Datei verwendet {\uud}, um die empfangenen Daten
wieder in die urspr"ungliche Datei zu konvertieren.

{\Arcgsh} arbeitet mit {\uud} 3.4 (25.11.1988) and {\uue} 3.1
(6.8.1987) zusammen.



\subsection{Uud}

\begin{description}

\item[\field{File to be uudecoded}:] Eine einzelne zu uudekodierende Datei
hat in der Regel die Endung {\tt .UUE}; die erste einer Folge von Dateien
die Endung {\tt .UAA}.

\item[\field{Source directory}, \field{Target directory}:] Wenn hier Ordner
angegeben wurden, liest {\uud} die Eingabedatei(en) aus dem Quellordner
("`source directory"') und schreibt die generierten Dateien in den Zielordner
("`target directory"').

\end{description}



\subsection{Uue}

Normalerweise erzeugt {\uue} aus einer Eingabedatei eine einzelne
Ausgabedatei mit der Endung {\tt .UUE}. Wenn allerdings der Knopf
\button{Generate multiple file output ...} selektiert ist, erzeugt {\uue}
{\bf mehrere} Ausgabedateien mit den Endungen {\tt .UAA, .UAB} bis maximal
{\tt .UZZ.} Die Anzahl der Zeilen, die {\uue} in eine Ausgabedatei schreibt,
k"onnen Sie folgenderma"sen "andern: Selektieren Sie zun"achst
\button{Generate ...} und klicken Sie dann das Feld mit der maximalen
Zeilenzahl an.  Jetzt k"onnen Sie diese Zahl editieren. Die Voreinstellung
von 500 Zeilen d"urfte ein vern"unftiger Wert sein, da eine einzelne
Ausgabedatei damit kleiner als 32~KByte ist und die meisten Mailer Dateien
dieser Gr"o"se verkraften k"onnen.




\section{Der benutzerdefinierte Pager}\label{Der benutzerdefinierte Pager}

Mit Hilfe des benutzerdefinierten Pagers k"onnen Sie sich den Inhalt einer
Datei ansehen, ohne {\Arcgsh} verlassen zu m"ussen. Diese Funktion ist nicht
in {\Arcgsh} selbst eingebaut, sondern Sie k"onnen dazu ein beliebiges
Programm ausw"ahlen, mit dem man eine Datei betrachten kann. (Ich selbst
benutze und empfehle das kostenlos verf"ugbare Program {\tt LESS.TTP} von
Moshe Braner.)

Wenn Sie \menu{Show file ...}\ im \menu{File}-Men"u selektieren, erscheint
die GEM-Dateiauswahlbox, und Sie k"onnen angeben, welche Datei angezeigt
werden soll. Falls Sie noch kein Pager-Programm vorgesehen haben, erscheint
zuvor eine Dialogbox, mit der Sie ein solches Programm konfigurieren k"onnen
(siehe Beschreibung zum Men"u \menu{Configuration}).




\section{Der benutzerdefinierte Editor}\label{Der benutzerdefinierte Editor}

Mit Hilfe des benutzerdefinierten Editors k"onnen Sie eine Datei editieren,
ohne {\Arcgsh} verlassen zu m"ussen. Diese Funktion ist nicht in {\Arcgsh}
selbst eingebaut, sondern Sie k"onnen dazu einen beliebigen Editor
ausw"ahlen. 

Wenn Sie \menu{Edit file ...} im \menu{File}-Men"u selektieren, erscheint die
GEM-Dateiauswahlbox, und Sie k"onnen angeben, welche Datei editiert werden
soll. Falls Sie noch keinen Editor vorgesehen haben, erscheint zuvor eine
Dialogbox, mit der Sie ihn konfigurieren k"onnen (siehe Beschreibung zum
Men"u \menu{Configuration}).




\section{Aufruf weiterer Programme}\label{Aufruf weiterer Programme}

Au"ser den oben genannten Programmen k"onnen Sie beliebige andere Programme
"uber den Men"ueintrag \menu{Other program ...} im \menu{File}-Men"u
aufrufen.  In der angezeigten Dialogbox m"ussen Sie den Programmnamen
angeben. Dar"uber hinaus k"onnen Sie Programmparameter "ubergeben, den
Arbeitsordner ausw"ahlen und Standardeingabe und -ausgabe umlenken.

Die meisten Programme erwarten Dateinamen als Parameter.  Aus diesem Grund
erscheint nach einem Doppelklick in das Feld \field{Parameters} die
Dateiauswahlbox. Auf diese Weise k"onnen Sie z.\,B.  zuerst bequem einen
Dateinamen ausw"ahlen und danach ggf. das Feld per Hand weiter editieren.

Wenn Sie nicht explizit mit dem Dateiauswahlmanager einen Arbeitsordner
festlegen, wird der Ordner, in dem das gerufene Programm steht, als
Arbeitsordner verwendet. {\bf Achtung:} Wenn ein GEM-Programm eine
Ressource-Datei ben"otigt, sucht es diese normalerweise im Arbeitsordner und
kann nicht ablaufen, wenn es sie dort nicht findet. Deshalb sollte der
Arbeitsordner nicht umgesetzt werden, wenn ein solches Programm gestartet
wird.




\section{Der Dateiauswahlmanager}\label{Der Dateiauswahlmanager}

Der Dateiauswahlmanager ist eine Dialogbox (und etwas Programmkode), die es
Ihnen erlaubt, eine ganze Reihe von Dateinamen (oder beliebigen anderen
Text) auszuw"ahlen, die einem gerufenen Programm als Parameter "ubergeben
werden sollen. Au"serdem k"onnen Sie die Standardeingabe und -ausgabe
umlenken, und Sie k"onnen f"ur das gerufene Programm einen Arbeitsordner
festlegen.

Im Dateiauswahlmanager sehen Sie folgende Komponenten:

\begin{description}

\item[Zeilen:] Hier spezifizieren Sie "ublicherweise Dateinamen. Sie k"onnen
allerdings auch beliebige andere Texte eingeben.

Wenn Sie eine leere Zeile mit der linken Maustaste anklicken, erscheint die
GEM-Dateiauswahlbox, mit der Sie dann wie gewohnt eine Datei selektieren
k"onnen. Der Name der ausgew"ahlten Datei wird anschlie"send mit
Laufwerkskennung und komplettem Pfad in dieser Zeile angezeigt. Wenn n"otig,
k"onnen Sie den Dateinamen danach noch per Hand editieren.

Ein Dateiname, der so lang ist, da"s er nicht in die Zeile pa"st, wird vorn
durch drei Punkte abgek"urzt, so da"s nur der hintere Teil zu sehen ist.
Derart abgek"urzte Dateinamen sind nicht editierbar. Wenn Sie den Inhalt
einer solchen Zeile "andern wollen, m"ussen Sie die Zeile anklicken und mit
der dann erscheinenden Auswahlbox irgendeinen Dateinamen ausw"ahlen, der
kurz genug ist, um in die Zeile zu passen. Anschlie"send k"onnen Sie die
Zeile wieder editieren.

Diese Funktionalit"at besitzen auch die im folgenden genannten Felder.

\item[\field{Standard input}:] Hier k"onnen Sie eine Datei angeben, die das
gerufene Programm als Standardeingabe verwenden soll.

\item[\field{Standard output}:] Hier k"onnen Sie eine Datei angeben, die das
gerufene Programm als Standardausgabe verwenden soll.

\item[\button{Append}, \button{Create}:] Diese Kn"opfe sind von Bedeutung,
wenn Sie die Standardausgabe in eine Datei umgelenkt haben. Sie geben an, ob
die Ausgaben des gerufenen Programms an die spezifizierte Datei angeh"angt
werden soll {\bf (append)} oder ob eine neue Datei angelegt wird {\bf
(create)}. Falls die Ausgabedatei bereits existiert, geht ihr bisheriger
Inhalt bei {\bf create} verloren.

\item[\field{Working directory}:] Hier k"onnen Sie den Arbeitsordner f"ur
das gerufene Programm spezifizieren.

\item[\button{OK}:] Anklicken dieses Knopfes beendet den Dateiauswahlmanager.

\item[\button{Cancel}:] Anklicken dieses Knopfes beendet den
Dateiauswahlmanager ebenfalls, allerdings werden alle Einstellungen und
"Anderungen, die Sie gemacht haben, nicht wirksam. Beim erneuten Aufruf des
Dateiauswahlmanagers erhalten Sie wieder die vorigen Werte.

\item[\button{Clear all}:] Dieser Knopf l"oscht alle Textfelder.

\end{description}




\section{Parameter"ubergabe an gerufene Programme}\label{Parameteruebergabe
an gerufene Programme}

Einem Programm mu"s man in der Regel einen oder mehrere {\bf Parameter}
mitgeben. Sie sagen dem Programm, was getan werden soll. Gute Beispiele
daf"ur stellen die von {\Arcgsh} unterst"utzten Archivierer dar: Sie erwarten
Parameter, die dem Programm sagen,

\begin{itemize}

\item {\bf was} getan werden soll (z.\,B. Dateien in ein Archiv aufnehmen
oder aus einem Archiv extrahieren), und

\item mit {\bf welchen Dateien} gearbeitet werden soll (die Archivdatei,
Archivelemente oder andere Dateien).

\end{itemize}

All diese Parameter werden dem gerufenen Programm als Text, der {\bf
Kommandozeile,} "ubergeben. Allerdings beschr"ankt das Betriebssystem des
Atari-ST die L"ange der Kommandozeile auf maximal 125 Zeichen.
Kommandozeilen, die mehr Zeichen enthalten, werden gnadenlos auf 125 Zeichen
abgeschnitten.

Nat"urlich sollte man schon in der Lage sein, einem Programm mehr als 125
Zeichen zu "ubergeben, beispielsweise wenn ein Archivierer mit sehr vielen
Dateinamen als Parameter aufgerufen wird. Aus diesem Grund haben einige Leute
Verfahren zur sogenannten {\bf erweiterten Parameter"ubergabe} entwickelt,
die genau das bezwecken. Diese Verfahren funktionieren alle nach dem
folgenden Schema: Das rufende Programm "ubergibt dem gerufenen Programm den
Parameter-String in einer bestimmten {\bf Environment-Variablen.} Das
gerufene Programm pr"uft, ob diese Variable in seinem Environment-String
enthalten ist und verwendet dann den Inhalt der Variablen als
Programm-Parameter. Andernfalls liest das Programm seine Parameter wie
"ublich von der Kommandozeile. Nat"urlich funktioniert dieses Verfahren nur,
wenn es sowohl vom rufenden als auch vom gerufenen Programm unterst"utzt
wird.

Die am weitesten verbreiteten erweiterten Parameter"ubergabeverfahren sind
{\em xArgv\/} und {\em ARGV.\/} {\Arcgsh} unterst"utzt beide Verfahren und
kann daher Kommandozeilen mit mehr als 125 Zeichen an solche Programme
"ubergeben, die ebenfalls entweder das {\em xArgv-\/} oder das {\em
ARGV-\/}Verfahren verwenden. Die Archivierer {\arc} und {\zoo} sind
Beispiele f"ur solche Programme.

In den Genu"s des {\em xArgv-\/} und des {\em ARGV-\/}Verfahrens kommen nur
registrierte {\Arcgsh}-Benutzer. Wie Sie ein registrierter Benutzer werden
k"onnen, lesen Sie in Kapitel \ref{Arcgsh ist Shareware} (Seite
\pageref{Arcgsh ist Shareware}).



\section{Automatischer Start --- Arcgsh als Desktop-Anwendung}

Es kommt wahrscheinlich nicht selten vor, da"s Sie sich mit dem GEM-Desktop
oder einer anderen Shell verschiedene Ordnerinhalte Ihres Dateisystems
ansehen. Nehmen wir an, Sie haben in einem Fenster eine Archivdatei und
wollen sich kurz anschauen, was in diesem Archiv enthalten ist. W"are es
eine Textdatei, k"onnten Sie einen Doppelklick auf die Datei ausf"uhren und
ihren Inhalt mit Hilfe der im Betriebssystem eingebauten Anzeigefunktion
betrachten.

Mit einer Archivdatei geht das nat"urlich nicht, denn es ist ja keine
Textdatei. Was Sie machen k"onnten, ist folgendes: "Offnen Sie ein weiteres
Fenster, gehen Sie damit zum {\Arcgsh}-Ordner, starten Sie {\Arcgsh},
w"ahlen Sie den richtigen Archivierer aus dem \menu{File}-Men"u aus,
selektieren Sie die Archivdatei, klicken Sie die "`list"'-Funktion des
Archivierers und starten Sie das Programm.

Gl"ucklicherweise geht es aber auch einfacher. Das folgende Verfahren l"auft
unter TOS~1.4 und sp"ateren TOS-Versionen\footnote{Bei TOS-Versionen $<$1.4
funktioniert es nur dann, wenn Sie den Ordner, in dem {\Arcgsh} installiert
ist, in die Environment-Variable PATH einf"ugen. Das ist unter dem
GEM-Desktop leider nicht direkt m"oglich, sondern Sie m"ussen ein besonderes
Auto-Ordner-Programm zum Setzen von Environment-Variablen bei Systemstart
ausf"uhren. Soweit ich wei"s, ist das kostenlos verf"ugbare Programm GEMBOOT
von Konrad Hahn dazu in der Lage.}: Installieren Sie {\Arcgsh} als
Desktop-Anwendung. Nachdem Sie das getan haben, brauchen Sie nur noch einen
Doppelklick auf die Archivdatei auszuf"uhren.  {\Arcgsh} startet automatisch
und zeigt auch gleich die richtige Dialogbox an, wobei der Name des Archivs
nat"urlich ebenfalls bereits an der richtigen Stelle eingetragen ist. Alles,
was Sie noch tun m"ussen, ist, einen Kommandoknopf zu selektieren --- z.\,B.
"`list"' --- und auf \button{OK} zu klicken.

Das gleiche k"onnen Sie mit uukodierten Dateien machen: Ein Doppelklick auf
eine Datei mit der Endung {\tt .UUE} startet {\Arcgsh} und zeigt die
{\uud}-Dialogbox mit dem Namen der uukodierten Datei an.

Hier eine Kurzanleitung zur Installation von {\Arcgsh} als Desktop-Anwendung:

\begin{enumerate}

\item Gehen Sie unter dem GEM-Desktop in den {\Arcgsh}-Ordner und
selektieren Sie {\tt ARCGSH.PRG}.

\item Bewegen Sie die Maus in das Men"u \menu{EXTRAS} und selektieren Sie
den Men"ueintrag \menu{Anwendung anmelden}.

\item Im Feld \field{Dateityp} geben Sie {\tt ZOO} ein; dann klicken Sie auf
\button{Installieren}.

\item Selektieren Sie den Eintrag \menu{Arbeit sichern} im
\menu{EXTRAS}-Men"u. Nachdem Sie die R"uckfrage best"atigt haben, wird die
Datei {\tt DESKTOP.INF} auf Ihre Boot-Disk geschrieben. Dadurch ist
{\Arcgsh} dauerhaft als Desktop-Anwendung installiert.

\end{enumerate}

Allerdings: Bis jetzt haben Sie {\Arcgsh} nur als Desktop-Anwendung f"ur
{\zoo}-Archive installiert. Wenn Sie {\Arcgsh} so wie oben beschrieben auch
f"ur Dateien mit den Endungen {\tt .ARC}, {\tt .LZH}, {\tt .TAR} und {\tt
.UUE} installieren, geht es schief: Das GEM-Desktop vergi"st n"amlich den
vorher spezifizierten Dateityp und merkt sich nur den zuletzt angegebenen.

Um diese Einschr"ankung des Desktops zu umgehen, m"ussen Sie die Datei {\tt
DESKTOP.INF} nach der Installation von {\Arcgsh} f"ur {\zoo}-Archive mit
einem Texteditor bearbeiten: Suchen Sie in {\tt DESKTOP.INF} eine Zeile, die
der folgenden "ahnlich sieht:

\begin{quote}
{\tt \#G 03 04   C:$\backslash$BIN$\backslash$ARCGSH$\backslash$ARCGSH.PRG@ *.ZOO@}
\end{quote}

Hier gibt {\tt C:$\backslash$BIN$\backslash$ARCGSH$\backslash$ARCGSH.PRG}
den vollen Dateinamen des Programms {\Arcgsh} an. Diese Angabe kann auf
Ihrem Rechner durchaus anders aussehen. Der String {\tt *.ZOO} spezifiziert
die Dateien, f"ur die {\Arcgsh} gestartet werden soll.

Kopieren Sie diese Zeile viermal, und "andern Sie in den Kopien den String
{\tt ZOO} in {\tt ARC}, {\tt LZH}, {\tt TAR} und {\tt UUE}. Jetzt sollten
Sie etwa folgendes haben:

\begin{quote}
{\tt \#G 03 04   C:$\backslash$BIN$\backslash$ARCGSH$\backslash$ARCGSH.PRG@ *.ARC@}\\
{\tt \#G 03 04   C:$\backslash$BIN$\backslash$ARCGSH$\backslash$ARCGSH.PRG@ *.LZH@}\\
{\tt \#G 03 04   C:$\backslash$BIN$\backslash$ARCGSH$\backslash$ARCGSH.PRG@ *.ZOO@}\\
{\tt \#G 03 04   C:$\backslash$BIN$\backslash$ARCGSH$\backslash$ARCGSH.PRG@ *.TAR@}\\
{\tt \#G 03 04   C:$\backslash$BIN$\backslash$ARCGSH$\backslash$ARCGSH.PRG@ *.UUE@}
\end{quote}

Jetzt k"onnen Sie {\tt DESKTOP.INF} speichern und das System neu starten.
Danach wird {\Arcgsh} automatisch bei Doppelklick auf {\arc}-, {\lharc}- and
{\zoo}-Archive sowie auf Dateien mit den Endungen {\tt .TAR} und {\tt .UUE}
gestartet.




\section{Einschr"ankungen}

\begin{itemize}

\item Die Benutzung von {\lharc} ist nicht unproblematisch. Am besten
verwenden Sie einen anderen Archivierer, z.\,B. {\zoo}. Lesen Sie dazu bitte
Kapitel \ref{LHarc} (Seite \pageref{LHarc}).

\item Konfigurationsdateien, die mit einer {\Arcgsh}-Version kleiner 3.0
erzeugt wurden, k"onnen mit dieser Version nicht mehr verwendet werden.
L"oschen Sie {\tt ARCGSH.CFG} und erzeugen Sie eine neue Konfigurationsdatei.

\item Dateinamen k"onnen inkl. Pfad nicht l"anger als 119 Zeichen sein, da
Dateinamen mit mehr als 119 Zeichen vom GEM-Desktop nicht verarbeitet werden
k"onnen. Beim Versuch, eine solche Datei zu benutzen, kann {\Arcgsh}
abst"urzen. Falls Sie eine {\Arcgsh}-Version, die l"angere Dateinamen
verarbeiten kann, ben"otigen sollten, setzen Sie sich bitte mit mir in
Verbindung.

\item Die Installation von {\Arcgsh} als Desktop-Anwendung unter
TOS-Versionen, die "alter als TOS~1.4 sind, funktioniert nur dann, wenn der
{\Arcgsh}-Ordner in der Environment-Variablen PATH enthalten ist.

\end{itemize}

\end{document}
