home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / amiga / tools / system / updatecopy / docs / updatecopy.dok < prev   
Encoding:
Text File  |  1998-01-20  |  8.1 KB  |  208 lines
  1.  
  2.                         Dokumentation für UpDateCopy
  3.  
  4.                           Version 1.00 - 20.01.1998
  5.                    $VER: UpDateCopy.dok 1.00 (20.01.1998)
  6.  
  7.  
  8.                        Geschrieben von Sven Steiniger
  9.                                -- Cardware --
  10.  
  11.  
  12. ------------------------------------------------------------------------------
  13.                                  Einführung
  14. ------------------------------------------------------------------------------
  15.  
  16.     UpDateCopy ist eine Erweiterung des Standard copy Kommandos. Es
  17.     kopiert nicht nur Dateien und erzeugt (wenn notwendig) Verzeichnisse
  18.     sondern bearbeitet auch schon existierende Dateien: ältere Dateien
  19.     werden automatisch durch neuere ersetzt. UpDateCopy sucht erst nach
  20.     nach der Versionszeichenkette ($VER: Programmname Version.Reversion)
  21.     in der Datei und überschreibt nur Dateien mit höherer Versionsnummer.
  22.     Findet UpDateCopy keine Versionsnummern vergleicht er das Datum der
  23.     Dateien und erzetzt wenn nötig.
  24.     UpDateCopy verarbeite außerdem mehrere Quelldateien, Namensmuster
  25.     und rekursive Verzeichnisdurchsuchung.
  26.  
  27. ------------------------------------------------------------------------------
  28.                            Systemvorraussetzungen
  29. ------------------------------------------------------------------------------
  30.  
  31.     - einen Amiga :-)
  32.     - mindestens KickStart 2.04
  33.  
  34. ------------------------------------------------------------------------------
  35.                                  Benutzung
  36. ------------------------------------------------------------------------------
  37.  
  38.  
  39.     Befehlsformat:
  40.         UpDateCopy [FROM] {<sourcename|sourcepattern>} [TO] <destname>
  41.                        [QUIET] [ALL] [FORCE] [DEEP] [NODATECHECK]
  42.                    [TESTMODE] [CLONE] [PAPF] [SMARTINFO] [FAST]
  43.                    [NOASK] [CHECKARCBIT] [SETARCBIT]
  44.  
  45.     Befehlsschablone:
  46.         UpDateCopy FROM/M,TO/A,QUIET/S,ALL/S,FORCE/S,DEEP/S,
  47.                    NDC=NODATECHECK/S,TESTMODE/S,CLONE/S,PAB=PAPF/S,
  48.                    SMARTINFO/S,FAST/S,NOASK/S,SAB=SETARCBIT/S,
  49.                            CAB=CHECKARCBIT/S
  50.  
  51.  
  52.     Parameter:
  53.         sourcename, sourcepattern
  54.             Die Namen der zu kopierenden Dateien und Verzeichnisse
  55.             (auch Namensmuster).
  56.         destname
  57.             Name des Zielverzeichnisses.
  58.         QUIET
  59.             Schaltet die Ausgabe aus. Es werden nur nur Fehler-
  60.             meldungen angezeigt.
  61.         ALL
  62.             Wenn diese Option angegeben wird, durchsucht
  63.             UpDateCopy auch die Unterverzeichnisse; wenn nicht
  64.             dann nur Dateien und Verzeichnisnamen des Quell-
  65.             verzeichnisses.
  66.         FORCE
  67.             Normalerweise können Lösch-geschützte Dateien nicht
  68.             überschrieben werden. Wenn du diese Option an-
  69.             wählst ignoriert UpDateCopy diese Schutzbits.
  70.         DEEP
  71.             UpDateCopy vergleicht nur das Datum der Dateien.
  72.             Mit der DEEP-Option untersucht UpDateCopy die Dateien
  73.             erst nach Versionsnummern ($VER:) und vergleicht
  74.             diese. Nur wenn keine Versionsnummern zu finden sind,
  75.             wird das Datum verglichen.
  76.             Merke: Obwohl dieser Suchealgorithmus in Assembler
  77.                    geschrieben ist, verlangsamt diese Option das
  78.                    Programm.
  79.         NODATECHECK
  80.             Schaltet das Vergleichen des Datums aus. Das ist zum
  81.             Beispiel beim kopieren von gepackten Dateien nützlich.
  82.             Merke: Wenn diese Option angegeben wird, wird der
  83.                    DEEP-Scanmodus automatisch eingeschaltet.
  84.         TESTMODE
  85.             Schaltet den Testmodus ein. UpDateCopy kopiert/ersetzt
  86.             ältere Dateien nicht mehr und Verzeichnisse werden
  87.             auch nicht mehr angelegt. Dabei sind die Ausgaben
  88.             jedoch die selben wie ohne Testmodus. Diese Option
  89.             kann fürs einfache Vergleichen von Verzeichnissen
  90.             nützlich sein.
  91.         CLONE
  92.             Wenn diese Option angegeben wird kopiert UpDateCopy
  93.             das Datum von der Quelldatei.
  94.         PAB
  95.             Normalerweise löscht UpDateCopy das Archive-Schutzbit
  96.             bei kopierten Dateien. Wird diese Option angegeben
  97.             wird dieses Bit nicht verändert.
  98.             Bemerkung: UpDateCopy kopiert immer
  99.                     - die Schutzbits (außer Archive)
  100.                     - und den Dateikommentar.
  101.         SMARTINFO
  102.             UpDateCopy zeigt keine unveränderten ('skipped')
  103.                         Verzeichnisse und Dateien an.
  104.         FAST
  105.             Schaltet den Zeilenvorschub ab. Damit wird die
  106.             Bearbeitung vieler kleiner Dateien viel schneller, da
  107.             das Rollen der Anzeige länger als das Durchsuchen
  108.             dauert.
  109.         NOASK
  110.             Wenn ein Fehler auftritt, fragt UpDateCopy
  111.             normalerweise was es tun soll. Wird diese Option
  112.             angegeben, beendet sich das Programm automatisch.
  113.         CHECKARCBIT
  114.             Kopiert Dateien/Verzeichnisse nur, wenn ihr
  115.             Archive-Bit *nicht* gesetzt ist.
  116.             Normalerweise wird dieses Bit immer gelöscht, wenn
  117.             eine Datei verändert wird. In Verbindung mit
  118.             SETARCBIT können veränderte Dateien leicht kopiert
  119.             werden.
  120.             Bem.:    Auf Dateien mit einem gelöschten Archive-Bit
  121.                 werden alle Vergleichsmethoden (Datums-
  122.                 vergleich, DEEP) angewendet.
  123.         SETARCBIT
  124.             Setzt das Archive-Bit bei allen kopierten Dateien/
  125.             Verzeichnissen.
  126.  
  127.     Beispiele:
  128.         UpDateCopy #? ram:T
  129.             Kopiert alle Dateien des aktuellen Verzeichnisses nach
  130.             "ram:T". Nicht existierende Dateien werden kopiert,
  131.             nicht existierende Verzeichnisse werden erzeugt.
  132.             Existierende Dateien werden nur überschrieben, wenn
  133.             sie älteren Datums sind.
  134.         UpDateCopy #? ram:T ALL
  135.             Das selbe wie vorher aber UpDateCopy untersucht jetzt
  136.             auch Unterverzeichnisse.
  137.         UpDateCopy #? ram:T DEEP
  138.             Wie das erste Beispiel aber UpDateCopy vergleicht
  139.             nicht nur das Datum sondern vorher die Versionsnummern
  140.             (wenn vorhanden).
  141.         UpDateCopy #? ram:T DEEP NDC
  142.             Wie das erste Beispiel aber UpDateCopy vergleicht
  143.             nur die Versionsnummern. Wird keine Versionsnummer
  144.             gefunden kopiert/ersetzt UpDateCopy keine Dateien
  145.             auch wenn sie neueren Datums sind. Auch nicht
  146.             existierende Verzeichnisse werden nicht angelegt.
  147.         UpDateCopy #?.info #?.e TO=ram:T ALL DEEP esource:3D/Plotter3D
  148.             Kopiert all Dateien des aktuellen Verzeichnisses nach
  149.             "ram:T" welche mit ".info" oder ".e" enden. Auch
  150.             Unterverzeichnisse werden untersucht und die Datei
  151.             "esource:3D/Plotter3D" wird kopiert.
  152.         UpdateCopy sys: TO backup: ALL CAB SAB SMARTINFO
  153.             Das ist meine normale Backup-Routine. Es werden nur
  154.             geänderte Dateien (Archive-Bit) kopiert, das
  155.             Archive-Bit wird dort gesetzt und eine Liste aller
  156.             kopierten Dateien wird angezeigt.
  157.  
  158. ------------------------------------------------------------------------------
  159.                                    Author
  160. ------------------------------------------------------------------------------
  161.  
  162.     Schicke Fehlerreports, Ideen, usw. an:
  163.  
  164.                                Sven Steiniger
  165.  
  166.                               Rathener Str. 29
  167.                                01259 Dresden
  168.                                 Deutschland
  169.  
  170.                      Email: ss37@irz.inf.tu-dresden.de
  171.  
  172. ------------------------------------------------------------------------------
  173.                                Copyright etc.
  174. ------------------------------------------------------------------------------
  175.  
  176. UpDateCopy ist CARDWARE, das bedeutet dass du mir eine Email schicken
  177. solltest, wenn du dieses Programm benutzt. Auch kleine Geschenke sind immer
  178. willkommen.
  179.  
  180.  Copyright
  181. -----------
  182. UpDateCopy wurde geschrieben von Sven Steiniger. Du kannst den Quelltext frei
  183. in deinen eigenen Programmen verwenden oder ihn einfach erweitern. Aber, bitte
  184. verbreitet eine modifizierte Version nicht unter diesem Namen (UpDateCopy),
  185. Wenn der Quelltext zu etwas nützlich war, würde ich mich über eine Kopie des
  186. Programms freuen.
  187.  
  188.  Verbreitung
  189. -------------
  190. Dieses Programm kann frei verbreitet werden solange der Archiv-Inhalt nicht
  191. verändert wird and keinerlei Profit damit gemacht wird.
  192. Archiv-Inhalt:
  193.     UpDateCopy/UpDateCopy        - die ausführbare Datei
  194.     UpDateCopy/Source/UpDateCopy.e    - der Quelltext (AmigaE)
  195.     UpDateCopy/Docs/UpDateCopy.doc    - Englische Dokumentation
  196.     UpDateCopy/Docs/UpDateCopy.dok  - Deutsche Dokumentation
  197.     UpDateCopy/Scripts/BackUpUp     - Backup-Skript von Attilio Scifoni
  198.     UpDateCopy/Scripts/BackUpUp2    - modifiziertes BackUpUp-Skript
  199.     UpDateCopy/Scripts/BackUpUp_GUI - BackUpUp2 mit Requestern
  200.     UpDateCopy/Scripts/BackUpUp.doc - englische Beschreibung der Skripte
  201.     UpDateCopy/readme        - Kurzinformation
  202.  
  203.  
  204.  Haftung
  205. ---------
  206. Ich (der Author) bin in keiner Weise für Schäden, die direkt oder indirekt
  207. durch dieses Programm erzeugt wurden, verantwortlich.
  208.