home *** CD-ROM | disk | FTP | other *** search
/ Fun & Games 1 / FUNGAMES1.cdr / wind / fm / fm.doc < prev    next >
Text File  |  1993-02-23  |  37KB  |  749 lines
  1.                                 File Magician
  2.                                     V2.0
  3.                              Copyright 1993-1994
  4.                               by Terry Bullard
  5.                                for Windows 3.1
  6.  
  7.  
  8.  
  9.     Welcome to File Magician version 2.0!!  For those of you who viewed v1.0
  10.   will see there has been tons of additions added to the program, 90K of.exe
  11.  worth!  File Magician is a type of program with unlimited growth potential.
  12.  As I stated before, my main goal in this and all programs is to make them as
  13.  user friendly and fast as possible.  I've added a new goal for File Magician,
  14.  to put it bluntly, File Magician will (if it hasn't already) totally waste
  15.  all current File Management and Archive Management programs available for the
  16.  PC.  This program will not stop here as many programs do, it will continue to
  17.  be an on going part of my life and yours.
  18.  
  19.     There is a couple of questions I have received which probably should be
  20.  discussed, first..
  21.  
  22.   Is Trust Mail for Real?
  23.     You bet!   I'm from a small town where most people trust each other, so why
  24.     shouldn't I trust you!   I'm sure I'll get burnt but perhaps they need it
  25.     more then I do.   I have received some bad comments on it from other groups
  26.     in starting something new, but I do have confidence it will work!
  27.  
  28.   Can I make Payments?
  29.     Yes!   Forty dollars at times is a lot of money to come up with!  For the
  30.     last four years I have gone through seven doctors and have literally ran
  31.     up tens of thousands of dollars worth of uninsured medical bills that I'm
  32.     still trying to pay on and at times ten dollars is hard to find!  The
  33.     funny part is that it finally became established a few weeks ago
  34.     that my problem is an over active mind.  Anyone have a valium?  grin.
  35.     So I can relate to making payments.  When you call to order, tell us what
  36.     you can handle at that time and you need not supply a reason as to why.
  37.  
  38.  
  39.  
  40.     I should also get this out of the way too.  There are a few things you
  41.     can do that would help tremendously.
  42.  
  43.        Success of any good program depends upon distribution!  We need you to
  44.        help do that.  Please give a copy of this evaluation program to any
  45.        one you know, or upload it to any BBS you call.
  46.  
  47.        Register Now! - Not only will this allow me to devote more time to the
  48.        program but will also help me catch up on some past due items!
  49.  
  50.        If you don't like the program..  Call me and tell me why.  At my age I
  51.        have learned  only fools never listen to what other people have to
  52.        say.
  53.  
  54.  
  55.  
  56.  NOW  I have gotten that off my chest its time to talk about File Magician!
  57.  
  58.  
  59.  What I'm going to do is to insert a lot of the old docs and COMMENT: the
  60.  different changes that have been made.  After that a NEW ADDITIONS: section.
  61.  Also bare with me on this, documentation is a definite short coming for me!
  62.  
  63.  
  64.  
  65. Description  (old)
  66. ~~~~~~~~~~~
  67.    Well, enough said on that subject!  Now to tell a little about File Magician.
  68.  File Magician has a similar interface like Disk Master v1.4 for the amiga, if
  69.  you own an amiga and don't have Disk Master, get it , it is a must have.
  70.  File Magician has two view windows, one is always the 'Source Window' and one
  71.  is always the 'Destination' window. Source and Destination can be swapped by
  72.  clicking the LMB in the window or in the path bar above the window.  The
  73.  clicked area will then become the 'Source' window.  The 'Source' window will
  74.  have a red box around it plus the little toggle bar between the windows at the
  75.  top of the screen will also point to it.  In the center of the screen between
  76.  the two windows will be a column of push buttons. The first six buttons are
  77.  for your drive configuations.  The program will automatically configure to
  78.  your current devices. The following buttons will perform the different
  79.  functions as is explained below.  Let me add at this point that File Magician
  80.  is a shareware program and that it is for evaluation only.  Somewhere there
  81.  had to be a stopping point with File Magician as an evaluation program.
  82.  File Magician can only grow from this point.  I have over 50 planned functions
  83.  that File Magician will have as time goes on, not counting new ideas that will
  84.  be generated by time and user input. Basically File Magician has unlimited
  85.  growth potential!  User registration increases that potential many times over.
  86.  
  87.  Comment: 50 planned additions might very well be an understatement now. I'm
  88.   starting to see many more than a mere 50, not counting what I've already
  89.   added.
  90.  
  91.  
  92. So Just What Is File Magician?
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94.     File Magician is a program that EVERY PC owner must have.  If you own a
  95.  computer, sometime during your computer lifetime you will Have To make
  96.  some type of file or directory adjustment to your hard drive or floppy disks.
  97.  File Magician is designed to be as simplistic as possible in allowing you to
  98.  manage your files and directories.  File Magician is for all levels of users,
  99.  beginning to advanced.
  100.  
  101. Requirements
  102. ~~~~~~~~~~~
  103.     A computer
  104.     Windows 3.1
  105.     Be Registered
  106.  
  107.  
  108. How To Register
  109. ~~~~~~~~~~~~~~~
  110.     There are a couple of ways to register 'File Magician'.  First you can send
  111.  a check or money order for $40.00 US Funds to:
  112.  
  113.     Terry Bullard
  114.     Bullard Software
  115.     3291 Mt. View Rd.
  116.     Ferndale, Wa.   98248
  117.  
  118.  OR
  119.      by Trust Mail.
  120.  
  121. Trust Mail
  122. ~~~~~~~~~~
  123.     Trust Mail is a term that I invented.  Most places insist you
  124.  send  money first and then they will send you your requested items.  You trust
  125.  them to do this after you have parted with your money.  With trust mail, we
  126.  will send you our software first and when you receive it, we will trust that
  127.  you will send us back a check or money order for it.  All you need do is to
  128.  pick up your phone and dial the number supplied below and then register.
  129.  Don't be surprised if you get just a "Hello" instead of "Hello this is Bullard
  130.  Software".  I have a really hard time being so formal!  After you register
  131.  we will within 24 hours have 'File Magician' on its way to you, first class
  132.  and postage paid by us.  As our company grows with your support we will add
  133.  additional lines for ordering and support.  For now you can order between
  134.  4:00 P.M. and 9:00 P.M. Pacific Standard Time.  Keep in mind that there is
  135.  three hours difference between here and the east coast.
  136.     Also  I must keep Trust Mail limited to the USA and Canada.  Don't get
  137.  me wrong for those that don't live there, I must see how this works out first.
  138.  I do hope you understand.
  139.  
  140.     CALL NOW:     1-(206)-384-6740
  141.  
  142.    Now I also have a BBS that you can register through.  A local fellow has
  143.  agreed to open a special conference just for this.  He also has Amiga and IBM
  144.  files online.  The BBS is a free bbs but does have ratios.  It supports baud
  145.  rates from 1200 to 19200 and open 24 hours.  The Number is 1-(206)-384-2591.
  146.  You can get online help there or leave any bug reports.
  147.  
  148.  
  149. What You Get
  150. ~~~~~~~~~~~~
  151.     Once you register, we will send you 'File Magician' without the dialog boxes
  152.  that appear when any item is first clicked.  The program will be the lastest
  153.  update of File Magician.  The first manual will be soft bound.  With the
  154.  planned growth of File Magician it is not feasible to have any other type
  155.  of manual.  The cost of re-printing such would be terribly expensive
  156.  and it would be unfair to pass this unneccessary cost on to you.. 
  157.  You will be placed on our mailing list and will be notified immediately
  158.  by mail of future updates of File Magician and any new products we develop.
  159.  The software package will be sent postage paid by Bullard Software.
  160.  
  161.  Comment: Also registered owners who have paid in full will receive the
  162.   first update free, postage paid.  If you are on a payment plan,
  163.   before you receive a free update you must be paid in full.
  164.  
  165.  
  166. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  167. NEW:
  168.  
  169.    First and Most important before running File Magician!
  170.      For Best results..
  171.        1.  Double Click on Window's pif editor.
  172.        2.  Select 'Open' from the File Menu.
  173.        3.  Select _default.pif from the selection box, then press 'OK'.
  174.        4.  Locate 'Windowed' button and select to ON.  This is a radio button
  175.            and if a dot appears in the middle of the circle it is then on.
  176.        5.  Locate 'Close Window On Exit' button and select to ON.  This
  177.            is an X type button and an 'X' in the square is on.
  178.        6.  Now from the File Menu select 'Save As'.
  179.        7.  The filename and path "C:\Windows\_default.pif" should be hi-lited
  180.            in the file name box, if so, press 'OK', if not enter in your
  181.            windows path adding the _default.pif filename and click 'OK'
  182.        8.  A Dialog box will appear and inform you the  file already
  183.            exists and ask you if you wish to 'Replace existing file?'. Select
  184.            'Yes'
  185.  
  186.    Doing this is the only windows adjustment that you must make.  You may then
  187.    decide where you wish place File Magician and what icon you may want it to
  188.    have.
  189.  
  190.  
  191.    NEXT Important thing..  File Magician's Configuration..
  192.  
  193.       Nothing to it really but it might seem a bit complicated at first.  V1.0
  194.  had a seperate configuration program, it was scrapped in favor of using
  195.  multiple dialog boxes and just to avoid confusion.
  196.  
  197.    The configuration is done within the program during runtime.  When the
  198.  configuration is saved, a file called Magic.dat is created which contains your
  199.  configuration in binary form.  This can be changed at anytime and resaved.
  200.  Included in the archive should be a sample of the configuration that I use,
  201.  examine it if you wish and change it to suit your needs.  When the program
  202.  first boots up it will search for the Magic.dat file, once finding it, it will
  203.  then load the settings.  If the file is not available a requester will inform
  204.  you of such and switch automatically to a default settings mode.
  205.  
  206.    Next click on the 'Config' button, a rather large dialog box should appear.
  207.  The three boxes to the left of the dialog contain configurations for Pkzip,
  208.  Pkunzip, Lharc, and Arj.  To use these compression programs you must have the
  209.  compression programs located in your path stream, such as c:\dos etc.
  210.  change the default settings you must first have a working knowledge of these
  211.  fine programs or accept my usage of them.  No attempt to explain their usage
  212.  is located within the program.  By clicking on the button with the programs
  213.  name it will open another dialog box where you may change the current settings
  214.  you desire.  The Dlbck button in each box tells File Magician to
  215.  decompress a file when it is double clicked. (see below on double clicking)
  216.  
  217.    The next box to the right labeled 'Warn' tells the program to warn you if
  218.  you are about to 'Copy', 'Delete', or 'Move' Files, if these boxes are not
  219.  checked then the operation will commence without giving you the choice of
  220.  backing out.
  221.  
  222.    The Next box to the right called 'Paths' is, for this release, a temporary
  223.  working directory for the program.  Here File Magician will sometimes write
  224.  necessary files for its operation when handling dos assignments.  The program
  225.  will clean up after itself with the exception of two files it re-uses
  226.  at times.  This directory will not grow, nor is there a real need to worry
  227.  about it. BUT it must be there for the program to function properly!!!
  228.  
  229.    The final box for this release is called 'Names'.  The top 4 entries are
  230.  for Pkzip, Pkunzip, Lha, and Arj.  If by some chance you call these programs
  231.  by a different name you may enter your name to the right of the original
  232.  programs name.  The next choice down is 'Read'.  There are many fine file
  233.  reading programs available and the one I supply hasn't had enough time to
  234.  be developed to a full potential, so if you wish to supply a different file
  235.  reading program, enter in the programs name in the right box.  The other
  236.  program must be in the path stream or located in the same directory as
  237.  File Magician.  The following five boxes are left blank.  For now these boxes
  238.  can be used as CMDs and follow the same rules for Cmds, a bit further down
  239.  will explain Cmds.
  240.  
  241.    Attributes - Pressing this button will display a configuration box that
  242.  will allow you to chose what files with what attributes you would like
  243.  File Magician to display for your use.  The 'Help' button will give you a
  244.  very brief description of what each attribute is. 'OK' will allow the changes
  245.  to be saved in the configuration save option.
  246.  
  247.  CMDS
  248. ~~~~~
  249.  
  250.    CMDS - Short for Commands.  File Magician allows you to run other programs,
  251.  either dos or windows, ones that operate on files or are stand alone. There
  252.  are 10 Command Button Cmds and 10 Menu Command Cmds. After you press the 'Cmd'
  253.  button you will see 4 columns of string boxes. The first two columns are for
  254.  buttons on the command screen and the second two columns are for the menus.
  255.  The first row for either set, labeled 'Prg. Name' is the name of the program
  256.  you wish to use and it will be the name that will appear in the button
  257.  box or menu box.  The .exe extension is not necessary.  The second column in
  258.  either section labeled 'Argument' is the Path of the program, if it isn't in
  259.  the path stream or the program argument that is needed to make the program
  260.  run.  Most argument type programs work on files and/or have optional settings,
  261.  needed to run the program.  So in the second column you supply the needed
  262.  settings/arguments and if part of those setting require a file name you would
  263.  add '%s' without the quotes.  This tells File Magician to substitute the %s
  264.  with the file that has been selected in the active window.
  265.       Again:   %s  =  File selected in active window.
  266.       Example  Pkunzip (1st col.)  -d -$ %s a:\ (2nd col.)
  267.  You would click on a .zip and then click the Pkunzip (example name). Pkunzip
  268.  would then decompress the selected .zip file to drive a:
  269.     Now for a program you like that isn't located in your path stream.
  270.  We'll use WFinder.exe as a example
  271.       WFinder (1st col.)  Path c:\utils\ (2nd col.)
  272.  Path tells the program that it is a path file not a argument file.
  273.  
  274.      You may run nearly any type of program using cmds.  The power this
  275.  configuration set gives you can be pretty awesome indeed!!
  276.      Clicking the default button will preset everything back to my orginal
  277.  settings. Clicking save will save all the adjustments that you have made to
  278.  Magic.dat which will reside in the same directory as where you placed File
  279.  Magician, so if you move File Magician, be sure to move the Magic.dat file
  280.  as well.
  281.  
  282.  
  283.   FINALLY...
  284.     Now that you have configured File Magician you can put it to work.  The
  285.  program has all the Copy, Move, and Delete functions of multiple files and
  286.  directories (explained below) as a lot of the rest of the management programs
  287.  but also has some other goodies.
  288.  
  289.    I should insert here about selecting file(s).  File Magician has the ablility
  290.  to select (tag) any amount of files at one time.  You need not select all or
  291.  only one as I've seen a  lot of programs do.  For those that wonder, I
  292.  do NOT use the Windows List Box procedure.  It is a good idea and everyone
  293.  uses it but I find it too limiting and to tell the truth a bit ugly.  So
  294.  everything is handled internally with a big glob of extra coding by me.
  295.  Yes I know that list boxes can select multible files but like I said I just
  296.  don't like it.
  297.  
  298.  
  299.  
  300.  
  301.   Compression:
  302.  
  303.      There are several ways to decompress .zip, .lha, arj files.
  304.  
  305.  1.  The File menu.  First click on the file to decompress then go to the
  306.      menu method and choose 'Extract'.  If you only have a source window
  307.      active the program will assume you wish to extract to the same directory
  308.      as the source window indicates.  A dialog box will appear asking you to
  309.      'Enter destination path', if you wish to extract there choose 'OK'. If
  310.      you wish to extract to a different directory or drive, enter that path
  311.      and choose ok.  Or you may cancel the operation if you wish.
  312.      Now if you have a destination window operational the program will assume
  313.      that you wish to extract to that directory. If not you may follow the
  314.      same procedure above.
  315.  
  316.  2.  Double clicking.  Provided that you have set your configuration section
  317.      to double clicking you can use this method.  Double clicking does not
  318.      give you a choice to cancel, it is for fast and dirty work.  If you do
  319.      not have a destination window operational the program will extract to
  320.      the source window.  If the destination window is visible the program will
  321.      automatically extract to destination window.
  322.      This method works for all .zip, .arj, .lha files!  File Magician can
  323.      determine what type of file it is dealing with by binary means, extensions
  324.      mean absolutely nothing and when a program deals with extensions, in my
  325.      opinion, is a pretty stupid program.
  326.      For .exe compression files, the file will only decompress in the source
  327.      window area for now. This will be explored later.
  328.      See double clicking below for additional abilities.
  329.  
  330.  3.  The Archive Commander...  see below..
  331.  
  332.  
  333.  
  334.  Archive Commander!
  335.     For now the commander deals with .zip files only, later releases will
  336.   have additional functions and possibly other compression types.
  337.   With the commander you can select up to 30 .zip file for enhanced
  338.   handling.  The program will do the counting for you so don't worry about
  339.   being exact.  Select the files you wish to work on and then either
  340.   from the menu select 'Archive Commander' or click the push button
  341.   'Command'.   You will then be presented with a whole new screen.
  342.   The two view windows, one called 'Archived Files', which is the big one
  343.   on the left, and the other called 'Selected Archives', which is the
  344.   smaller one in the center, to the right there will be nine buttons.  In the
  345.   Selected Archives window there will appear the .zip files you have previously
  346.   selected, you may work on only one at a time for now (what I have planned
  347.   is totally awesome but damned if I want to give the idea to someone else
  348.   right now!).  Select a file and click the 'Process' button or just
  349.   double click the .zip, same thing, things will hum for a bit and the files
  350.   that are within the archive will be displayed in the left view window.
  351.   Here you may extract, read, delete any of the files by first selecting
  352.   them and then choosing the operation button.  If you wish to read or
  353.   run a archive file just double click on it, the program determines
  354.   the type through a binary method and works accordingly.
  355.      To extract a file(s) first pay attention to the 'Destination' button.
  356.   This button indicates below the button column as to where the extracted
  357.   files will be sent.  The options are ..
  358.  
  359.      'Destination Window' - The destination path of the main command screen.
  360.      'Source Window'      - The Source path of the main command screen.
  361.      'Your Specification' - Here a Dialog box will appear and allow you
  362.                             to type in the path of where you wish the extracted
  363.                             file to be sent to.
  364.  
  365.   Now Select the File(s) and push the extract button.  The selected files will
  366.   be sent to where you have set the Destination to be.
  367.  
  368.    The Commanders buttons:
  369.       Process - Displays the selected .zip file's contents to the left window.
  370.                 same as double clicking the .zip file
  371.       Extract - Explained above. Extract one or more of the contents of an
  372.                 archive.
  373.       Delete  - Deletes one or more of the archives contents.  Just select
  374.                 which files you wish to delete and push this button.
  375.       Run     - Select a file to run in the left window then push this button.
  376.                 If the file is a stand alone program it should function
  377.                 correctly.  Double clicking the file will also run it or read
  378.                 it, if it is a .exe or any type of text file.  Extensions DO NOT
  379.                 apply.
  380.       Test    - This Calls Pkunzip to test the archive and the File Magician's
  381.                 'Reporter' displays the results.
  382.       All     - Selects all the files in the 'Archive Files' Section.
  383.       Clear   - De-selects any selected file in the 'Archive Files' Section.
  384.       Destination - Changes the extraction destination path to either the
  385.                 previously set 'Source Path', or 'Destination Path' from the
  386.                 main command screen.  OR  Allows you to specify a different
  387.                 path where extracted files should be sent.
  388.  
  389.  
  390.  
  391.   Double-Clicking
  392. ~~~~~~~~~~~~~~~~~
  393.      File Magician does NOT use the extension method to determine filetypes.
  394.  The program will read a binary header from the file and determine what type
  395.  of file it is dealing with.  Currently File Magician understands .exe, .lha,
  396.  .zip, .arj and text files.  Much time WILL be spent in expanding the different
  397.  filetypes for future updates.  This will be one of the many major strengths
  398.  File magician will have.  Currently you can double click a text file to
  399.  read it, an .exe file to launch it and de-compress archived files, as explained
  400.  above.
  401.  
  402.  
  403.  
  404.   Path Bars
  405. ~~~~~~~~~~~
  406.      The path bar, which is located above each view window, shows the complete
  407.  directory/device path to the current directory  the view window is
  408.  displaying.  With version 2.00 you can revalidate the file listing for that
  409.  window just by clicking somewhere in the path bar.  This is a lot better then
  410.  hitting f2 or f3, which btw are still active for this function.
  411.  
  412.   Split
  413. ~~~~~~~
  414.      The Split function will split any selected file into two equal parts
  415.  without harming the orginal file.  Split will use the first four letters
  416.  of the filename (or less if the file has less) and create two equal halfs
  417.  with the _D1 _D2 tacked on. If the file is a odd byte size the second half
  418.  will be 1 byte larger then the first.  Files may be text to binary format.
  419.  
  420.   Duplicate
  421. ~~~~~~~~~~~
  422.      The Duplicate functions will duplicate a file in the same directory as
  423.  the selected file.  It too will take the first four letter and tack on a
  424.  _Dup to the end. The file can then be renamed to something else.  This
  425.  command works on files only.  I have thought about duplicating entire
  426.  directories and files but before I do that I would like to hear some
  427.  feed back on it if there is a need.
  428.  
  429.  
  430.   Menus
  431. ~~~~~~~
  432.      Menus are new in this version of File Magician.  In my opinion menus are
  433.  nice only when you run out of room for push buttons!  grin.  With 38 push
  434.  buttons on the main command screen and a ton more stuff to add, menus became
  435.  necessary.
  436.  
  437. ***  Compression Menu  ***
  438.  
  439.  
  440.                   _ Create  Archive
  441.                  /_ Extract Archive
  442.          Pkzip--/__ Pkzip   Settings
  443.                 \__ PkUnzip Settings
  444.  
  445.  
  446.         Create Archive   - Select the files in a source window you wish
  447.                            to compress as one archive.  Select this option from
  448.                            the menu.  You will then be asked to supply an archive
  449.                            name and supply a path for the archive to be created
  450.                            in if you do not like the default path.  The default
  451.                            path will be the destination window if it is
  452.                            operational or the source if it isn't.  You may
  453.                            specify whatever path to whatever device you wish.
  454.                            Selecting 'OK' will start the process.
  455.  
  456.         Extract Archive  - Select the file to decompress and then select this
  457.                            option.  A Dialog box will appear and ask you to
  458.                            enter the destination path.  Default paths are the
  459.                            same as above.
  460.         Pkzip   Settings - If you wish to alter the current configuration
  461.                            settings for Pkzip you may select this option to do
  462.                            so.  Altering the settings at the menu DOES NOT save
  463.                            to the configuration file.  The settings will be
  464.                            active for the current session only.
  465.         PkUnzip Settings - The same rules apply here as for Pkzip
  466.  
  467.  
  468.  
  469.                __ Creat   Archive
  470.          Arj--/__ Extract Archive
  471.               \__ Arj     Settings
  472.  
  473.  
  474.                __ Creat   Archive
  475.          Lha--/__ Extract Archive
  476.               \__ Lha     Settings
  477.  
  478.  
  479.     For Arj and Lha, the same procedure applies to them as it does Pkzip
  480.  
  481.  
  482. ***   CMD's   ***
  483.  
  484.     See CMDs and The Configuration Section.   Once the Cmd configuration for
  485.  the menu section is setup and the configuration file is saved, File Magician
  486.  will automatically rename the menu items to your specification.
  487.  
  488.  
  489. ***  Extras  ***
  490.  
  491.      Drive status - will access the device that are current to both the Source
  492.                     and Destination window and display in the Title bar of the
  493.                     main screen the number of bytes that the disk has free.
  494.                     This function use to be automatic, using a timer function
  495.                     but the timer it seems would always go off at the wrong
  496.                     time and access the drives, therefore slowing down whatever
  497.                     I was trying to accomplish at the time. So the function was
  498.                     stuck in a menu called extras. Extras will fill up as time
  499.                     and demand goes on.  Now the only time a byte free function
  500.                     is called is when it is currently accessing the drive for
  501.                     some given reason.
  502.  
  503.  
  504.  
  505.   Command Buttons
  506. ~~~~~~~~~~~~~~~~~
  507.      All of the command buttons on the main view screen are pretty much
  508.  described below, not counting the CMD buttons.  Also there are seven buttons
  509.  that are unaccounted for, so to speak.  The first one is in the last position
  510.  of the first column of buttons.  Currently it has no function attached to it
  511.  with this release.  The other six  are located in the right column starting
  512.  with the fourth button from the top.  The First of the six is also blank
  513.  with nothing attached to it.  The next five down have been temporary assigned
  514.  as CMDs as explained above.  The reason for this is future expansion and
  515.  screen layout.  The last five buttons that are assigned as CMDs will be
  516.  assigned to something else unless public feedback demands that they stay as
  517.  they are.  If so I'll figure something to attach the assignments too.
  518.  
  519.  With version 1.0 there was only 1 column of buttons with the first 6 buttons
  520.  assigned to drive specifications.  Now the drive specifications are assigned
  521.  to the first 3 buttons of each column.
  522.  
  523.  
  524.  
  525.  
  526. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  527.  
  528.  
  529. Now the Grit  (old)
  530. ~~~~~~~~~~~~
  531.     Now if you haven't already loaded File Magician you are one of a
  532.  few.  Who reads the docs anyhow?  (g)  I'll try and keep it as brief as
  533.  possible, but please read below on "what you can do for us".
  534.  
  535. View Windows
  536. ~~~~~~~~~~~~
  537.     File Magician has two view windows.  One is the 'Source' and one is the
  538.  'Destination'.  The source window will always be the one with the red box
  539.  around it.  The Source and the Destination window can be swapped. To activate
  540.  a 'Source' window, click in the window itself or click in the path bar above
  541.  the window.  Once a 'Source' window is established the opposite window
  542.  automatically defaults to the 'Destination' window.    Often a directory will
  543.  have more file and directory listings then the view window can display.  Use
  544.  the scroll gadget to the right of the window to view the additional listings.
  545.  The bottom scroll gadget is inactive with this release but it is there for
  546.  future compatability.
  547.  
  548. Selection
  549. ~~~~~~~~~~
  550.     The left mouse button (LMB) is used to select a file or directory. Clicking
  551.  once will select the listing and the listing will be highlighted.  Double clicking
  552.  a directory will instruct the program to enter and display to the view window
  553.  that directory listing.  Double clicking a file listing causes No Action with
  554.  this release of File Magician.  The next release of File Magician will contain a
  555.  a smart mode file selection.  Smart Mode will be one of the main arteries of
  556.  File Magician!
  557.     When a file or directory is selected it means that the next command action
  558.  will be taken on all files and directories selected.  Changing to a different
  559.  directory will de-select automatically all of the previous selections.
  560.     No action will be taken on any file or directory that has Not been selected.
  561.  
  562. Title Bar
  563. ~~~~~~~~~~
  564.     The title bar is used as an action display.  There the program will show you
  565.  the current action that is taking place such as, copying, deleting, or moving
  566.  listings, bytes free on destination and source windows, files selected and
  567.  total bytes of selected files.  Currently there is a 5 second timer after a
  568.  title information display before it defaults back to a byte free display. This
  569.  may change to something else, what I'm not sure yet.
  570.  
  571. Keyboard:
  572. ~~~~~~~~~
  573.    F1   -  F1 activates "help mode".  When you active help mode you may then
  574.            click with the LMB on any item that you need help on.  A brief
  575.            help message will appear in the left view window.  Help mode will
  576.            then deactivate itself.  If you require more help you must press
  577.            F1 again.  To reset the left view window back to the file listings
  578.            press F2.  This method of help is designed for a 800x600 display.
  579.  
  580.          Comment: Help messages are now displayed in Dialog boxes.  It was
  581.          more efficent this way to span all display modes.
  582.  
  583.  
  584.    F2   -  F2 will re-display the file and directory listings on the left view
  585.            window.  This sometimes becomes necessary when de-compressing files
  586.            or using the help mode feature.
  587.  
  588.    F3   -  F3 will re-display the file and directory listings on the right view
  589.            window.
  590.  
  591.    ESC  -  Will exit the program.
  592.  
  593.  
  594. Buttons:
  595. **********
  596.  
  597.  Drive Buttons:
  598. ~~~~~~~~~~~~~~~
  599.     The first six buttons from the top of the screen are reserved for your
  600.  drive devices.  The program will automatically configure to the first six
  601.  drive names in the list.  Clicking the LMB on one of these will display the
  602.  root contents to the window that is active.  The view window will display
  603.  yellow text as directories and white text as file.  To enter a directory
  604.  double click the name of the directory.
  605.  
  606.  COMMENT: Reassignment of the top six buttons is now the top three buttons of
  607.           both columns.
  608.  
  609.  
  610. Parent:
  611. ~~~~~~~
  612.     The 'Parent' button will direct the program to reassign the current
  613.  directory back one directory.  For instance, when you double click a directory
  614.  name the program will display the contents of that directory to the view
  615.  window, when you click the parent window, the program will re-display the
  616.  previous directory.  This command is completely harmless.  The parent button
  617.  only works on the 'Source' window.
  618.  
  619. All:
  620. ~~~~
  621.     The 'All' command will select all the files and all the directories that
  622.  are in the current directory of the 'Source' view window.  If a directory has
  623.  more files and directories then the view can be displayed, those files and
  624.  directories will also be selected.
  625.  
  626. Clear:
  627. ~~~~~~
  628.     'Clear' will de-select any file or directory that has been previously
  629.  selected.  All files and directories outside of the view window will also be
  630.  de-selected.
  631.  
  632. Copy:
  633. ~~~~~
  634.     To use the copy function, first select a view window  you wish to
  635.  become the Destination point.  Next go to the opposite window and select the
  636.  files or directories  you wish to copy.  Press the 'Copy' button.  Thats
  637.  it.
  638.     Copy, will copy all files or directories that have been selected to the
  639.  Destination device (view window).  If a directory has been tagged, the
  640.  program will create and copy all files and directories within the selected
  641.  directory to the Destination point.  This release Does Not have an option to
  642.  check first to see if there is enough room in the destination area.  The next
  643.  registered release will.  You may use the 'Byte Req' button on the Source
  644.  directory before copying.
  645.  
  646. Rename:
  647. ~~~~~~~
  648.     To rename a file or directory first select the item then press the 'Rename'
  649.  button.  A dialog box will appear.  Enter in the new name excluding the full
  650.  path, the program keeps track of the location of the listings internally so
  651.  just the new name will be enough.  Select OK.
  652.  
  653. Move:
  654. ~~~~~
  655.     The move function will move all files and directories that have been
  656.  selected to the location of the destination area.  Moving a selected listing
  657.  means that basically the file is copied to destination area and then deleted
  658.  from the source area.  So once a listing is moved it will no longer reside
  659.  in the source area!  If a directory is selected, all files and directories
  660.  that are buried within that selected directory will also be moved.
  661.  
  662. Delete:
  663. ~~~~~~~
  664.    The 'Delete' button will delete all selected files and directories that have
  665.  been selected from the 'Source' window.  All files and directories that are
  666.  buried within a selected directory will Also be deleted.  With this version
  667.  of File Magician, when the 'Delete' is first invoked, a dialog box will appear
  668.  giving you the option of aborting.  A later version of the program will allow
  669.  you to discontinue this option.
  670.  
  671. Read:
  672. ~~~~~
  673.     The 'Read' function is a seperate program  File Magician calls to read
  674.  a text file.  The reason  I have done this is for future expandability!
  675.  I can think of a zillion different things  a read program should do and
  676.  I'm sure  you can too.  So for ease of development I'm doing it this way.
  677.  Currently the read function is set to read text files only.  It will read
  678.  anything, but only text files will display properly.  The file size of the text
  679.  file is not important, there is not a byte limitation.  There are three button
  680.  controls 'PageUp', 'PageDown', and 'Quit', also several keyboard controls are
  681.  present.
  682.     F1        = a brief help screen
  683.     PageUp    = up a screen page
  684.     U         = same
  685.     PageDown  = down a screen page
  686.     Space     = same
  687.     Enter     = same
  688.     D         = same
  689.     ESC       = exit read function
  690.     Q         = same
  691.  For best results read only one file at a time.  Multiple selections are
  692. possible but uses a lot of extra memory and it starts multiple instances of the
  693. read program.  Possibly in future versions I might be able to make Windows be
  694. a bit more behaved.
  695.  
  696. Comment: Read the configuration setting above for a alternate reader.
  697.  
  698.  
  699. Byte Req.:
  700. ~~~~~~~~~~
  701.     This function will total the bytes of all selected listings.  If a
  702.  directory is selected, all the bytes of all the files  buried within
  703.  that selected directory will be totaled and displayed on the title bar at
  704.  the top of the screen.  This function is very handy to use before moving
  705.  or copying files to another device and just to know how large a directory might
  706.  be.
  707.  
  708. MakeDir:
  709. ~~~~~~~~
  710.     'MakeDir' will create a directory in the location that the 'Source'
  711.  window is displaying.  Push the 'MakeDir' button, a dialog box will appear.
  712.  Enter in the name of the new directory  you wish to create.  Press 'OK'
  713.  
  714.  
  715. Run:
  716. ~~~~
  717.    The 'Run' function will attempt to start any program that has been selected.
  718.  'Run' works on: .pif , .bat, .exe (dos or windows), .com (dos or windows),
  719.  files.   A little care must be used when using this command, it is not harmful
  720.  but currently it has no way of checking to see how much memory an external
  721.  application will use.  Good judgement and a knowledge of how much memory your
  722.  computer has and how fast your computer is makes a big difference with
  723.  the results of this function.  Personally I haven't had too much trouble
  724.  using a 486(25) with 4 megs of memory and I was actually surprised on just
  725.  what it would handle.
  726.  
  727.  
  728.  
  729.  
  730.    Jeez I hope I didn't miss anything (probably did but it should be easy to
  731.    figure out, after all that is the idea!)
  732.  
  733.    Current source size is 645,878  bytes.  So I'm sure I forgot something.
  734.                                     GRIN
  735.  
  736.  
  737.  
  738. Note:
  739.    If you have read down this far be damn sure to call now and order!!!!
  740.  
  741.        Terry Bullard
  742.        Bullard Software
  743.        3291 Mt. View Rd.
  744.        Ferndale, wa. 98248
  745.         (206)-384-6740  between (5:00 P.M. to 9:00 PM PST)
  746.         (206)-384-2591  BBS  24 hours   1200 - 19200 baud   8N1  v42bis
  747.  
  748.  
  749.