home *** CD-ROM | disk | FTP | other *** search
/ Amiga GigaPD 3 / Amiga_GigaPD_v3_3of3.iso / wbsplitter / wbsplitter.dok < prev    next >
Text File  |  1993-06-25  |  15KB  |  409 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               (WB)FileSplitter V 1.2
  12.                               ----------------------
  13.  
  14.                         Programmierung, Konzept, Idee: MMR
  15.  
  16.                                   ⌐ 1992 BY MMR ⌐
  17.  
  18.  
  19.                         Nur fuer Kick 2.0 (V37.) aufwaerts
  20.                         **********************************
  21.                                     >Freeware<
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. Inhalt:
  32. -------
  33.    1.   FileSplitter         ---> WB-CLI Version
  34.    2.   FileSplitter.info    ---> Sehr wichtig fuer Gundeinstellung
  35.    3.   FileSplitter.dok     ---> Dies File hier....
  36.  
  37.  
  38. Benoetigte Lib:
  39. ---------------
  40.    Libs: reqtools.library.....V37.?? oder hoeher
  41.    Lha/Lzh/arc kompatiebler Packer
  42.  
  43.  
  44.  
  45.  
  46. Allgemeines
  47. -----------
  48.  
  49. Mit dem FileSplitter ist es moeglich, sich ein File oder mehrere Files aus
  50. einem [.lha/.lzh] File zu entpacken.
  51. Desweiteren ist es auch moeglich Files und Directorys zu selektieren und
  52. diese zu packen, als extra File.lha oder an ein File anzuhaengen.
  53.  
  54. Warum denn sowas?
  55. Vielleicht moechte man sich nur mal das Doc.File oder Programmfile aus einem
  56. Paket entpacken lassen, und wenn das Paket 600 KB gross ist (und man kein
  57. Besitzer einer Turbokarte ist), kann das ganz schoen nerven bis das Paket
  58. entpackt ist, evtl. hat man auch zu wenig Speicher um das ganze Paket ins
  59. RAM: zu entpacken, usw....
  60. Mittlerweile bin ich bei der Version 1.2 angelangt, mit dieser ist es nun
  61. auch moeglich File(s) oder Directorys zu packen, also ist der FileSplitter
  62. schon sowas wie eine Benutzeroberflaeche fuer den LHA.
  63.  
  64.  
  65. Installation
  66. ------------
  67.     CLI:  Einfach FileSplitter eingeben und Return druecken.
  68.  
  69.           Beim CLI-Start werden keine Eingabeparameter erwartet, d.h.
  70.           der FileSplitter benutzt seine internen Werte, also die
  71.           die Defaultwerte, diese koennen aber jederzeit geaendert werden!
  72.           Als da waeren:
  73.  
  74.  
  75.               GADGETS             Einstellung
  76.               -------             -----------
  77.  
  78.           1.  Showlist           aktiviert
  79.           2.  Showextract        aktiviert
  80.           3.  Suchpfad           Default Pfad   SYS:
  81.           4.  Packerpfad         Default Packer c:LHA
  82.           5.  Optionen                  ----
  83.           5.1 |-- Outputwindow   Default CON:10/30/620/198/Filesplitter Output
  84.           5.3 |-- Entpackoption  Default e
  85.           5.4 |-- Packoption     Default -w -x a
  86.           6.  Zielpfad           Default Pfad   RAM:
  87.           7.  Windowdelay        Default 2 Sekunden
  88.  
  89.  
  90.      WB:  Einfach auf das Icon doppelklicken
  91.  
  92. WICHTIG:  Das Icon enthaelt wichtige >Tooltype< Eintraege,also
  93.           einmal anklicken, dann in der Menueleiste >Piktogramm/Information
  94.           oder mit R-AMIGA-I, das Tooltypearray editieren!
  95.  
  96.  
  97.           1. SHOWLIST=        YES/NO
  98.           2. SHOWEXTRACT=     YES/NO
  99.           3. OUTPUTWINDOW=    Definiert das Extrackt/Packwindow
  100.           4. ZIELPFAD=        Das Destination Directory
  101.           5. PACKERPFAD=      Den Pfad und Packer
  102.           6. SUCHPFAD=        Das Directory zum LHA Files einlesen
  103.           7. ENTPACKOPTION=   Die Optionen des LHA zum entpacken
  104.           8. PACKOPTION=      Die Optionen des LHA zum packen
  105.           9. WINDOWDELAY=     Zeit die verstreicht bis das window schliesst
  106.  
  107.  
  108.           Diese Einstellungen werden dann vom FileSplitter uebernommen.
  109.           -------------------------------------------------------------
  110.  
  111. Arraytypen: SHOWLIST=YES/NO        ....listet das .lha File in einem Shell
  112.                                        Window auf, eigendlich nur wichtig
  113.                                        um festzustellen ob das File ok ist.
  114.                                      * siehe auch WINDOWDELAY, OUTPUTWINDOW
  115.  
  116.  
  117.             SHOWEXTRACT=YES/NO     ....listet das selektierte File in einem
  118.                                        Shell-Window auf, auch nur wichtig
  119.                                        um festzustellen ob das File ok ist.
  120.                                      * siehe auch WINDOWDELAY, OUTPUTWINDOW
  121.  
  122.  
  123.             OUTPUTWINDOW=CON:10/30/620/200/Outputwindow
  124.                                    ....hier koennen die Shell-Window
  125.                                        groessenangaben eingestellt werden,
  126.                                        Diese Optionen werden genauso wie
  127.                                        im CLI erwartet
  128.                                      * siehe auch SHOWEXTRACT, WINDOWDELAY
  129.                                        SHOWLIST
  130.  
  131.                    Die Parameter werden genauso wie im CLI erwartet
  132.  
  133.             also:  CON:10/30/620/200/Windowname
  134.                     |  |  |  |   |   |_____________Titel des Fensters
  135.                     |  |  |  |   |_________________Hoehe in Bildpunkten
  136.                     |  |  |  |_____________________Breite in Bildpunkten
  137.                     |  |  |________________________Y-Startpunkt des Fensters
  138.                     |  |___________________________X-Startpunkt des Fensters
  139.                     |______________________________Device
  140.  
  141.  
  142.             ZIELPFAD=RAM:          ....hier kann der Pfad des entpackten
  143.                                        Files.lha eingestellt werden, z.B.:
  144.                                        DF0:, DH0:Tools usw.
  145.  
  146.  
  147.             SUCHPFAD=DH1:Download  ....hier kann das Directory eingestellt
  148.                                        werden, in dem man die .lha Files
  149.                                        liegen hat.
  150.  
  151.  
  152.             PACKERPFAD=C:LHA       ....hier wird der Pfad und der Packer
  153.                                        eingestellt.
  154.  
  155.  
  156.             ENTPACKOPTION=e        ....hier die Option (e) entpacken
  157.  
  158.  
  159.             PACKOPTION=-w -x a     ....hier -w = set Workdirectory, sehr
  160.                                        wichtig damit nur die selektierten
  161.                                        File und Diectorys gepack werden und
  162.                                        nicht der komplette Pfad ab dem
  163.                                        Devicenamen.
  164.                                        -x = Use Pathnames
  165.                                        a = add also packen
  166.  
  167.  
  168.             WINDOWDELAY=2          ....Die Wartezeit bis das Shell-Window
  169.                        (0)             wieder geschlossen wird.
  170.                                        Wird der Wert 0 eingegeben, erscheint
  171.                                        im Outputwindow der Text
  172.                                        "Press RETURN..."
  173.                                        Das Window bleibt solange geoeffnet
  174.                                        bis mit RETURN bestaetigt wird!!
  175.  
  176.  
  177.  
  178.  
  179. Benutzung
  180. ---------
  181.                                   FEHLER
  182.                                 **********
  183.  
  184. Sollte etwas mit den Optionen nicht stimmen, z.B. ein Zeichen vergessen,
  185. Windowgroesse stimmt nicht, falscher Pfad, wird dieses mit einem aufblitzen
  186. des Screen angedeutet.                                           ^^^^^^^^^^
  187.  
  188. Um an die Default-Einstellungen zu gelangen, braucht man nur einmal CANCEL
  189. im Requester (fuer alle Optionen, Zielpfad, Packerpfad, Suchpfad)   ^^^^^^
  190. bestaetigen, und die Standartoptionen werden uebernommen.........
  191. Diese Optionen waeren dann mit den der CLI-Eingabe identisch!
  192.  
  193.  
  194.  
  195. Nach dem starten...
  196. -------------------
  197.  
  198. Taste=R-AMIGA-Q oder das Closewindow-Gadget
  199. -------------------------------------------
  200.  
  201.    Hiermit wird das Programm beendet, bzw. auch mit dem Menueeintrag QUIT.
  202.  
  203.  
  204. Show List und Show Extract
  205. --------------------------
  206.  
  207.    Die Gadgets Show List und Show Extract sind zum ueberpruefen des Files
  208.    gedacht, z.B. kann das File ein CRC-Error haben, und dieses merkt man nur
  209.    an dem Output des Packers und dem Returncode und evtl. gefolgt von einem
  210.    aufblitzen des Screen......
  211.  
  212.  
  213. Taste=SPACE oder das Cycel-Gadget
  214. ---------------------------------
  215.  
  216.    Das Cycel-Gadget beinhaltet drei Moeglichkeiten:
  217.  
  218.     1.  Information         ...kleines Info
  219.     2.  File entpacken      ...das .lha File anwaehlen
  220.     3.  File(s) packen      ...Files und Directorys packen
  221.     4.  Palette             ...Farben aendern
  222.  
  223.    Diese Funktionen koennen auch mit der SPACE-TASTE durchgeblaettert werden
  224.    Zu aktivieren sind diese dann mit dem Starten-Gadget, oder R-AMIGA-S
  225.  
  226.  
  227. Taste=R-AMIGA-S oder das Starten-Gadget
  228. ---------------------------------------
  229.  
  230.    Mit diesem Gadget werden die Aktionen ausgefuehrt die im Cycel-Gadget
  231.    selektiert wurden.
  232.  
  233.  
  234. Taste=R-AMIGA-P oder das Packerpfad-Gadget
  235. ------------------------------------------
  236.  
  237.    Hier wird der Packer gewaehlt, z.B. LHA oder LZ.
  238.    Wird im Requester CANCEL gewaehlt, wird der Defaultwert c:LHA uebernommen.
  239.  
  240.  
  241. Taste=R-AMIGA-Z oder das Zielpfad-Gadget
  242. ----------------------------------------
  243.  
  244.    Hier wird der Zielpfad (Greraet/Directory) angewaehlt, z.B. RAM:, DH0:Tool
  245.    Wird im Requester CANCEL gewaehlt, wird der Dafaultwert RAM: uebernommen.
  246.  
  247.  
  248. Taste=R-AMIGA-O oder das Optionen-Gadget
  249. ----------------------------------------
  250.  
  251.    Es erscheint ein neues Window, indem die Pack, Entpack, und Windowoptionen
  252.    eingestellt werden koennen.
  253.    Das Eingabeformat etspricht dem des Tooltypearrays, bitte dort nachlesen!
  254.    Wird im Requester CANCEL gewaehlt, wird der Defaultwert fuer:
  255.  
  256.    1.       Outputwindow: CON:10/30/620/198/Filesplitter Output
  257.  
  258.    3.       Packeroption: e
  259.  
  260.    4.      Entpackoption: -w -x a
  261.  
  262.    uebernommen.
  263.  
  264.  
  265.  
  266.                               Los gehts
  267.                              ***********
  268.  
  269.  
  270. Also dann, Files entpacken:
  271. ---------------------------
  272.  
  273. Das Cycelgadget auf File entpacken stellen und einmal auf das
  274. Startengadget klicken. Es erscheint ein Filerequester in dem das File
  275. angewaehlt werden kann. Sollte das Gadget Show List aktiv sein, wird ein
  276. Listing ausgegeben.
  277. Sollte alles richtig eingestellt sein erscheinen 5 neue Gadgets.
  278. Nun erscheint eine Liste der Files aus dem .lha Paket, diese brauchen
  279. einfach nur einmal angeklickt zu werden! Sollte das Gadget Show Extract aktiv
  280. sein, wird das entpacken in einem Shell-Window angezeigt.
  281. Nach dem entpacken wird das selektierte File aus der Liste geloescht!
  282.  
  283. Wird das Multi-Wahl Gadget einmal angeklickt (dadurch wird das Multi-Doit
  284. Gadget waehlbar), kann ab sofort in das Listwindow geklickt werden ohne das
  285. die Files sofort ertpackt werden. Erst nach bestaetigen des Multi-Doit
  286. Gadgets werden die selektierten Files entpackt, oder aber es wurde das
  287. letzte File in der Liste angeklickt, dann wird automatisch entpackt.
  288.  
  289. Um die Multi-wahl Funktion wieder abzuschalten, genuegt es einmal auf das
  290. Multi-Doit Gadget zu klicken, aber nur wenn noch kein File selektiert worden
  291. ist, wurden Files selektiert, werden dieses erst entpackt!
  292.  
  293. Das Nix mehr Gadget bricht alles ab und fuehrt wierder zum Hauptmenue.
  294. Das New File Gadget bricht alles ab und fuehrt sofort wieder in den
  295. Fileauswahl Requester um ein neues File zu selektieren.
  296. Sollte das Multi-Wahl Gadget gerade aktiv sein und es wurden Files
  297. selektiert, werden dies ignoriert!!
  298.  
  299.  
  300.  
  301. Taste=R-AMIGA-N oder das Nix mehr-Gadget
  302. ----------------------------------------
  303.  
  304.    Hiermit gelangt man wieder in den Anfangszustand des Programms um evtl. ein
  305.    neues File zu laden, oder die Optionen aendern zu koennen.
  306.  
  307.  
  308. Taste=R-AMIGA-F oder das New File-Gadget
  309. ----------------------------------------
  310.  
  311.    Hiermit gelangt man sofort in den Filerequester, um ein neues File
  312.    einzulesen! Die durch Multi-Wahl selektierten Files werden nicht mehr
  313.    entpackt.
  314.  
  315.  
  316. Taste=R-AMIGA-M oder das Multi-Wahl-Gadget
  317. ------------------------------------------
  318.  
  319.    Dieses Gadget wird nach dem anklicken inaktiv und das Multi-Doit Gadget
  320.    aktiv. Dies bedeutet, das alles jetzt angeklickten Files gepuffert werden
  321.    und erst dann entpackt werden wenn das Multi-Doit Gadget angeklickt wird,
  322.    oder das letze File in der Liste selektiert wurden ist.
  323.    Wurde kein File selektiert und man klickt in das Multi-Doit Gadget, blitz
  324.    der Screen einmal, und man gelang wieder in den Entpackmodus einzelner
  325.    Files.
  326.  
  327.  
  328. Taste=R-AMIGA-D oder das Multi-Doit-Gadget
  329. ------------------------------------------
  330.  
  331.    Diese Gadget ist nur aktiv wenn das Multi-Wahl Gadget aktiviert worden
  332.    ist. Hiermit werden die selektierten Files dann entpackt.
  333.    Sollten noch Files in der Liste vorhanden sein die nicht selektiert
  334.    wurden, werden diese wieder angezeigt.
  335.  
  336.  
  337. File(s) packen:
  338. ---------------
  339.  
  340. Das Cycelgadget auf File(s) packen stellen, und einmal das Startengadget
  341. anklicken. Es erscheint nun ein MULTISELECT-REQUESTER, das heisst, um
  342. mehrere Files oder auch Directorys zu selektieren haelt man einfach die
  343. SCHIFT-TASTE gedrueckt und klickt das File oder Directory EINMAL an.
  344. Ich hoffe das mit dem Requester jeder vertraut ist, er bietet wirklich sehr
  345. viel Optionen.
  346. Gut, nach dem selektieren erscheinen wieder 4 neue Gadget und ein Listgadget!
  347. In diesem werden jetzt alle selektierten Files und Directory angezeigt.
  348. Mit Abbruch wird sofort wieder zum Startmenu gesprungen.
  349. Ein Klick auf das Remove Gadget aktiviert dieses, dadurch werden die anderen
  350. Gadget inaktiv, ein nochmaliger Klick auf das Remove Gadget schaltet die
  351. Remove Funktion wieder ab, dadurch werden die anderen Gadget wieder aktiv.
  352. Bei aktivem Remove kann jetzt in die Liste geklickt werden um Files oder
  353. Directorys zu loeschen, falls man diese doch nicht packen moechte!
  354. Bei Nichtaktivem Remove kann jetzt einfach in die Liste geklickt werden und
  355. diese File oder Directory wird dann gepack, in diesem Moment erscheint ein
  356. neuer Requester in dem man den Pfad und Filenamen angeben kann.
  357. Ein Klick auf das Packen Gadget packt alle Files und Directorys in der List
  358. und spring dann in das Startmenu zurueck. Auch hier wird nach dem Pfad und
  359. Filenamen durch ein Requester gefragt, sollte dies nicht vorher schon
  360. geschehen sein.
  361. Ein Klick auf das File dazu Gadget packt alles Files oder Directorys in der
  362. Liste, sollte noch kein Filename existieren wird auch diese per Requester
  363. erfragt. Danach wird sofort wieder der MULTISELECT-REQUESTER aufgerufen um
  364. neue Files oder Directorys zu selektieren. Doch bei diesem Gadget wird
  365. spaeter nicht mehr nach dem Pfad und Filenamen fuer das Packfile gefragt,
  366. also werden die Daten an das bestehende File.lha angehaent.
  367.  
  368.  
  369. Taste=R-AMIGA-A oder das Abbruch-Gadget
  370. ---------------------------------------
  371.  
  372.    Dieses Gadget bricht alles ab und springt in das Startmenu.
  373.  
  374.  
  375. Taste=R-AMIGA-P oder das Packen-Gadget
  376. --------------------------------------
  377.  
  378.    Hiermit werden die Files oder Directorys in der Liste gepackt, es wird
  379.    mit einem Requester der Pfad und Filename erfragt, danach gelangt man
  380.    wieder in das Startmenu
  381.  
  382.  
  383. Taste=R-AMIGA-R oder das Remove-Gadget
  384. --------------------------------------
  385.  
  386.    Wird in dieses Gadget geklickt, aktiv wenn die anderen Gadgets
  387.    inaktiv sind, kann ein File oder Directory aus der Liste geloescht werden
  388.    indem man das File oder Directory anklickt.
  389.    Ein nochmaliger Klick in das Remove Gadget hebt diese Funktion wieder
  390.    auf, erkenntlich an den anderen aktiven Gadgets. Ab jetzt kann wieder ein
  391.    einzelnes File oder Directory gepackt werden indem man es einfach in der
  392.    Liste anklickt.
  393.  
  394.  
  395. Taste=R-AMIGA-F oder das New File-Gadget
  396. ----------------------------------------
  397.  
  398.    Wird dieses Gadget angeklickt, werden die Eintraege der Liste gepackt und
  399.    danach erscheint der MULTISELECT-REQUESTER um neue Files zu selektieren, die
  400.    dann wieder an das bestehende File.lha gepackt werden.
  401.  
  402.  
  403. Hmm, das waere dann schon das Groebste, denk ich.
  404.  
  405.  
  406.  
  407. MMR.........(Barney)
  408.  
  409.