--------------
                                   AInc V450
                                --------------
                               by Th.Strauß '93
                              © 1993 by Th.Strauß
                                   ADG Saar
                                     ----


AInc ist frei kopierbar, bei dauerhafter Nutzung ist eine Sharewaregebühr von
10 DM fällig.  AInc darf nicht ohne das schriftliche Einverständnis des Autors
in eigenen Produkten verwendet werden.

Registrierte Anwender bekommen Updates per EMail oder gegen Leerdiskette +
Rückporto zugesendet.

Sinn und Zweck:

AInc wurde aus der Not geboren, daß ANUBIS keine Möglichkeit bietet per Script
oder RexX irgendwelche Binärdateien in die Bretter upzuloaden.

Arbeitsweise:

AInc benötigt Kickstart/Workbench 2.0. Wird keine Dos-Lib V37.x gefunden,
beendet AInc mit einer entsprechenden Fehlermeldung.
Der Ansender ist im Moment fest auf Sysop eingestellt.
AInc speichert die Datei mit aktuellem Datum ab. Das Brett in welches geuppt
wurde, wird ebenfalls aktualisiert.
Als Betreff setzt AInc den Filenamen ein, als Kurzbetreff werden die Ersten
60 Buchstaben aus einer ".readme" Datei verwendet. Zu jedem File kann eine
solche Datei angelegt werden.
Ab Version 450.20 muss nicht mehr der komplette Pfad angegeben werden.
Ausserdem sind Joker möglich.
Für die Readme-Dateien ist jetzt eine Art Basename eingeführt.
Wenn AInc keine normale .readme Datei findet, schneidet es alles nach
dem letzten Punkt (falls einer da ist) im Dateinamen ab, hängt
".readme" an und sucht nach dieser Datei.

Benutzung:

AInc hat eine einfache Syntax:

AINC [-L] BRETT [FILE] ... [FILE]

Wird AInc nur mit einem Brett als Argument aufgerufen, so werden der Brettinhalt
bzw die Unterbretter ausgegeben. Dateien die auf LÖSCHEN stehen, werden dabei
von der Ausgabe unterdrückt.

AINC PD-SOFT               -> Gibt die Unterbretter von PD-SOFT aus
AINC "PD-SOFT/DFUE TOOLS"  -> Gibt die Einträge in PD-SOFT/DFUE TOOLS aus

Um jetzt in ein Brett upzuloaden, gibt man einfach das File mit komplettem
Pfadnamen an:

AINC "PD-Soft/Dfue Tools" pub:new/LinuX#?

Groß-Kleinschreibung wird nicht unterschieden. Für jede Datei wird jetzt noch
überprüft, ob eine ".readme" Datei existiert, ist dem so, wird der Kurzbetreff
entsprechend gesetzt.

Es wird nicht der File-Comment verwendet, da diese z.Bsp in vielen Fällen durch
NComm verändert wird. Wer seine Software per FTP besorgt, wird die Funktion
zusätzlich zu schätzen wissen.

Der Schalter -L veranlasst AInc das File nicht zu kopieren, sondern ein Hardlink
darauf zu erzeugen. Dadurch ist es möglich Files in ANUBIS verfügbar zu machen,
ohne sie entweder doppelt zu behalten oder ständig darauf achten zu müssen, daß
sie beim nächsten CRUNCH ALL den Bach runter gehen.

Liegen die Files auf verschiedenen Devices, kopiert AInc die Datei, da SoftLinks
noch nicht komplett unterstützt werden.

Sonstiges:

AInc versucht auch mit minimalem Speicher die Dateien zu kopieren. Theoretisch
genügt ein Byte. Die Copy-Buffergröße wird für jedes File einzeln berechnet.
Es werden keine seltsamen Kopien der Datei in "T:" oder sonstwo angelegt. Einen
"VOLUME RAM DISK: IS FULL" braucht man also nicht zu erwarten.

AInc sucht die Brettliste unter "ANUBIS:DATEN/BRETTLISTE".  Dies ist z.Zt.  nur
mittels eines Patches zu ändern.

Wer AInc verwenden will, der sollte auf die Versionsnummer achten. Die Version
von AInc ist der von ANUBIS angepasst, d.h. Version 450.x funktioniert mit
ANUBIS Versionen, deren INDEX-Files und BRETTLISTE-File zu ANUBIS V.450
kompatibel ist.

AInc ist bewusst als CLI-Programm gehalten. es wird keine GUI oder so etwas
geben. Auch das geplante Config File wird als ASCII-Text gespeichert sein. Das
hat den einfachen Grund, daß man AInc auch von der DOS-Shell aus bedienen und
konfigurieren können soll.

To Do:

- Kick/WB 2.0 Command Line Parsing
- Realname Links, um Files dem Namen nach in ANUBIS-Directories ansprechen zu
  können.
- Config-Datei, in der Absender und ANUBIS-Directory eingestellt werden können.
- ...  Open for your Ideas!

Registrierung:

Eine Mail an TOM@OUTWORLD.ZER im Z-Netz, oder an
             thst@coli-gate.coli.uni-sb.de im Internet
ergibt eine Info über die aktuelle Version.

Ein Brief mit 10 Mark an
                          ADG Saar
                          Thomas Strauß
                          Josefstr. 64
                          6637 Nalbach

in dem ganz WICHTIG: entweder eine Diskette inclusive Rückporto ist oder
                     eure EMail Adresse.

Erweiterte Möglichkeiten der reg. Version:

-: Die Version ist unkrippled. Wer sich registriert, kriegt eine
-: geTeXte Anleitung und ein Update.
-: Bis auf kleinere Bugfixes ist das hier wohl die letzte öffentliche
-: Version ...
-: ... Es sei denn ich überlegs mir wieder anders :-)

Archivinhalt:

  - Dieses Dok-File   :   AInc.dok   - ( 5087 Bytes )
  - History-File      :   History    - ( 3653 Bytes )
  - AInc Executable   :   AInc       - ( 9356 Bytes )
  - UpNew.rexx        :   UpNew.rexx - ( 2290 Bytes )