home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / pmxpd.zip / PMXPD.DOC next >
Text File  |  1992-12-28  |  12KB  |  316 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                 PMXPD 
  22.  
  23.                          PM eXPunge Directory
  24.                              Version 1.1
  25.  
  26.              An OS/2 2.x 32-Bit Directory Deletion Utility
  27.  
  28.                             Copyright 1992      
  29.                                   by
  30.                           ZebbWare Products
  31.                                   &
  32.                             Jay Zebrowski
  33.  
  34.                    Spectre's OS/2 Technical Exchange BBS
  35.                Node #1: (714)751-9307 (300-16.8k+ HST-Dual)
  36.                Node #2: (714)751-6534 (300-14.4k  USR v.32)
  37.  
  38.                          ALL RIGHTS RESERVED!
  39.  
  40.                         ********************     (TM)
  41.                         ********************                         
  42.                       ......           ***....                          
  43.                         ..           ***  ..                      
  44.                          ..      ..***   ..                            
  45.                           ..    ....    ..                                  
  46.                            ..  *** ..  ..                                 
  47.                             .***    ....   *          
  48.                            ***.      ..   **
  49.                          *******************
  50.                         ********************
  51.  
  52.             
  53.  
  54.  
  55.                       Table of Contents
  56.  
  57.  
  58.  
  59.  
  60.      What Am I?.................................................1
  61.      Introduction...............................................1
  62.          License, Prices, Warnings & Copyrights.................1
  63.          Contacting ZebbWare Products...........................2
  64.          List of Files on Disk (or in Archive)..................2
  65.      Using the eXPunge Directory program........................3
  66.          Program Usage..........................................3
  67.          Command Line Options...................................3
  68.          Screen Control Usage...................................4 & 5
  69.          Drag & Drop (Shredder).................................5
  70.      Last Word..................................................5
  71.  
  72. PM eXPunge Directory (C)1992 ZebbWare Products  29/Dec/1992  Page 1
  73.  
  74.  
  75.  
  76. What Am I?
  77.  
  78.      The PM eXPunge Directory Program (PMXPD.EXE) will delete a     
  79. directory and all of its contents.  This includes any files, sub-  
  80. directories, sub-directories within sub-directories, etc, etc, etc.
  81. Optionally, it can be made to include Read-Only, Hidden, or System
  82.  files.  It can be used in it's automatic mode for command (.CMD)
  83. files or as a simple replacement for the shredder.
  84.  
  85. Introduction
  86.  
  87.      PMXPD was originally designed for my use at home.  I am constantly
  88. re-installing software, which contains various levels of sub-directories,
  89. onto my hard drive.  To varify an old install wasn't getting in the
  90. way of a new install, I would painstakingly delete each sub-directory
  91. individually.  If I knew I was going to be installing a particular     
  92. piece of software frequently, I would then build a batch file to do
  93. the work for me.  Eventually I built XPD to handle it.  XPD was PMXPDs
  94. predecessor.  It did not support a GUI front end.  With OS/2 v2.0s
  95. new container controls, I found the need to learn how to program for
  96. drag & drop operations.  I decided to give XPD a GUI interface and use
  97. it as my testing grounds for drag & drop.  PMXPD was born.
  98.  
  99.  
  100. License, Prices, Warnings & Copyrights
  101.  
  102.      The PM eXPunge Directory is a copyrighted work, protected by
  103. United States law and international treaty provisions.  There is a
  104. $10 dollar charge for continued use of this program, optionally the
  105. source code is also available for an additional $25.00.  If you 
  106. would like the C Set/2 source code for PMXPD.EXE send a check or
  107. money order for $26.50 ($1.50 shipping & Handling) to Jay Zebrowski
  108. 17770 Cartwright Road, Irvine California, 92714.
  109.  
  110.      If your still using this program after 30 days, you really should
  111. pay for it.  $10.00 isn't going to break you.  
  112.  
  113.      Please feel free to distribute this program to other bulletin 
  114. boards & friends.  
  115.  
  116.      THIS IS A USE AT YOUR OWN RISK PROGRAM!!!  ZebbWare Products &
  117. the author will NOT be responsible for lost or damaged files.  I make
  118. no Guarantees or promises!  It does, however, work fine for me!
  119.  
  120. WARNING: Typing "pmxpd \ /a /n" will effectively erase your hard drive
  121.          partition!!!!  Use this program with caution!
  122.     
  123.  
  124.  
  125. PM eXPunge Directory (C) 1992 ZebbWare Products  29/Dec/1992  Page 2
  126.  
  127.  
  128. Contacting ZebbWare Products
  129.  
  130.      Even if you don't pay for it I would like to hear your thoughts
  131. & suggestions.  I can be reached at Spectre's BBS (listed on the cover
  132. page of this document) or CompuServe ID: 71242,1043.  Use a Psuedoname
  133. if you must but your suggestions REALLY ARE WELCOME!
  134.  
  135.  
  136. List of Files on Disk (or in Archive)
  137.  
  138.      Your eXPundge Directory archive/disk should contain the following
  139. files:
  140.  
  141.      PMXPD.EXE  - PM eXPunge Directory Program (45903 bytes)
  142.      PMXPD.HLP  - On-Line Help file (8535 bytes)
  143.      PMXPD.DOC  - This documentation you're reading right now!
  144.      README.1ST - (Optional) If this file exists, it will contain
  145.                   any last minute information.
  146.  
  147.  
  148.  
  149. PM eXPunge Directory (C) 1992 ZebbWare Products  29/Dec/1992  Page 3
  150.  
  151.  
  152.  
  153. Usage
  154.           c:\pmxpd [ switches... ] {Directory} 
  155.  
  156.                             or
  157.  
  158.           c:\pmxpd {Directory} [ switches... ]  
  159.  
  160.     
  161. Command Line Options
  162.  
  163.       The valid switches are as follows:
  164.  
  165.  
  166.       /a or /A  Automatic Mode
  167.  
  168.       This option is for full automation.  Basically it means, when the
  169. directory has been deleted, stop running.  Very Useful in command (.CMD) 
  170. files to delete whole directory structures without the need for human
  171. intervention.  ( To be fully automatic and to delete everything in the
  172. directory you would type c:> PMXPD C:\DelToDir /a /n /i )
  173.  
  174.  
  175.       /f or /F  Delete Files Only. Leave Directory Structure intact
  176.  
  177.       If you want PMXPD to only delete the files found in the directory
  178. specified (and all the sub-directories under it).  This will leave the
  179. directory structure in place with no files.
  180.  
  181.  
  182.       /i or /I  Ignore file attributes.  
  183.  
  184.       PMXPD, by default, will not delete files that have 'Read-Only',
  185. 'Hidden', and/or 'System' attributes set.  If the /I switch is given 
  186. however, then PMXPD will delete everything regardless of their attribute
  187. settings.
  188.  
  189.  
  190.       /n or /N  No Confirmation
  191.  
  192.       PMXPD, by default, prompts you to ask 'Are You Sure' before you
  193. begin a deletion process.  You will need to use this switch for full 
  194. automatic mode.  Otherwise, we recommend that you NEVER turn use this   
  195. switch.  Think of it this way.  It's better to do one extra mouse-click
  196. or key-stroke then to try and recover a deleted hard drive.
  197.  
  198.  
  199.       /s or /S  Supress Status Messages
  200.  
  201.       If specified on the command line, PMXPD will hide (or supress)
  202. all status messages.  Using this option greatly decreases the amount of
  203. time required to delete a directory.  If you don't care to watch what
  204. file or directory it is currently deleting, then specify /S on the 
  205. command line.
  206.  
  207.  
  208. PM eXPunge Directory (C) 1992 ZebbWare Products  29/Dec/1992  Page 4
  209.  
  210.  
  211. Screen Control Usage
  212.  
  213.       "Enter the Directory to Remove:" Entry Field
  214.  
  215.       This is where you enter the directory you want to delete.  It is
  216. good practice to fully qualify (use the full name) of the directory.
  217. If you drop a WPS directory folder on PMXPD, it's fully qualified
  218. directory name will be displayed here.  If you entered a directory to
  219. delete on the command line, then it will appear here.
  220.  
  221.       "Status:" Message Display
  222.  
  223.       This is where status messages are displayed.  It will display each
  224. file as it is deleting it. If the 'Hide Status' check-box is CHECKED, 
  225. then only generic messages will be diaplayed.  Generic messages are
  226. messages like: (-Idle-), (-Completed-), (-In Progress-), etc. ( See
  227. /S Command Line Parameter )
  228.  
  229.       "Files Only" Check Box
  230.  
  231.       If this check-Box is CHECKED then PMXPD will only delete files.
  232. It will leave the directory structure intact. ( See /F Command Line
  233. Parameter )
  234.  
  235.       "Ignore Attrib" Check Box
  236.  
  237.       If this check-box is CHECKED then PMXPD will delete Read-Only,
  238. Hidden, & System attributed files.  ( See /I Command Line Parameter )
  239.  
  240.       "Hide Status" Check Box
  241.  
  242.       If this check-box is CHECKED then PMXPD will not display filenames
  243. that it is deleteing in the 'Status:' field.  This Check-Box should be
  244. CHECKED if your looking to get the fastest speed out of PMXPD. (Also see
  245. 'Status:' screen control field, and, /S Command LIne Parameter )
  246.  
  247.       "Confirmation On / Off" Radio Buttons
  248.  
  249.       If the 'On' radio button is selected then PMXPD will prompt a
  250. warning before it begins any deletion process.  This is the default 
  251. mode for safety reasons.
  252.       If the 'Off' radio button is selcted then PMXPD will not prompt
  253. a warning before deleting files.  As soo as you select the 'Expunge'
  254. push button the deletion process will begin. 
  255.  
  256.       "Expunge" Push Button
  257.  
  258.       Pressing the 'Expunge' directory begins the deletion process. PMXPD
  259. will first verify the directory specified is a valid directory.  If the
  260. Confirmation 'On' radio button is selected then PMXPD will then prompt
  261. a warning that you are about to delete the specified directory.  If you
  262. respond OK to the warning (OR) the confimation 'Off' radio button is
  263. selected then PMXPD will begin the deletion process.
  264.  
  265.  
  266. PM eXPunge Directory (C) 1992 ZebbWare Products  29/Dec/1992  Page 5
  267.  
  268. Screen Control Usage (continued)
  269.  
  270.       "Cancel" Push Button
  271.  
  272.       This push button is only enabled when a deletion is in progress. 
  273. It will abort the deletion process. (Sort of like a Panic Button).  If
  274. you inadvertantly start deleting a directory you need, this is the way
  275. to save some of the files.  The <Esc>ape key will also act like the 
  276. 'Cancel' Push Button.
  277.  
  278.       "Pause/Resume" Push Button
  279.  
  280.       This push button is only enabled when a deletion is in progress. 
  281. If will Temporarily Pause a deletion in progress.  Once Paused, this
  282. push button with then act to 'Resume' the deletion process.  The
  283. 'Cancel' pushbutton can be used while a deletion process is paused.
  284.  
  285.       "Help" Push Button
  286.  
  287.       This button will bring up OS/2's Internal Help SubSystem to give
  288. you On-Line Help with various parts of PMXPD.  Pressing F1 while on a
  289. particular area of the screen will give you help for that area.
  290.  
  291.  
  292.  
  293. Drag & Drop (Shredder Replacement?)
  294.  
  295.       PMXPD supports some basic drag & drop.  If you drag a directory 
  296. folder (from the 'Drives') folder and drop it on PMXPD, then PMXPD will
  297. act as if you entered the directory name and pressed the 'EXPUNGE' push
  298. button.  If confirmation is 'On' then you will get a warning prompt.  If
  299. you want the drop to automatically start the deletion process then you
  300. must have set confimration to off before the drop.
  301.  
  302.       If PMXPD is minimized to the Minimized Window Viewer then it will
  303. not work with Drag & Drop.  The Minimized Window View seems to be a
  304. animal of a different sort.  In most cases I have found that minimizing
  305. PMXPD to the desktop is the best course of action anyway.
  306.  
  307.       Future versions of PMXPD may support Drag & Drop to a greater
  308. extent.  Possibly to become a full fledged replacement for the Shredder.
  309. As it is now, it is only a semi-replacement but it does offer different
  310. options.
  311.  
  312.  
  313.  
  314. Last Word :        "Incandescent"
  315.  
  316.