CabMan version 1.3 WinCIM Filing Cabinet Manager by Borys Medicky [73234,1630] ============================= If you are using Notepad to read this, select Edit/Word Wrap. *** PLEASE READ THIS FILE AND THE CABMAN MANUAL BEFORE USING *** *** THIS SOFTWARE IS PROVIDED AS-IS, AND THE AUTHOR ASSUMES NO LIABILITY FOR ITS USE. REGISTERED USERS HAVE A LICENSE FOR ITS USE, BUT THE PROGRAM REMAINS THE INTELLECTUAL PROPERTY OF THE AUTHOR. *** What is CabMan? --------------- CabMan is a Filing Cabinet manager for users of CompuServe's WinCIM interface program. It allows the user to backup and restore, selectively or completely, the contents of the Filing Cabinet, as well as viewing, deleting, printing and exporting the text of entries, and even the importing of non-Filing Cabinet text into the Filing Cabinet. When backing up the Filing Cabinet, the user may select entries to back up based on date (e.g. for monthly backups) or record type (article, mail, ENS, message, thread). Entries may be selected from a single Folder, multiple Folders or the entire Filing Cabinet at once. If required, the contents of Folders may be displayed, and Folder entries may be individually marked for backup, deleted (without backup, if required), viewed for reading, printed, deleted or saved as unformatted DOS text. Searching for records based on user-specified keywords is supported. Entries selected for backup are copied into another Folder, or to another directory or disk with optional compression. After backup, any copied entries can optionally be deleted from the Filing Cabinet. When restoring to the Filing Cabinet from a prior backup, identical criteria apply. Entries may be deleted from a prior backup after copying, with automatic recompression of the backup. Note that backups do not have to be copied back into the Filing Cabinet in order to be accessible to the user. CabMan now supports the creation and use of multiple Filing Cabinets. Any Cabinet can be added to a list of predefined Cabinets within CabMan and is then usable as both a source and destination for copying, printing, deleting, importing and exporting operations. All Cabinets created through CabMan are fully WinCIM/CSNav-compatible. Extensive backup and restore features, coupled with text viewing, printing, deleting and keyword searching, allow CabMan to be used as a general Filing Cabinet management program independent of WinCIM. What is new in this version of CabMan? -------------------------------------- Version 1.3 of CabMan improves the functionality and appearance of version 1.2. Certain code that did not perform swiftly or reliably (e.g. printing, reindexing) has been rewritten. As well, there are major new features, especially support for multiple Filing Cabinets. For a full list, see "Version History" at the end of this document. Packing List ------------ The following files should be present in the unZIPped archive: CABMAN.EXE: CabMan executable CABZIP.PIF: Compressing program PIF CABUNZIP.PIF: Uncompressing program PIF GRID.VBX: Custom grid control CMDIALOG.VBX: Custom dialog control for printer setup VBCTL3D.VBX: Custom control for 3D appearance of CabMan PICBTN1.VBX: Custom control for graphic command buttons RTMOUSE.VBX: Custom control for popup balloon help README.TXT: This file REGISTER.TXT: Shareware registration information MANUAL.WRI: CabMan user's manual Installing CabMan ----------------- NOTE: Before installing, ensure that: * VBRUN300.DLL, the Visual Basic runtime module, is in your \WINDOWS\SYSTEM directory. This file is widely available on CompuServe (GO IBMFF and search for VBRUN300.EXE, a self-extracting file), ZiffNet (GO FREEUTIL, PCMag Library) and the Internet. Prior versions of this file (VBRUN200, VBRUN100) are NOT acceptable. *the Wingdings font is installed (see the Control Panel Fonts box). CabMan requires this font to draw graphics on some command buttons. *you own some compression software to use with CabMan: none is provided with this package. Any program can be used, but you must specify the directory containing the software after installation. *you have backed up your Filing Cabinet, just in case. ---First-time install--- 1. Create a new directory for CabMan. DO NOT install CabMan on a floppy disk, as it requires large amounts of temporary disk space. 2. Copy all CabMan files into this directory, EXCEPT the GRID.VBX, VBCTL3D.VBX, PICBTN1.VBX, RTMOUSE.VBX and CMDIALOG.VBX files, which should go in the \WINDOWS\SYSTEM directory. 3. Create a New Program Item, using Program Manager, for CABMAN.EXE. 4. Start CabMan by double-clicking its icon, and verify the information presented in the Setup window. New to this version of CabMan is the specification of (de)compression software directly in the Setup window: DO NOT modify the supplied .PIF files -- this step is NOT necessary. See section 5.1 of the user's manual for further details. ---Installing a new version over an older one--- 1. If you have a previous version of CabMan, delete ALL program files EXCEPT the GRID.VBX file, which should remain in the \WINDOWS\SYSTEM directory. Do not mix the new version files with the old ones: they are NOT compatible. 2. Copy all CabMan files into the directory that contained the old version. 3. Copy VBCTL3D.VBX, PICBTN1.VBX, RTMOUSE.VBX and CMDIALOG.VBX to the \WINDOWS\SYSTEM directory. Make sure you replace your existing VBCTL3D.VBX (if present) with the one provided with this version of CabMan. This VBX is an upgrade and is also compatible with Windows 95. 4. If you previously used version 1.0 of CabMan, change the executable file name associated with CabMan's Program Manager icon so that it is NOT followed by any numbers (e.g. not CABMAN10.EXE, but CABMAN.EXE). 5. Proceed with step 4 under "First-time install". IMPORTANT NOTE: Make sure that all VBXs are found ONLY in the \WINDOWS\SYSTEM directory. Do not keep extra copies in the CABMAN program directory, or unpredictable errors may result when running CabMan. Using CabMan ------------ A full manual for CabMan is contained in the file MANUAL.WRI, which should be opened using Windows Write. CabMan provides right mouse button help. By right-clicking any CabMan control, a help balloon will describe the function of that control for as long as the right mouse button is held down. In addition, one-line help is provided on status bars in several windows by passing the mouse pointer over the control in question. CabMan and Windows 95 --------------------- This version of CabMan has been tested under both Windows 3.1 and Windows 95. Since CabMan is a Windows 3.1 application, it does not support any Win95-specific features, most notably long file names. Right mouse button clicks in CabMan provide popup help balloons. Make sure you replace any existing VBCTL3D.VBX with the one included in this package. The old VBX is not fully Win95-compatible, and, although it does not interfere with CabMan's basic operation, it fails to properly paint the background of 3D controls. Uninstalling CabMan ------------------- Should you wish to uninstall CabMan, follow these steps: 1) Delete all the files from the CABMAN directory (or whichever directory contained the executable and setup files). 2) Remove the directory that contained the files. 3) In the \WINDOWS\SYSTEM directory, delete the files VBCTL3D.VBX, PICBTN1.VBX and RTMOUSE.VBX. 4) Determine whether you use any other Visual Basic programs. If not, delete the VBRUN300.DLL, GRID.VBX and CMDIALOG.VBX files from the \WINDOWS\SYSTEM directory. If uncertain, rename these files to some other filename and see if any of your commonly used programs give error messages about not being able to find these files. Should an error message occur, you must restore the original filenames and keep these files. 5) Click on the CabMan icon in the Program Manager and select File/Delete from the menu. Support for CabMan ------------------ CabMan is SHAREWARE. This means that, if you like CabMan and intend to continue using it, you must pay a registration fee of $20 (twenty) U.S. dollars to the author. For details, see the REGISTER.TXT file. Registered users receive priority in technical support and also receive the next version of the program free of charge on disk, when the next version becomes available. An upgrade discount is available for users who have registered an earlier version of CabMan. Details are provided to such users via email. If you have questions, comments, criticisms or suggestions, please send email to the author. Identify which version of the program you are using, as well as your operating system. Borys Medicky 73234,1630 (CIS) bmedicky@io.org (Internet) Version History --------------- This contains a list of corrections and additions to the CabMan program. v1.3c (3 Oct 95) ===== Official release of CabMan 1.3. Bug fixes --------- -corrected tendency to interpret soft line breaks in Articles as hard breaks (i.e. carriage-return+linefeed) -corrected improper sorting of items by date in Folder View window (caused by certain Time display settings in Control Panel) -corrected inability to recognize European number formats in Print window (i.e. 0,5 1.000 etc.) -corrected tendency for Folder View window to disappear behind others when focus was lost Setup ----- -'Cancel' button now acts a a true Cancel, i.e. discards any changes made to Setup window and reloads previous settings from CABMAN.INI file Backup/Restore -------------- -added ALT+key labels to graphic buttons and 'Folder Name' list for keyboard access Load/Save --------- -CABMAN.LOG now records the original Filing Cabinet records were in so that Restore can copy into the proper destination Cabinet when using log file Text View --------- -added name of Folder to text header (useful for identifying source Folder for messages that result from a keyword search across multiple Folders) Print ----- -corrected margin and spacing fields to allow entry of numbers according to International settings in Control Panel -added 'Folder' option to Header and Footer boxes to print the name of the Folder containing the record being printed -'Print file headers' and 'inches/cm between records' now recorded in CABMAN.INI -'Cancel' now acts as a true Cancel button and discards any changes made to the Print window -added ALT+key labels to all controls for keyboard access Import ------ -added ALT+key labels to all controls for keyboard access vß1.3c (31 Aug 95) ====== Improvements to the 1.3b beta. Bug fixes --------- -corrected failure of 'Run WinCIM', 'Reindex' and 'New' commands to properly run WinCIM if it was on a disk drive different from CabMan's drive -fixed 'Bad File Name' bug on some computers when attempting to Import a file General ------- -replaced CABMAN.SET with true CABMAN.INI file, located in the CabMan program directory Setup ----- -divided Setup controls into several windows, accessible via 'General...', 'Compression...', 'Environment...', and 'Other...' buttons -added multiple Filing Cabinet support via a 'Source Cabinet' button that opens the Select Cabinet window -added 'Always overwrite' and 'Never overwrite' options to Setup to control whether duplicated files (e.g. pieces of broken threads) should be allowed to overwrite each other Select Cabinet -------------- -allows selection of source Filing Cabinet (i.e. Cabinet to copy from, print, delete, save as text, read) from a list of user-defined Cabinets saved in the CABMAN.INI file; accessible from the Setup and Backup window -allows selection of destination Filing Cabinet (i.e. Cabinet to copy into); accesible from the Save Archive/Save into Filing Cabinet window -allows selection of Cabinets to reindex; accesible by pressing the Reindex button in the initial window -user-defined Cabinet definitions consist of a descriptive name and the parent directory of the Cabinet -users can create new Cabinets, change descriptions for existing Cabinets, delete Cabinet definitions (but not the actual Cabinets), select Cabinets as source/destination, select Cabinets to reindex -users can reindex one Cabinet at a time, or all those that need reindexing -reindexing code modified: CabMan now deletes Filing Cabinet index (.IDX) files, then starts WinCIM to automatically reindex CabMan initial window --------------------- -'Quit' button now exits CabMan immediately as long as no reindexing is required -reindexing calls on the Select Cabinet window and shows a list of Cabinets; cabinets that need reindexing are marked 'R' Import ------ -changed code that auto-generates filenames for imported files to avoid duplicating filenames, which led to overwriting of files (e.g. importing into several different folders would create an ART00001.ART file in each, which could overwrite each other in future copy operations) Backup ------ -added 'Source Cabinet' button to allow changing the source Cabinet (identical to 'Change...' button in Setup); last source Cabinet used is saved into CABMAN.INI. Folder View ----------- -added routine to strip TABs out of certain Washington Post article titles, which could not be opened without causing 'Bad File Name' errors Save ---- -last DOS directory and Folder name used are now saved into CABMAN.INI file and used as defaults for next CabMan session -last destination Cabinet used is saved into CABMAN.INI file -added 'Destination Cabinet' button to allow changing the destination Cabinet Print ----- -added 'inch' and 'cm' option buttons to convert margin and spacing measurement units; default units can be saved as a future print preference vß1.3b (14 July 95) ====== Improvements to the 1.3a beta. Bug fixes --------- -corrected occasional disappearance of CabMan windows behind other windows -fixed inability to print to right-hand page margin -fixed loss of printer font information when printing multiple items at once -fixed bug where final page footer was never printed when printing multiple items per page -fixed bug where minute shown in message creation times was incorrect -fixed bug where foreign-language ENS text was truncated at the beginning General ------- -added popup balloon help (right mouse button activated) to all windows Backup/Restore -------------- -replaced command icons with graphic picture buttons (buttons can receive focus, which will assist with future Help methods) Setup ----- -added 'Delete originals after Importing' checkbox -added 'Folder View default sort' boxes to specify default sorting when window first shown -added 'Folder View left mouse button' boxes to alter type of marking done by clicking left mouse button -added file mask box to allow typing *.*, etc. Load/Save --------- -added file mask box to allow typing *.*, etc. Print ----- -replaced font selection box with Windows common dialog box for selecting fonts, printer and paper -print margins are now relative to page edges, not relative to built-in print offsets of the print driver -print speed greatly enhanced Folder View ----------- -cleared all sort option buttons after every sort so sort keys can be clicked successively -records on same date are now sorted by time of day -replaced command buttons with graphic command buttons -modified 'Tile with Text Views' checkbox so that Folder View window is returned to centre of screen when checkbox is deselected Text View --------- -added 'More' button to scroll text window without using scroll bar vß1.3a (23 May 95) ====== Functional and cosmetic improvements to CabMan 1.2. Bug fixes --------- -fixed needless display of duplicated messages in some threads -fixed problem that caused printing routine Invalid Property Value error on some computers -rewrote Reindex procedure to work reliably -fixed bug where cancelling specified actions in Folder View window disabled Next button after clicking it in any visible Text View window -fixed bug caused by pressing Previous or Next buttons in Text View window whose parent Folder View had been closed (program later failed to show Backup/Restore window after closing last Folder View) -fixed Path/File Error that resulted from trying to create a compressed backup from a currently loaded compressed backup General ------- -added 3D appearance to all windows and controls (optional; can be disabled in Setup window) -added control boxes to all non-modal windows -added online help to registered version -'Cancel' button now works during printing Setup ----- -added 'Enable 3D effects' checkbox to allow disabling of 3D appearance -added 'CabMan windows always on top' checkbox to keep all CabMan windows on top of others even when inactive or minimized -added 'F3 finds keyword in next record' checkbox to allow automatic opening and keyword searching of next available record -added 'Quit WinCIM after Reindexing' checkbox to determine if WinCIM keeps running after reindexing CabMan initial window --------------------- -added 'Run WinCIM' command button to start WinCIM Import ------ -added 'Edit menu with 'Cut/Copy/Paste/Clear' functions -added warning message when imported text is truncated on loading -added sizeable window borders and Maximize button to window -added 'FILED' caption above text window when current text is filed -text window is now cleared after deleting the current file, to eliminate confusion -Save Into Filing Cabinet window now remembers last folder used for filing Backup/Restore -------------- -added 'View Messages' button to provide quick shortcut to the Folder View window Folder View ----------- -added ability to highlight a range of items by dragging with mouse or SHIFT+clicking -marking buttons now mark highlighted range as well as single item -Mark All button marks all items in highlighted range, or entire header list if only one item highlighted Text View --------- -printing speed now greatly accelerated -added 'Edit' menu with 'Copy' function -added warning message if currently read text is truncated on loading -improved speed at which window is redrawn when resizing v1.2 (13 Mar 95) ==== Official release of CabMan 1.2, with a few corrections to the 1.2c beta version. Bug fixes --------- -fixed Out of Memory error when importing a large text file -fixed Overflow error when printing multiple records per page -fixed bug where Folder list in Save window was sometimes empty -fixed bug where OK button in Save window was sometimes disabled Save Archive window ------------------- -window now remembers last directory and Folder name used, as well as deletion and compression settings Folder View/Text View --------------------- -Keyword searches now remember last used keyword vß1.2c (1 Mar 95) ====== A few features added to the 1.2b beta version. Bug fixes --------- -fixed misnumbered message numbers in threads downloaded using CSNAV (e.g. 1 of 0, 2 of 0) CabMan initial window --------------------- -added Import button to allow importing of non-Filing Cabinet items into the Filing Cabinet Backup window ------------- -added double-clicking of a Folder name to immediately show headers Folder View window ------------------ -added sorting of header list using any column as a sort key Load/Save window ---------------- -improved log file operation so that log file records Folder names instead of DOS directory names Print window ------------ -added capability to disable printing of file headers vß1.2b (19 Feb 95) ====== A few additional features and bug fixes to the 1.2a beta version. Bug fixes --------- -fixed print routine ignoring some margin settings if no header or footer specified -corrected mis-identification of record types for items downloaded using CSNAV -fixed Bad Record Number bug when trying to read emails with attached files -fixed 'Selected directory is empty' bug when using CabMan with certain features disabled -corrected improper Folder View window title when viewing records by type Folder View window ------------------ -improved speed with which search results were displayed in a new Folder View window -added feature to tile Folder View window with newly opened Text View windows for simultaneous viewing Save As Text window ------------------- -added feature to concatenate multiple items being saved as text into a single text file Print window ------------ -improved printing speed vß1.2a (12 Feb 95) ====== Major upgrade with a few bug fixes and many new features. Bug fixes --------- -blank lines in Folder View window when viewing large folders (>1100 items or so) now fixed -CSNAV-downloaded threads causing blank text windows now fixed -false 'Could not create compressed archive...' error message now fixed -disabled OK button in Folder View window, caused sometimes by individually unmarking previously marked items, now fixed -@b symbols in certain messages now removed General ------- -ALT+keyboard shortcuts for many command buttons and checkboxes -improved error handling: Abort, Retry, Ignore buttons on error boxes prevent lockups or endless loops -operation with reduced features: CabMan will now function in the absence of a Filing Cabinet, WinCIM and/or (de)compression software, with any features that require missing Setup information disabled Setup window ------------ -user-specified default directory to save backups into -specification of default file extension used by compression software (to eliminate bug) -specification of (de)compression software program names and command-line switches in Setup window: no more modification of .PIF files required Backup/Restore window --------------------- -scrollable list for Folder Name display, instead of old dropdown list -true multiple folder support: select one folder, ALL FOLDERS, or multiple individual folders using SHIFT-clicking or CTRL-clicking or dragging with mouse button down -viewing contents of multiple folders in Folder View window is now possible -keyword search options added to Backup/Restore window, with multiple folder support and selectable search case-sensitivity -All By Date backup/restore option can now show records within specified dates in the Folder View window -all Destination, 'Use compression' and 'Delete originals' options have been moved to the Load/Save window -Load Archive window has checkbox for specifying a compressed archive, to eliminate previous confusion -'New' button moved to Load/Save window; allows creation of new Folder or DOS directory depending on selected Destination -memory limitations significantly reduced: if not using Folder View window, number of Filing Cabinet records handled is essentially unlimited (when running Windows in enhanced mode) Folder View window ------------------ -Total items in folder and number of Marked items displayed at top of Folder View window for statistical purposes -marking for 'Save as text' option available in Folder View window: saves records as plain DOS text -'Mark All' command and soft buttons have 'Save as text' option -multiple Folder View window support for Keyword command button: can either mark records containing keyword or show search results in a new Folder View window (which can be searched again, if desired) -'Save Header Summaries' command allows a list of all header information to be written into a DOS text file, delimited by TABs (for importing into a spreadsheet) -optional use of multiple text windows: double-clicking a header name does not create a new text window if a non-minimized window is presently on-screen; pressing View command button always creates a new text window -memory limitations reduced: Folder View window can now handle approx. 16500 headers simultaneously Text window ----------- -Text view window has 'Save as text' checkbox -'Save' command button allows saving currently viewed text as unformatted DOS text -'Find' command now performs case-insensitive searches -keyboard support for <-, -> buttons (use -,+ keys) -selectable printing of user-highlighted text only Print window ------------ -selectable bold, italic, underline font options -selectable left, right, top and bottom margins -selectable paper dimensions -page headers/footers: none, Forum, Subject, Source/Author, Date, page number or user-specified text -multiple records can be printed per page, to save paper (selectable) -all font options, margins, headers/footers can be saved as future print preferences v1.1 (6 Dec 94) ==== Maintenance release: existing features improved and bugs corrected. General ------- -fixed Illegal Function Call when pressing Print button in Text View window -fixed Type Mismatch Error when first starting CabMan -fixed Out of String Space when opening text very close to 32K in size -fixed Out of String Space when archiving a large Filing Cabinet -fixed Previous, Next buttons not showing subsequent articles when Text View window is maximized -Very slow opening of text files is now corrected -fixed Illegal Function Call when viewing headers for a large folder Setup ----- -Setup window now has drive, directory and file boxes for assisting the user in choosing the proper directories Text View --------- -'Find' button in Text View window now remembers previously used keyword so F3 can be pressed repeatedly without respecifying keyword v1.0 (19 Nov 94) ==== General ------- -fixed bug where hourglass would not disappear during initial Setup screen -corrected error when using All by Date archiving option -corrected potential Out of Memory error when backing up large Filing Cabinets -corrected infinite loop when Esc pressed during Setup -program does not end anymore if Cancel pressed when saving archives -corrected bug where recently deleted folders were still shown in Folder Name list -corrected inconsistent showing of Folder View window when selecting records by type -new initial screen contains Backup, Restore, Reindex, Setup and Quit options Backup/Restore window --------------------- -'New' button added for creating new folders -Save dialog now occurs before Backup begins -Backup no longer creates a temporary directory for archives, unless compression is used -original locations of archives can be logged if backing up to DOS destination (for use when Restoring) -backups can be restored to Filing Cabinet, using same criteria as Backup -logged backups can be restored into their original folders -can work with Backups (i.e. view, print, delete) without having to actually copy into Filing Cabinet Folder View window ------------------ -Folder View window now has printing and deleting options -can mark items containing a specified keyword(s) for Backup or Restore -'Mark All' button has been added -keyboard can be used along with mouse to mark items Text View window ---------------- -new 'Print' button for immediate printing -contains 'Mark', 'Print', 'Delete' check boxes allowing marking without closing window -new 'Find' button for searching text for keyword(s) -Threads and Messages now properly displayed -date, time, author, recipient, subject info now displayed along with text v?.? (unnumbered) ================= Initial release of CabMan. *****