home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 June / Chip_2002-06_cd1.bin / sharewar / archivp / MANUAL.TXT < prev    next >
Encoding:
INI File  |  2000-01-10  |  15.3 KB  |  350 lines
  1. [Note: This text file was converted from HTML by Netscape Communicator 4.6.
  2. To see the images that accompany the text, please open manual.htm instead.]
  3.  
  4.                         Archive Peek for Windows 95
  5.  
  6.                                 Version 2.2
  7.  
  8.                                 User manual
  9.  
  10.                               by Javier Thaine
  11.  
  12. E-mail: jthaine@hotmail.com
  13.  
  14. Homepage: http://www.geocities.com/SiliconValley/Heights/7017/
  15.  
  16.                                   Contents
  17.  
  18. 1. Disclaimer and license agreement
  19.  
  20. 2. What is Archive Peek?
  21.  
  22. 3. Searching for files
  23.  
  24. 4. The Options menu
  25.  
  26. 5. Extracting files from ZIP archives
  27.  
  28. 6. Information for advanced users
  29.  
  30. 7. History of changes
  31.  
  32. 8. Additional credits
  33.  
  34.                       Disclaimer and license agreement
  35.  
  36. Archive Peek for Windows 95
  37.  
  38. Copyright 2000 Javier Thaine
  39.  
  40. Archive Peek for Windows 95 is a freeware program.
  41.  
  42. Archive Peek for Windows 95 and all of its related files may only be
  43. distributed in the original distribution form. The distribution file may
  44. not have files added to it or removed from it, and none of its contents may
  45. be modified, decompiled, or reverse engineered.
  46.  
  47. You may distribute this program as part of a shareware distribution,
  48. magazine, internet book, CD ROM, etc.
  49.  
  50. Archive Peek for Windows 95 is provided AS IS without warranty of any kind,
  51. either express or implied, including but not limited to the implied
  52. warranties of merchantability and fitness for a particular purpose. In no
  53. event shall Javier Thaine be liable for any damages whatsoever including
  54. direct, indirect, incidental, consequential, loss of business profits or
  55. special damages, even if Javier Thaine has been advised of the possibility
  56. of such damages. Use this program at your own risk.
  57.  
  58.                            What is Archive Peek?
  59.  
  60. Have you ever wondered in what ZIP file you kept that song? Or in which ARJ
  61. file in the C:\Letters folder you kept that letter to dad? Archive Peek is
  62. the answer. You can search for any file you specify inside all of the
  63. archives of a floppy disk, CD-ROM, hard disk, etc. For updates of Archive
  64. Peek as well as a Windows 3.1 version of this program and more free
  65. software, go to my home page at:
  66.  
  67.             http://www.geocities.com/SiliconValley/Heights/7017/
  68.  
  69.                             Searching for files
  70.  
  71. First, some terminology: by "archives", I mean ZIP, RAR, ARJ or other files
  72. that contain more than one file within them.
  73.  
  74.           When you start Archive Peek you will see the following:
  75.  
  76.                                   [Image]
  77.  
  78. 1. Select the folder your archives are in by typing it in the box entitled
  79. "Look in:" or by clicking on the "Browse" button. You may type in more than
  80. one folder name in the box, separated by spaces, but you can only select
  81. one folder with the "Browse" button. The Search menu allows quick selection
  82. to make you search in all drives, all removable drives or all non-removable
  83. drives.
  84.  
  85. IMPORTANT: Since you can specify more than one path, quotes "" are required
  86. around paths that contain spaces.
  87.  
  88.                                   [Image]
  89.  
  90. 2. In the "Find files named:" box, type in the files you want to find
  91. inside your archives. You can type up to one hundred names separated by
  92. spaces, and wildcards are allowed. If your filename has a space in it, put
  93. it between quotes ""
  94.  
  95. 3. Click on "Begin Search" or press Enter.
  96.  
  97. Here is an example of a possible search. It demonstrates the use of
  98. multiple folder names, wildcards and spaces in filenames. Clicking on the
  99. button with the arrow next to each box allows you to choose things you
  100. typed in the past.
  101.  
  102.                                   [Image]
  103.  
  104. During a search you may click on [Image] "Stop Search." Archive Peek will
  105. finish the archive it's currently looking at and then it will stop. Don't
  106. press this button twice since it will restart the search.
  107.  
  108. The number of files found and the time the operation took are displayed at
  109. the bottom of the window. While it is searching, Archive Peek also tells
  110. you in which folder it is looking.
  111.  
  112.                                   [Image]
  113.  
  114. You may double click on a file to open it. If it is not in an archive (just
  115. in a regular folder) or if it inside a ZIP file, Archive Peek will open it
  116. directly. If it is in another kind of archive, Archive Peek will run the
  117. program associated with that archive type (WinZip, for example.)
  118.  
  119. Archive Peek tells you many things about the files which it found:
  120.  
  121.                                   [Image]
  122.  
  123. "File" is the name of the file found. "Archive/Folder" is the compressed
  124. archive (ZIP, RAR, etc.) or the regular Windows folder the file is in.
  125. "Modified" is the last date and time this file was changed. "Size" refers
  126. to the original size of the file before compression. "Packed" refers to the
  127. size of the file after it was compressed. "Ratio" refers to the
  128. effectiveness of the compression: it tells you how much space was saved by
  129. compressing the file. For example, 0% would mean the file was not
  130. compressed at all. 50% would tell you that the file now takes half the
  131. space it originally took.
  132.  
  133. You can change the order in which the files are listed by clicking on one
  134. of these buttons shown in the image above. For example, if you click on
  135. "File", results will be sorted in alphabetical order by filename. If you
  136. click on "Modified", results will be sorted by date, and so on. If you
  137. click on one of these buttons a second time, the sorting order will be
  138. reversed. For example, if you click on "File" twice, results will be sorted
  139. in inverse alphabetical order.
  140.  
  141. You may save your results in text format or in HTML format by clicking on
  142. 'Save Results As...' in the File menu. You can also add the new results to
  143. an existing text file by clicking on 'Append Results to Text File...' in
  144. the File menu. Results will always be saved in the order they are sorted by
  145. on the screen. You may also print your results from the File menu. Archive
  146. Peek will only print the file and archive/folder names. If you want a nicer
  147. printout, it is recommended that you save your output to HTML format and
  148. then use your web browser to print the results.
  149. NOTE: It is important to turn off word wrapping in notepad (in the Edit
  150. menu, "Word Wrap") in order to make the text file you saved legible. This
  151. is true for programs other than notepad too.
  152.  
  153.                               The Options menu
  154.  
  155. You can customize Archive Peek's operation through the Options menu:
  156.  
  157.                                   [Image]
  158.  
  159. Case Sensitive: Since Windows 95 supports lower and uppercase letters in
  160. filenames, this option allows you to specify whether the filenames you are
  161. looking for must be exactly those you typed (case sensitive) or if the case
  162. may be ignored (not case sensitive). By default, this option is turned off.
  163.  
  164. Include Subfolders: If this options is checked, Archive Peek will also look
  165. into all subfolders of the folder(s) you selected. By default, this option
  166. is turned on.
  167.  
  168. Display count only: If you only want to know the number of files Archive
  169. Peek finds, this speeds up the program a lot. The number of files is
  170. displayed at the bottom of the results window. By default, this option is
  171. turned off.
  172.  
  173. Show warnings: Archive Peek might have problems reading some archives. If
  174. so, leaving this option on will allow Archive Peek to tell you which
  175. archives it couldn't read and why. The warnings created by Archive Peek are
  176. saved in a "warnings.txt" file in the same folder as Archive Peek, and it
  177. is erased every time a search is performed. By default, this option is
  178. turned on.
  179.  
  180. Create shortcut in Start Menu | Programs and
  181. Create shortcut in Start Menu | Find will create links to Archive Peek so
  182. that you can easily access it from the Windows Start Menu.
  183.  
  184. Advanced Options - You should take a look to see if any of these options
  185. can help you:
  186.  
  187.                                   [Image]
  188.  
  189. Archive types to look inside:
  190.  
  191. If you know what kind of archives the files you are looking for are in,
  192. choosing only them helps Archive Peek work faster. If you click on Select
  193. All, all of the formats will be selected. If you click on Select All again,
  194. all of the formats will be cleared. Selecting "File folders" will make
  195. Archive Peek look into ordinary folders, just like using the Start Menu's
  196. "Find Files or Folders" utility. By default, all formats are selected.
  197.  
  198. The currently supported archive formats are ZIP (used by PKZIP and WinZip),
  199. RAR, LZH, ARJ, ZOO, PAK, ARC, TAR (often used on UNIX machines), SQZ, HYP,
  200. WAD (used by games created by Id software), GRP (used by Duke Nukem 3D),
  201. CAB (Windows cabinet files) and ACE (used by WinAce archiver).
  202.  
  203. Saving results to disk:
  204.  
  205. These options affect the appearance of results when you save them to text
  206. or HTML files.
  207.  
  208. HTML options:
  209.  
  210. If you ever save your results to HTML files, you can change their
  211. appearance here. You can choose an item from the combo box and choose which
  212. color goes with it. 'Background color' refers to the 'paper' color of the
  213. HTML document. 'Visited link color' refers to the color of links that point
  214. to files you've already opened. 'Active link color' refers to the color a
  215. link takes when you click on it. You may also change the text and normal
  216. link colors of the document.
  217.  
  218. Of course, the color options for links are only valid if you check the
  219. 'Create hyperlinks' option. You may choose to turn this off to save hard
  220. disk space when saving a search that produced many results. Hyperlinks
  221. allow you to click on the names of files to access them.
  222.  
  223. The results in HTML format are displayed in a table. If you want that table
  224. to have borders, check the option 'Display table borders.'
  225.  
  226. Include...
  227.  
  228. Of course, when saving results to disk, you will always want to have both
  229. the name of the file found and the archive it was in included so you can
  230. retrieve it later. However, you might or might not want to include the last
  231. date and time the file was changed, the original size of the file before
  232. compression, the size of the file after the compression and the compression
  233. ratio which describes the effectiveness of the compression, so you may
  234. uncheck the ones you don't want here. By default, they are all activated.
  235.  
  236. More options
  237.  
  238. Normally, when saving results to a text file, Archive Peek aligns all the
  239. columns with spaces. However, if you want to load your results into a
  240. spreadsheet such as Corel Quattro Pro or Microsoft Excel, it is better to
  241. select 'Put tabs in the text file rather than spaces'. This will
  242. essentially make your text file unreadable to you, but as soon as you
  243. import it into a spreadsheet, it will have a nice tabular format. By
  244. default this option is turned off, since only few people may want to use
  245. it.
  246.  
  247. If you check 'Launch viewer when results are saved to disk', Archive Peek
  248. will start your web browser or text editor to view the file you save. This
  249. saves you the work of having to look for and open the file yourself. By
  250. default, this option is turned on.
  251.  
  252.                      Extracting files from ZIP archives
  253.  
  254. To extract files from a ZIP archive, select them with the mouse and
  255. right-click on them. Then click on "Extract." You can also do this by
  256. selecting files with the mouse and clicking on "Extract selected files" in
  257. the File menu. Archive Peek can only extract files from ZIP archives and it
  258. can only extract them from one ZIP archive at a time.
  259.  
  260.                                   [Image]
  261.  
  262.                  If all goes well, this window will appear:
  263.  
  264.                                   [Image]
  265.  
  266. Type the name of the folder you want to extract the selected files to in
  267. the box next to "Extract to:" or click on "Browse." Selecting "Overwrite
  268. files" will allow Archive Peek to overwrite files without asking. Selecting
  269. "Extract with folder names" will let Archive Peek create subfolders if they
  270. exist in the ZIP file. Click OK to finish. The extraction may take a while
  271. and I have not yet programmed a progress indicator, so please be patient.
  272.  
  273.                        Information for advanced users
  274.  
  275. Searching
  276.  
  277. If you want to display only files within a certain subdirectory of your
  278. archive, you may type it before the filename you are searching. For
  279. example:
  280.  
  281.                                   [Image]
  282.  
  283. help\*.txt
  284.  
  285. This will search only for the text files inside the "help" directory of
  286. your archives. If a certain archive does not have a "help" directory,
  287. Archive Peek will not find any text files in it. This is also important: if
  288. the "help" directory has subdirectories (example: "help\techsupport"),
  289. files within those subdirectories will also be displayed. Files will also
  290. be found if "help" is a subdirectory itself (example:
  291. "files\help\techsupport"). You can also specify more than one subdirectory
  292. in which case Archive Peek will only report files found within
  293. subdirectories of such a combination. For example:
  294. help\about\*.*
  295.  
  296. File formats
  297.  
  298. Some ZIP files are not supported due to their rarity. If such a file is
  299. encountered, Archive Peek will issue a warning if warnings are enabled. ARC
  300. files whose first byte is not Control-Z will not be read by Archive Peek
  301. and no warning will be issued. Also, Archive Peek won't find folders in CAB
  302. archives, only files.
  303.  
  304.                              History of changes
  305.  
  306. From version 2.11 to version 2.2:
  307.  
  308.    * Archive Peek now displays a file's modified date and time, original
  309.      size, compressed size and compression ratio.
  310.    * Results can now be sorted by filename, by archive name, by date, by
  311.      original size, by compressed size and by compression ratio, both in
  312.      ascending order and in descending order.
  313.    * WinAce Archiver's ACE files can now be read.
  314.    * A configuration file is no longer needed: Archive Peek now uses the
  315.      Windows registry to save its settings.
  316.    * You can extract files using the File menu.
  317.  
  318. From version 2.0 to version 2.11:
  319.  
  320.    * More than one folder can be searched at a time: because of this quotes
  321.      must be put around paths that contain spaces
  322.    * Files to search can contain spaces if they are within quotes
  323.    * Files can be searched within specific subdirectories in an archive
  324.    * Past searches are saved for easy access
  325.    * The window position is saved to disk when exiting Archive Peek
  326.    * The online help is now in HTML format
  327.    * A Search menu was added for quickly performing multi-drive searches
  328.    * Warnings are now issued when problems arise reading archives
  329.    * Archive Peek can do ZIP extraction by itself
  330.  
  331. From version 1.0 to version 2.0: Changes were not recorded.
  332.  
  333.                              Additional credits
  334.  
  335. First of all, Archive Peek would not be nearly as complete without the
  336. components written by William Yang (Dream Graphic Pack), Eric W. Engler
  337. (TZipBuilder), Todd Fast (TBrowseFolder), Eric J. Francois (ProgLink) and
  338. Nathan Fredrickson (TConstrain). Special thanks are due to Alexander
  339. Tarianik who developed a system allowing Archive Peek to be in the Start
  340. Menu Find section.
  341.  
  342. I would like to thank my good friend Jan Zlahoda for beta-testing, as well
  343. as Alexander Tarianik, Volker Wiens, Don Ferris, Hermann Seegert, Harry
  344. Albert Randrianasolo, Dale Sweetland, Bob Hamilton, Quique de Red Masters,
  345. Roland Piquepaille, Miroslav Jezek, Llew, Robert Hazelett and Robert I.
  346. Lasher for their precious suggestions.
  347.  
  348. Finally, I thank all the users of my software for supporting me, you've all
  349. been really helpful.
  350.