home *** CD-ROM | disk | FTP | other *** search
/ BUG 12 / BUGCD1998_03.ISO / util / unfrag / readme.txt next >
Text File  |  1998-02-11  |  6KB  |  130 lines
  1. ________________________________________________________________ 
  2. Unfrag (VERSION 1.0)
  3. Copyright (c) 1997 Ziff-Davis Publishing Company
  4. Written by Jeff Prosise
  5. First Published in PC Magazine, US Edition, December 16, 1997.
  6. ________________________________________________________________ 
  7.  
  8. About Unfrag:
  9. If you're a Windows 95 or Windows NT user, you may be losing 
  10. precious disk space without even knowing it. Most hard disks 
  11. today contain compound files created by Microsoft Word, 
  12. Microsoft Excel, and other applications that support Object 
  13. Linking and Embedding (OLE). Compound files, when fragmented, 
  14. can waste a lot of disk space. This issue's free utility, which I've 
  15. named Unfrag to distinguish it from conventional hard disk 
  16. defraggers, hunts down compound files and unfragments them for you.
  17.  
  18. Usage:
  19. To install Unfrag, copy Unfrag.exe to the folder of your choice. 
  20. There are no auxiliary files or DLLs to copy, and Unfrag writes 
  21. nothing to your system's registry. The entire program can be 
  22. uninstalled simply by deleting Unfrag.exe.
  23.  
  24. When executed, Unfrag displays a simple dialog box. To begin 
  25. the unfragging process, enter a file name or file name specification 
  26. (for example, *.doc) in the Named box and a path name identifying 
  27. a drive or folder in the Folder box. If you'd like Unfrag to unfrag 
  28. compound files in the specified folder and its subfolders, check the 
  29. "Include subfolders" box. Then click the Unfrag button.
  30.  
  31. When executed, Unfrag displays a simple dialog box. 
  32. To begin the unfragging process, enter a file name or 
  33. file name specification (for example, *.doc) in the Named 
  34. box and a path name identifying a drive or folder in the 
  35. Folder box. If you'd like Unfrag to unfrag compound files 
  36. in the specified folder and its subfolders, check the 
  37. "Include subfolders" box. Then click the Unfrag button.
  38.  
  39. As the unfragging process runs its course, Unfrag keeps 
  40. you apprised of its progress with a dialog box. 
  41. "Files examined" indicates how many files have thus far 
  42. been found whose names match the pattern in the Named 
  43. box. "Compound files found" tells you how many of those 
  44. files are compound files. Each time it identifies a compound 
  45. file, Unfrag unfragments the file, compares the new file size 
  46. to the old, and adds the difference to the "Bytes saved" 
  47. value displayed in the dialog. Note that not all compound 
  48. files shrink when they're unfragmented because some have 
  49. no dead space in them. Don't be alarmed if "Bytes saved" 
  50. doesn't increase every time a compound file is processed.
  51.  
  52. You can cancel an unfragging operation at any time by 
  53. clicking the Cancel button. When unfragging is complete, 
  54. the Cancel button changes to an OK button. The dialog 
  55. box remains on the screen until OK is clicked so you can 
  56. review the results of the unfragging process.  You may 
  57. invoke online help for Unfrag by selecting "Help" from 
  58. the System menu or pressing function key F1.
  59.  
  60. Unfrag supports a full set of command line options that 
  61. enable it to be run without user intervention. This feature 
  62. will come in handy if you wish to use System Agent or a 
  63. similar utility to schedule the launch of Unfrag and let it 
  64. run unattended. Unfrag's command-line syntax is:
  65.  
  66.  UNFRAG pathname [/S] [/R]
  67.  
  68. where pathname is the path to the folder containing the 
  69. files to be unfragged, /S tells Unfrag to process files in the 
  70. specified folder and its subfolders (equivalent to checking 
  71. the "Include subfolders" box in the Unfrag window), and 
  72. /R means "Run now"-the command-line equivalent of 
  73. clicking the Unfrag button in Unfrag's main window. 
  74. The pathname parameter may include a file specification 
  75. (for example, *.doc). Be sure to enclose pathname in 
  76. quotation marks if the path name includes spaces. 
  77. Otherwise, Unfrag will interpret a space embedded in a 
  78. path name as a separator character marking the end of a 
  79. command-line parameter.
  80.  
  81. A few examples will help to clarify Unfrag's command-line 
  82. options. Suppose you're using System Agent to launch 
  83. Unfrag in the wee hours of the morning, and you'd like 
  84. Unfrag, when started, to unfrag all the .doc files on 
  85. drive C:. Here's the command to use:
  86.  
  87. UNFRAG C:\*.DOC /S /R
  88.  
  89. If you'd rather have Unfrag unfrag all the files in drive 
  90. C:'s My Documents folder and its subfolders, use this 
  91. command instead:
  92.  
  93. UNFRAG "C:\My Documents" /S /R
  94.  
  95. To restrict Unfrag to just the My Documents folder 
  96. (no subfolders), omit the /S switch:
  97.  
  98. UNFRAG "C:\My Documents" /R
  99.  
  100. Be sure to include a /R switch if you want Unfrag to 
  101. start processing files immediately. If you omit this 
  102. switch, the options you entered on the command line 
  103. will show up in Unfrag's window (for example, the 
  104. "Include subfolders" box will be checked if the 
  105. command line includes a /S switch), but unfragging 
  106. won't begin until the Unfrag button is clicked.
  107.  
  108. Note: The file UNFRAG_S.ZIP contained in UNFRAG.ZIP is the 
  109. source code for Unfrag.  This will only be of interest 
  110. to you if you are a programmer, and can be discarded 
  111. if you choose.
  112.  
  113. Support for Unfrag:
  114. Support for the free utilities offered by PC Magazine can be 
  115. obtained electronically in the discussion area of PC 
  116. Magazine's Web site. Go to the URL 
  117. http://www.pcmag.com/discuss.htm/ and select the Utilities 
  118. area. You can also access the Utilities discussion area from the 
  119. utility's download page. The authors of current utilities 
  120. generally monitor the discussion area every day. You may 
  121. find an answer to your question simply by reading the 
  122. messages previously posted. If the author is not available and 
  123. you have a question that the sysops can't answer, the editor of 
  124. the Utilities column, who also checks the area each day, will 
  125. contact the author for you.
  126.  
  127. Jeff Prosise is a contributing editor of PC Magazine.
  128. 
  129. 
  130.