home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma40.dms / ma40.adf / DeInstaller / DeInstaller.doc < prev    next >
Text File  |  1995-07-09  |  13KB  |  374 lines
  1.  
  2.              --------------------------------------------------
  3.  
  4.                           »»» DeInstaller v1.1a «««
  5.                  "The only way to keep your harddisk clean!"
  6.  
  7.                     Beetware © 1994-1995 The Beet Research
  8.  
  9.                         written by Grzegorz Calkowski
  10.  
  11.       -----------------------------------------------------------------
  12.  
  13.  
  14. Disclaimer
  15. ----------
  16.  
  17.     The program executable and information above is provided "as is".  No
  18. representations or warranties are made with respect to the accuracy,
  19. reliability, performance, currentness, or operation of this software and
  20. information, and all use is at your own risk.  The author doesn't assume any
  21. responsibility or liability whatsoever with respect to your use of the
  22. program and information.
  23.  
  24.  
  25. Copying
  26. -------
  27.  
  28.     DeInstaller is published under "BeetWare" conception.  It's very special
  29. sort of GiftWare.  It means you should send a beet to the author (but not a
  30. rotten one!  8).  Well, if you run short on beets send a disk or a small
  31. donation or anything else.  (Have a hint:  a bottle of beer would be
  32. excellent...  :)
  33.  
  34. This program can be freely distributed under following conditions:
  35.  
  36.         1. Everything in this distribution must be kept together and
  37.            unaltered. Applies to:
  38.  
  39.            DeInstaller                    (the program itself)
  40.            DeInstaller.info               (its icon)
  41.            DeInstaller.doc                (plain-ascii doc)
  42.            DeInstaller.doc.info
  43.            DeInstaller.guide              (AmigaGuide®'ed doc)
  44.            DeInstaller.guide.info
  45.            libs/reqtools.library          (Nico's marvelous lib)
  46.            MWB-Icons/DeInstaller.info     (program icon in MagicWB style :)
  47.            MWB-Icons/DeInstaller_alt.info (an alternate MWB icon)
  48.            MWB-Icons.info
  49.  
  50.         2. Copyright notices are not removed from executable and
  51.            documentation.
  52.  
  53.         3. No more than a nominal fee is charged to cover cost of magnetic
  54.            media.
  55.  
  56. DeInstaller is Copyright (C) 1994 The Beet Research. All rights reserved.
  57.  
  58. The program uses:
  59.  
  60.               MultiGUI Copyright (C) TBR (it's linked together with program
  61.                                           should be available as a shared
  62.                                           library soon... :-)
  63.  
  64.               ReqTools library Copyright (C) Nico François.
  65.  
  66.  
  67. Introduction
  68. ------------
  69.  
  70.     Every time you tried to install to your system a complex program
  71. spreading its stuff all over your harddisk (fonts, libs, scripts, locales,
  72. prefs, ARexx scripts and other accompaning files) you wondered "How will I be
  73. able to restore previous state of my harddisk?".  How many times you removed
  74. a program you couldn't figure out what file belongs to?  How many times you
  75. found a file in deep nookes of harddisk and you said "WHAT THE HELL IS IT?"
  76. and finally you didn't delete it???  Well, no more...
  77.  
  78.     DeInstaller should be used during installation.  It looks for all write
  79. attempts (including creating subdirectories) and creates an AmigaDOS script
  80. which, when executed, will throw out all the mess the installer did.  It also
  81. looks for all overwrite attempts giving you possibility to backup existing
  82. files (extension '.old' will be added).
  83.  
  84.  
  85. Features
  86. --------
  87.  
  88.    o Ability to deinstall everything you've installed.  Doesn't matter what
  89.      you've used to install (orginal Installer by Commodore, other custom
  90.      installers, install scripts or even you did it by hand...  :)
  91.  
  92.    o Font-sensitive GUI, fully keyboard controlled, just Commodore's user
  93.      interface style guide compliant (maybe except locale, sorry). But...
  94.      not only.  I followed Nico François standards, what means when you press
  95.      a key assigned to a gadget it will be visualised and you can cancel it by
  96.      pressing a SHIFT key.  Even more.  There is a keypress timeout (very
  97.      useful when your other hand holds a cake, cup of coffee, bottle of beer
  98.      or even a girlie ;-).
  99.  
  100.    o MultiGUI'ed what means internal multitasking.  It's not so usable in
  101.      such a program but, for example, while DeInstaller is tracing you can
  102.      execute a script.  Or even you can contemplate 20 "Abouts"
  103.      simultaneously. Moreover it gives you proper (one pixel lower)
  104.      underscore char even if you use the ugly topaz (another great Nico's
  105.      idea - but mine is smarter, if you use a proportional font, underscore
  106.      won't be placed too low...  :).
  107.  
  108.    o 100% legal (well, almost :) & 100% assembly code.
  109.  
  110.    o Thoroughly tested with Enforcer & Mungwall.
  111.  
  112.  
  113. Requirements
  114. ------------
  115.  
  116.     DeInstaller requires an Amiga (surprise?) with at least Kickstart
  117. 2.04 (NOTE:  tested only on 3.0/3.1!, sorry :).  It is completely
  118. useless without harddisk.  It has no special memory requirements,
  119. should run even on 0.5MB machines.
  120.  
  121.     DeInstaller requires reqtools.library V38+ installed in your LIBS:
  122. (it's included in this archive).
  123.  
  124.  
  125.  
  126. Installation
  127. ------------
  128.  
  129.     Copy the main program file and its icon whatever you want.  There
  130. are supplied two alternate icons in MagicWB style (Thanks, Dixan :).
  131.  
  132.     Copy (if you haven't) reqtools.library to your LIBS:  directory.
  133.  
  134.  
  135. Usage from Shell
  136. ----------------
  137.  
  138.     Bad news...  Although DeInstaller can be launched from Shell no
  139. options can be specified (only when launching from Workbench - via
  140. tooltypes).  But don't cry - for your convenience DeInstaller
  141. automatically detaches from Shell.
  142.  
  143.  
  144. Usage from Workbench
  145. --------------------
  146.  
  147.     When launched from WB DeInstaller looks for following tooltypes:
  148.  
  149.  
  150.         SCRIPTDIR=<path>      Sets the default directory for generated
  151.                               "deinstall scripts". If not specified, S:
  152.                               will appear in "Script" gadget.
  153.  
  154.                               Examples:
  155.                                          SCRIPTDIR S:deinstall
  156.                                          SCRIPTDIR=WORKS:scripts
  157.  
  158.                                 
  159.         NOREQUESTCHOICE       Sets "ask" mode instead of "requestchoice"
  160.                               mode. By default DeInstaller generates
  161.                               scripts which use RequestChoice command. As
  162.                               it is not available up to 2.1 Kickstart
  163.                               specifying this tooltype forces it to
  164.                               generate script which use ask command instead.
  165.  
  166.  
  167. Program's gadgets
  168. -----------------
  169.  
  170.     The program window contains following gadgets:
  171.  
  172.  
  173.         Program             Specifies the name of a program to install and,
  174.                             indirectly, to deinstall. You can type here
  175.                             whatever you want, but it is wise to note here
  176.                             program name and version. Program name doesn't
  177.                             mean a script name!
  178.  
  179.         Script              Specifies the script name to generate.
  180.  
  181.         Req                 As above, but pops up a file requester. 
  182.  
  183.         Trace               Begins the tracing for "newcomers" on your
  184.                             harddisk. If you didn't specify the program
  185.                             name you are kindly informed about.
  186.  
  187.                             Message "DeInstaller on duty" should appear.
  188.  
  189.         Stop                Quite self-explanating... finishes the
  190.                             operation.
  191.  
  192.                             Then you get a deinstall script, executable from
  193.                             Shell or directly from DeInstaller using Launch
  194.                             gadget. (For your convenience it has the script
  195.                             bit set, so you can omit Execute command, when
  196.                             launching from Shell).
  197.  
  198.         Launch              Executes selected script(s). It's for people
  199.                             who really don't like shell :-).
  200.  
  201.         Delete              Delete selected file(s). It's intended for
  202.                             deleting deinstaller scripts but, of course,
  203.                             you can delete what you want with this.
  204.  
  205.         About               Well, what to say about...
  206.  
  207.         Quit                I bet you have seen something like this before,
  208.                             haven't you?
  209.  
  210.         There is also an information (read-only) gadget.  Shows current
  211.         program status (eg. info about caught files and dirs).
  212.  
  213.  
  214. Examplary usage
  215. ---------------
  216.  
  217.     I want to install program Mess-on-harddisk v8.71 which I've just
  218. pirated.  It occupies 7 floppies and I'm really afraid it can fill my
  219. drive with hundreds of "don't-know-what-the-hell-it-is-for" files.
  220.  
  221. So I...
  222.  
  223.      - start DeInstaller
  224.  
  225.      - type "Mess-on-hardisk v8.71" in the »Program« gadget
  226.  
  227.      - press »Req« gadget - it will bring you a file requester in
  228.        S: directory (by default) and then type filespec (example:
  229.        "S:deinstall/messonhd-remove") for the "deinstall script" to generate
  230.  
  231.      - press »Trace« what brings the file requester
  232.        ("Deinstaller on duty" should appear)
  233.  
  234.        NOW, I INSTALL THE PROGRAM! (with installer, if supplied or by hand)
  235.  
  236.        (during the installation DeInstaller shows how many files and dirs
  237.        were created on my harddisk)  
  238.  
  239.      - press »Stop« button when installation is done.
  240.  
  241.      - press »Quit« to leave the program.
  242.  
  243.        Now I have program Mess-on-harddisk v8.71 installed.  It filled my
  244.        drive with hundreds of "don't-know-what-the-hell-it-is-for" files.
  245.        And as I've figured out that this program is completly useless I
  246.        want to flush all that stuff out of my precious harddisk space.
  247.  
  248.      - start DeInstaller again. 
  249.  
  250.      - press »Launch« gadget - select the script (in this case it is
  251.        "S:deinstall/messonhd-remove")
  252.  
  253.      - confirm the deinstallation process!
  254.  
  255.      After some flashings of harddisk led the harddisk is as BEFORE!
  256.      ---------------------------------------------------------------
  257.  
  258.      So, now I can install program Mess-on-harddisk-bigger-than-ever-before
  259.      which fills my drive with even more hundreds of "still-don't-know-what-
  260.      the-hell-it-is-for" files. So I...
  261.  
  262.  
  263. To Do
  264. -----
  265.  
  266.    Well, in previous release (1.1) I enumerated here some things to add in
  267. future (BTW:  it was over half a year ago !).  Yeah, but I decided to not use
  268. assembler anymore (at least for utilities), so DeInstaller wouldn't be updated.
  269. Believe me, I haven't enough motivation to rewrite it in, for example, C.  And,
  270. to be honest, there are much more exciting projects on the way.
  271.  
  272.  
  273. Contacting the author
  274. ---------------------
  275.  
  276.     Any ideas, bug reports, donations, etc.  will be sincerely
  277. welcomed.  Just drop me a piece of paper.
  278.  
  279.     My addy:
  280.  
  281.                 Grzegorz Calkowski
  282.                 Rzedowice
  283.                 ul.Dobrodzienska 8
  284.                 42-780 Dobrodzien
  285.                 POLAND
  286.  
  287.         phone: +48(0)34-575875
  288.                 
  289.                 (pity, no E-Mail yet...)
  290.  
  291.  
  292. Always remember:
  293. ----------------
  294.  
  295.         Beeting is beliving...
  296.  
  297.         and Amiga is best computer ever!
  298.  
  299.  
  300. Acknowledgements
  301. ----------------
  302.  
  303. Thanks should go to:
  304.  
  305.  - Michal Prochownik for really constructive help with writting this doc
  306.    and for those awfully pretty icons.
  307.  
  308.  - my brand new A4000 which seems to be faaaar more reliable than the
  309.    damned A1200 I had before (and at least it looks faaaar better...:^).
  310.  
  311.  - Commodore for resurrection...
  312.  
  313.  
  314. Any greetings expected?  Well, press some keys in the program window... 8)
  315.  
  316.  
  317. *******************************************************************************
  318.  
  319.                            PROGRAM HISTORY:
  320.  
  321.  
  322. v1.0ß (16.10.94)
  323.  
  324.    o First BETA release.
  325.  
  326. ===========================================================================
  327.  
  328. v1.0 (25.10.94)
  329.  
  330.    o Ooopps... it worked only on my A4000 due to a damned bug causing an
  331.      Enforcer hit in MultiGUI stuff.
  332.  
  333.    o Another Enforcer hit found in CreateDir() patch. Fixed.
  334.  
  335.    o Some Mungwall hits found. Fixed.
  336.  
  337.    o Startup code was broken - DeInstaller crashed immediately when
  338.      launched from Shell. Fixed.
  339.  
  340.    o Small optimizations.
  341.  
  342. ===========================================================================
  343.  
  344. v1.1 (23.11.94)
  345.  
  346.    o AmigaGuide®'ed documentation included.
  347.  
  348.    o Important feature added: attempts to overwrite existing files are
  349.      intercepted - user can let overwrite, reject or backup existing
  350.      file (appends ".old" extension).
  351.  
  352.    o »Script« and »Req« gadgets added (instead of poping-up requester when
  353.      »Go« was pressed..
  354.  
  355.    o New gadgets added: »Launch« (allows to execute scripts), »Delete«
  356.      (allows to delete scripts)
  357.  
  358.    o »Go« renamed to »Trace«.
  359.  
  360.    o Now window can be zipped (zoomed).
  361.  
  362.    o Version string was incorrect.
  363.  
  364.    o A plenty of internal optimizations.
  365.  
  366. ===========================================================================
  367.  
  368. v1.1a (09.07.95) <-- sic!
  369.  
  370.    o Some nasty mungwall hits found & cured.
  371.  
  372.    o Hope it will finally work on anything else than my A4000... ;]
  373.  
  374.