home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / fmas_030.zip / FMASTER2.DOC < prev    next >
Text File  |  1996-02-25  |  38KB  |  1,233 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                  File Master/2
  14.  
  15.                                  Version 0.30
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                A file-area manager for LoraBBS-OS/2 version 2.4x
  24.  
  25.  
  26.                                  Release date:
  27.                                February 25, 1996
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.               Copyright 1995,1996 by Alexander Erne / EAgle Soft
  47.                               All rights reserved
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                           File Master/2 version 0.30
  59.  
  60.  
  61.                                      Index
  62.  
  63.        Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  64.        Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  65.        Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  66.          LoraConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  67.          DefaultColor . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  68.          BarColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  69.          PopupColor . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  70.          NoDesc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  71.          ZIP  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  72.          unZIP  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  73.          UseInfoZIP . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  74.          ARJ  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  75.          RAR  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  76.          LZH  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  77.          ArchiveShell . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  78.          JPG-View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  79.          GIF-View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  80.          MaxLevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  81.          AllFilesList . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  82.          NewFilesList . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  83.          NewFilesDays . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  84.          ShowAreaInfo . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  85.        The File Manager . . . . . . . . . . . . . . . . . . . . . . . . . 8
  86.          File-area selection  . . . . . . . . . . . . . . . . . . . . . . 9
  87.          File-area processing . . . . . . . . . . . . . . . . . . . . .  11
  88.          The description editor . . . . . . . . . . . . . . . . . . . .  14
  89.        The Command-line Processor . . . . . . . . . . . . . . . . . . .  15
  90.          [command]  . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  91.            Help . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  92.            FileList . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  93.            BestDownload . . . . . . . . . . . . . . . . . . . . . . . .  16
  94.          [option] . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  95.            Group:<x>[,<x>[-<x>]]  . . . . . . . . . . . . . . . . . . .  16
  96.            NoCD . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  97.            CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  98.            Compress:<xxx> . . . . . . . . . . . . . . . . . . . . . . .  17
  99.            OutFile:<d:\path\filename.ext> . . . . . . . . . . . . . . .  17
  100.        User agreement . . . . . . . . . . . . . . . . . . . . . . . . .  18
  101.        Registration and Support . . . . . . . . . . . . . . . . . . . .  19
  102.        Credits  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  103.        Copyrights . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                       -1-
  112.  
  113.  
  114.                           File Master/2 version 0.30
  115.  
  116.  
  117.                                  Introduction
  118.  
  119.     Before I was  running LoraBBS I run Spitfire BBS (a DOS based BBS). For
  120.     Spitfire BBS there were 'only'  4 file-area managers, and they all  had
  121.     the same kind of lay-out. That lay-out showed a lot of quality. It also
  122.     was (and still is) a real user-friendly interface.
  123.     When I  switched to LoraBBS I tried a  few file-area managers, but none
  124.     of them  showed the quality, and had interface I was used to work with.
  125.     On that moment I wanted to write my own file manager for LoraBBS.
  126.     On april 7,  1995 I started writing  File Master/2. Until now  I really
  127.     liked  the job, and I'm a little  proud on the work I've delivered with
  128.     File Master/2.
  129.  
  130.     Now it's up to you to tell me what you find of File Master/2. Remember,
  131.     File Master/2  is still under  development. Eventhough I've  taken File
  132.     Master/2  out of  the Beta  test,  there might  still be  a  bug hidden
  133.     somewher. Please don't be angry on me about the bug, but report it.
  134.     I'd also  appreciate it  if you'd  tell me  what you  think about  File
  135.     Master/2, and what you thank could be a nice addition. Remember, you're
  136.     the one who uses File Master/2,  and I want to give you a  program that
  137.     you want to work with...
  138.  
  139.                                                    Diemen, 25 February 1996
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                                       -2-
  168.  
  169.  
  170.                           File Master/2 version 0.30
  171.  
  172.  
  173.                                  Installation
  174.  
  175.     To install  File  Master/2, you  need to  place all  the  files of  the
  176.     distribution package into one directory (i.e. C:\FMASTER2).  As you can
  177.     see, there are  no executable files. But  there are two ZIP  files. One
  178.     called FMAS_386.ZIP  and the  other  FMAS_486.ZIP. They  both hold  the
  179.     executable file of File Master/2.
  180.  
  181.     FM2_386.ZIP  holds the regular compiled version  of File Master/2. This
  182.     version can manage up to 1024 files per file-area.
  183.     FM2_486.ZIP  holds the  486 optimized  version  of File  Master/2. This
  184.     version can manage up to 2048 files per file-area.
  185.  
  186.     When you've placed  the files in  one directory, you  need to create  a
  187.     configuration file  called FMASTER2.CFG.  The configuration  file is  a
  188.     plain ASCII file, that can be created with any text editor.
  189.     For the configuration file you need to use a number of keywords. I will
  190.     explain them below.
  191.  
  192.     LoraConfig
  193.        With this keyword you tell File Master/2 where the main configur-
  194.        ation  of  your  LoraBBS  is located.  By  default  File Master/2
  195.        assumes  that  the  main  LoraBBS  configuration  is  located  in
  196.        C:\LORA\CONFIG.DAT.
  197.        (i.e. LoraConfig D:\LORA\CONFIG.DAT)
  198.  
  199.     DefaultColor
  200.        This keyword should be followed by 2 numbers. The first holds the
  201.        color  of the foreground, and  the second holds the  color of the
  202.        background.
  203.        The colors numbers that  can be used are the standard  ANSI color
  204.        codes. I assume  you don't have them laying  around somewhere, so
  205.        here they are listed.
  206.  
  207.          ANSI color codes.
  208.           0 - Black                8 - Dark grey
  209.           1 - Blue                 9 - Light blue
  210.           2 - Green               10 - Light green
  211.           3 - Cyan                11 - Light cyan
  212.           4 - Red                 12 - Light red
  213.           5 - Magenta             13 - Light magenta
  214.           6 - Brown               14 - Yellow
  215.           7 - Light grey          15 - White
  216.          For the background colors 0 through 7 can only be used.
  217.  
  218.        File Master/2 uses  color 11 for  the foreground, and  1 for  the
  219.        background as default.
  220.        (i.e. DefaultColor 15 0)
  221.  
  222.  
  223.                                       -3-
  224.  
  225.  
  226.                           File Master/2 version 0.30
  227.  
  228.  
  229.     BarColor
  230.        Just  like 'DefaultColor' this keyword  should be followed by two
  231.        numbers  too. With these  two colors you define  the color of the
  232.        selection  bar. The  foreground color  is also  used to  mark the
  233.        tagged files.
  234.        The colors 14 and 3 are used as default colors.
  235.        (i.e. BarColor 8 0)
  236.  
  237.     PopupColor
  238.        With this keyword you  can define the color of the pop-up windows
  239.        that File  Master/2 generates.  Pop-up windows  are used for  the
  240.        on-line help system, small messages, and response requests.
  241.        This keyword also needs two numbers to define the colors that are
  242.        used. By default File Master/2 uses 15 and 4.
  243.        (i.e. PopupColor 15 0)
  244.  
  245.     NoDesc
  246.        This option gives you the opportunity to set the prompt that File
  247.        Master/2 will give when no description is entered for a file.  By
  248.        default File Master/2 will use '<No description available>'.
  249.        (i.e. NoDesc *Unknown*)
  250.  
  251.     ZIP
  252.        Need  I say  more?  This  keyword tells  File  Master/2 what  the
  253.        command is to  ZIP a file. Because  of the great variety  of pro-
  254.        grams that  can create ZIP  files, File Master/2 uses  no default
  255.        value for this one.
  256.        The program that you point at, must be in the PATH.
  257.        (i.e. ZIP ZIP.EXE)
  258.  
  259.     unZIP
  260.        Just like  the 'ZIP' keyword, except that this keywords points at
  261.        the un-ZIP command.
  262.        (i.e. unZIP UNZIP.EXE)
  263.  
  264.     UseInfoZIP
  265.        This keyword can only  be followed by a  simple Yes or No and  is
  266.        used  to tell  File Master/2  if you  use InfoZIP  to  handle ZIP
  267.        files. When you're  using InfoZIP, additional parameters  have to
  268.        be added to get a few things done.
  269.        Because File  Master/2 is an OS/2 program, and  InfoZIP is one of
  270.        the most used ZIP compressors under OS/2 the keyword will default
  271.        to Yes.
  272.        (i.e. UseInfoZIP No)
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.                                       -4-
  280.  
  281.  
  282.                           File Master/2 version 0.30
  283.  
  284.  
  285.     ARJ
  286.        Just  like the  'ZIP' keyword.  This  keyword points  to the  ARJ
  287.        compression  method.  Remember that you use a  program that knows
  288.        how to compress and de-compress ARJ files.
  289.        (i.e. ARJ ARJ.EXE)
  290.  
  291.     RAR
  292.        Just  like the  'ZIP' keyword.  This  keyword points  to the  RAR
  293.        compression method.  Remember that you  use a program  that knows
  294.        how to compress and de-compress RAR files.
  295.        (i.e. RAR RAR.EXE)
  296.  
  297.     LZH
  298.        Just  like the  'ZIP' keyword.  This keywords  points to  the LZH
  299.        compression method. The compressor must know the Lha5 method.
  300.        (i.e. LZH LH2.EXE)
  301.  
  302.     ArchiveShell
  303.        With this option you can enable the archive-shell in File Master-
  304.        /2. This option is build, so you  can examine the contents of the
  305.        files that are in your file-area.
  306.        The program you point to should be in the PATH. If the program is
  307.        not in the  PATH, you should include the  complete PATH, directly
  308.        followed by the filename of the program.
  309.        The compression  shell you use  should be familiar with  the ZIP,
  310.        ARJ, RAR and LZH compression methods.
  311.        (i.e. ArchiveShell RAR.EXE)
  312.  
  313.     JPG-View
  314.        When using this option, you will be able to view JPEG pictures in
  315.        the file-area's from File Master/2.
  316.        The program you point to should be in the PATH. If the program is
  317.        not in the  PATH, you should include the  complete PATH, directly
  318.        followed by the filename of the program.
  319.        (i.e. JPG-View C:\JOEVIEW\JOEVIEW.EXE)
  320.  
  321.     GIF-View
  322.        When using this option, you will be  able to view GIF pictures in
  323.        the file=areas from File Master/2
  324.        The program you point to should be in the PATH. If the program is
  325.        not in the  PATH, you should include the  complete PATH, directly
  326.        followed by the filename of the program.
  327.        (i.e. GIF-View C:\JOEVIEW\JOEVIEW.EXE)
  328.  
  329.     The next options will be  used when you use the  command-line processor
  330.     that is build in File   Master/2. If you don't use this  option of File
  331.     Master/2 (which I doubt <G>), you don't need to configure them.
  332.  
  333.  
  334.  
  335.                                       -5-
  336.  
  337.  
  338.                           File Master/2 version 0.30
  339.  
  340.  
  341.     MaxLevel
  342.        This option hold  the maximum level of the  file-area that should
  343.        be included when using the command-line processor of File Master-
  344.        /2.
  345.        Because the levels of the file-area's are different on every BBS,
  346.        File  Master/2 doesn't  use a  default value. Basicly  this means
  347.        that  when you  don't use  this keyword,  File Master/2  won't do
  348.        anything when you use command-line processor.
  349.        The keyword should be  followed by the maximum level you  want to
  350.        be included when use the command-line processor of File Master/2.
  351.        You can use the numeric value of the level, or the normal written
  352.        value, like LoraBBS does.
  353.        Following  is a  list of  the written  level, with  their numeric
  354.        equivalent.
  355.          Twit        16
  356.          Disgraced   32
  357.          Limited     48
  358.          Normal      64
  359.          Worthy      80
  360.          Privil      96
  361.          Favored    112
  362.          Extra      128
  363.          Asstsysop  160
  364.          Sysop      176
  365.          Hidden     192
  366.        (i.e. MaxLevel Extra)
  367.  
  368.     AllFilesList
  369.        Using this option you tell File Master/2 where to create the list
  370.        of files,  when using the  'FileList' option of  the command-line
  371.        processor.
  372.        (i.e. AllFilesList D:\DOWNLOAD\ALLFILES.TXT)
  373.  
  374.     NewFilesList
  375.        Using this option you tell File Master/2 where to create the list
  376.        of new  files, when using  the 'FileList' option of  the command-
  377.        line processor.
  378.        (i.e. NewFilesList D:\DOWNLOAD\NEWFILES.TXT)
  379.  
  380.     NewFilesDays
  381.        This option has  to be used with the  'NewFilesList' keyword. The
  382.        'NewFilesDays'  keyword defines  the  number of  days  a file  is
  383.        marked by File Master/2 as new. Setting this number to zero means
  384.        that no list of new files is created.
  385.        (i.e. NewFilesDays 30)
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                                       -6-
  392.  
  393.  
  394.                           File Master/2 version 0.30
  395.  
  396.  
  397.     ShowAreaInfo
  398.        With this  option you  can turn  extra information regarding  the
  399.        file-area generated  by File  Master/2 in  an AllFilesList  on or
  400.        off. There are two possible parameters too use: YES and NO.
  401.        YES will show the extra information, containing the area name and
  402.        number at the top of the  file-area, and the number of files  and
  403.        their size at the bottom of the file-area.
  404.        NO will not show any extra information about the file-area.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.                                       -7-
  448.  
  449.  
  450.                           File Master/2 version 0.30
  451.  
  452.  
  453.                                The File Manager
  454.  
  455.     When you start File Master/2  without any parameter, File Master/2 will
  456.     take you to the file  manager. This file manager is build  with you, as
  457.     user of File Master/2, in mind. Therefor  File Master/2 has a very easy
  458.     and user-friendly interface.
  459.     File Master/2  holds also  an on-line help  system. Whenever  you're in
  460.     need of a little help, you only need to press the F1 key, and your help
  461.     is there.
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.                                       -8-
  504.  
  505.  
  506.                           File Master/2 version 0.30
  507.  
  508.  
  509.     File-area selection
  510.  
  511.     After  you've started  File Master/2  you'll  see a  list of  available
  512.     file-area's within your LoraBBS.
  513.     If you've made your color configuration right, the first file-area will
  514.     be in  a bar of a different color then the rest of the screen. This bar
  515.     is the  file-area-selection bar. You can move this  bar up and down, to
  516.     select the file-area you'd like to process.
  517.     To move the file-area-selection  bar, you can use one of  the following
  518.     keys.
  519.  
  520.     Arrow-Down
  521.        Moves the file-area-selection  bar one file-area down.  If you're
  522.        already at the bottom of the screen, the file-area-selection  bar
  523.        will stay  there, and the  file-area's will scroll up,  until the
  524.        last file-area is reached.
  525.  
  526.     Arrow-Up
  527.        Moves the  file-area-selection bar  one file-area  up. If  you're
  528.        already at  the top  of the  screen, the file-area-selection  bar
  529.        will stay there, and the  file-area's will scroll down, until the
  530.        first file-area is reached.
  531.  
  532.     Page-Down
  533.        Moves the file-area's  to the next page.  The file-area-selection
  534.        bar will stay on the place where it is. The file-area that was on
  535.        the  bottom of  the screen will  appear again  on the top  of the
  536.        screen.
  537.        When you reach  the last page  of file-area's, the  file-area-se-
  538.        lection bar will drop down to the last file-area available.
  539.  
  540.     Page-Up
  541.        Moves the file-area's to the previous page. The file-area-select-
  542.        ion bar will  stay on the place  where it is. The  file-area that
  543.        was on the top  of the screen will appear again  on the bottom of
  544.        the screen.
  545.        When you reach  the first page of file-area's,  the file-area-se-
  546.        lection bar will jump to the first file-area available.
  547.  
  548.     End
  549.        Drops  down the  file-area-selection bar  to  the last  available
  550.        file-area on your system.
  551.  
  552.     Home
  553.        Jumps the file-area-selection bar to the first available filearea
  554.        on your system.
  555.  
  556.  
  557.  
  558.  
  559.                                       -9-
  560.  
  561.  
  562.                           File Master/2 version 0.30
  563.  
  564.  
  565.     Enter
  566.        When you  press the  'Enter'-key, you  will make your  selection.
  567.        When  copying/moving files,  this will  be  the target  file-area
  568.        where the files will be  copied/moved to. Otherwise the  selected
  569.        file-area will be loaded.
  570.  
  571.     Esc
  572.        The  Escape-key  will  leave the  file-area  selection.  When you
  573.        wanted to  copy/move a  file, this process  is aborted.  When you
  574.        were selecting a file-area to process, File Master/2 will ask you
  575.        if you'd like to exit File Master/2.
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.                                      -10-
  616.  
  617.  
  618.                           File Master/2 version 0.30
  619.  
  620.  
  621.     File-area processing
  622.  
  623.     When you've selected a file-area, File Master/2 will load the FILES.BBS
  624.     for you,  and show it to you. Just  like the file-area selection you'll
  625.     see a bar on your screen. This is the file-selection bar. You can  move
  626.     this bar  on the screen on the  same way as you've done  to select this
  627.     file-area.
  628.     Besides the direction keys to move the file-selection bar, there are  a
  629.     lot of other command-keys. I will explain them below.
  630.  
  631.     Enter
  632.        This  key allows  you to  view and  edit the  description of  the
  633.        current file. Pressing the 'Enter'-key will load internal editor.
  634.        You can use  the editor also to view the  complete description of
  635.        the file.
  636.  
  637.     Space
  638.        The SpaceBar tags and de-tags a file for batch-processing.
  639.        Batch-processing is a  system that saves   you lots of time.  All
  640.        you need to do is tag  all files you want to do the  same command
  641.        with, and then  give the  command you'd like  to be executed.  In
  642.        File Master/2 the keys you need to press are the Alt-key  and the
  643.        key  for the command  itself. When batch-processing  is available
  644.        for a  command, it is  written directly under the  explanation of
  645.        the command itself.
  646.        Similar to 'Space' is pressing the 'T'-key.
  647.  
  648.     Alt-T
  649.        Tags all files in the current file-area.
  650.  
  651.     Ctrl-T
  652.        De-tags all files in the current file-area.
  653.  
  654.     C  Copies the current file to an anther file-area.
  655.        (Alt-C is used for batch-processing)
  656.  
  657.     M  Moves the current file to an other file-area.
  658.        (Alt-M is used for batch-processing)
  659.  
  660.     D  Deletes the  current file  from both the  FILES.BBS and  from the
  661.        harddisk. Before the file is  deleted, File Master/2 will ask you
  662.        to confirm that the file has to be deleted.
  663.        Similar to 'D' is pressing the 'Del'-key.
  664.        (Alt-D is used for batch-processing)
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.                                      -11-
  672.  
  673.  
  674.                           File Master/2 version 0.30
  675.  
  676.  
  677.     R  Removes  the current file  from the FILES.BBS.  This option won't
  678.        delete the  file from the  harddisk. Just like the  'D'-key, File
  679.        Master/2 will ask you to confirm that the file has to be removed.
  680.        (Alt-R is used for batch-processing)
  681.  
  682.     I  Extracts the  FILE_ID.DIZ from a  compressed file, and  loaded it
  683.        into memory as  the description of the file.  You should remember
  684.        that the FILE_ID.DIZ will  only be extracted from  the compressed
  685.        file if you configured that kind of compression.
  686.        (Alt-I is used for batch-compression)
  687.  
  688.     P  Extracts the size (in pixels)  of a picture. At this  moment only
  689.        the JPEG  and GIF standards  are supported by File  Master/2, but
  690.        other picture kinds will be supported in the future.
  691.        (Alt-P is used for batch-processing)
  692.  
  693.     V  Views  the current  picture. This  option only  works if  you did
  694.        configure  the program that is  able to view the  type of picture
  695.        you want to be displayed.
  696.        Keep in  mind that File  Master/2 shells to an  external program.
  697.        Depending on your system, this might take a while.
  698.  
  699.     A  Shells  to  an  archive-shell.  This  option  only  works  on the
  700.        configured compression  types, and if you did configure an exter-
  701.        nal archive-shell.
  702.        Keep in  mind that File  Master/2 shells to an  external program.
  703.        Depending on your system, this might take a while.
  704.  
  705.     F  Sets the date of the current file to today.
  706.        (Alt-F is used for batch-processing)
  707.  
  708.     ?  Gives  you  general  information  about  the  current  file-area.
  709.        Information is given  on the name, the total  number of files and
  710.        the total size. And the number of tagged files with their size.
  711.  
  712.     O  Adopts  orphan files,  that are  not yet  in the  FILES.BBS. When
  713.        using  this   option,  all  compressed files  are  scanned for  a
  714.        FILE_ID.DIZ, and for the picture-size.
  715.  
  716.     S  This option  sorts the  FILES.BBS in any  logic form.  That means
  717.        that the FILES.BBS can be sorted on filename, date and size.  All
  718.        of them ascending and descending.
  719.        A sub-menu will be shown with the following options.
  720.           F  Sorts ascending on filename
  721.           S  Sorts ascending on size
  722.           D  Sorts ascending on date
  723.          ^F  Sorts descending on filename
  724.          ^S  Sorts descending on size
  725.          ^D  Sorts descending on date
  726.  
  727.                                      -12-
  728.  
  729.  
  730.                           File Master/2 version 0.30
  731.  
  732.          The '^' means  that the Ctrl key  has to be pressed  with the
  733.          following key. (i.e. '^F' means 'Ctrl-F')
  734.  
  735.     F2
  736.        Saves the FILES.BBS that is in memory to the harddisk.
  737.  
  738.     Esc
  739.        Pressing the Escape-key  will end the file-area  processing. When
  740.        data has been changed, you will be prompted if the FILES.BBS  has
  741.        to be saved.
  742.        You will be returned to the file-area selection screen.
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.                                      -13-
  784.  
  785.  
  786.                           File Master/2 version 0.30
  787.  
  788.  
  789.     The description editor
  790.  
  791.     Just like   the file-area  selection and the file-area  processing, the
  792.     description editor uses the same  keys to move your cursor through  the
  793.     text of the file-description. There are however two differences...  The
  794.     Home  is used  to get  back to  the beginning  of  the current  line of
  795.     description, and the  End key is used  to go to the end  of the current
  796.     line. Also the Arrow-Up and Arrow-Down keys are a little different. You
  797.     would expect that  the cursor would stay on the same position, but then
  798.     one line up or below. That's not true. The cursor is moved to the first
  799.     position of the new line.
  800.     And then  there are  two new  defined keys.  I think  you'll know  them
  801.     already. Those are the Arrow-Left and Arrow-Right. These keys will move
  802.     your cursor one position left or right.
  803.     When editing the description of the  file, you can use all normal  keys
  804.     you  wish to use  for the description. Two keys  can only not be  used.
  805.     These keys are Ctrl-Y and Alt-167.
  806.     Ctrl-Y  is used to delete  a complete line of  description. The Alt-167
  807.     combination is used as the Carriage Return.
  808.     The description editor has  also a few limits. This is  to prevent that
  809.     File Master/2  uses too much memory, and that the user won't get a huge
  810.     description. The limitation  is 1536 bytes (1.5Kb), or  100 lines, each
  811.     with a maximum of  250 characters. But I  think that these  limitations
  812.     aren't real limitations  at all...  For a  file-description, you should
  813.     have enough room... <G>
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                                      -14-
  840.  
  841.  
  842.                           File Master/2 version 0.30
  843.  
  844.  
  845.                           The Command-line Processor
  846.  
  847.     Besides  the file  manager,  File Master/2  also  holds a  command-line
  848.     processor.  The command-line  processor allows  File Master/2  to do  a
  849.     number of routines,  without the need of someone to tell  how it has to
  850.     be  done exactly.  The command-line  processor can  be used  for batch-
  851.     processing, for example in the nightly maintenance.
  852.     The command-line processor  uses three  basic elements.  These are  the
  853.     command, the option(s) and (if needed) an output indication.
  854.     To call the command-line processor from the OS/2 command-line, it would
  855.     look something like this:
  856.  
  857.          FMASTER2.EXE [command] [option]..[option] [output]
  858.  
  859.     The explanation of command, option  and output will follow in this  and
  860.     the following pages...
  861.  
  862.  
  863.     [command]
  864.  
  865.     You can use the command only once on the command-line [command]. If you
  866.     use more than one command at a time on one command-line,  File Master/2
  867.     will only execute the  first command entered. [command]  can be any  of
  868.     the following.
  869.  
  870.     Help
  871.        This command  shows a small help  to you. Displayed  are only the
  872.        important things you  should need to know about  the command-line
  873.        processor.  This the  'Help' command  you  can't use  any of  the
  874.        options that are available, or the output.
  875.  
  876.     FileList
  877.        Using the 'FileList' command, File Master/2 will create a list of
  878.        all files  available on you BBS, and a list of the new files, for
  879.        the last number of  days as you've configured  in 'NewFilesDays'.
  880.        The list  of all files will always be kept,  even if there are no
  881.        files at all (is there a BBS without any files? <G>). The list of
  882.        the new files will be erased,  when there are no new files  to be
  883.        reported.
  884.        Possible options to use:
  885.        Group:<x>[,<x>[-<x>]], CD, NoCD, Compress:<xxx>
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.                                      -15-
  896.  
  897.  
  898.                           File Master/2 version 0.30
  899.  
  900.  
  901.     BestDownload
  902.        With  this  command you  create  a top  10  bulletin of  the best
  903.        downloaded files. The  created bulletins are made  in ASCII, ANSI
  904.        and Avatar.
  905.        Possible options to use:
  906.        Group:<x>[,<x>[-<x>]], CD, NoCD
  907.        OutFile:<d:\path\filename.ext>
  908.          Using the 'OutFile:' parameter  you only have to  specify the
  909.          base  filename  of the  bulletin to  be created,  without the
  910.          extentions '.ANS' and '.ASC'.
  911.          Avatar/0+ code is not (yet) implemented in File Master/2.
  912.          (defaults to .\TOP25D)
  913.  
  914.     [option]
  915.  
  916.     Besides the commands, File Master/2 also  knows a number of options, to
  917.     give directions to the commands. The directions that these options give
  918.     are numerous, and they are explained below.
  919.  
  920.     Group:<x>[,<x>[-<x>]]
  921.        This option assigns a  group, or number  of groups you'd like  to
  922.        process for the command. LoraBBS knows up to 999 groups, and File
  923.        Master/2 supports them all.
  924.        You can use the 'Group:' option as follows:
  925.          Group:4        Uses file-group 4 only
  926.          Group:4,7      Uses file-groups 4 and 7
  927.          Group:10-13    Uses file-groups 10 tru 13
  928.          Group:4,10-13  Uses file-groups 4 and 10 tru 13
  929.        These examples  are simple. If   you'd like  you can  even assign
  930.        'Group:4,10-13,500-525,900', and  File Master/2 will  process the
  931.        file-groups as you've specified them.
  932.        NOTE: This option is only  available for registered users of File
  933.        Master/2.
  934.  
  935.     NoCD
  936.        With this  option File Master/2  won't process  the CD-ROM  file-
  937.        area's. The file-area's must have  the CD-ROM flag set in LoraBBS
  938.        to be a CD-ROM file-area.
  939.        NOTE: This option is only  available for registered users of File
  940.        Master/2.
  941.  
  942.     CD
  943.        This option  is opposite  to the 'NoCD'  option. The  'CD' option
  944.        will force File  Master/2 to process the file-area's  that are on
  945.        the CD-ROM.
  946.        NOTE: This option is only  available for registered users of File
  947.        Master/2.
  948.  
  949.  
  950.  
  951.                                      -16-
  952.  
  953.  
  954.                           File Master/2 version 0.30
  955.  
  956.  
  957.     Compress:<xxx>
  958.        The compress option is only used with the 'FileList' command. The
  959.        'Compress:' option  causes the  both the  file-lists to  be comp-
  960.        ressed.
  961.        The <xxx>  has to be  replaced with  one of the  four compression
  962.        methods that are supported  by File Master/2, and it  can be ZIP,
  963.        ARJ, LZH or RAR
  964.  
  965.     OutFile:<d:\path\filename.ext>
  966.        This parameter allowes you to give a file to be generated. If the
  967.        parameter can be  used with a command parameter  it is written by
  968.        the command. Using  the 'OutFile:' parameter you'll  override the
  969.        default that is normally used.
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.                                      -17-
  1008.  
  1009.  
  1010.                           File Master/2 version 0.30
  1011.  
  1012.  
  1013.                                 User agreement
  1014.  
  1015.     With the use of File Master/2  you to hold the author harmless for  all
  1016.     damages done directly  or indirectly by File Master/2  to your computer
  1017.     system, software and  other data, your common sense  and health and all
  1018.     other things that File Master/2 could otherwise do harm to.
  1019.  
  1020.     File Master/2 is provided as-is. This means that File Master/2 holds no
  1021.     warranty of  any kind.  The only thing  I can  please you with  is that
  1022.     possible  problems on your  side might also  result on the  side of the
  1023.     author, because he's using File Master/2 too.
  1024.  
  1025.     It is strictly forbidden to  de-compile, dis-assemble, or use any other
  1026.     kind of reverse engineering on File Master/2. Changing any of the files
  1027.     in the distribution package is also forbidden.
  1028.  
  1029.     The distribution package of File Master/2 holds an Authentic Verificat-
  1030.     ion. Please note it. When you've unZIPped the distribution package with
  1031.     PKWare's PKUNZIP you should see that behind every file a '-AV'  comment
  1032.     is placed.  When the file is completely decompressed you should see the
  1033.     following comment:
  1034.  
  1035.               Authentic files Verified!   # TZD532
  1036.               Alexander Erne
  1037.  
  1038.     If you don't  see this comment, or  the '-AV' comment, the  package you
  1039.     have  is not  the  original distribution  package.  Please contact  the
  1040.     author in  that case, and upload the  package you have to  his BBS (see
  1041.     further under 'Support Sites').
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.                                      -18-
  1064.  
  1065.  
  1066.                           File Master/2 version 0.30
  1067.  
  1068.  
  1069.                            Registration and Support
  1070.  
  1071.     File Master/2  is distributed under  the ShareWare concept.  This means
  1072.     that you're free to  use File Master/2 for  a trial period of  30 days.
  1073.     After  that  trial period  you  must  decide  either to  register  File
  1074.     Master/2 with the author, or stop using it for now and the future.
  1075.     The registration of  File Master/2 isn't expensive.  File Master/2 only
  1076.     costs $15  (DFl 25,00). This  registration will be valid  until version
  1077.     0.99.  With the  release of  File  Master/2 version  1.00, you  need to
  1078.     upgrade the registration. The upgrade registration of the 1.00 version,
  1079.     will be lower than the normal registration for the 1.00 version.
  1080.     To register File Master/2, you need to do  is complete the REGISTER.FRM
  1081.     file, and send it to one of the registration sites.
  1082.     When you've  registered File    Master/2, you'll  be able  to use  more
  1083.     options. And  the further the  development of File Master/2  comes, the
  1084.     more (new) options will be only available for the registered version of
  1085.     File Master/2.
  1086.  
  1087.     The address to send the completed registration form to is:
  1088.          EAgle Soft
  1089.          a.t.t.n. Alexander Erne
  1090.          Burg de Kievietstraat 86
  1091.          1111 GR  Diemen - The Netherlands
  1092.     For the USA and Canada, the registration site is:
  1093.          Robert M Butler
  1094.          7941 NW Crossland Cir
  1095.          Lawton, Ok. 73505
  1096.  
  1097.     Support for File Master/2 can be gained on the  two registration sites,
  1098.     and on the following BBS systems:
  1099.  
  1100.     BBS-name            Sysop               FidoNet   Phone#
  1101.  
  1102.     EAgle Soft BBS      Alexander Erne      2:280/230 31-20-6900028
  1103.                         InterNet: alexerne@eagle.xs4all.nl
  1104.     Fire 4 Effect!      Robert Butler       1:385/26  1-405-536-0583
  1105.                                                       1-405-536-0325
  1106.  
  1107.     Of course every new version of File Master/2 will be placed on the Lora
  1108.     File Network.
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.                                      -19-
  1120.  
  1121.  
  1122.                           File Master/2 version 0.30
  1123.  
  1124.  
  1125.                                     Credits
  1126.  
  1127.     While I've been programming File  Master/2, I've had some great support
  1128.     of a number  of people. Some  of them I'd  like to mention, because  of
  1129.     their great help.
  1130.  
  1131.        Francien van Lent (my girl-friend): You showed your patience when
  1132.        I spent sometimes more time to File Master/2 than I spent to you.
  1133.        In all  circumstances you  were there  for me. You  even gave  me
  1134.        solutions to problems I had with File Master/2.
  1135.  
  1136.        Maurice Elfert:  Thank you  for putting me  on the  File Master/2
  1137.        project, and the testing while your BBS was on-line.
  1138.  
  1139.        Robert Butler: After  the call Maurice Elfert did  the first time
  1140.        you immediately wanted to become a Beta tester. Later on you also
  1141.        wanted to become my US/Canadian registration  and support site. I
  1142.        think you're on an important place in the File Master/2 project.
  1143.        Without  you I don't think  I would make it  on the other side of
  1144.        the  Ocean... I surely hoop to  drink a pint of  beer with you in
  1145.        person one day!
  1146.  
  1147.        Rob  Schouw: A  friend  and  colleague of  mine.  When I  started
  1148.        working on  File Master/2 I  already wrote two small  programs in
  1149.        C++.  You were more  experienced than me with  C++. Thank you for
  1150.        teaching me so much in this great programming language.
  1151.  
  1152.        Henk Dijksma: I would like to thank you for the Beta  testing you
  1153.        did.  I'd also like to  thank you for showing  your patience when
  1154.        File Master/2 had  yet an other bug  in the first Beta  versions.
  1155.        <G>  I also  appreciate it that  you're thinking on  how to solve
  1156.        bugs in File Master/2.
  1157.  
  1158.     Further more  I'd like to thank you for using File Master/2 as the file
  1159.     manager for your BBS!
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.                                      -20-
  1176.  
  1177.  
  1178.                           File Master/2 version 0.30
  1179.  
  1180.  
  1181.                                   Copyrights
  1182.  
  1183.     File Master/2  is copyright (c)  1995,1996 by Alexander Erne  and EAgle
  1184.     Soft. Eagle Soft is a trading name used by Alexander Erne.
  1185.     All  rights on  File Master/2, the  program, name,  this documentation,
  1186.     sources,  and  all  files belonging  to  the  distribution  package are
  1187.     strictly reserved to Alexander Erne.
  1188.     The copyrights on File Master/2 are protected by the Dutch and Interna-
  1189.     tional Law.  Any violation of  the copyrights of File  Master/2 will be
  1190.     prosecuted according to Dutch, or International Law.
  1191.  
  1192.     In this documentation I mentioned also the names of programs, that were
  1193.     made  by other  developers.  These  programs are  listed  below (in  no
  1194.     particular order).
  1195.  
  1196.          LoraBBS  - Copyright 1989-95 by Marco Maccaferri
  1197.          OS/2     - Copyright 1987, 1994 by IBM corp.
  1198.          Spitfire - Copyright and TradeMark by Mike Woltz
  1199.          PKUNZIP  - Copyright 1989-1993 and TradeMark by PKWare
  1200.  
  1201.     It's possible that  I missed some copyrights announcements  in the list
  1202.     above. But  all authors  do have  their own  rights on  their programs,
  1203.     eventhough I didn't mention them.
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.                                      -21-
  1232.  
  1233.