home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / av182.zip / av.doc next >
Text File  |  1993-09-02  |  16KB  |  323 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) with
  80. UNZIP.EXE, then run INSTALL.EXE and answer a few questions.
  81. Alternatively, unpack the internal AVEXE.ZIP and copy AV.EXE to a
  82. directory on your PATH, AV.HLP to a directory in your HELP path, and
  83. ARCHIVER.BB2 to a directory on your DPATH (automated installation can be
  84. easilty accomplished with this in mind).  Note that you cannot install a
  85. new version of AV while AV is already running. You might want to set a
  86. default directory for AV that would point to where new archives are
  87. usually to be extracted (the AV work directory will be off of this
  88. directory, too), and enable AV for drag-and-drop startup by including
  89. "%*" as a parameter, like this on the first settings page of the AV WPS
  90. object (note the Parameters and Working directory fields):
  91.  
  92.    ╔══╤══════════════════════════════════════════════════════╤══╤══╗
  93.    ║--│ AV.EXE - Settings                                    │  │  ║
  94.    ╟──┴──────────────────────────────────────────────────────┴──┴──╢
  95.    ║┌────────────────────────────────────────────────┐             ║
  96.    ║│                                                ├┐            ║
  97.    ║│                                                │├┐           ║
  98.    ║│                                                │Program      ║
  99.    ║│                                                ││││          ║
  100.    ║│                                                ││Session     ║
  101.    ║│ Required                                       ││││          ║
  102.    ║│   Path and file name:                          │││Assocation ║
  103.    ║│   ┌───────────────────────┐   ┌───────╖        ││││          ║
  104.    ║│   │C:\UTILS\AV.EXE        │   │Find...║        ││││General   ║
  105.    ║│   └───────────────────────┘   ╘═══════╝        ││││          ║
  106.    ║│                                                ││││          ║
  107.    ║│ Optional                                       ││││          ║
  108.    ║│   Parameters:                                  ││││          ║
  109.    ║│   ┌───────────────────────────────────┐        ││││          ║
  110.    ║│   │%*                                 │        ││││          ║
  111.    ║│   └───────────────────────────────────┘        ││││          ║
  112.    ║│   Working directory:                           ││││          ║
  113.    ║│   ┌───────────────────────────────────┐        ││││          ║
  114.    ║│   │D:\ADIRECTORY                      │        ││││          ║
  115.    ║│   └───────────────────────────────────┘        ││││          ║
  116.    ║│                                                ││││          ║
  117.    ║│ ┌───────╖   ┌───────╖                          ││││          ║
  118.    ║│ │ Undo  ║   │ Help  ║                          ││││          ║
  119.    ║│ ╘═══════╝   ╘═══════╝                          ││││          ║
  120.    ║│                                             < >││││          ║
  121.    ║└┬───────────────────────────────────────────────┘│││          ║
  122.    ║ └┬───────────────────────────────────────────────┘││          ║
  123.    ║  └┬───────────────────────────────────────────────┘│          ║
  124.    ║   └────────────────────────────────────────────────┘          ║
  125.    ║                                                               ║
  126.    ╚═══════════════════════════════════════════════════════════════╝
  127.  
  128. You may also want to add associations for archive files at the
  129. Associations tab of the Settings notebook.  That will allow you to start
  130. AV looking at the file by double-clicking on a file object in a
  131. directory folder:
  132.  
  133.    ╔══╤══════════════════════════════════════════════════════╤══╤══╗
  134.    ║--│ AV.EXE - Settings                                    │  │  ║
  135.    ╟──┴──────────────────────────────────────────────────────┴──┴──╢
  136.    ║┌────────────────────────────────────────────────┐             ║
  137.    ║│                                                ├┐            ║
  138.    ║│ Available types               Current types    │├┐           ║
  139.    ║│ ┌─────────────┬─┐ ┌────────╖ ┌─────────────┬─┐ ││├┐Program   ║
  140.    ║│ │Assembler Cod│^│ │  Add>> ║ │Arc archive  │^│ ││││          ║
  141.    ║│ │BASIC Code   ├─┤ ╘════════╝ │Arj archive  ├─┤ ││││Session   ║
  142.    ║│ │Binary Data  ├─┤            │FTN mail arch│ │ ││││          ║
  143.    ║│ │Bitmap       │ │            │LHarc archive│ │ │Assocation   ║
  144.    ║│ │C Code       ├─┤            │LHarc source ├─┤ ││││          ║
  145.    ║│ │COBOL Code   │v│ ┌────────╖ │Zip archive  │v│ ││││General   ║
  146.    ║│ ├─┬─────┬───┬─┼─┘ │<<Remove║ ├─┬─────┬───┬─┼─┘ ││││          ║
  147.    ║│ │<│     │   │>│   ╘════════╝ │<│     │   │>│   ││││          ║
  148.    ║│ └─┴─────┴───┴─┘              └─┴─────┴───┴─┘   ││││          ║
  149.    ║│  New name:                    Current names    ││││          ║
  150.    ║│┌────────────────┐ ┌────────╖ ┌─────────────┬─┐ ││││          ║
  151.    ║││*.ARC           │ │  Add>> ║ │*.ZIP        │^│ ││││          ║
  152.    ║│└────────────────┘ ╘════════╝ │*.LZH        ├─┤ ││││          ║
  153.    ║│                              │*.ZOO        ├─┤ ││││          ║
  154.    ║│                   ┌────────╖ │             │v│ ││││          ║
  155.    ║│┌──────╖ ┌──────╖  │ Remove ║ ├─┬─────────┬─┼─┘ ││││          ║
  156.    ║││ Undo ║ │ Help ║  ╘════════╝ │<│         │>│   ││││          ║
  157.    ║│╘══════╝ ╘══════╝             └─┴─────────┴─┘   ││││          ║
  158.    ║│                                             < >││││          ║
  159.    ║└┬───────────────────────────────────────────────┘│││          ║
  160.    ║ └┬───────────────────────────────────────────────┘││          ║
  161.    ║  └┬───────────────────────────────────────────────┘│          ║
  162.    ║   └────────────────────────────────────────────────┘          ║
  163.    ║                                                               ║
  164.    ╚═══════════════════════════════════════════════════════════════╝
  165.  
  166.  
  167. As lagniappe, LA.EXE is included in the archive.  It's a text-mode app
  168. that can list and view archive contents, and extract from archives,
  169. without your needing to know anything about what kind of archive it is
  170. or what the various archivers' commands are.  Run it without arguments
  171. for a brief help screen.  It also uses ARCHIVER.BB2 and is a 16-bit
  172. application.
  173.  
  174.  
  175.          ┌───System Menu                          Maximize icon──┐
  176.          │   ┌───Title Bar                Hide/minimize icon──┐  │
  177.        ╔═╪╤══╪═══════════════════════════════════════════════╤╪═╤╪═╗
  178.        ║--│ AV:  Select Files                                │  │  ║
  179.        ╟──┴──────────────────────────────────────────────┬───┴──┴──╢
  180. Menu───╫─ Files  Dirs  Config  Misc  End                 │ F1=Help ║
  181.        ╟─────────────────────────────────────────────────┴─────────╢
  182.        ║┌─────────────────────────┬─┐   ┌───────────────────────┬─┐║
  183. Masks──╫┤*                        │v│ @ │*.C                    │v│║
  184.        ║└─────┼───────────────────┴─┘   └───────────────────┼───┴─┘║
  185. Dir    ║      │                     ┌───╖                   │      ║
  186. Stats──╢5     │    35975k         0 │──>║ 1         88266k  │     0║
  187.        ║      V                     ╘═══╝                   V      ║
  188.        ║┌────────────────────────────┐ ┌──────────────────────────┐║
  189.        ║│ E:\                        │ │ D:\ADIR                 ─┼╫─Path
  190.        ║└───────────┼────────────────┘ └──────────┼───────────────┘║
  191.        ║┌───────────┼──────────────┬─┐ ┌──────────┼─────────────┬─┐║
  192.        ║│ DOCS      V   >> 93/02/25│^│ │TEST.C    V  >> 93/04/03│^│║
  193.        ║│ FTSCDOCS      >> 93/02/11├─┤ │                        ├─┤║
  194.        ║│ GRAPHICS      >> 93/02/12│ │ │                        │ │║
  195.        ║│ MISC_BBS      >> 93/02/11│ │ │                       ─┼─┼╫─File list
  196.        ║│ PROG          >> 93/02/12│ │ │                        │ │║
  197.        ║│ XBBS          >> 93/02/10├─┤ │                        │ │║
  198.        ║│AV32SRC.ZIP    >> 93/08/31│ │ │                        │ │║
  199.        ║│HEAD4SRC.ZIP   >> 93/08/31│ │ │                        │ │║
  200.        ║│XBBS2SRC.ZIP   >> 93/08/31│ │ │                        │ │║
  201.        ║│FMSRC.ZIP      >> 93/08/31├─┤ │                        ├─┤║
  202.        ║│XBBSOS2!.ZIP   >> 93/08/31│v│ │                        │v│║
  203.        ║├─┬───────────────┬──────┬─┼─┘ ├─┬──────────────┬─────┬─┼─┘║
  204.        ║│<│               │      │>│   │<│              │     │>│  ║
  205.        ║└─┴───────────────┴──────┴─┘   └─┴──────────────┴─────┴─┘  ║
  206.        ║┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐║
  207.        ║│  │ │  │ │  │ │  │ │  │ │  │ │  │ │  │ │  │ │  │ │  │ │ ─┼╫─Toolbox
  208.        ║└──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘║ icons
  209.        ╚═══════════════════════════════════════════════════════════╝
  210.               Figure: A typical AV main (Select Files) window
  211.  
  212. You'll do most of your AV work from a window like that in the figure
  213. above.
  214.  
  215.  
  216.  
  217. Known bugs/features:
  218. ===================
  219.  
  220. AV doesn't handle archived filenames with spaces in them.  Setting a
  221. desktop bitmap with anything but Scaled doesn't work.  Other limitations
  222. are as imposed by OS/2; for instance, DosStartSession, the API that
  223. creates new sessions, can only accept 1024 bytes on the command line,
  224. listboxes are still limited to around 64K of text, and the internal
  225. viewer is subject to the usual MLE limitations and caveats.  Future
  226. revisions of OS/2 may relax these restrictions.
  227.  
  228. Sometimes the archivers themselves have bugs:  for example, ZOO 2.01
  229. seems to extract files with paths even when you don't ask for it, ZIP
  230. 1.9 sometimes crashes out with an "internal logic error" when building
  231. files, and UNZIP 5.01 doesn't seem to extract a file without directories
  232. at all.  I've tried to note these bugs, where known, in ARCHIVER.BB2.
  233.  
  234. There could be bugs in AV, of course -- AV is a non-trivial program --
  235. but these problems/features are all I know about.  If you think you've
  236. found a bug and would like to report it, do so with enough detail to
  237. allow me to repeat the problem, or you're wasting your time and mine.  I
  238. can't fix phantoms.  "It doesn't work" doesn't help.  "If I do this,
  239. then I do this, that happens" might.
  240.  
  241.  
  242.  
  243. Warranty:
  244. ========
  245.  
  246. Absolutely none.
  247.  
  248.  
  249.  
  250. Support:
  251. =======
  252.  
  253. Registered users may send and receive Fidonet netmail, Snail mail or
  254. call the BBS with questions and answers (although, to be honest, AV is
  255. so simple help should rarely, if ever, be needed).  See end of document
  256. for addresses.
  257.  
  258. Unregistered users will get help as and if I get the time.
  259.  
  260.  
  261.  
  262. Reality Check:
  263. =============
  264.  
  265. I have a strange sense of humor, and it shows.  Registered users can
  266. turn the weird stuff off if they don't like it.
  267.  
  268.  
  269.  
  270. Shareware:
  271. =========
  272.  
  273. If you like and regularly use AV, you should register it by sending the
  274. author $35.00 US via check or money order (sorry, no plastic) at the
  275. address below.  Send $5.00 US more for shipment outside the continental
  276. US (unless you want to pick it up electronically or send an SASE).  The
  277. registered version doesn't have the opening popup, has fully operational
  278. Groups, will build archives, and allows the OS/2 2.x extended selection
  279. interface.  You'll get the latest copy by diskette with whatever
  280. additional enhancements I can concoct on it.
  281.  
  282. You may continue to use the unregistered version of AV if you're a
  283. tightwad, or just plain broke (not a sin).  My intent is not to gouge
  284. you for cash, but to provide a service and sell a program.  You must
  285. register, however, to get a fully functional copy of AV, and
  286. registrations help to ensure that AV will continue to be upgraded and
  287. improved regularly (makes the wife happy).  Compare the cost to
  288. something like Norton Commander at a retail of $149.00...
  289.  
  290. The above prices and terms are for private individuals.  Commercial
  291. users _must_ register to use AV, and must pay $75.00 US per
  292. copy/machine.  Bulk rates and site licenses available on request.
  293.  
  294. You can call the BBS at the number below to set up picking up your
  295. registered version by modem if you prefer.  I'll still send you a disk.
  296.  
  297.  
  298.  
  299. Copyrights and such:
  300. ===================
  301.  
  302. Zoo         --  Rahul Dhesi
  303. Lh2         --  Peter Fitzsimmons (from Haruyasu Yoshizaki)
  304. PK(UN)ZIP   --  PKWARE (Phil Katz)
  305. Arj         --  Robert Jung
  306. Zip         --  Mark Adler, Richard B. Wales, Jean-loup Gailly
  307.                 and Kai Uwe Rommel.
  308. Unzip       --  S. H. Smith and others / Info-ZIP
  309. Pak         --  Nogate Consulting
  310. ARC         --  System Enhancements Associates (Thom Henderson)
  311. Fidonet     --  Tom Jennings
  312. AV, XBBS,   --  Mark Kimes
  313. FM &
  314. Headedit
  315.  
  316.  
  317.  
  318. Mark Kimes
  319. 542 Merrick
  320. Shreveport, LA  71104
  321. (318)222-3455 data (FTN mailer and BBS)
  322. Fidonet#1:380/16.0
  323.