--------------
                                   AInc V500
                                --------------
                               by Th.Strauß '93
                              © 1993 by Th.Strauß
                                TOMTOM Software
                                     ----


Seit Version 450.29 ist AInc frei kopierbar.  AInc darf nicht ohne das
schriftliche Einverständnis des Autors in eigenen (egal ob PD oder
Kommerziell) Produkten verwendet werden.

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.  Oder
während ein User in der Box ist mal eben nachzuschauen, was in einem Brett
ist.

Arbeitsweise:

AInc benötigt Kickstart/Workbench 2.0.  Wird keine Dos-Lib V37.x gefunden,
beendet AInc.
Die Version 500.1 funktioniert zwar noch mit den Indexdateien der Version
450, es ist aber nicht möglich mit Version .450 von ANUBIS an einem Netz
teilzunehmen.

AInc speichert die Datei(en) die in der Commandline übergeben wurden mit
aktuellem Datum ab im übergebenen Brett ab.  Das Brett in welches geuppt
wurde, wird ebenfalls aktualisiert, sowie der gesamte Brettpfad.  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.
Mit Version 500.1 ist es möglich das auslesen einer solchen README Datei zu
verbieten. Das ermöglicht es, auch .readme Dateien problemlos up-zuloaden.
 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.
AInc V500.1 bietet die Möglichkeit den Kurzbetreff in der Commandline
anzugeben. Solange Readme's nicht verboten werden (NOREADME) haben sie
jedoch Vorrang vor diesem Kurzbetreff.

ACHTUNG AB VERSION 450.29 IST AINC NICHT MEHR VON DER WB AUS ZU STARTEN!

Benutzung:

AInc hat eine (nicht mehr ganz) einfache Syntax:

AINC L=LINK/S,N=NET/S,NORME=NOREADME/S,T=TEXTTYPE/S,
     BRETT/A,FILE/M,UPL=UPLOADER/K,DEFKB=DEFAULTKBTR/K

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 dieser in vielen Fällen durch
eine zum Download verwendete Terminalsoftware (z.Bsp.  NComm) verändert
wird.  Wer seine Software per FTP besorgt, wird die Funktion zusätzlich zu
schätzen wissen.

Die Optionen von AINC:
----------------------
L=LINK/S:  Der Schalter LINK 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.

N=NET/S:  Ab ANUBIS V500 ist es möglich an Netzwerken teilzunehmen
	(ZConnect3.8-Mailer) dieser Schalter ermöglicht es, daß die Datei
	auch noch in das Netzwerk durchgeroutet wird. (NOCH NICHT VERFÜGBAR)

NORME=NOREADME/S: Damit kann man verhindern, daß für den Kurzbetreff nach
	einer .README Datei gesucht wird. Sinnvoll für Dateienamen wie
	Bla.readme.

T=TEXTTYPE/S: Die Datei wird nicht als Binaerfile gekennzeichnet sondern
	als Textfile.

BRETT/A: Brettname, muss mindestens angegeben werden.

FILE/M: Fileliste, der Dateien, die in BRETT geschoben werden sollen.

UPL=UPLOADER/K: Name, der beim Absender eingtragen werden soll.

DEFKB=DEFAULTKBTR/K: Default-Kurzbetreff für die Files, die keine .readme
	Datei haben, oder falls NOREADME gesetzt wurde.


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, und wird wohl auch so bleiben.

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.

Wer RealName Links benötigt, den verweise ich auf ALink (<2kb) oder AnuLink
(>20kb), die beide fehlende Links nachtragen.

To Do:
- Config-Datei, in der Absender und ANUBIS-Directory eingestellt werden können.
- ...  Open for your Ideas!

Archivinhalt:

  - Dieses Dok-File   :   AInc.dok
  - History-File      :   History
  - AInc Executable   :   AInc
  - UpNew.rexx        :   UpNew.rexx