home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / newc_dev / create.lha / Create / Create.dok < prev    next >
Text File  |  1992-10-13  |  8KB  |  287 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                        ANLEITUNG DOKUMENTATION ZU
  14.  
  15.  
  16.                 Create  VERSION  1.1  FREEWARE VERSION
  17.  
  18.  
  19.                         geschrieben 1992 von H.P.G.
  20.  
  21. INDEX:
  22.  
  23.  
  24.  
  25.             INDEX
  26.             Allgemeine Beschreibung
  27.             System Vorrausetzungen
  28.             Rechtliches
  29.             FEATURES
  30.             Installation
  31.             Starten von Create
  32.             Create START PARAMETER
  33.             Technisches
  34.             Zum Schluß
  35.             Adresse
  36.             Liste der Dateien
  37.  
  38.  
  39.  
  40.  
  41. Allgemeine Beschreibung:
  42.  
  43.  
  44.         Create erzeugt wahlweise ein neues Verzeichnis  oder  eine  neue
  45.         Datei. Dabei können an Create  beliebig  viele  Namen  übergeben
  46.         werden. Man  kann  also  auch  Dateien  und  Verzeichnisse  beim
  47.         Aufruf mischen.
  48.  
  49.         Es handelt sich bei Create u. a. also um  eine  MakeDir  Verbes-
  50.         serung.
  51.  
  52.         Create kann man z.Bsp in der Startup-Sequence einsetzen.
  53.  
  54.         Wie schon vorher erwähnt kann Create Dateien erzeugen.
  55.         Einige Leute werden sich jetzt fragen, warum soll ich eine leere
  56.         Datei erzeugen.
  57.  
  58.         Nun es gibt einige Programme, wie TextEditoren oder MalProgramme
  59.         etc., an die man den Namen einer Datei in den Cli-Aufruf anhängen
  60.         kann. Existiert diese Datei wird sie dann automatisch geladen.
  61.         Existiert sie aber nicht,
  62.  
  63.         - wird man entweder durch einen nervenden Datei-Requester aufge-
  64.           fordert eine andere Datei zu wählen ,(was noch der beste Fall
  65.           wäre),
  66.  
  67.         - oder durch eine einfache Nachricht, wie 'Kann Datei nicht laden'
  68.           abgespeist,
  69.  
  70.         - oder aber ,(was das Schlimmste ist), das Programm bricht einfach
  71.           mit einer Fehlernachricht ab.
  72.  
  73.         Für diese Fälle ist Create gedacht.
  74.         Als beste Lösung der oben genannten Probleme ist meineserachtens
  75.         das Erstellen einer Batch-Dateien, die sich im AmigaDOS-Suchpfad
  76.         befinden muß ( z.B. im s:- oder c:- Verzeichnis).
  77.  
  78.         Beispiel:
  79.  
  80.         Wenn man Einen TextEditor benutzt, nehmen wir an er hieße TextEd,
  81.         kann man folgende BatchDatei benutzen
  82.  
  83.         .Key FileName               ; Name des Textes
  84.  
  85.         if EXISTS <FILENAME>        ; wenn der Text existiert, dann
  86.             TextEd <FILENAME>       ; ganz normaler Aufruf
  87.         endif
  88.         else                        ; sonst
  89.             Create <FILENAME> QUIET ; Erst Create aufrufen und Datei erzeugen
  90.             TextEd <FILENAME>       ; dann erst TextEd mit der Datei aufrufen
  91.         endif
  92.  
  93.         Nun muß man diese Datei bspw. noch unter dem Namen 's:TED' ab-
  94.         speichern und mittels 'protect s:TED +s' das Script-Bit setzen.
  95.  
  96.         BEMERKUNG:
  97.  
  98.             Durch die OPTION QUIET gibt Create keine Nachricht über die er-
  99.             folgreiche Erstellung einer Datei oder eines Verzeichnisses aus.
  100.  
  101.         Gibt man jetzt im CLI, TED gefolgt von einem Dateinamen ein,
  102.         so wird eine Datei erstellt, wenn die Datei noch nicht existiert,
  103.         sonst wird TextEd einfach mit dem Namen aufgerufen.
  104.  
  105.         Keine Nerv-Requester oder blöde Nachrichten mehr.
  106.  
  107.         Das funktioniert natürlich auch bei Musik-Programmen oder DPaint
  108.         o.ä.
  109.  
  110. System Vorrausetzungen:
  111.  
  112.  
  113.         Für Create benötigt man mindestens Kickstart 2.xx Version 37.xx.
  114.  
  115.         Da Create regen Gebrauch von den neuen OS 2.0 Features macht, ist
  116.         es leider unter Kickstart 1.2 1.3 nicht lauffähig.
  117.  
  118.  
  119. Rechtliches:
  120.  
  121.  
  122.         Ich habe mich entschlossen dieses Programm und alle beigefügten
  123.         Dateien und Scripts, sowie aller Anleitungen als FREEWARE zu
  124.         deklarieren.
  125.         D.H.:
  126.  
  127.             Jeder kann Create benutzen.
  128.             Jeder darf Create weitergeben, wenn:
  129.  
  130.                 1. alle unten aufgeführten Programme mit weitergegeben werden,
  131.  
  132.                 2. keinerlei Veränderungen unten aufgeführten Programmen vor-
  133.                    genommen wurden,
  134.  
  135.                 3. bei Nachkompilierungen der Quell-Codes muß ein Hinweis auf
  136.                    den Orginal-Programmierer vorhanden sein,
  137.                    bei Herausgabe dieser, muß eine Kopie an mich gesandt werden.
  138.  
  139.                 4. Create darf nicht verkauft werden.
  140.  
  141.                        Außnahme: Es darf eine geringe Kopiergebühr erhoben
  142.                                  werden, die aber 5 DM bzw. den entsprechenden
  143.                                  Gegenwert in anderen Währungen nicht über-
  144.                                  steigt.
  145.  
  146.                 5. Create darf nur als Teil eines kommerziellen Produktes
  147.                    herrausgegeben werden, mit ausdrücklicher schriftlicher
  148.                    Genehmigung des Autors (Adresse siehe unten).
  149.  
  150.                 Zuwiderhandlungen der oben Aufgeführten Konditionen werden
  151.                 Zivilrechtlich verfolgt.
  152.  
  153.  
  154.         Ferner wird für die Funktion des Programmes ,sowie möglicher Folgen
  155.         der Benutzung des Programmes sowie der u. a. Dateien, keinerlei Ge-
  156.         währleistung übernommen. Alle Risiken trägt der Benutzer allein.
  157.  
  158.  
  159. FEATURES:
  160.  
  161.         - Erstellung von Dateien und Verzeichnissen
  162.  
  163.         - Übergabe von beliebig vielen Verzeichnissen möglich
  164.  
  165.         - sehr kleine Programmgröße
  166.  
  167.         - Es besitzt eine QUIET-Funktion die es dem Benutzer ermöglicht,
  168.           Create in Batch-Scripts zu benutzen.
  169.  
  170. Installation:
  171.  
  172.  
  173.         Einfach Create ins C:, oder jedes beliebig andere Verzeichnis im
  174.         aktuellen AmigaDOS-Suchpfad kopieren.
  175.  
  176.  
  177. Starten von Create:
  178.  
  179.  
  180.  
  181.         Craete muß vom CLI aus gestartet werden. Alternativ dazu kann man
  182.         auch den WBenchmenüpunkt 'ExecuteCommand' ausführen.
  183.  
  184.  
  185. Create START PARAMETER:
  186.  
  187.         Create hat folgende
  188.  
  189.         Syntax: Craete File_Or_Dir/M/A,[QUIET/S]
  190.  
  191.  
  192.         File_Or_Dir/M/A beliebige Anzahl Der Name einer Datei oder eines Ver-
  193.                         an Zeichenketten zeichnisses, daß erzeugt werden soll.
  194.                                          Es können beliebig viele Namen ange-
  195.                                          geben werden. Will man eine Datei er-
  196.                                          stellen, so muß man ein '/' an den
  197.                                          Namen anhängen. Sonst wird eine Datei
  198.                                          erzeugt.
  199.  
  200. !!!! ACHTUNG:
  201.  
  202. Man sollte darauf achten, daß manche Komprimierungsprogramme, wie etwa LHA
  203. oder LHArc, Probleme mit leeren Verzeichnissen und Dateien haben. Also
  204. bevor man ein Verzeichnis komprimieren will, sollte man sich überzeugen,
  205. daß in ihm keine leeren Dateien vorhanden sind, und diese gegebenenfalls
  206. vorher löschen.
  207.  
  208.         QUIET  --------------    Mit Angabe dieser OPTION erzeugt Create
  209.                                  keine Meldungen über erfolgreiche Ver-
  210.                                  zeichnis- und/oder Datei- Erzeugungen.
  211.                                  Dies ist besonders bei Aufrufen in Batch-
  212.                                  Scripts nützlich.
  213.                                  Passiert allerdings ein Fehler, so wird
  214.                                  dieser trotzdem ausgegeben. Außerdem setzt
  215.                                  Create den ReturnCode auf WARN (5), was
  216.                                  normalerweise zum Abbruch der Batch-Datei-
  217.                                  Bearbeitung führt.
  218.  
  219.  
  220. Startet man Create ohne PARAMETER wird ein kleiner Hilfstext ausgegeben.
  221. Dieser Hilfstext erscheint ebenfalls bei falschen Parameterübergaben.
  222.  
  223.  
  224. Technisches:
  225.  
  226.  
  227.         Create wurde in C geschrieben und mit dem Manx Aztec C V 5.2a -
  228.         Compiler kompiliert.
  229.  
  230.  
  231.         EM benutzt die neuen DOS ReadArgs Funktionen für CommandLine-
  232.         Parsing. Ebenfalls werden die Funktionen Lock etc. der DOS-
  233.         Library benutzt.
  234.  
  235. Zum Schluß:
  236.  
  237.         Ich hoffe Create wird von vielen Leuten benutzt. Sollten sich
  238.         Fehler des Programms herausstellen, so schreibt mir. Auch kon-
  239.         struktive Kritik und/oder Ideen sind willkommen.
  240.  
  241.  
  242. Adresse:
  243.  
  244. Schickt alle Anschriften bitte an:
  245.  
  246.  
  247.  
  248.                 Hans-Peter Günther
  249.  
  250.                 Grüner Weg 5
  251.  
  252.                 3501 Fuldatal 2
  253.  
  254.                 ( B.R.D )
  255.  
  256. Liste der Dateien:
  257.  
  258. (Fehlen ein oder mehrere dieser Dateien, ist diese Veröffentlichung
  259.  inkomplett)
  260.  
  261.  
  262. Create            : das Programm
  263. Create.info
  264. Create.dok        : die englische Anleitung
  265. Create.dok.info
  266. Create.doc        : die deutsche Anleitung
  267. Create.doc.info
  268.  
  269. ---
  270. END
  271.  
  272.  
  273.  
  274.  
  275. Viel Spaß noch mit Create...
  276.  
  277.                 H.P.G
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.