home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / pmund151.zip / pmundel.doc next >
Text File  |  1995-09-19  |  10KB  |  228 lines
  1.  
  2.  
  3.         PM UNDELETE for OS/2 Version 1.51                        19 Sep 95
  4.         __________________________________________________________________
  5.  
  6.         PM UNDELETE is a GUI program for a quick recovery of deleted
  7.         files.
  8.  
  9.         OS/2 offers a feature which allows the recovery of deleted files.
  10.         However, the control program for this feature is a command line
  11.         driven tool with poor comfort: The OS/2 program UNDELETE.
  12.  
  13.         PM UNDELETE is an easy-to-use PM program to undelete deleted files
  14.         to their original directory or to the system's TMP directory.
  15.         Deleted files may be also be sent to Nirwana, that is, their
  16.         deletion is made permanent. (This corresponds to the /F option of
  17.         the OS/2 UNDELETE command.)
  18.  
  19.         PM UNDELETE is also able to display deleted files in order
  20.         to explore their contents before performing any actions.
  21.  
  22.         PM UNDELETE uses the OS/2 program UNDELETE.COM to do its job.
  23.         This means that PM UNDELETE does not rely on a specific version
  24.         of OS/2 nor does it use undocumented system calls or other
  25.         quirks!!! This feature is sometimes called 'compatibility'.
  26.  
  27.         This program is FREEWARE and may be distributed together with
  28.         this documentation to all OS/2 users!!!
  29.  
  30.         __________________________________________________________________
  31.         ___ Installation _________________________________________________
  32.  
  33.         Copy PMUNDEL.EXE and PMUNDEL.ICO (or any other icon you prefer) to
  34.         a directory in your PATH.
  35.  
  36.         You should install a program object for PMUNDEL.EXE on the desktop
  37.         for a quick access!
  38.  
  39.         Be shure that the variable TMP is set in the OS environment
  40.         and that it points to a directory for temporary files.
  41.  
  42.         (e.g.         SET TMP=C:\TMP   )
  43.  
  44.         Be shure that the variable DELDIR is set in the OS environment
  45.         for all drives on which the recovery of deleted files is desired.
  46.         Refer to your OS/2 user manual (online) for more information.
  47.  
  48.         (e.g.         SET DELDIR=C:\TMP\DELETE;D:\DELETE   )
  49.  
  50.         __________________________________________________________________
  51.         ___ Usage ________________________________________________________
  52.  
  53.         Start PMUNDEL.EXE. If you start the program from the OS/2 command
  54.         line be shure to add the command line parameter "/REFRESH".
  55.         (See also 'bug list' below!)
  56.  
  57.         PM UNDELETE displays all drives which support the recovery of
  58.         deleted files (that is, all files specified in the DELDIR variable).
  59.  
  60.         Select a drive and press the refresh button or double click the
  61.         drive. Refresh may be clicked whenever another process has erased
  62.         files and the list of files being deleted (for the selected drive)
  63.         should be updated.
  64.  
  65.         PM UNDELETE displays all files which can be recovered.
  66.  
  67.         Select the desired files (extended multiple selection).
  68.  
  69.         By pressing the appropriate button you can undelete the selected
  70.         file(s) to their original directory or to the TMP directory.
  71.         'Deleting files forever' means that the files may not be
  72.         recovered any longer.
  73.  
  74.         'Deleting files forever' means that the files may not be
  75.         recovered any longer. (Corresponds to the /F /A options of the
  76.         OS/2 UNDELETE command.)
  77.  
  78.         'Viewing files' means that all selected files can be displayed by
  79.         an internal viewer. The viewer displays all selected files one by
  80.         one and supports vertical and horizontal scrolling and binary file
  81.         handling. If a file contains more than 500 lines, the viewer asks
  82.         whether the whole file should be displayed or whether it may be
  83.         truncated for viewing.
  84.  
  85.         It is sooo easy.
  86.  
  87.         __________________________________________________________________
  88.         ___ Command line options _________________________________________
  89.  
  90.         /REFRESH   Refer to section "Bugs" below
  91.  
  92.         /NOBANNER  The moving banner may be disabled by the menu option
  93.                    "Disabled banner". This may be useful in the case that
  94.                    this feature consumes too much CPU time on your system.
  95.  
  96.                    Starting the program with the command line option
  97.  
  98.                         "/NOBANNER"
  99.  
  100.                    disables the moving banner from the beginning.
  101.  
  102.         /DRIVE X:  You may supply a drive letter for the initial list of
  103.                    deleted files.
  104.                    (Of course it is possible to access all other drives
  105.                    through the menu of drives.)
  106.  
  107.         __________________________________________________________________
  108.         ___ Special Hint _________________________________________________
  109.  
  110.         Michael Bode (bode@zarkon.in-ulm.de) pointed out the following
  111.         nice idea to me. Thanks a lot.
  112.  
  113.               "Man legt PM Undelete zusaetzlich ins Open Menue des
  114.               DELETE Directories und setzt das Default Open auf Undelete.
  115.               Jetzt noch das entsprechende Icon fuers DELETE-Dir und
  116.               fertig ist die Macintosh-like Trashcan.
  117.               Jedenfalls bis auf Kleinigkeiten."
  118.  
  119.         For all those who are not familiar with the German language.
  120.         (If you need other translations (Suaheli, Old-Icelandic, etc.)
  121.         let me know...)
  122.  
  123.          o Open the settings of the DELETE directory of a desired
  124.            drive X:
  125.          o Go to the menu tab.
  126.          o Select "Open" in "Available Menus"
  127.          o "Create another" entry for the "Open"
  128.          o Enter "Undelete" as program title and "PMUNDEL.EXE"
  129.            (probably with path spec.) as program name.
  130.            Do not forget the command line argument "/DRIVE X:"
  131.          o Change "Settings" for the "Open"
  132.          o Set default action to "PM Undelete"
  133.          o Close settings notebook
  134.  
  135.         With this setup you can have a nice (almost) Mac-like trashcan.
  136.         Whenever you open the folder with the DELETE directory of a
  137.         specific drive the PM Undelete program is started listing all
  138.         files that can be undeleted.
  139.  
  140.         __________________________________________________________________
  141.         ___ Bugs _________________________________________________________
  142.  
  143.         PM UNDELETE has a bug causing an incorrect display of the dialog
  144.         window if being started from the OS/2 command line. This is due
  145.         to a bug either in the DrREXX window handler or in the
  146.         corresponding OS/2 subsystem.
  147.  
  148.         A workaround for this bug (since it is now documented, hence I will
  149.         call it a feature...) is to start the program with the command line
  150.         option "/REFRESH".
  151.  
  152.            (e.g.      pmundel /REFRESH      )
  153.  
  154.         This will redraw the dialog window after a call to OS/2 UNDELETE.
  155.  
  156.         If PM UNDELETE is started directly from the WPS via a program
  157.         object, via a program file object or via a PM shell (such as
  158.         PC/2) the dialog window will be displayed properly!
  159.  
  160.         NOTE: The conversion of all filenames to UPPERCASE is *not* my
  161.               fault. The guy who wrote OS/2 UNDELETE must be blamed
  162.               for this!!! (The filenames are stored in the proper case
  163.               in CONTROL.DEL.)
  164.  
  165.         __________________________________________________________________
  166.         ___ History ______________________________________________________
  167.  
  168.         V1.00          - Released
  169.         V1.01          - Switch "/REFRESH" added
  170.         V1.10          - Pre-Viewer added
  171.         V1.11 27-12-93 - Bug fixed that caused invalid refresh on systems
  172.                          with drives x1 ... xi, xi+2 ... xn
  173.                        - Bug fixed in documentation that caused illegal
  174.                          e-mail address (@#+!)
  175.         V1.20 27-04-94 - All program windows may be resized and/or
  176.                          maximized
  177.                        - Menu control added for viewer
  178.                        - "About" button removed (it's not that urgent to
  179.                          be present all the time)
  180.         V1.21 05-06-94 - Bug fixed in handling filenames containing
  181.                          blanks
  182.         V1.22 10-06-94 - Now able to handle a TMP path specification
  183.                          with forward slashes (vital for EMACS users)
  184.         V1.30 10-07-94 - Command line option "/NOBANNER" added
  185.                        - Menu "Options" added
  186.                        - Moving banner may be disabled/enabled
  187.         V1.31 01-11-94 - Recompiled for use with OS/2 Version 3 (WARP)
  188.         V1.40 01-05-95 - Bug fixed that caused some problems on
  189.                          non-german versions of OS/2
  190.         V1.41 13-07-95 - Now case-insensitive on drive letters as
  191.                          specified in the DELDIR statement
  192.         V1.50 13-09-95 - Command line option "/DRIVE" added
  193.                        - Another bug fixed in handling filenames
  194.                          containing blanks in function "Undelete forever"
  195.                        - "Special Hint" added to documentation
  196.         V1.51 19-09-95 - File viewer now displays filesize
  197.                        - Another bug fixed in function "Undelete forever"
  198.                        - Michael Bode is nominated "Best WIN'95"
  199.                          (Watchdog for Incompleteness and Nasty bugs)
  200.  
  201.         __________________________________________________________________
  202.         ___ Acknowlegdements _____________________________________________
  203.  
  204.         PM UNDELETE is a REXX program designed and created using the
  205.         superior and phantastic DrDIALOG/DrREXX environment written by
  206.         David C. Morill.
  207.         Thanks to him, he has done a great job!!!
  208.  
  209.         DrRexx/DrDialog is IBM EWS (Employee Written Software).
  210.         The DrRexx/DrDialog package is also included in the IBM OS/2
  211.         Developer Connection CD.
  212.  
  213.         __________________________________________________________________
  214.         ___ Usage ________________________________________________________
  215.  
  216.         Comments, criticism and postcards may be sent to:
  217.  
  218.            affie@watson.ibm.com
  219.  
  220.         Snail Mail:
  221.  
  222.            Ralf Hauser
  223.            16 Sunset Drive
  224.            Bedford Hills 10507
  225.            U.S.A
  226.  
  227.  
  228.