home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / win / tools / fc30e / readme.txt < prev    next >
Text File  |  1994-10-08  |  18KB  |  418 lines
  1.  
  2.    WELCOME TO FILE COMMANDER!
  3.  
  4.    This disk contains File Commander 3.0e
  5.  
  6.  
  7.    File Commander is an extender for the Win 3.1 File Manager.  It allows
  8.    you to add four (see below) menu items to the File Manager menu bar.
  9.    From each of these top-level menu items, File Commander allows you to
  10.    make up to 99 menu items spread up to 5 levels deep.
  11.  
  12.    File Commander helps you end the drudgery of day-to-day tasks
  13.    when working in Microsoft Windows.  Its FAST text-based interface
  14.    completely avoids the graphical overhead that often bogs down real
  15.    productivity in Windows.
  16.  
  17.    How many times have you tired of changing drives, moving through two
  18.    subdirectories, finding an executable file from among 43 other
  19.    filenames, double clicking on it, selecting File/Open, then searching
  20.    for another directory in the listbox because your document happens to
  21.    be in a different directory than the program!  With File Commander you
  22.    can automate that knowledge of where to move around the disk, which
  23.    directories to go to, which files you want to work on, what size you
  24.    prefer your window to be, and so on.
  25.  
  26.  
  27.  
  28.    With almost three hundred and fifty functions and commands, File Commander can:
  29.  
  30.  
  31.      .  Run Windows and DOS programs.
  32.  
  33.      .  Send keystrokes directly to applications.
  34.  
  35.      .  Rearrange, resize, hide, and close windows.
  36.  
  37.      .  Run programs either concurrently or sequentially.
  38.  
  39.      .  Display information to the user in various formats.
  40.  
  41.      .  Prompt the user for any needed input.
  42.  
  43.      .  Present scrollable file and directory lists.
  44.  
  45.      .  Copy, move, delete, and rename files.
  46.  
  47.      .  Read and write files directly.
  48.  
  49.      .  Copy text to and from the Clipboard.
  50.  
  51.      .  Perform string and arithmetic operations.
  52.  
  53.      .  Make branching decisions based upon numerous factors.
  54.  
  55.  
  56.    And much, much more.
  57.  
  58.    Of course, to take full advantage of the flexibility of File Commander,
  59.    one must spend some time with either the manual or the help file and
  60.    become aquainted with the underlying WIL script language.  However,
  61.    for those less technically inclined (you mean not everyone is a rocket
  62.    scientist???), the sample menus shipped with File Commander provide a
  63.    great deal of added value with no modifications whatsoever, and (even
  64.    though I hate to admit it) I expect a sizeable portion of File
  65.    Commander users will never actually have the need to modify the File
  66.    Commander menus by hand.
  67.  
  68.    There are few things you should understand about the File Manager and
  69.    its relationship to File Commander and other File Manager extenders.
  70.    Be sure to read the both this readme file and File Commander manual
  71.    if you have any other File Manager extenders installed.
  72.  
  73.    SYSTEM REQUIREMENTS
  74.  
  75.    File Commander requires an IBM PC or compatible with a minimum of 4
  76.    megabytes of RAM (You need 8 really though), running Microsoft Windows
  77.    version 3.1
  78.  
  79.  
  80.  
  81.  
  82.    *** LATE BREAKING NEWS ***
  83.  
  84.    File Commander 3.0 is a FREE major update from the previous version.
  85.    It is a "free for the download" upgrade.  The licensing codes are
  86.    the same as for version 2.0.
  87.  
  88.    If we need to get involved - if you want a printed version of the
  89.    manuals (nearly 450 pages) or real disks, then the upgrade fee
  90.    is $20.  Call 1-800-762-8383 if you wish the $20 upgrade.
  91.  
  92.    File Commander comes with four sample menu files, each of which are
  93.    associated with a new File Manager menu item.  To wit:
  94.  
  95.        Menu title          Menu File
  96.  
  97.        Main                WWWFC1.MNU
  98.        Applets             WWWFC2.MNU
  99.        Utils               WWWFC3.MNU
  100.        Groups                WWWFC4.MNU
  101.  
  102.    Although these files are mainly intended as code samples that you can
  103.    peruse to make your own add-on menu items, a lot of people, especially
  104.    those not willing to plunge in and learn the batch language, will find
  105.    that the sample menu items do all sorts of neat stuff, and may be
  106.    perfectly content to live with the sample menus supplied.
  107.  
  108.    These sample menus are not exactly documented anyplace, but if you
  109.    browse through the pull-down menus in File Manager, the functions of
  110.    the various menus items should become obvious.  We've carefully designed
  111.    them to run on almost *any* system.  If something does not work for you,
  112.    then its up to you to dig into the sample menu code and rectify any
  113.    imcompatibilities that may be occurring.
  114.  
  115.  
  116.    *** NORTON DESKTOP FOR WINDOWS ***
  117.  
  118.    This version also allows you to add the same menu items to the
  119.    Norton Desktop for Windows File Manager menu.  File Commander will
  120.    attempt to determine if there are any compatibility problems, and,
  121.    if so, will put up a message with further instructions, and then
  122.    exit.
  123.  
  124.    In some cases, especially with Non-English versions of NDW, there may
  125.    be serious undetectable incompatibility problems.
  126.  
  127.    To turn off the informational message OR to tell File Commander NOT
  128.    to run with the NDW File Manager, do the following:
  129.  
  130.        Edit the WINFILE.INI file  ((( NOT WIN.INI !!! )))
  131.  
  132.        Find the [FileCmdr] Section.  If it does not exist, make one.
  133.  
  134.        Insert a line containing "NDW=2"
  135.  
  136.        When you are done it should look something like...
  137.  
  138.                [FileCmdr]
  139.                NDW=2
  140.  
  141.  
  142.  
  143.  
  144.  
  145.    *** GENERAL INFORMATION ***
  146.  
  147.    File Commander is an extender for the Win 3.1 File Manager.  It allows
  148.    you to add upto four menu items to the File Manager menu bar.
  149.  
  150.    From each of these top-level menu items, File Commander allows you to
  151.    make up to 99 menu items spread up to 5 levels deep.
  152.  
  153.    The menu items, when selected, execute our Windows Interface Language (WIL)
  154.    code.  What is the WIL language?  Well, its the Windows batch file language
  155.    developed by Wilson WindowWare, and found in several products, including
  156.    the following:
  157.  
  158.      Wilson WindowWare:  Command Post     - As the menu script language
  159.      Wilson WindowWare:  WinBatch         - The Windows batch language
  160.      Graphical Dynamics: Clock Manager    - Scheduler script language
  161.  
  162.      >>> If you have used Command Post, you will find the menu scripts
  163.      >>> *remarkably* similiar. 
  164.  
  165.    The WIL language supports zillions (well maybe 350) different functions
  166.    that allow you to do pritnear anything.
  167.  
  168.    Be sure to check out our new WIL.HLP Windows help file.  It has a
  169.    complete description of the WIL language (Thats the programming language
  170.    found in our products).  It should prove useful.
  171.  
  172.    NOTE:  The documentation for the Windows File Manager Extender Interface
  173.    states that 5 top-level menus may be added to the File Manager menu.
  174.    However, due to what appears to be a bug in the Windows File Manager,
  175.    the fifth menu item does not work properly.  Any command selected from
  176.    the fifth menu item becomes confused with the adjacent "Windows" menu,
  177.    and the corresponding command from the "Windows" menu is executed instead.
  178.    All this is saying is don't use more than 4 new top-level menus with the
  179.    Windows File Manager.
  180.  
  181.  
  182.  
  183.    INSTALLATION NOTES
  184.  
  185.    File Manager Extenders are not EXE files.  They are DLL's.  When File
  186.    Manager starts up, it inspects the WINFILE.INI file for a special
  187.    [AddOns] section.  The [AddOns] section (when File Commander is 
  188.    installed) looks >something< like the following:
  189.  
  190.          [AddOns]
  191.          WWWFC1=C:\FILECMDR\WWWFC1.DLL
  192.          WWWFC2=C:\FILECMDR\WWWFC2.DLL
  193.          WWWFC3=C:\FILECMDR\WWWFC3.DLL
  194.          WWWFC4=C:\FILECMDR\WWWFC3.DLL
  195.  
  196.    You should only have 4 items TOTAL in the [Addons] section (due to the 
  197.    aforementioned bug). 
  198.  
  199.    The File Commander install process installs 4 DLL's to allow you to have
  200.    4 menu items.  There are a few other *much less capable* extenders
  201.    available from various sources.  Some of these are:
  202.  
  203.           a) Extenders that come with DOS or MS Mail.
  204.           b) The Windows Resource toolkit File Size extender.
  205.           c) An extender known as "Goodies"
  206.           d) Certain internal corporate extenders
  207.           e) And others likely to show up someplace or another.
  208.  
  209.    In any case, if you have another extender, you may have to pick and choose
  210.    the extenders that you keep.  In general, File Commander, with just a few
  211.    new menu scripts, can do *anything* and *everything* that any other
  212.    extender imaginable could possibly hope to do.  The only real reason to
  213.    keep any of the other extenders around is if your corporate MIS department
  214.    informs you that if you don't, you might get fired.
  215.  
  216.    So....the upkeep and maintenance of the [AddOns] section of the WINFILE.INI
  217.    is your responsibility.  You will have to decide what to keep and what goes.
  218.  
  219.    We do provide four extenders:
  220.  
  221.        WWWFC1.DLL
  222.        WWWFC2.DLL
  223.        WWWFC3.DLL
  224.        WWWFC4.DLL
  225.  
  226.    which our installation program will install.  Each one controls a menu
  227.    item.  The menu items will appear on your File Manager menu in the same
  228.    order that the menu items occur in the [AddOns] section.
  229.  
  230.    The installation process installs, and File Commander refers to an
  231.    additional, new section of the WINFILE.INI file -- The [FileCmdr] section.
  232.  
  233.    The [FileCmdr] section of the WINFILE.INI file contains the titles of the
  234.    top level menu items, and also contains the file names of the menu script
  235.    files.  You usually do not have to worry about these items, as our sample
  236.    menu scripts maintain this section.  However, in the interest of complete
  237.    documentation, the [FileCmdr] section as it appears immediately after File
  238.    Commander installation is shown below:
  239.  
  240.  
  241.        [FileCmdr]
  242.        MenuFile1=WWWFC1.MNU
  243.        MenuFile2=WWWFC2.MNU
  244.        MenuFile3=WWWFC3.MNU
  245.        MenuFile4=WWWFC4.MNU
  246.        MenuTitle1=&Main
  247.        MenuTitle2=&Applets
  248.        MenuTitle3=&Utils
  249.        MenuTitle4=&Demos
  250.  
  251.   The WWWFC1.DLL extender will refer to the MenuFile1 keyword to determine
  252.   which menu script file to use, and it will refer to the MenuTitle1 keyword
  253.   to determine the title of the desired menu item.
  254.  
  255.   Likewise, the WWWFC2.DLL extender will refer to MenuFile2 and MenuTitle2,
  256.   and so on.
  257.  
  258.  
  259.  
  260.    HOW-2-ADD YOUR OWN MENU ITEMS
  261.  
  262.    The Main menu item added to the File Manager menu has a selection to
  263.    assist you in editing menus.  All it really does is to run the Windows
  264.    Notepad editor on one of the four menu files, WWWFC1.MNU, WWWFC2.MNU,
  265.    WWWFC3.MNU or WWWFC4.MNU.
  266.  
  267.    In order to take full advantage of File Commander, you should read
  268.    through most of the documentation.  It will teach you about the WIL
  269.    script language in an easy step-by-step fashion (We've got stacks of
  270.    letters from non-programmers who said they were a tad scared about
  271.    tackling the WIL language, but once they went through our tutorial,
  272.    can write menu scrips with the best of them.  One guy even decided he
  273.    liked programming, took a few community college courses, and now has
  274.    a job programming for a living!)
  275.  
  276.    More experienced people, people who are familiar with DOS BAT files,
  277.    people familiar with DOS BASIC or other programming languages, and
  278.    the average unreconstructed hackers may simply wish to plunge in,
  279.    examine the sample menus and wing it.  Although we don't officially
  280.    recommend this kind of thing, it does happen.
  281.  
  282.    In any case, especially for those trying to "wing it", the menu script
  283.    files ares COLUMN SENSITIVE, especially in the first four columns
  284.    (character positions) which define the menu item titles.  WIL batch code
  285.    should start in column 5 or later (I like col 8).  The structure of a
  286.    menu file (this is the short form, see the docs for a real explanation);
  287.  
  288.                          111111111122222222223
  289.      Columns    123456789012345678901234567890... etc
  290.                 ; Semicolons are the comment symbol.  Everything to the
  291.                 ; right of a semi-colon is ignored.  At the top of the file
  292.                 ; is the "auto-exec" section which runs on File Manager
  293.                 ; startup, and whenever the extenders are reloaded.
  294.                 ; Note that the autoexec code starts in column 8 (way past
  295.                 ; column 5 so it does not get confused with menu items.
  296.                         TAB=Num2Char(9)        ; Define a TAB char for laters
  297.                         CR=strcat(Num2Char(13),Num2Char(10)) ; Define a CRLF
  298.                 ; That was our autoexec section.  It just defined a few
  299.                 ; special characters for later use.  Here is our first menu
  300.                 ; item...
  301.                 NOTEPAD
  302.                         Run("Notepad.exe","")      ;Run Notepad
  303.                 ; That was it.  The word NOTEPAD will appear on a menu and
  304.                 ; when selected it will execute the command that launches the
  305.                 ; Notepad editor.
  306.                 ; Now, lets have a drop-down menu that off of a menu item.
  307.                 ; (Menu items don't need to be all CAPS, it is just to make
  308.                 ; this example a tad clearer.
  309.                 ACCESSORIES
  310.                  CONTROL PANEL
  311.                         Run("Control.exe","")
  312.                  CALCULATOR
  313.                         Run("Calc.exe","")
  314.                 ; Note that the first level menu, ACCESSORIES started in
  315.                 ; column 1, and that the two drop down menu items off of it
  316.                 ; both started in column 2.  It is important to remember that
  317.                 ; the columns that the menu titles start in control what kind
  318.                 ; of menu item it is, and putting a menu item in the wrong
  319.                 ; column is the most common error in writing a menu.
  320.  
  321.  
  322.    When loading a new menu script, File Commander will report on lines in the
  323.    menu script file that it does not like.  In general it is always expecting
  324.    one kind of line or another, and if the current line does not meet up to
  325.    its expectations, it displays the line with an error message.  Quite often,
  326.    the actual error occurred on the previous line.  Almost all problems on
  327.    load have to do with improper indent in the menu titles.  In addition,
  328.    after an error, the remainder of the menu file is ignored.
  329.  
  330.    Each menu script file can only support upto 99 menu items.  It you have
  331.    more that 99 menu items, the ones past the 99th item will not appear, and,
  332.    if the 100th item occurs on some sub-level menu, can make its parent level
  333.    disappear too.
  334.  
  335.    THE WIL.HLP file
  336.  
  337.    The installation program should have installed an icon in the Program
  338.    Manager File Commander group which will bring up this file.  Or just
  339.    double click on it to make it run.  Its also accessable from our sample
  340.    menus.
  341.  
  342.    The first menu item you write might be to add a new menu item to access
  343.    the WIL.HLP file to one of your own menus.  Here's one way to do it.
  344.  
  345.        First, figure out where the WIL.HLP file is.  Lets assume that you
  346.        took the standard installation program defaults.  That would put
  347.        the WIL.HLP file into the C:\FILECMDR directory.  Verify this.
  348.  
  349.        Assuming you have File Commander running, select the "Main" menu item.
  350.        The first thing you will see in the drop-down menu that appears is the
  351.        "Edit File Commander Menus".  Select that option.
  352.  
  353.        Another drop down menu will appear which gives you a choice of editing
  354.        the menu scripts or changing the top-level menu titles.  Choose the
  355.        first selection, "Edit menu scripts".
  356.  
  357.        Choose the first selection, WWWFC1.MNU, to edit the first menu file.
  358.  
  359.        This will pop you into the Notepad editor, editing the WWWFC1.MNU
  360.        menu file.  Move to the bottom of the file and add the following
  361.        lines.  BE SURE THAT THE MENU TITLE STARTS AT THE FAR LEFT WITH NO
  362.        SPACES IN FRONT OF IT.  Adjust the DirChange command, if required,
  363.        to point to the directory containing the WIL.HLP file.
  364.  
  365.               ; This menu item brings up the WIL.HLP help file
  366.               Get WIL Help File
  367.                       DirChange("C:\FILECMDR")
  368.                       Run("winhelp.exe","wil.hlp")
  369.  
  370.        Close the note pad editor.  Look at your first menu.  Strange, the
  371.        new menu item is NOT there.  Select one of the menu items, say 
  372.        "Browse".  File Commander will look at the menu file, decide that it
  373.        was modified since the last time it was inspected, and proceed to
  374.        reload it.  Since there's no telling what might have changed in the
  375.        file, File Commander will tell you that the menu files were reloaded,
  376.        and that you should re-select the desired menu item.
  377.  
  378.        After a short delay while the reload occurs, look at the menu item 
  379.        again.  Lo and behold, it should be there on the bottom of the first
  380.        menu.  Select it.  WinHelp should load with the WIL language help.
  381.  
  382.        Good Luck.
  383.  
  384.  
  385.  
  386.  
  387.  
  388.   *** FOREIGN LANGUAGE SUPPORT ***
  389.  
  390.   File Commander now supports some foreign languages.  English is built in,
  391.   and the software attempts to examine your system, and, if you are using
  392.   German or French, will configure itself to use German or French.  More
  393.   languages on the way.  There is also "ValSpeak", which is both a parody
  394.   on Southern California slang, and an example of how *some* messages may
  395.   be modified for the end users.
  396.  
  397.   If you are using Windows 3.1, File Commander will attempt to determine
  398.   what language Windows you are running and automatically configure itself
  399.   to use that language.
  400.  
  401.   To access a non-default langauage, choose the "Main" menu, and then
  402.   the "Modify File Commander" submenu, and then the "Language for error
  403.   messages" menu item.  It will bring up a dialog box allowing you to
  404.   choose a supported language.   This menu item will only affect the
  405.   internal WIL engine language.  It is still up to you to write or
  406.   translate File Commander menu items as you see fit.
  407.  
  408.   To add a whole new lanugage to the WIL engine, examine the WWWDLANG.*
  409.   files, especially  the WWWDLANG.ENU file.  By translating this file to
  410.   the language you your choice, you can make the WIL engine run in any
  411.   language.
  412.  
  413.  
  414.  
  415.  
  416.  
  417.   Please see the README2.TXT file for more information
  418.