═══ 1. Introduction ═══ File Commander/W V1.51 File Commander/W is a 32 bit Win32 console mode file manager and shell that allows you to locate, copy, move, delete, view, edit and execute your files in a quick, convenient and customizable manner. It's main display provides dual directory view panels that may serve as source and destination of a copy or move operation or just two different views of your files. A panel may also be used to view a directory tree, drive statistics or may be turned off altogether, making visible the output of previously executed commands. A command line is also provided and operates in conjuction with the directory panels to make it much more powerful than a regular CLI including pasting file names from the panel, a command history recall window and command completion from history. Please remember that File Commander/W is Shareware. If you like and use it, please support the shareware concept by Registering. ═══ 2. Features ═══ The following are some of the major features of File Commander/W: o Built in archive support, with ZIP, ARJ, RAR and LZH types currently supported. o Mouse support. o Full long file name support. o User definable menu, featuring powerful operators such as - Run a command once for every tagged file. - Automatically create a file containing a list of tagged files. - Get input value from the user. - List all tagged files in the parameter list, automatically running the command multiple times if the command line gets too long. o Online help. o Many configuration options. o Built in file viewer with hex view mode. o Built in editor with cut/copy/paste ability using the Windows clipboard. o File Find facility combining wildcard file name filters with file contents scanning. o Calculation of the total disk usage of a directory tree. o Tree views for quick and easy directory changes. o Ability to start Win32 console, Windows GUI and DOS applications. o Easy creation of Shortcuts. o Enhanced wildcard handling including boolean operators (and, or, not, brackets) for combining multiple file name masks. o Flexible file name filtering. o Support for 4DOS/4OS2/4NT descriptions o 132 column mode support. o Full support for volumes larger than 4GB (up to 2^63 bytes). ═══ 3. Shareware ═══ File Commander/W is copyrighted software. However, you are encouraged to copy and share the software with others according to the following requirements: File Commander/W may be freely copied and shared with others, so long as no charge is made for the software, and it is unmodified and copied in its entirety, including program documentation. It may be distributed by electronic means (modem, ftp etc), provided that all files are transmitted (archived) together. Notice that shareware is copyrighted software. It is not "Public Domain" software, nor is it "free" software. If you continue to use this program beyond a reasonable "trial period", not to exceed 30 days, you must pay for it by registering. See Registering for how to register. o Your registration fee makes it possible for me to continue to improve the program and increases the likelihood that I will provide useful, cheap software in the future. o IF YOU USE THE PROGRAM FOR COMMERCIAL PURPOSES, YOU MUST REGISTER. o Your registration fee buys you the right to use the program beyond the trial period of 30 days. Your registration covers ALL VERSIONS of File Commander/W, past, present AND future. ie You'll only ever have to register File Commander/W once. You may NOT charge anyone for a copy of this software other than a small copying fee. You may NOT include this software with any commercial software without the consent of the author. This software is supplied WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. In no event shall the author be liable to you for any consequential, special incidental or indirect damages of any kind arising out of the performance or use of the software, even if the author has been advised of the possibility of such damages. By using the software, you agree to these terms. ═══ 4. Registering ═══ The registration fee for File Commander/W is $29 Australian or $25 US. Once you have registered, you will be sent a serial number that, with your name, will allow you to 'register' the copy of the program you have. Once you have done this your name will appear in the 'Info' panel and you will not see any shareware reminders. This serial number will be good for all future versions of FC/W so you'll only ever have to pay once. Note that File Commander comes in two flavours, OS/2 and Win32. For registration purposes there is no distinction between the two so if you're registered for one you're registered for both. You don't need to register again if you move from one to the other or use both (ie dual booting). To register, choose whichever of the following applies to you. 1. Registering in Australia. 2. Registering from anywhere else. ═══ 4.1. Registering in Australia ═══ Australian residents can register by sending a Registration form and a cheque to the address given in Contacting the Author. Please make cheques payable to 'Brian Havard' (and please spell it correctly when writing the cheque to keep my bank manager happy). If you especially want to pay by credit card you'll need to register through BMT Micro as I can't accept credit cards directly myself. ═══ 4.1.1. Registration form (Australia) ═══ File Commander/W Order Form =========================== Name: Company: Address: Phone: Fax: Email: Product Price Quantity Total -------------------------------------------------------------------- File Commander/W single licence $ 29.00 x = $ . File Commander/W 5 user licence $ 120.00 x = $ . File Commander/W 10 user licence $ 200.00 x = $ . File Commander/W 25 user licence $ 500.00 x = $ . File Commander/W 50 user licence $ 800.00 x = $ . File Commander/W 100 user licence $1200.00 x = $ . File Commander/W unlimited licence $2000.00 x = $ . Latest File Commander/W on disk $ 3.50 x = (includes postage) Subtotal: $ . Delivery (check one): [ ] Email Free [ ] Fax (Australia) Free [ ] Fax (Non-Australia) $ 2.00 [ ] Regular Mail Free Total: A$ . ═══ 4.2. Registering Anywhere Else ═══ Non-Australian residents and Australians who wish to pay by credit card can register via BMT Micro, a US company that specializes in OS/2 shareware. Choose your prefered Payment method and Order method, then send in a completed Registration form. ═══ 4.2.1. BMT Micro Payment Methods ═══ You can register File Commander/W using any of the following payment methods. For up to date information on payment methods, see http://www.bmtmicro.com/info/payment.html. 1. Credit Card For your convenience, we accept most major credit cards. In order for your order to ship without delay, you must give the billing address and ZIP code that your credit card statement is mailed to. We will not normally ship to a different address than this address unless we have a faxed signature and can verify the "Ship to" address by phone. We reserve the right to refuse to ship to a different address than the credit card statement mailing address. We accept the following credit cards: o American Express o Diner's Club o Discover o Eurocard o Mastercard o Novus (all variations) o Optima o Visa 2. Money Orders/Cashiers Check Money orders, cashiers checks, and bank drafts are welcome, and all Shareware registered using these methods will ship as soon as payment is received. Please remember that all payments must be in U.S. dollars. 3. Personal Checks (US or Canadian Funds) Personal checks are welcome, but please allow up to two weeks for your check to clear the bank. Canadian Funds must equal the registration amount in US dollars. Make all checks payable to "BMT MICRO" and write "FOR DEPOSIT ONLY" on the reverse side of the check where it will be endorsed for your protection. In the lower-left edge of your check, please write in the name of the program you are registering. 4. Cash / Non-USA Funds We do not encourage that you send cash or currency in the mail but if you choose this method we will only be responsible for delivery if the mail containing your registration and cash require a signature upon receipt of delivery by a BMT Micro employee. We gladly accept German and British currency in any amount. Eurochecks are welcome but must be made in Deutsche Marks. To get the current exchange rate send a message to dm_to_us@bmtmicro.com. 5. Special Information for our German Customers File Commander/W can also be purchased by depositing the registration fee into our account with Deutshe Bank. Empfanger: Thomas Bradford / BMT Micro Konto-Nummer: 0860221 Bankleitzahl: 500-700-10 6. Other Payment Methods We're always adding additional payment methods. If you prefer or know of a payment method that would be more convenient for you please let us know. We'll make it a priority to make the arrangements. ═══ 4.2.2. Order methods ═══ Any of the following methods may be used to contact BMT Micro. 1. Voice Phone Numbers 8:00am - 7:00pm EST (-5 GMT) o (+1) 800-414-4268 -- Orders only (United States and Canada) o (+1) 910-791-7052 -- Orders and questions 2. FAX o (+1) 910-350-2937 -- 24-hour FAX o (+1) 800-346-1672 -- 24-hour FAX (toll free in USA and Canada) This is the perfect way to order after regular business hours or to send in questions, comments, or suggestions for a program. 3. Mail Address all mail to: BMT Micro P.O. Box 15016 Wilmington, NC 28408 USA 4. Over the Internet BMT Micro Web Page http://www.bmtmicro.com BMT Micro Secure Orders https://wwws.wilmington.net/bmtmicro Orders Only orders@bmtmicro.com ASCII Catalog catalog@bmtmicro.com .INF Format Catalog infcatalog@bmtmicro.com Lost Registration Information keys@bmtmicro.com Customer Service bmt@bmtmicro.com PGP Key for orders ftp://ftp.bmtmicro.com/bmtmicro/pgpkey We have also established an FTP site where the latest versions of our programs can be obtained 24 hours a day via anonymous login. FTP to ftp.wilmington.net as "anonymous", using your e-mail address as the password. All programs are contained in the /bmtmicro directory. You may wish to check /bmtmicro/incoming as well. 5. Support BBS For your convenience, we operate a bulletin board that can be used for registration, technical support, and downloading the latest versions of the Shareware programs we distribute. The BBS is available 24 hours per day, seven days a week at: o (+1) 910-350-8061 (10 lines @ 14.4kbps, v.32bis) o (+1) 910-799-0923 (28.8kbps) 6. CompuServe You may contact customer support by leaving us mail on CompuServe. Our CIS ID is 74031,307. Many of our products are also available on CompuServe in the OS2BVEN forum. 7. AOL (America Online) You may contact customer support on AOL also. Our AOL ID is bmtmicro. Check the OS/2 area on AOL for many of the products we distribute. 8. MSN: bmtmicro 9. Prodigy: HNGP66D ═══ 4.2.3. Registration form (BMT Micro) ═══ File Commander/W Order Form =========================== Name: Company: Address: Phone: Fax: Email: Product Price Quantity Total -------------------------------------------------------------------- File Commander/W single licence $ 25.00 x = $ . File Commander/W 5 user licence $ 90.00 x = $ . File Commander/W 10 user licence $ 150.00 x = $ . File Commander/W 25 user licence $ 375.00 x = $ . File Commander/W 50 user licence $ 600.00 x = $ . File Commander/W 100 user licence $ 900.00 x = $ . File Commander/W unlimited licence $1500.00 x = $ . Latest File Commander/W on disk $ 3.00 x = (includes postage) Subtotal: $ . North Carolina USA, residents, please add 6% sales tax: +$ . Shipping (check one): [ ] Email (subject to credit card verification) Free [ ] Fax (USA / Canada) $ 1.00 [ ] Fax (Non-North America) $ 2.00 [ ] Worldwide 1st Class Mail .................. Free Total: US$ . For credit card payment only: Check one: VISA [ ] Master [ ] Discover [ ] AMEX [ ] Diners's Club [ ] Credit card number: Expiration date: ═══ 5. Where to find FC/W ═══ To find the latest version of File Commander/W, try the following places: o FTP sites ┌─────────────────────────┬──────────────────────────────────────────────────┐ │BMT Micro │ftp://ftp.bmtmicro.com/bmtmicro/ │ │ │ │ │Walnut Creek CDROM │ftp://ftp.cdrom.com/pub/win95/diskutil/ │ │ │ │ │Monash Uni (Australia) │ftp://ftp.monash.edu.au/pub/win95/diskutil/ │ │ │ │ │File Commander home │ftp://silk.apana.org.au/pub/fcw/ │ └─────────────────────────┴──────────────────────────────────────────────────┘ o World Wide Web ┌────────────────────┬───────────────────────────────────────────────────────┐ │File Commander/W │http://silk.apana.org.au/fc.html │ │home │ │ └────────────────────┴───────────────────────────────────────────────────────┘ o BMT Micro support BBS, USA - +1-910-350-8061 (10 lines @ 14.4kbps, v.32bis) - +1-910-799-0923 (28.8kbps, v.FC) ═══ 6. Online Help ═══ FC/W has an online help facility that may be called up using the F1 key. For it to work, you must have the file fc.hlp in the same directory as fc.exe. The text called up will depend on what state FC/W is in when F1 is pressed. There are separate help texts for the following: o The main FC/W screen o Each of the 5 Menus o The Configuration window o The Confirmations window o The internal viewer o The internal editor o File Find o Attribute Change o The history window o Directory Compare o Edit User Menu o Edit Associations o The help window When there is more text than will fit in the window, you can use the Up / Down arrow, Page Up, Page Down, Home and End keys to move around or you can click the mouse in the top or bottom thirds of the window to scroll it (like in the Internal Viewer). ═══ 7. The File Panels ═══ The file panels are central to most operations in FC/W. They allow you to browse through the files on your drives, copy, move, rename and delete files you select from them as well as view, edit or execute any file. Normally, one panel will be active and the other will be inactive. The active panel is indicated by having its title highlighted. To change the active panel, press the TAB key or click the mouse on the panel you wish to become active. At any time, either or both panels can be hidden, allowing you to view the screen behind which will contain the output of any programs you've run. Press Ctrl-O to hide / re-display all visible panels or Ctrl-F1/F2 to switch the Left/Right panel on or off. If you feel that the information in a panel is no longer up to date, you can press Ctrl-R to re-read the information displayed in the panel. Note that this may take some time for Tree view panels if you have a large number of directories on your drive. ═══ 7.1. Panel View Modes ═══ The panels can display a list of files in several different ways. To change the style of view, select it via the Menu (Left or Right, depending on which panel you wish to change). You have the choice of: Brief Displays three columns of file names with no details. The status line at the bottom of the panel displays the details as in Full view for the current file. Full Displays file names with their size and the date and time of last modification. The status line is devoted entirely to displaying as much of the file name as possible allowing you to see more of a long file name than in the main section of the panel. Wide Displays file names with their size, providing much more space for the file name. This mode is most useful when viewing directories with many long file names. Tree Views the overall directory structure of the current drive of the opposite panel. Unlike in the above modes, when a panel is in tree mode, it is linked to the opposite panel in that selecting a directory on the tree and pressing ENTER causes the opposite panel to view that directory. Info The Info panel displays drive summary information for the current drive of the opposite panel. Details listed include total space, free space, label, file system and serial number. In addition, if the drive is mapped to network server or a peer share then the mapping of the drive is shown. If the opposite panel is viewing the contents of an archive, the panel shows total uncompressed size, total compressed size and compression ratio instead. You can quickly activate an Info panel using Ctrl-L. ═══ 7.2. Moving Around the Current Directory ═══ When you have a list of files showing (which is most of the time) you can move around the list using the following keys: Up Arrow Move up one file name. Down Arrow Move down one file name. Page Up Move up one screenful of file names. Page Down Move down one screenful of files names. Home Move to the first file name End Move to the last file name. Alt-[printable char] Move to the first file starting with [printable char]. If you continue to type printable characters, FC/W will look for a file starting with the string you've typed. Your typing is displayed in the status line of the current panel. Alt-Up/Down These keys serve two functions. If the cursor has just been moved using the above function, they move to the previous/next file name matching the partial name displayed in the status line. Otherwise they move to the first tagged file above/below the current position. When the current panel is in Brief mode, The left and right arrow keys move across one column. ═══ 7.3. Navigating around your drives ═══ When moving to a particular directory, the first step is get the correct drive showing. Press Alt-F1 for the left panel or Alt-F2 for the right panel to display a simple dialog box showing the currently available drives. Select the drive you want by pressing the appropriate letter, using the left / right arrows to move the highligt and press ENTER or clicking on the letter with the mouse. You can also change drives by entering a command in the form "d:" on the command line. Once you have the right drive, you can move around your directories by moving the cursor to a directory you want to change into and pressing ENTER. Selecting ".." moves to the parent of the current directory. Moving the cursor around the list of files in the current directory is achieved using the Up / Down arrows, Page Up, Page Down, Home and End. Double clicking the mouse on a directory name has will also change into that directory. The full path of the current directory is always shown on the top line of the panel. Other useful keys for navigating around your drive are: Ctrl-\ Move to the root directory of the current drive. Ctrl '-' Move back to the previously viewed directory. Note that this is only for the '-' on the main keyboard, not the numeric keypad (which has its own function). Ctrl-Page Up Move to the parent of the current directory (same as selecting ".."). Ctrl-Page Down Move into the currently highlighted directory (same as pressing ENTER except that the contents of the command line is ignored). A number of other methods can be used to find the directory you want, including: o Change directory tree o File Find o Recall stored path o Tree view panel o Command Line CD ═══ 7.3.1. Change Directory Tree ═══ The Change Directory Tree can be used to quickly locate and display the directory you're looking for. To activate it, press Alt-F10 or select it from the Commands Menu. You can then either browse through the tree structure using the same keys as used to browse through a file panel, or you can start typing the name of the directory you are looking for. As you type, the view will jump to the first directory name matching what you have typed so far. You can either keep typing until the directory you're looking for is located or you can use Ctrl-Enter to find the next match of what you've typed. When you've found the directory you want, press ENTER to make it the current directory of the current panel. You can exit the Change Directory Tree at any time by pressing ESC. If you have not previously viewed the tree of the current drive it must be read and this may take some time on a large drive. Once it has been read, the tree structure for the drive is saved to a file for future reference. Normally this file (fc2tree.dat) is written to the root directory of the drive the file describes. If you don't like this or if it's not possible (eg CD-ROM drives) you can make FC/W store all tree data files in one directory of your choice. To do this, change the Tree Data Directory setting in Options/Configuration to specify the directory where you want the data files. If at any time you believe the tree being shown is not correct, you can re-read the tree structure by pressing Ctrl-R. ═══ 7.3.2. File Find ═══ The File Find function can be used to search for a particular file. To activate it, press Alt-F7 or select it from the Commands Menu. There are five controls on the File Find dialog that you can use to narrow the search. These are: File(s) to Find The name of the file you're looking for. The name can contain any of the wildcard characters and boolean operators described in Tagging. Containing A text string that a file must contain in order to be considered a match. Case Sensitive Normally files are searched for the Containing text without matching case. Check this option to make the search case sensitive. Start at Root If this option is checked (default) the file search will begin at the root of the current drive. If not, it will begin in the current directory of the panel that was active when File Find was activated. Scan Subdirectories When checked, the search will recurse into all subdirectories of the starting directory, otherwise only the starting directory is searched. Use TAB / Shift-TAB and Cursor Up/Down to move between these fields entering your search data, then press ENTER to begin the search. As matches are found, they are listed with their full path in the top section of the File Find window. You can stop the search at any time by pressing ESC. You can do this to save time if the file you're looking for has been located but much of the drive has yet to be searched. Once the search is over, the list of matches is displayed from which you can choose using the Up / Down arrows, Page Up/Down, Home/End or clicking with the mouse. Pressing ENTER or double clicking the mouse on a file name will return to the file panel with its current directory changed to that of the selected file and with the selected file highlighted. You can also view or edit a file from the list using F3 or F4 respectively. If you used the Containing field and you use FC/W's internal viewer or editor, the starting position will be that of the first match. A file in the list can be deleted using F8. Note that this doesn't just remove it from the list but deletes the actual file. This can be handy if you are using File Find to locate junk files that you want to remove. If you do not want to see any of the files found you can press ESC to exit File Find (or click Cancel). To start a new search, change the appropriate fields then press ENTER. Whichever way you exit the File Find dialog, you can recall the list of files found by the last search by pressing Shift-Alt-F7. This can be very handy if you wish to examine each matched file in turn. ═══ 7.3.3. Storing and retrieving Paths ═══ To speed up access to you most frequently used directories, you can store the current directory path in one of ten 'slots'. At a later point in time you may recall the directory which causes the current panel to instantly move to the stored directory. o To store the current directory, hold down Ctrl and Shift then press one of keys 0-9 on the numeric keypad. o To retrieve a directory, hold down Ctrl then press one of keys 0-9 on the numeric keypad. If you forget which directories you've assigned to which keys, you can view the contents of the slots using Alt-F5. This lists all ten stored paths from which you can select one to change to using the Up / Down arrow keys and ENTER, clicking on one with the mouse or pressing a number from 0-9. If you do a 'Save Setup' before exiting FC/W, the directories you've stored will be remembered the next time you start it up. ═══ 7.4. Copying, Moving and Deleting Files ═══ These three operations are all performed in a similar way. All can be performed on either a single file or a group of files. To operate on a single file, simply move the highlight bar to the file you want to copy/move/delete using the keys described in Moving Around the Current Directory and press F5 to copy, F6 to move and F8 to delete. These keys (along with the rest of the function keys) are listed at the bottom of the screen so you don't have to memorize them. If you want to operate on a number of files at once, you should tag the files you wish to be affected (See Tagging). It's also possible to use Shift-F8 to to delete a single arbitrary file If you select copy or move, you will next be presented with a dialog box that allows you to specify the destination directory and file name. The default destination is the directory showing in the opposite panel. If this is what you want, just press ENTER to proceed, otherwise use the arrow keys, Delete, Backspace etc., to alter the path to what you want. You can also change the file name if you wish. You can rename several files at once using wild card characters '*' and '?'. For example, to change the extension of several files to .bak you would specify the destination file as '*.bak'. The wildcard characters represent characters taken from the source file name. If you select delete, you will be prompted with a confirmation dialog. If you're sure you want to go ahead with the delete, press Enter, 'y' or click 'OK'. To back out, press ESC, 'n' or click 'Cancel'. If there are files tagged you will be warned and asked a second time to confirm the delete. This is to make sure you haven't forgotten that some files are tagged which can happen if the tagged files have been scrolled off the panel. Either or both of these confirmations can be disabled if you wish (See Confirmations). All of the above operations can be stopped mid-process by pressing ESC. ═══ 7.4.1. Deleting a single arbitrary file. ═══ You can delete any single file, regardless of the state of the current panel, using Shift-F8. This displays a dialog that allows you to enter the full or relative path of any single file or directory that you want deleted. The default name is that of the file the panel cursor is currently on, allowing easy deletion of a single file in the current panel when in the middle of tagging a number of files for some other operation. ═══ 7.5. Tagging Files ═══ There are several commands available to tag files. These are: Insert Pressing the Insert key toggles the tag for the currently highlighted file and moves the highlight down to the next file allowing you to repeatedly press Insert to tag multiple files. Grey + Pressing the '+' key on the numeric key pad pops up a dialog into which you can enter a file name mask to specify which files should be tagged. The following types of wildcards can be used in the mask: * Substitutes for zero or more characters of any value. ? Substitutes for one character of any value. [a-d] Substitutes for one character of value a, b, c or d. [^a-d] Substitutes for one character of any value except a, b, c or d. [a-d^c] Substitutes for a, b or d. {fred,joe,foo}Substitutes for any one of the comma separated strings. In addition, several expressions can be combined using the following operators. | The OR operator, give a match if either of the expressions given match. IE "*.cpp | *.h" will match all .CPP and all .H files, and is equivalent to "*.{cpp,h}". & The AND operator, give a match if both expressions match. IE "*x* & *y*" will match any file that contains both an X and a Y. The AND operator has higher priority than the OR operator, so "a* & *b | c* & *d" is equivalent to "(a* & *b) | (c* & *d)". ! The NOT operator, reverses the match / no match result of any expression. "!*x*" will match any file that doesn't contain an X. () Brackets can be used to force order of operations override, as in mathematical expressions. Grey - This is just like Grey + except that it untags files that match the file mask. Grey * Invert tagging. All untagged files become tagged and all tagged files become untagged. Ctrl-Grey + Tag all files. Ctrl-Grey - Untag all files. Compare directories Selecting Compare Directories from the Commands Menu or pressing Ctrl-K tags files based on differences between the two panels. Restore Selection Selecting Restore Sel'n from the Files menu or pressing Alt-Grey-+ returns the current panel to the state of tagging as it was before the last F5-Copy command. This allows you to re-copy or perform some other operation on the same set of files as was just copied. Mouse Clicking the right mouse button on a file name toggles the tagging for that file. Holding the right button down and moving the mouse will tag / untag all files touched. If the Tag Directories option is not set, only Insert and Mouse allow you to tag directories. The other tagging methods ignore directories. When the Tag Directories option is set, all the above commands except Compare directories affect directory tagging. When any files are tagged, a summary of the tagged files is shown on the status line of the panel. This shows the number of files tagged and their total size. ═══ 7.5.1. Compare Directories ═══ The Compare Directories function provides a way to detect and, if desired, eliminate differences between two similar directories. The uses of this function are many but the most common use is syncronizing two copies of a set of files. When selected, FC/W identifies differences in the file lists of the left and right panels, tagging files according to the options selected. Most of the options are used to decide which files are tagged if a file name appears in both file lists. Date/Time Determines if the older, newer, both or neither copies of the file are tagged if the dates on them are different. Size Determines if the larger, smaller, both or neither copies of the file are tagged if the size of them are different. Tag Unmatched If a file name appears in one panel but not the other, this option causes it to be tagged. Compare Contents This is the brute force method. The two copies are compared byte for byte to check if there is any difference. If there is, both will be tagged. ═══ 7.6. Creating a Directory ═══ To create a subdirectory in the current directory, press F7 and enter the name of the subdirectory you want to create into the dialog. If the current panel is in tree view mode, the directory will be created in the directory the highlight is currently on. ═══ 7.7. Directory Size Calculation ═══ If you want to get an idea of what's taking up your precious disk space it's often useful to calculate how much space is used by a particular directory and all its sub-directories. File Commander/W allows you to do this for one or more of the directories showing in a file panel. To calculate the size of a directory, move the highlght on to the directory you wish to know the size of and press Ctrl-Q. This may take some time if there are a large number of files or sub-directories in the directory being calculated. When the directory has been scanned its total size is displayed in the same field as where a file's size is displayed instead of the word SUBDIR. If you want several of the directories in the panel to be calculated, tag them before pressing Ctrl-Q and all will be calculated. Calculating all of the directories provides a useful breakdown of where your disk space is being used. If you decide that the calculation is taking too long you can cancel it at any time by pressing ESC. Normally, the result of the size calculation is discarded when you change to another directory. If you want to browse through the directories that were calculated while retaining the calculated size display, set the Retain Dir Count option on the Options Menu. ═══ 7.8. Creating Shortcuts ═══ File Commander/W provides a quick and easy way to create Explorer shortcuts that simplifies the job of making programs available via the Explorer interface. All you have to do is locate the file you want an object for and press Alt-F6. There is a simple confirmation dialog to make sure you mean what you've pressed. Note that if you have tagged any files, shortcuts will be created for all tagged files with the default value for their titles. All shortcuts are created in the Programs folder for easy access. ═══ 7.9. Creating an Archive ═══ To create a new archive from a selection of files, press Shift-F5. You will be prompted for the path and name of the archive to be created as well as the type of the archive. The default path is that of the opposite panel. The default name is that of the file that the cursor is currently on without its extension. When you select OK, FC/W will call the selected archiver program to create the archive. ═══ 8. Running Other Programs ═══ There are several ways to start a program using FC/W. 1. Move the highlight bar to an executable file (.exe .com .cmd .bat) and press ENTER. 2. Move the highlight bar to a file which matches a defined Association and press ENTER. 3. Select a program from the User Menu. 4. Enter the program name on the Command Line. With all these methods, except the User Menu, you can start the program in a separate session by pressing Shift-Enter instead of just Enter. The way FC/W goes about starting the program depends on what type of executable it is. The following types are recognized: Win32 Console Started within the FC/W session unless Shift-Enter was used. Windows GUI Windows GUI apps are automatically started detached so there is no need to use Shift-Enter to make sure you can still use FC/W while the program is running. DOS Started within the FC/W session unless Shift-Enter was used. FC/W will invoke a command interpreter (as specified by COMSPEC) to run the program if any of the following are true. 1. The program is a script (.BAT). 2. The program cannot be found on your PATH. 3. The program name is preceded by a '#' 4. The command line contains a | (pipe) operator . ═══ 8.1. Associations ═══ An association is used to link data files to the program that uses them. To create an association, add a line of the following form: mask : program to your fcw.ini file using the Commands/Edit Associations menu option. You can also use the following when specifying the command to be run: ! Name of current file. !x Name of current file without its extension. !p Path of current panel. !P Path of opposite panel. !f Name of current file with full path. !s Path of current panel with trailing '\' !S Path of opposite panel with trailing '\' !n Nothing, but prevents automatic appending of current file name !! A literal, single ! If none of the above are used, the name of the current file is appended. EG *.dsk: loaddskf ! a: *.zip: pkunzip ! !P *.inf: view *.ico: iconedit *.zoo: zoo x *.cpp: make !x.exe *.{gif,jpg,bmp}|os2logo: pmview ═══ 9. Command Line ═══ The command line provided by FC/W operates in much the same way as your normal command prompt with a few extra features. The following keys are used to operate the FC/W command line: Pasting file names Ctrl-J or Ctrl-Enter Pastes the file name of the currently highlighted file into the command line. Note that if the character to the left of the cursor is alphanumeric, a recall from History will be performed instead. Ctrl-F Pastes the file name of the currently highlighted file with its full path into the command line. Ctrl-[ & Ctrl-] Pastes the left or right panel's path with trailing \. Clipboard Ctrl-Insert Copies the whole command line to the clipboard. Shift-Insert Pastes the clipboard to the command line at the cursor's current position. Ctrl-Shift-J Copies the name of the current file to the clipboard. Ctrl-Shift-F Copies the full path of the current file to the clipboard. Moving the cursor Left/Right Arrows Move the cursor around the command line. Note that these keys do not operate the command line if the current panel is in brief view. Use Alt-Left/Right Arrows instead. Alt-Left/Right Arrows Move the cursor around the command line regardless of which mode the current panel is in. Ctrl-Left/Right Arrows Move the cursor one word left or right. Ctrl-Home Move the cursor to the start of the line. Ctrl-End Move the cursor to the end of the line. Deleting characters Backspace Delete the character to the left of the cursor. Delete Delete the character under the cursor. Ctrl-Delete Delete the word to the right of the cursor. Ctrl-Backspace Delete the word to the left of the cursor. Esc Clear the entire command line. Changing Drive/Directory Commands of the form d: and cd somedir are interpreted by FC/W instead of being executed by the command interpreter. This provides the following differences to normal command line behaviour: 1. A CD command that specifies a drive letter will change both the current drive and directory in one command. 2. If the directory specified in a CD command does not exist in the current directory then any tree data that has been collected will be searched for the directory name specified. If found, it will be changed into. Using ! substitutions All the ! substitutions allowed in user menus can also be used on the command line. If you need an actual ! character you must to double it. ═══ 9.1. History ═══ Command history is used to save you re-typing a command that is the same or similar to a command you've entered before. There are several ways to locate the command you wish to repeat: Ctrl-E or Ctrl-Up Recall previously entered command. Repeated use steps through command history from newest entry to oldest entry. Ctrl-X or Ctrl-Down Steps forwards through command history. Useful if you overshoot using Ctrl-E Ctrl-J or Ctrl-Enter Recall previously entered command that matches the text to the left of the cursor. Can be used repeatedly to find successive matches. Note that this function only operates when the character to the left of the cursor is alphanumeric, otherwise a file name paste occurs as described in Command Line. Alt-F8 Displays a window containing a list of previously entered commands from which you can choose. Once you've highlighted the command you want using the Up / Down arrow keys or the mouse, you can press: Enter Re-execute command now. Shift-Enter Re-execute command now in a separate session. Ctrl-Enter Place command on the command line for editing. ═══ 10. Menu ═══ FC/W includes a menu system to provide easy access to a range of functions. Most of the functions on the menu can be activated by short-cut keys which are listed on the menus. The menu system can be operated by keyboard, mouse or a combination of both if you like. Keyboard 1. Activate the menu bar by pressing F9 or Ctrl-N. Also, Shift-F10 activates the menu with the cursor positioned on the last used function. 2. Select which menu you want by pressing the first letter of its title or by using the Left / Right arrows and pressing Enter. 3. Use the Up / Down arrows to select the menu item you want and press Enter to activate it. Alternatively, you can press the key that is highlighted in the menu item's name. 4. You can press Esc to back out. Mouse 1. Activate the menu bar by clicking the right mouse button on the top line. 2. Click on the title of the menu you want to use. 3. Click on the menu item you want ot activate. 4. To dismiss the menu, click anywhere away from the menus. These should be taken as examples only. The menus operate in much the same way as Windows pull down menus. ═══ 10.1. Left / Right Menu ═══ The Left and Right menus contain exactly the same functions but apply them to the appropriate panel. Brief Set panel to view files in Brief mode. Full Set panel to view files in Full mode. Wide Set panel to view files in Wide mode. Info Set panel to show drive summary information. Tree Set panel to view directories as a Tree. On/Off Toggle the visibility of the panel. Turning a panel off allows you to see the output of previously executed commands. Name Sort panel by file name Extension Sort panel by file name extension. The extension of a file name is from the last '.' onwards. Files with the same extension are ordered by name. Time Sort panel by file modification time and date. Files are listed from newest to oldest. Size Sort panel by file size. Files are listed from largest to smallest. Files of the same size are ordered by name. Unsorted Files are listed in the order provided by the file system. Reverse Reverses the order in which files are listed. Re-Read Refresh the contents of the panel. Useful if another process has modified the contents of the panel's directory or if removable media has been changed. Filter Display a dialog that allows you to modify the file name Filter Drive Change the drive being viewed. A small dialog is displayed showing the currently available drives from which you can choose. ═══ 10.1.1. Filters ═══ The file name filter can be used to define which files you want to see and which files you don't. It may contain up to 40, space separated file masks that are tested from left to right. The first mask that matches a file name will determine that file's visibility. To indicate an exclusion file mask, precede it with a '!'. If a file name doesn't match any of the masks, it will not be shown. EG *.exe *.com *.cmd *.bat Show only executable files !*.obj * Show all files except object files. foo* !*.obj * Show all files except object files unless they start with foo. ═══ 10.2. Files Menu ═══ ManuaBR(l) View User Manual. User Menu Display the User Menu. View View the current file. Edit Edit the current file. Copy Copy Files. Rename or Move Move Files. Make Directory Create a Directory. Delete Delete Files. File Attributes Display a dialog to alter File Attributes. File Case Modify a file or group of tagged files' names to be upper, lower or mixed case. This is only useful on case preserving file systems . File Date/Time Modify a file or group of tagged files' date stamp (last modified date). Select Group Tag a group of files by file name mask. Unselect Group Untag a group of files by file name mask. Invert Selection Toggle the Tagging status of all files in the current panel. Restore Selection Restore tagging status to the way it was before the last copy operation. Quit Exit File Commander/W. ═══ 10.2.1. File Attributes ═══ The File Attributes dialog allows you to modify the Read Only, Archive, Hidden and System attributes of a file or a group of files. To activate it select it from the Files Menu or press Ctrl-A. If no files are tagged, you'll be presented with a dialog displaying the attributes of the currently highlighted file. You can use the Up / Down arrow to move the cursor and Space to toggle the attribute the cursor is on or you can click on the check boxes with the mouse. If you have any files tagged, you'll be presented with a slightly different dialog. For each attribute, you can set, clear or leave alone that attribute for all the tagged files. The dialog looks similar to the one used for a single file but the check boxes are 3 state instead of 2. The three states are: [·] Don't change attribute (default) [ ] Reset attribute [X] Set attribute When you've set all the check boxes the way you want them, press Enter (or click OK) to proceed or ESC (or click Cancel) to exit without changing anything. ═══ 10.3. Commands Menu ═══ Tree Pop up the Change Directory Tree. File Find Locate a file using File Find History View the Command Line History. EGA Lines Toggle 50 line mode. Swap Panels Swaps the positions of the left and right panels. Panels On/Off Removes or replaces the panels allowing you to view the output of previously executed programs. Compare Directories Tags files according to the differences between the two panels. See Tagging for details. Calculate Dir Size Totals the size of all the files the currently highlighted diretory or currently tagged directories and displays the result(s) on the file panel in the field that normally says 'SUBDIR' Open Explorer Window Causes Explorer to open the window corresponding to the directory that FC/W is currently displaying. Register Turns a shareware copy of File Commander/W into a registered version. Once you have entered your name and serial number, you will not see any reminder messages and your name will appear on the Info panel. Edit Associations Starts the internal editor on your fcw.ini file. Any changes you make to associations will become active immediately. Edit User Menu Starts the internal editor on your main fcw.mnu file. ═══ 10.4. Options Menu ═══ Configuration Display the Configuration dialog allowing you to alter a number of options. Colours Edit the Colour Scheme Confirmations Display a dialog that allows you to disable some of the Confirmations. Hidden Files Toggles whether files with their hidden attribute set will be shown on the file panels or not. When hidden files are displayed, they are denoted by a '░' character. Path Prompt Toggles the display of the current path on FC/W's command line prompt. Full Screen Toggles whether the panels occupy the full screen length or just half the screen. Clock Toggles whether a clock will be shown in the top right hand corner or not. Tag Directories Enables the mass tagging commands to tag directories also. See Tagging Files for more details. Thousand Separator Toggles the use of a thousand separator in the file size column of Full and Wide modes. This reduces the number of significant digits that can be displayed but can increase readability. Retain Dir Count When set, the results of a Ctrl-Q Directory Size Count are retained when changing directory. This makes it easier to track down directories that are hogging a lot of disk space. Note that the directory sizes displayed are only as up to date as the last count. Save Setup Saves all current settings to the file fcw.ini so that all FC/W options will be set the same the next time you start it up. This can be performed automatically on exit if you wish by setting the autosave option (See Configuration). ═══ 10.4.1. Configuration ═══ To view the configuration options, select 'Configuration' from the Options Menu. Any options you change take effect as soon as you click OK (or press Enter when OK is the default button). If you use Cancel, all changes you've made are forgotten. To select an option to change either click on it with the mouse or use the TAB, Shift-TAB, Up & Down arrow keys to move to it. The current option is indicated buy a flashing cursor. If you want the changes to still be in effect the next time you start FC/W you need to select 'Save Setup' from the Options Menu otherwise the changes will be lost when you exit. Alternatively, you can switch on 'Autosave Setup' seen below. The options are: Viewer The file name (with full path if not in a directory on your PATH) of the file viewer to be used when you press F3. All the '!' substitutions described in Associations can be used when specifying a viewer or an editor. If this field is left blank, the Internal Viewer will be used. Alternate Viewer As for Viewer but specifies the viewer used when Alt-F3 is pressed. Editor Similar to Viewer but specifies the editor used when F4 is pressed. If left empty, the Internal Editor will be used. Alternate Editor As for Editor but specifies the editor used when Alt-F4 is pressed. Left Startup Directory The directory the left panel will display on start up. If left blank, the current directory for the session will be shown. Right Startup Directory The directory the right panel will display on start up. If left blank, the current directory for the session will be shown. Separate Session Prefix String added at the start of a command that causes it to be executed in a separate session. Default value is 'start /f'. Tree Data Directory The directory where tree data is stored. If left blank, tree data will be written to the root directory of each drive as "fc2tree.dat". The data stored is a representation of the directory structure of a drive and is used to avoid re-scanning the drive. Case Filter File Systems A list of file system names (as displayed on the Info panel) that are not case preserving and so need file names to be converted to lower case for easier reading. If not listed here, file names will be displayed as provided by the file system. Manual Name of an Information Presentation Facility file (*.inf) that is to be viewed when 'Manual' is chosen from the Files Menu. The default is fcw.inf (this file). Path Extension A list of directories, separated by semicolons, that are to be searched for executables in addition to those specified in the PATH environment variable. Auto Save Switching Autosave on causes FC/W to automatically perform a 'Save Setup' just before exiting the program. Num Lock Specifies if numlock should be fixed on or not. Affects both FC/W and any program started by FC/W unless it is in a separate session. Use 132 Columns When on, FC/W will use 132 column display whenever possible. 132 column mode is only supported on some video cards in full screen sessions. Use Win Clipboard When on, FC/W's internal editor will use the Windows clipboard when performing Copy/Cut/Paste operations allowing it to share clipboard data with other programs. When this option is turned off, FC/W reverts to using its private clipboard which operates somewhat faster. Ctrl-R Drv Change Enables the drive selector dialog when pressing Ctrl-R. ESC Panel Switch Enables the use of ESC as a quick key for switching panels off/on when the command line is empty. Size Count Pause If enabled, FC/W will pause at the end of a directory size count activated by Ctrl-Q, allowing you to view the total file and directory counts. Pressing any key dismisses the dialog. Lines Sets the number of lines on screen or in window. Can be any number supported by your video card for full screen sessions or any value of at least 25 for a windowed session. Using a number that is not supported by your card in a full screen session will result in the number of lines being set to the next possible value up. Screen Saver The number of minutes of idle time before FC/W activates its screen saver. If set to 0, the screen saver will not activate. Note that the screen saver only operates when in a full screen session. Scroll Delay The time (in milliseconds) that FC/W waits between scrolling each line when the mouse has been used to scroll a panel or window. Use of this option stops the text flying past before you've had a chance to see what it is. Time Mode The type of time display used on the clock and when file time stamps are viewed in the files panel (Full mode). ═══ 10.4.2. Colours ═══ The Colours dialog allows you to alter the colour scheme used by FC/W. To activate it, select 'Colours' from the Options Menu You will be presented with a list of items in the colour scheme. Use the up & down arrow keys to move to the item you wish to change and then use F to cycle through forground colours and to cycle through background colours. Holding SHIFT at the same time will cycle backwards. There are a total of 16 colours to choose from for both foreground & background. When you're done, choose OK to use the changes you've made or ESC to forget them. Note that the changes will only be remembered for next time if you use 'Save Setup' or have Autosave enabled. ═══ 10.4.3. Confirmations ═══ Before doing anything significantly destructive, FC/W will ask for confirmation from the user to prevent accidental loss of data. If you are confident in your use of FC/W and don't want to be asked for confirmation all the time, you can disable some of the more common confirmation prompts by selecting 'Confirmations' from the Options Menu. A dialog displaying a list of confirmation types is then displayed with a check box next to each one. An 'X' in a check box indicates that the confirmation is enabled. To disable a confirmation, click its check box with the mouse and click OK. The keyboard can also be used (Up / Down arrows and Space, Enter when done). The confirmations you can alter are: Delete File/Empty Directory The first prompt you see after pressing F8. Delete Tagged Files The second prompt you see after pressing F8 when there are files tagged. Delete Non-empty Directory The prompt that asks you to type "YES" before doing a tree delete. Quit FC/W The prompt shown when you press F10. With this disabled, F10 causes immediate exit. "YES" prompt for Non-Empty Directory Similar to Delete Non-empty Directory but instead of disabling the "YES" prompt altogether, it is replaced by an OK / Cancel / All choice, the default being Cancel so anyone blindly pressing ENTER won't get caught. ═══ 11. Viewing / Editing Files ═══ FC/W allows you to view the current file with a choice of two viewers or to edit the current file with a choice of two editors. To view a file, use F3 or Alt-F3. To edit a file, use F4 or Alt-F4. The program used to view or edit is specified in the Configuration dialog. By default, the built in Viewer and the built in Editor are used for F3 and F4 respectively. If you wish to specify the file to view or edit by typing its file name, use Shift-F3 for view or Shift-F4 for edit. If you specify a file to edit that does not exist, you will be given the option to create it. The viewer or editor can be invoked directly when starting FC/W using the command line switches /v or /e followed by the name of the file to be viewed or edited. This allows other programs to call FC/W to view or edit files for them. ═══ 11.1. The Internal Viewer ═══ The file viewer built into FC/W is a basic text viewer that is perfect for taking a quick look at your text files. You can use the mouse or keyboard to scroll the text up and down (Keys: Cursor-Up/Down, Page Up/Down, Home, End). To scroll the text using the mouse, click the mouse in the top or bottom thirds of the screen. Using the right mouse button pages up or down. When the mouse is being used to scroll the text, the speed of scrolling is determined by the 'scrolldelay' Configuration directive. If a line is longer than 80 columns it will be chopped off at that length and the remainder placed one the next line unless you use F2 to select Unwrap mode. With the text unwrapped, you can use the Left / Right arrows to scroll the text horizontally. Ctrl-Left/Right scrolls in a much larger step (40 columns). Also, the mouse can be used to scroll horizontally by clicking the mouse in the centre third of the screen on the left or right side. ie o You can search for a string using F7 (or Shift-F7 to find next). The search can be either case sensitive or insensitive and either forwards or backwards in the file from the current view point. Using Alt-F7 will search in the reverse direction to that currently selected. o Will correctly interpret UNIX, PC or MAC line terminators (LF, CR/LF, CR) or even a mix of all three. o F4 will toggle between ASCII and Hex view. o Alt-L can be used to position to a particular line number. o Alt-O can be used to position to a particular hex offset. Obviously most useful when using hex view mode but still works in ASCII view. o If, while viewing a file, you find you want to edit at the position you're currently at, you can jump into edit mode using Alt-F4. o I think I've got all the bugs out of it but if you ever think it has become confused, pressing Ctrl-L will repaint the screen. ═══ 11.2. The Internal Editor ═══ The built in editor is a simple text editor that allows you to make quick changes to any plain text file. o Like the viewer, the editor will read a file using any type of line terminator. The file will normally be written back using the same type of line terminator unless overridden by the Alt-U command listed below. o Although there is no limit on the size of file you can edit, keep in mind that the whole file is loaded into memory so opening a multi-megabyte file may blow out your swap file. o The editor uses the Windows clipboard allowing you to exchange text with other programs. This feature may be turned off using the Use Win clipboard setting in the Configuration o If you edit the same file again, FC/W will return you to the same edit position as when you last exited the editor. o Will not expand TABs to spaces so it is safe to edit makefiles that require TAB characters. EG GNU Make The following keys operate in the editor: Left/Right/Up/Down As you'd expect Backspace Delete character left of the cursor. Ctrl-Backspace Delete word left of the cursor. Delete Delete character under the cursor or, if any text is selected, deletes selected text. Ctrl-Delete Delete word right of the cursor. Home Start of line End End of line. Page Up/Down Up/Down one page Ctrl-Home Top of screen Ctrl-End Bottom of screen Ctrl-Page Up/Down Start/End of file Ctrl-Y Erase line Ctrl-Insert / Ctrl-C Copy selected text to clipboard Shift-Insert / Ctrl-V Paste from clipboard Ctrl-Delete Delete selected text. Shift-Delete / Ctrl-X Cut selected text and place on the clipboard. ESC or F10 Exit editor (prompts to save if changes made) Shift-F10 Save and exit F2 Save now without exiting F3 Save now with prompt to change file name. F7 Search for a word in the text. Case sensitivity is optional as is the direction of the search. Shift-F7 Search for the same word again Alt-F7 Search for the same word again in the opposite direction to that selected when F7 was used. F8 Search and Replace. Similar to the search function (F7) but allows a replacement string to be specified. When a match is found you are given the choice of replacing, skipping, cancelling or replacing all matches. Ctrl-Q Quote next character. This enables you to enter control character into the file that would normally be rejected. For example, pressing Ctrl-Q ESC would insert the ESC character into the text. Insert Toggle Insert/Overstrike mode. When in overstrike mode the cursor becomes a block instead of an underline. Alt-I Toggle Auto Indent mode. When this mode is on (indicated by an 'I' on the status line) Pressing ENTER will start a new line with the same indentation as the line above. This is most useful when editing program source files. Alt-L Used to jump to a given line number. Alt-U Toggle UNIX type line terminators. When this mode is on (indicated by a 'U' on the status line), saving the file will cause it to be written using a LF as the line termiator instead of the usual CR/LF pair. This can be used to convert a text file between PC and UNIX text formats. When the editor is started, this mode will automatically turn on if the file being opened only contains LF terminated lines. To select text, hold down Shift and use the above cursor movement keys to move over the text you want to select. You can also drag the mouse over the text. The mouse can also be used to perform a page up or down by clicking the right mouse button in the top or bottom third of the screen. The states of the Insert/Overwrite and Auto Indent modes are retained between edits and will be saved in fcw.ini if Save Setup is used. ═══ 12. The User Menu ═══ The user menu is a list of functions defined by you to help you carry out common tasks. It is activated by pressing F2 and then using the Up/Down arrows and Home/End to choose an item and Enter to select or ESC to cancel. The mouse may also be used to select a user menu choice. To create a user menu you need to create a plain text file (using an editor like FC/W's internal editor or Windows Notepad) named fcw.mnu containing your list of menu functions in the same directory as fcw.exe. Here is an example user menu file: S: Scan for viruses os2scan c: d: D: Dos Window start /dos F12: Pulse pulse Z:Zip tagged files zip -r !i"Name of Zip?" -@ < !@ U: Unzip to opposite panel cd !P unzip !f cd !p A line that starts in the first column is a description line. The key used to activate the function is first and may be any single letter or number or one of the function keys F1-F12. After a separating colon comes the description that will appear in the menu when it is displayed. Any line that starts with a space or tab is a command and will be executed when the preceding description is chosen from the menu. It may contain the same '!' substitutions as Associations with the addition of the following: !t Substitutes for the name of a file and causes the command to be executed once for each tagged file. If no files are tagged, !t is just like !. !l Substitutes for a list of all tagged files, space separated. The command line length will not be allowed to grow beyond 1000 characters so if many files are tagged, some might not make it. If this happens, the files that were not included remain tagged after the command is executed. !L Same as above but for the opposite panel. !@ Substitutes for the name of a temporary file that contains a list of tagged files, one per line. !i"Question" Substitutes for a value input from the user. This causes a small dialog to appear displaying the supplied question and an input field. If ESC is pressed during input the user menu command is terminated. If a !i appears on the same line as a !t, the question is asked only once even though the command may be executed multiple times. Local User Menus In addition to the main user menu, you may create additional special purpose user menus by creating an fcw.mnu file in directories other than the one containing fc.exe. When you press F2 to activate the user menu, FC/W first looks in the current directory for a local user menu and displays it if found. If no fcw.mnu is found in the current directory the main user menu is displayed. You can force the main user menu to show by pressing Shift-F2 instead of F2. ═══ 13. Archives ═══ File Commander/W provides support for archive files (ZIP, ARJ, LZH and RAR types are currently supported) that makes these files behave in a similar way to normal subdirectories. To view the contents of an archive you simply press ENTER when the cursor is located on the archive file. It's possible to navigate any subdirectories inside the archive just as you would a normal directory tree. When a panel is showing the contents of an archive its top line, showing the current path, changes colour so you won't forget that you're not looking at a real subdirectory. While the majority of functions are available inside an archive, some restrictions do apply. o Copying files into an archive may only be done when the destination is the root directory of the archive. o It's not possible to change the name of a file while copying it from an archive. o It's not possible to edit the contents of a file in an archive. o Making a directory (F7) is not supported. o Changing Date/Time, Attributes or File Case is not supported. o Making an object isn't supported (wouldn't make any sense anyway) o File Find isn't able to search into archives (this may change in later versions). o Directories don't show up on the tree. o Open Explorer window obviously can't work. After reading all that you may be wondering what does work. The answer (as far as I'm aware) is everything else. This includes, but is not limited to: o copy/move files out of archive (extracting) even from subdirs in archive. o copy/move files into archive (compress) but only into archive's root. o View file in archive. o Delete files from inside archive. o Ctrl-Q on directory inside archive. o If you use a ! on the command line or in a user menu function, FC/W automatically extracts the current file into a temporary directory and substitutes the full path of the temporary file for the '!'. o If you press ENTER on a file that is an executable or is associated with a program, it will be extracted temporarily to allow it to be used. Only the one file is extracted though so if other files in the archive are required (EG DLLs) then it won't work as you intend. o Self-extracting archives can be entered by using Ctrl-PageDown. As the file is an executable, FC/W's normal reaction is to run it if you press ENTER. ═══ 14. Using the Mouse ═══ You can use the mouse to perform the following operations: o Select a file by clicking button 1 on a file name. o Tag/Untag a file by clicking button 2 on it. o Execute a file or change into a directory by double clicking button 1 on it. o Scroll the files up or down by clicking button 1 on the line directly above or below the files. o Tag several files by holding down button 2 and moving the mouse. If, while button 2 is pressed, the mouse is moved onto the line above or below the file list, the panel will scroll, tagging all files that pass by. o Select a function to perform by clicking on the function bar at the bottom of the screen. Using button 2 Selects the Alt function. This is particularly handy for changing drives (Alt-F1/F2). If a Ctrl, Alt or Shift key is pressed when button 1 is clicked on the function bar, the function called is modified appropriately. o Activate the menu by clicking button 2 on the top line of the screen. The easiest way to make a selection is to hold button 2 down after activating the menu, "pull down" the menu you want and release button 2 when you have the correct item highlighted. Clicking outside the menu area will dismiss the menu. o Whenever a dialog popup appears that contains push buttons that look like "[ OK ]", you may click on these with mouse button 1 to select the indicated choice. Clicking button 2 will select the highlighted button. o Whenever a dialog popup appears that requests a string input (eg Make Directory), button 1 may be used to position the cursor on the line and button 2 is equivalent to pressing ENTER. Clicking button 1 outside the dialog box or on a Cancel button, cancels the operation. o When the results of a 'File Find' operation are showing, double clicking button 1 on a file name will cause FC/W to jump to the directory the file is in (like pressing ENTER). The window can be scrolled by clicking on the top or bottom lines of the window. o When using the internal file viewer, clicking button 1 in the top or bottom third of the screen scrolls the screen up/down. Using button 2 pages up or down. o When using the internal editor, the mouse may be used to position the cursor on the currently displayed page or dragged over a section of text to mark it for Cut/Copy/Paste operations. ═══ 15. Notes, Hints and Tips ═══ o To associate Netscape or Lynx with HTML files, the command syntax looks like *.{htm,html}: netscape file:///! o If you use 4NT as your command interpreter, try to keep the contents of your 4start.cmd to a minimum as it is run every time you execute an external command in FC/W. o The fastest way to select a new drive for a panel using the mouse is to click the right mouse button on F1/F2 in the help bar at the bottom of the screen. o If you attach 4DOS/4OS2 descriptions to your files, they will be preserved if you copy or move them using FC/W. o If you want your viewer or editor to run in a separate session, add the start keyword before the name of your viewer / editor. ═══ 16. Obscure Options ═══ The following miscellaneous options can only be changed by directly editing your fcw.ini file. Note that it's possible to use multiple INI files by specifying the name of an alternate INI file as a parameter to fcw.exe. If the specified file doesn't yet exist, the default INI file will be loaded but the specified file will be written when settings are saved. Running fcw /? displays all command line parameters. BriefWordRight [ON|Off] The behaviour of all 'word right' movement is altered by this option. If this option is on (which is the default) the cursor will move to the end of the current word or, if it is already at the end of a word, to the end of the next word. When off, the cursor will always move to the beginning of the next word. CmdChar This is the character that is interpreted as FC/W's command character for the substitutions listed in Associations and User Menu. As these substitutions are also applied to commands entered on the command line, changing this options may be useful if you have a lot of files with a ! in their name. Default is ! CodePage Sets the codepage that FC/W will use. A value of 0 (the default) means use the current codepage. DisableInvert [On|OFF] Disables the Invert Selection function of the Grey * key, allowing it to resume its normal function of typing a *. This is provided for people who's keyboards make it a chore to get the other * (Shift-8 on a normal US keyboard). The Invert Selection function can still be used by selecting it from the Files menu. Shadows [ON|Off] Enables window shadows. Default is ON. StickyAlt [ON|Off] Affects the behavior of file name seeking using Alt-[letter] combinations. If this option is off you need to keep the ALT key held down for the whole seek string. This has the advantage of allowing you to start typing a command as soon as ALT is released. ═══ 17. Contacting the Author ═══ If you have any comments, questions, suggestions or bug reports, please feel free to contact me by any of the following means: Email brianh@kheldar.apana.org.au Web http://silk.apana.org.au/fc.html Snail Mail Brian Havard PO Box 152 Southland Centre 3192 Victoria AUSTRALIA Users of PGP public key encryption may wish to use my PGP Public key ═══ 18. Release History ═══ o xx/xx/xx v1.51 ═══ 18.1. Version 1.51 ═══ First release of Win32 version. The version number is started at 1.51 to stay in alignment with the OS/2 version. ═══ ═══ To add this PGP public key to your keyring, use the "Copy to file" option on the "Services" menu. You must then edit the resulting text.tmp file to remove the leading spaces before running 'pgp text.tmp'. Alternatively, you can use the command finger brianh@silk.apana.org.au to retrieve the key from my server. -----BEGIN PGP PUBLIC KEY BLOCK----- Version: 2.6 mQBNAy5yw5sAAAECAL2gXzytfphF4113fQeLjxiL8TyYPGRbTIJOLJObcy8JRg64 nZ7k470/GN5Qriw4Okttzn0h16QZqb+QYoLWjRUABRG0KkJyaWFuIEhhdmFyZCA8 YnJpYW5oQGtoZWxkYXIuYXBhbmEub3JnLmF1Pg== =JGS/ -----END PGP PUBLIC KEY BLOCK-----