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