home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / file / aview / av.doc next >
Encoding:
Text File  |  1993-07-17  |  12.6 KB  |  281 lines
  1.  
  2.                         AV (Archive Viewer)
  3.                  Copyright (c) 1992/93 by M. Kimes
  4.                         All rights reserved
  5.  
  6.  
  7.  
  8. Overview:
  9. ========
  10.  
  11. AV is a 32-bit PM archive viewing, file/directory maintenance and
  12. program launching utility for OS/2 2.x.
  13.  
  14. Features:
  15. --------
  16.  
  17. o Configurable for any archive type, past, present and future
  18.   via self-documenting plain text configuration file.  Internal editting
  19.   dialog available, or can be editted with an external text editor.
  20.   Sample C code included should you want to utilize the configuration
  21.   file in your own work.
  22.  
  23. o Drag & drop, full keyboard interface including accelerator keys,
  24.   standard menu and configurable "toolbar" support.  Choose your
  25.   interface.
  26.  
  27. o Fast file-oriented design.  Not as pretty as WPS, but much quicker.
  28.   However, AV supports (and can even create and destroy) WPS objects.
  29.  
  30. o Full range of file manipulation functions:  copy, move, rename,
  31.   delete, execute, view, edit, print, alter attributes and datestamp,
  32.   set icon, create objects, encrypt, and more, on selected files.
  33.  
  34. o Directory tree with directory maintenance commands; delete, make,
  35.   rename, move, copy, and archive.  Delete and make work on multiple
  36.   levels:  delete a subdirectory and all files and subdirectories are
  37.   deleted; create a directory many levels deep with one command.
  38.  
  39. o Viewing and editting text files via simple internal MLE viewer/editor
  40.   or seamlessly integrate more sophisticated and/or specialized external
  41.   programs; for example, view ICONs via ICONEDIT and INFs via VIEW just
  42.   by selecting them.
  43.  
  44. o File association separate from the WPS's; no space required in
  45.   "fragile" OS/2 system .INI files or EAs.  Can be used to extend
  46.   viewing capabilities and/or execute programs when their data files are
  47.   selected.
  48.  
  49. o OS/2 1.x-like Groups for organizing programs.  Can be used as an
  50.   alternate Workplace Shell on low memory machines.  Secure-mode
  51.   available in registered version to password-restrict a workstation to
  52.   a pre-arranged set of programs.
  53.  
  54.  
  55. As you've received AV, it's set up for the following OS/2 archivers on
  56. your PATH:
  57.  
  58. Zoo         2.1         [ZOO.EXE]
  59. PK(Un)Zip   1.01        [PKZIP.EXE/PKUNZIP.EXE]
  60. Zip/UnZip   1.9/5.0     [ZIP.EXE/UNZIP.EXE]
  61. LH2         2.22        [LH.EXE]
  62. UnArj port  2.10        [UNARJ.EXE]
  63. UnArj demo  2.30        [UNARJ.EXE]
  64. Arc         5.12mpl     [ARC.EXE]
  65. Arc2        6.0         [ARC.EXE]
  66.  
  67. If you don't have these OS/2 archivers by these names on your PATH
  68. you'll need to use a text editor to edit the ARCHIVER.BB2 control file
  69. or use the Config->Edit Archiver menu item from AV to make the necessary
  70. changes so your setup is reflected accurately.  Otherwise, archive
  71. viewing and manipulation may not work properly.  It's a simple process,
  72. so dive in.
  73.  
  74.  
  75. There's complete help online, so this document is mercifully brief.
  76. To get the most information in the least time, try the Contents
  77. option.
  78.  
  79. To install AV, unpack it into a scratch directory (top level only), then
  80. run INSTALL.EXE and answer a few questions.  Alternatively, unpack the
  81. internal AVEXE.ZIP and copy AV.EXE to a directory on your PATH, AV.HLP
  82. to a directory in your HELP path, and ARCHIVER.BB2 to a directory on
  83. your DPATH (automated installation can be easilty accomplished with this
  84. in mind).  You might want to set a default directory for AV that would
  85. point to where new archives are usually to be extracted (the AV work
  86. directory will be off of this directory, too), and enable AV for
  87. drag-and-drop startup by including "%*" as a parameter, like this on the
  88. first settings page of the AV WPS object (note the Parameters and
  89. Working directory fields):
  90.  
  91.    ╔══╤══════════════════════════════════════════════════════╤══╤══╗
  92.    ║--│ AV.EXE - Settings                                    │  │  ║
  93.    ╟──┴──────────────────────────────────────────────────────┴──┴──╢
  94.    ║┌────────────────────────────────────────────────┐             ║
  95.    ║│                                                ├┐            ║
  96.    ║│                                                │├┐           ║
  97.    ║│                                                │Program      ║
  98.    ║│                                                ││││          ║
  99.    ║│                                                ││Session     ║
  100.    ║│ Required                                       ││││          ║
  101.    ║│   Path and file name:                          │││Assocation ║
  102.    ║│   ┌───────────────────────┐   ┌───────╖        ││││          ║
  103.    ║│   │C:\UTILS\AV.EXE        │   │Find...║        ││││General   ║
  104.    ║│   └───────────────────────┘   ╘═══════╝        ││││          ║
  105.    ║│                                                ││││          ║
  106.    ║│ Optional                                       ││││          ║
  107.    ║│   Parameters:                                  ││││          ║
  108.    ║│   ┌───────────────────────────────────┐        ││││          ║
  109.    ║│   │%*                                 │        ││││          ║
  110.    ║│   └───────────────────────────────────┘        ││││          ║
  111.    ║│   Working directory:                           ││││          ║
  112.    ║│   ┌───────────────────────────────────┐        ││││          ║
  113.    ║│   │D:\ADIRECTORY                      │        ││││          ║
  114.    ║│   └───────────────────────────────────┘        ││││          ║
  115.    ║│                                                ││││          ║
  116.    ║│ ┌───────╖   ┌───────╖                          ││││          ║
  117.    ║│ │ Undo  ║   │ Help  ║                          ││││          ║
  118.    ║│ ╘═══════╝   ╘═══════╝                          ││││          ║
  119.    ║│                                             < >││││          ║
  120.    ║└┬───────────────────────────────────────────────┘│││          ║
  121.    ║ └┬───────────────────────────────────────────────┘││          ║
  122.    ║  └┬───────────────────────────────────────────────┘│          ║
  123.    ║   └────────────────────────────────────────────────┘          ║
  124.    ║                                                               ║
  125.    ╚═══════════════════════════════════════════════════════════════╝
  126.  
  127. You may also want to add associations for archive files at the
  128. Associations tab of the Settings notebook.  That will allow you to start
  129. AV looking at the file by double-clicking on a file object in a
  130. directory folder:
  131.  
  132.    ╔══╤══════════════════════════════════════════════════════╤══╤══╗
  133.    ║--│ AV.EXE - Settings                                    │  │  ║
  134.    ╟──┴──────────────────────────────────────────────────────┴──┴──╢
  135.    ║┌────────────────────────────────────────────────┐             ║
  136.    ║│                                                ├┐            ║
  137.    ║│ Available types               Current types    │├┐           ║
  138.    ║│ ┌─────────────┬─┐ ┌────────╖ ┌─────────────┬─┐ ││├┐Program   ║
  139.    ║│ │Assembler Cod│^│ │  Add>> ║ │             │^│ ││││          ║
  140.    ║│ │BASIC Code   ├─┤ ╘════════╝ │             ├─┤ ││││Session   ║
  141.    ║│ │Binary Data  ├─┤            │             │ │ ││││          ║
  142.    ║│ │Bitmap       │ │            │             │ │ │Assocation   ║
  143.    ║│ │C Code       ├─┤            │             ├─┤ ││││          ║
  144.    ║│ │COBOL Code   │v│ ┌────────╖ │             │v│ ││││General   ║
  145.    ║│ ├─┬─────┬───┬─┼─┘ │<<Remove║ ├─┬─────┬───┬─┼─┘ ││││          ║
  146.    ║│ │<│     │   │>│   ╘════════╝ │<│     │   │>│   ││││          ║
  147.    ║│ └─┴─────┴───┴─┘              └─┴─────┴───┴─┘   ││││          ║
  148.    ║│  New name:                    Current names    ││││          ║
  149.    ║│┌────────────────┐ ┌────────╖ ┌─────────────┬─┐ ││││          ║
  150.    ║││*.ARC           │ │  Add>> ║ │*.ZIP        │^│ ││││          ║
  151.    ║│└────────────────┘ ╘════════╝ │*.LZH        ├─┤ ││││          ║
  152.    ║│                              │*.ZOO        ├─┤ ││││          ║
  153.    ║│                   ┌────────╖ │             │v│ ││││          ║
  154.    ║│┌──────╖ ┌──────╖  │ Remove ║ ├─┬─────────┬─┼─┘ ││││          ║
  155.    ║││ Undo ║ │ Help ║  ╘════════╝ │<│         │>│   ││││          ║
  156.    ║│╘══════╝ ╘══════╝             └─┴─────────┴─┘   ││││          ║
  157.    ║│                                             < >││││          ║
  158.    ║└┬───────────────────────────────────────────────┘│││          ║
  159.    ║ └┬───────────────────────────────────────────────┘││          ║
  160.    ║  └┬───────────────────────────────────────────────┘│          ║
  161.    ║   └────────────────────────────────────────────────┘          ║
  162.    ║                                                               ║
  163.    ╚═══════════════════════════════════════════════════════════════╝
  164.  
  165.  
  166. As lagniappe, LA.EXE is included in the archive.  It's a text-mode app
  167. that can list and view archive contents, and extract from archives,
  168. without your needing to know anything about what kind of archive it is
  169. or what the various archivers' commands are.  Run it without arguments
  170. for a brief help screen.  It also uses ARCHIVER.BB2 and is a 16-bit
  171. application.
  172.  
  173.  
  174.  
  175. Known bugs/features:
  176. ===================
  177.  
  178. AV doesn't handle archived filenames with spaces in them.  Setting a
  179. desktop bitmap with anything but Scaled doesn't work.  Other limitations
  180. are as imposed by OS/2; for instance, DosStartSession, the API that
  181. creates new sessions, can only accept 1024 bytes on the command line,
  182. listboxes are still limited to around 64K of text, and the internal
  183. viewer is subject to the usual MLE limitations and caveats.  Future
  184. revisions of OS/2 may relax these restrictions.
  185.  
  186. Sometimes the archivers themselves have bugs:  for example, ZOO 2.01
  187. seems to extract files with paths even when you don't ask for it, ZIP
  188. 1.9 sometimes crashes out with an "internal logic error" when building
  189. files, and UNZIP 5.01 doesn't seem to extract a file without directories
  190. at all.  I've tried to note these bugs, where known, in ARCHIVER.BB2.
  191.  
  192. There could be bugs in AV, of course -- AV is a non-trivial program --
  193. but these problems/features are all I know about.  If you think you've
  194. found a bug and would like to report it, do so with enough detail to
  195. allow me to repeat the problem, or you're wasting your time and mine.  I
  196. can't fix phantoms.  "It doesn't work" doesn't help.  "If I do this,
  197. then I do this, that happens" might.
  198.  
  199.  
  200.  
  201. Warranty:
  202. ========
  203.  
  204. Absolutely none.
  205.  
  206.  
  207.  
  208. Support:
  209. =======
  210.  
  211. Registered users may send and receive Fidonet netmail, Snail mail or
  212. call the BBS with questions and answers (although, to be honest, AV is
  213. so simple help should rarely, if ever, be needed).  See end of document
  214. for addresses.
  215.  
  216. Unregistered users will get help as and if I get the time.
  217.  
  218.  
  219.  
  220. Reality Check:
  221. =============
  222.  
  223. I have a strange sense of humor, and it shows.  Registered users can
  224. turn the weird stuff off if they don't like it.
  225.  
  226.  
  227.  
  228. Shareware:
  229. =========
  230.  
  231. If you like and regularly use AV, you should register it by sending the
  232. author $35.00 US via check or money order (sorry, no plastic) at the
  233. address below.  Send $5.00 US more for shipment outside the continental
  234. US (unless you want to pick it up electronically or send an SASE).  The
  235. registered version doesn't have the opening popup, has fully operational
  236. Groups, will build archives, and allows the OS/2 2.x extended selection
  237. interface.  You'll get the latest copy by diskette with whatever
  238. additional enhancements I can concoct on it (still have several
  239. improvements I want to make).
  240.  
  241. You may continue to use the unregistered version of AV if you're a
  242. tightwad, or just plain broke (not a sin).  My intent is not to gouge
  243. you for cash, but to provide a service and sell a program.  You must
  244. register, however, to get a fully functional copy of AV, and
  245. registrations help to ensure that AV will continue to be upgraded and
  246. improved regularly (makes the wife happy).  Compare the cost to
  247. something like Norton Commander at a retail of $149.00...
  248.  
  249. The above prices and terms are for private individuals.  Commercial
  250. users _must_ register to use AV, and must pay $75.00 US per
  251. copy/machine.  Bulk rates and site licenses available on request.
  252.  
  253. You can call the BBS at the number below to set up picking up your
  254. registered version by modem if you prefer.  I'll still send you a disk.
  255.  
  256.  
  257.  
  258. Copyrights and such:
  259. ===================
  260.  
  261. Zoo         --  Rahul Dhesi
  262. Lh2         --  Peter Fitzsimmons (from Haruyasu Yoshizaki)
  263. PK(UN)ZIP   --  PKWARE (Phil Katz)
  264. Arj         --  Robert Jung
  265. Zip         --  Mark Adler, Richard B. Wales, Jean-loup Gailly
  266.                 and Kai Uwe Rommel.
  267. Unzip       --  S. H. Smith and others / Info-ZIP
  268. Pak         --  Nogate Consulting
  269. ARC         --  System Enhancements Associates (Thom Henderson)
  270. Fidonet     --  Tom Jennings
  271. AV & XBBS   --  Mark Kimes
  272.  
  273.  
  274.  
  275.  
  276. Mark Kimes
  277. 542 Merrick
  278. Shreveport, LA  71104
  279. (318)222-3455 data (FTN mailer and BBS)
  280. Fidonet#1:380/16.0
  281.