home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / opus / v5 / arcbyname / arcbyname.dok < prev    next >
Text File  |  1977-12-31  |  7KB  |  190 lines

  1. ****************************** DOKUMENTATION FUER **************************
  2.  
  3.                                 ArcByName.DOpus5
  4.                                      V1.0
  5.                               von Willy Gwerder
  6.                              für DirectoryOpus V5.11
  7.                               mit Lha und/oder LZX
  8.  
  9. ************************** geschrieben von Willy Gwerder *******************
  10.  
  11.  
  12. Wollten Sie auch schon mal...
  13. -----------------------------
  14.  
  15. ...mit dem DirOpus5 eine Reihe von Verzeichnissen oder Files in einzelne
  16. Archive packen? Dann haben Sie bestimmt bemerkt, dass es mühsam ist, jedem
  17. Archiv einen eigenen Namen geben zu müssen. Um dem abzuhelfen, habe ich
  18. dieses AREXX-Programm für DOpus geschrieben.
  19.  
  20.  
  21. Was ArcByName macht
  22. -------------------
  23.  
  24. Mit ArcByName können Sie die selektionierten Einträge - sowohl Files als
  25. auch Verzeichnisse - als Archive ins Zielverzeichnis kopieren oder
  26. verschieben. Die Archive erhalten den selben Namen wie die Originale aber
  27. natürlich mit dem Zusatz .lha bzw .lzx.
  28.  
  29.  
  30. Systemanforderungen
  31. -------------------
  32.  
  33. - Einen Amiga.
  34.   (Am besten einen mit 68060 Prozessor, einer superschnellen Grafikkarte
  35.   mit 1600x1280 Auflösung und einer Gigabyteplatte. Aber eigentlich reicht
  36.   auch ein Amiga der die Mindestanforderungen von DOpus5 erfüllt).
  37. - Directory Opus 5.11
  38. - Die Archivierprogramme LhA und/oder LZX im c: Verzeichnis.
  39.  
  40.  
  41. Installation
  42. ------------
  43.  
  44. Am besten kopieren Sie ArcByName.DOpus5 ins ARexx Verzeichnis von DOpus5:.
  45. ArcByName können Sie z.B. auf einen Knopf oder auch ins Benutzermenü von
  46. DOpus5 legen. Rufen Sie dazu den entsprechenden Editor auf. Im Funktions-
  47. editor wählen Sie "Hinzufügen", setzen das Cycle Gadget auf ARexx und geben
  48. den Pfad (zB DOpus:Arexx/) an. ArcByName braucht nun noch
  49. folgende Argumente:
  50.  
  51. ArcByName.DOpus5 lha {Qp}                oder
  52. ArcByName.DOpus5 lzx {Qp}
  53.  
  54. Sie können also zwischen lha oder lzx als Archivierprogramm wählen.
  55. (Für diejenigen die's nicht gemerkt haben: Man kann auch zwei Knöpfe
  56. definieren. Einen mit lha und den anderen mit lzx ;-)
  57.  
  58. Das Argument {Qp} wird benötigt, um den ARexx-Port von DOpus zu lokalisieren.
  59. Falls Sie dieses Argument weglassen, wird automatisch der Port des ersten
  60. gestarteten DOpus verwendet (DOPUS.1).
  61.  
  62. Wenn Sie nun die Konfiguration speichern, erhalten Sie einen neuen Knopf
  63. bzw. einen neuen Menüeintrag. Wenn diese kurze Instruktion nicht genügt,
  64. dann schlagen Sie bitte in Ihrem DOpus5 Benutzerhandbuch nach.
  65.  
  66.  
  67. Wie man es benutzt
  68. ------------------
  69.  
  70. Eigentlich funktioniert das Ganze wie das Kopieren von Einträgen. Stellen
  71. Sie das Quell- und Zielverzeichnis ein, markieren Sie die Einträge, welche
  72. Sie archivieren möchten, und starten Sie ArcByName. Ein Requester wird
  73. aufgehen und fragen:
  74.  
  75. "Delete source-files after archiving?"
  76. (= Sollen die Quelldateien nach dem archivieren gelöscht werden?)
  77.  
  78. Sie können dann zwischen YES und NO auswählen. Klicken Sie auf NO, so werden
  79. die angewählten Einträge als Archive ins Zielverzeichnis KOPIERT. Wird YES
  80. gedrückt, so erfolgt eine Sicherheitsabfrage:
  81.  
  82. "Are you sure???"
  83. (=Sind Sie sicher???)
  84.  
  85. Klickt man auf YES, so werden alle Einträge als LhA- bzw. LZX-Archive ins
  86. Zielverzeichnis VERSCHOBEN, dh. die Originalfiles werden gelöscht. Bei NO
  87. wird die erste Frage wiederholt.
  88.  
  89. Haben Sie sich durch die Requester durchgekämpft, so startet der
  90. Archivier-Vorgang und es öffnen sich ein Fortgangsindikator und ein kleines
  91. Ausgabe-Fenster. Dieses zeigt, was gerade archiviert wird. Der momentan
  92. bearbeitete Eintrag wird im Fortgangsindikator angezeigt.
  93.  
  94. Das Programm macht temporäre Einträge im Zielverzeichnis. Anstatt der
  95. File-Grösse wird die Bearbeitungsnummer angezeigt. Sind alle Einträge
  96. archiviert, so wird das Zielverzeichnis neu eingelesen, und die richtige
  97. Grösse erscheint.
  98.  
  99. Quell- und Zielverzeichnis können übrigens auch gleich sein. Das ist
  100. besonders mit der "Delete Source-Files" Option nützlich für den Fall, dass
  101. man ein Verzeichnis "kompakter" machen möchte. Dabei ist aber zu beachten,
  102. dass die einzelnen Dateien von selektionierten Verzeichnissen erst gelöscht
  103. werden, wenn das gesamte Verzeichnis archiviert wurde. Achten Sie also
  104. darauf, dass genügend Spielraum auf der Disk vorhanden ist.
  105.  
  106. Die *.info Files müssen übrigens nicht markiert werden, da sie automatisch
  107. ins Archiv übernommen werden falls vorhanden. Es macht aber auch nichts,
  108. wenn Sie es trotzdem tun.
  109.  
  110. Allerdings lassen sich *.info Files nicht als einzelne Archive erzeugen.
  111. (Es wäre ja auch nicht besonders sinnvoll). Sie werden vom Programm einfach
  112. übergangen.
  113.  
  114.  
  115. Wie man abbrechen kann
  116. ----------------------
  117.  
  118. Es gibt zwei Methoden das Programm abzubrechen:
  119.  
  120. 1. Das ARexx Programm kann abgebrochen werden, indem Sie auf die Schalt-
  121. fläche "Abbrechen" im Fortgangsindikator klicken. Das Skript wird angehal-
  122. ten, sobald das Archivierprogramm auf den nächsten markierten Eintrag
  123. zugreifen will. Wenn man also grössere Verzeichnisse archiviert, kann das
  124. ein Weilchen dauern. Dafür wird der gerade bearbeitete Eintrag noch fertig
  125. gemacht.
  126.  
  127. 2. Um das Programm sofort abzubrechen, klick man zuerst das Ausgabe-Fenster
  128. aktiv (der Mauszeiger ist nun nicht mehr "beschäftigt") und drückt dann
  129. CTRL-C. Der gerade bearbeitete Eintrag wird "fallengelassen", und das
  130. halbfertige Archiv-File nicht gespeichert. Sollte die "Delete Source-File"
  131. Option eingeschaltet sein, so wird der Quelleintrag natürlich nicht
  132. gelöscht.
  133.  
  134.  
  135. Haftung
  136. -------
  137.  
  138. Sie benutzen dieses Programm voll und ganz auf eigenes Risiko. Ich, der
  139. Author, kann in keinster Weise für irgendwelche Schäden oder Datenverluste,
  140. welche durch dieses Programm entstanden sind, verantwortlich gemacht werden,
  141. erst recht nicht, wenn das Programm verändert wurde.
  142.  
  143. ArcByName.DOpus5 ist Public Domain und darf nicht mit Profit verkauft
  144. werden. Es darf und soll frei kopiert, verbreitet und/oder und erweitert
  145. werden. Die beiden Dokumentationsfiles (deutsch und englisch) müssen
  146. allerdings enthalten sein.
  147.  
  148. Wenn Sie dieses Programm abändern und dann trotzdem weiterverbreiten,
  149. sollten Sie die Aenderungen unbedingt im Dok vermerken. Wenn Sie selber
  150. eine bessere Version des Programmes ausgearbeitet haben, dürfen Sie mir
  151. diese natürlich auch gerne zusenden... Sollten Sie in ArcByName Fehler
  152. finden, oder eine gute Idee zur Erweiterung haben, so können Sie Ihre
  153. Vorschäge richten an:
  154.  
  155.  
  156. Willy Gwerder
  157. Grundstrasse 97
  158. 6430 Schwyz
  159. Schweiz
  160.  
  161. e-mail: eagwerde@ztl.ch
  162.  
  163.  
  164. Sie dürfen ArcByName gerne auch als "Cardware" oder "e-mail-ware"
  165. betrachten und mir eine nette Ansichtskarte oder eine kurze Nachricht
  166. senden :-)
  167.  
  168.  
  169. Programmgeschichte
  170. ------------------
  171.  
  172. Das Programm basiert auf der Version V1.2 meines ARexx-Programms
  173. LhAByName.rexx für DOpus 4.11 vom 30.09.1994.
  174.  
  175.  
  176. 29.09.1995  V1.0  Erste Veröffentlichung
  177.  
  178.  
  179. Tests
  180. -----
  181.  
  182. Das Programm wurde ausgiebig getestet auf meinem:
  183.  
  184. A4000/40
  185.  
  186. mit Directory Opus V5.11 deutsch
  187. Lha V1.38e
  188. LZX V1.20e Version für 68040/68060
  189.  
  190.