home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_mail / fusl_140.arj / FUSL.DOC < prev    next >
Text File  |  1991-06-04  |  20KB  |  528 lines

  1.  
  2.  
  3.  
  4.  
  5.                     ┌─────────┐
  6.                     │▓▓▓▓▓▓▓▓▓│
  7.                     │▓▓┌────┬─┴┐┌──┐┌──────┐┌──┐
  8.                     │▓▓└───┐│▓▓││▓▓││▓▓▓▓▓▓││▓▓│
  9.                     │▓▓▓▓▓▓││▓▓││▓▓││▓▓ ───┤│▓▓│
  10.                     │▓▓┌───┘│▓▓││▓▓││▓▓▓▓▓▓││▓▓│
  11.                     │▓▓│    │▓▓└┘▓▓│├─── ▓▓││▓▓└────┐
  12.                     │▓▓│    │▓▓▓▓▓▓││▓▓▓▓▓▓││▓▓▓▓▓▓▓│
  13.                     └──┘    └──────┘└──────┘└───────┘
  14.                   ┌───────────────────────────────────┐
  15.                   │  FrontDoors Ulimate Scan Lister   │
  16.                   └───────────────────────────────────┘
  17.                   ┌────────────────────────────────────┐
  18.                   │(c)opyright 1990,91 Johannes Hoerhan│
  19.                   └────────────────────────────────────┘
  20.  
  21.  
  22.  
  23.  
  24.     COPYRIGHT
  25.     ----------------------------------------------------------------------
  26.  
  27.     You can use the FUSL (Noncommercial version) any way you like, as
  28.     long as you use it in a noncommercial enviroment. I only guarantee
  29.     that this program uses some space on your harddisk and in your
  30.     memory.
  31.  
  32.     Since development of FUSL took a lot of time and effort I will
  33.     stop the development of the noncommercial version at this point
  34.     (V 1.20). Up to this, both versions (registered and unregistered)
  35.     have exactly the same features except the unregistered version will
  36.     write "UNREGISTERD FUSL USER" as Sysopname.
  37.  
  38.     Further improvements will only concern the registered version!
  39.  
  40.  
  41.  
  42.     HOW TO REGISTER:
  43.     ----------------------------------------------------------------------
  44.  
  45.         Send    100.- austrian shillings or
  46.                  15.- DM or
  47.                  10.- US $
  48.  
  49.         to      Johannes HOERHAN (Fido 2:310/10)
  50.                 Ettenreichgasse 1/18
  51.                 1100 VIENNA
  52.                 AUSTRIA
  53.  
  54.         or to this account:
  55.  
  56.                 BLZ:  20151   Nr.: 907079719
  57.  
  58.  
  59.     You can request the newest versions of FUSL at the following nodes:
  60.  
  61.                 Blumenkistl     HST V32    2:310/10 @fidonet.org
  62.                 Gallatin Link   HST V32b   2:310/19 @fidonet.org
  63.                 The Rose        INTEL V32  1:105/7  @fidonet.org
  64.  
  65.     For US - users: contact Dan Dimick, 1:105/7, The Rose how to register!
  66.  
  67.  
  68.     PURPOSE OF FUSL
  69.     ----------------------------------------------------------------------
  70.  
  71.     The main reason while FUSL was born was the matter that I find it
  72.     quite annoying to search through kilobytes of filelistings to get
  73.     the new files there. The only indication I had was the datestamp
  74.     of the files. Well, we all know the matter that there might be
  75.     some files NEW in the different listings which haven't been there
  76.     before but didn't get a datestamp. I found it now interesting to
  77.     know what really happend in the listing since my last request.
  78.  
  79.     With FUSL you can now compair two filelistings for differences,
  80.     request from in the listing, and send a thanx msg to the nodes.
  81.     It seems to me that FUSL is one of the first anti D'Bridge tools
  82.     because now you can also bother these sysops with these very
  83.     important msg's;-)
  84.  
  85.  
  86.  
  87.     WHAT FUSL NEEDS
  88.     ----------------------------------------------------------------------
  89.  
  90.         ■ MS Dos compatible computer with MS Dos 3.x or better
  91.         ■ >200 K Memory
  92.  
  93.  
  94.     WHAT IS RECOMMENDED
  95.     ----------------------------------------------------------------------
  96.  
  97.         ■ AT class machine
  98.         ■ FrontDoor or Binkley as mailer
  99.         ■ DESQview or other multitasking software
  100.         ■ 1, better 2 filelistings
  101.         ■ Fidouserlist (recommended!)
  102.         ■ A modem;-)
  103.  
  104.  
  105.     GENERAL
  106.     ----------------------------------------------------------------------
  107.  
  108.     FUSL has some capabilities which you can't change. Here I've listed
  109.     them - hope I did not forget some:-)
  110.  
  111.     The configuration files 'FUSL.SYS', 'FUSL.MSG' are expected to be
  112.     found in the same directory as FUSL.EXE resides.
  113.  
  114.     FUSL is 'DESQview aware'. That means, if DESQview is installed, the
  115.     screenoutput will be done via bios. If DV is not present, FUSL will
  116.     do direct screen writes.
  117.  
  118.     FUSL will also check which graphics adapter is installed and choose
  119.     the screen modus which fits best. You can't force FUSL to run mono
  120.     when a color adapter is installed (CGA,EGA,VGA).  You only can change
  121.     the display lines (43 lines EGA / 50 lines VGA).
  122.  
  123.     When a SET TEMP= or SET TMP= is found in the environment, FUSL will
  124.     use this defined path for creating its temporary files too. This is
  125.     not valid, when FUSL has to unpack filelists. These temporary
  126.     directories (FUSL.$$1, FUSL.$$2) are always created in the root
  127.     directory of the current drive and removed when they are not needed
  128.     anymore.
  129.  
  130.     Also the 'comspec' variable would be used when entering the dosshell.
  131.     If no 'comspec' is found, FUSL is looking for command.com in the
  132.     dos path.
  133.  
  134.     Allthough this thing is called Frontdoor's... you can use it under
  135.     Binkley environment too!!
  136.  
  137.     The 'file requests' which FUSL generates are kept very common
  138.     (*.msg in netmail directory) so maybe other mailers could work
  139.     with FUSL as well.
  140.  
  141.  
  142.  
  143.     FUSL MENUS
  144.     ----------------------------------------------------------------------
  145.  
  146.     ■ MAIN
  147.  
  148.       · About       : Small product info
  149.       · Dosshell    : jump to DOS
  150.  
  151.     ■ SETUP
  152.  
  153.       · Mailer      : either Frontdoor or Binkley
  154.       · Netmailpath : path to your netmaildirectory
  155.       · Systempath  : path to where your mailer resides
  156.       · Fidouserpath: path to your fidouser.lst
  157.       · Your Name   : sysop name
  158.       · Your Adress : full network adress
  159.       · Register key: code you'll get for registering
  160.       · Baudrate    : your maximal baudrate
  161.       · Lists       : define filelists for scanning
  162.       · Packer      : define packer
  163.       · Swapping    : enable/disable disk/EMS swapping
  164.  
  165.     ■ REQUEST
  166.  
  167.       · Request List: select filelist to request from
  168.       · Filelists   : select filelists to compare for difference
  169.       · Get From    : enter systemdata from where to request the files
  170.       · Magic       : select some magic filenames
  171.       · Clear       : clear the request buffer
  172.       · Send msg    : generate the filerequest message
  173.  
  174.     ■ EDIT
  175.  
  176.       · Buffer      : edit the request buffer
  177.       · Message     : edit any request messages generated before
  178.  
  179.     ■ MSGSTATUS
  180.  
  181.       · Crash   YES : toggle crashflag yes/no
  182.       · Direct  NO  : toggle direct flag yes/no
  183.       · Hold    NO  : toggle hold yes/no
  184.       · Rescan  YES : toggle rescan yes/no
  185.       · Rq-Msg  No  : toggle sending of the "thanx message"
  186.       · Save Flags  : save your current flag-setting
  187.  
  188.     ■ MOUSE
  189.  
  190.       · Mouse   OFF : enables mouse yes/no
  191.       · Full    OFF : toggle full mouse support
  192.  
  193.     ■ VIDEO
  194.  
  195.       · 25 lines    : normal 25 line video mode
  196.       · 43 lines    : switch to 43 line EGA mode
  197.       · 50 lines    : switch to 50 line VGA mode
  198.  
  199.     ■ QUIT
  200.  
  201.  
  202.  
  203.     SETUP FUSL
  204.     ----------------------------------------------------------------------
  205.  
  206.     Since the most parameters need no explanation at all, here I will
  207.     explain some of the more complex ones:
  208.  
  209.     ■ MAILER: either Frontdoor or Binkley
  210.  
  211.       When Frontdoor is selected FUSL needs no further information.
  212.       If you use Binkley as a mailer you are prompted for a 'rescan cmd'.
  213.       This is the command FUSL will perform AFTER generating the request
  214.       message. This is needed to generate  *.REQ *.CLO files in the
  215.       outbound directory.  eg.: QMAIL PACK
  216.  
  217.  
  218.     ■ FIDOUSERPATH: path to your fidouser.lst
  219.  
  220.       If you want to use the comfortable way of entering the
  221.       network adresses and sysop names, where to request the
  222.       files from, you have to generate a fidouser.lst.
  223.  
  224.       Here an example:
  225.  
  226.       Aaboe, Ole                                          2:231/75
  227.       Aagaard, Klaus                                      2:234/62
  228.       Aagaard, Peter                                      2:231/11
  229.       Aalsburg, Hans Van                                 2:285/508
  230.       Aaron, Fred                                        1:109/601
  231.       Aarssen, Henry Van.                                 2:500/27
  232.       Abate, Artie                                       1:101/342
  233.       Abbott, Bob                                          1:157/0
  234.       Abbott, Bob                                        1:157/511
  235.       Abbott, Douglas                                    1:363/123
  236.       .
  237.       .
  238.       .
  239.       You can generate such a list with parselst or the golded
  240.       nodelist compiler.
  241.  
  242.       Simply enter now a part of the sysop name (similar to FrontDoor)
  243.       and FUSL will find the destination node. Or enter a nodenumber and
  244.       press ENTER at the prompt for a name - FUSL will scan the
  245.       fidouser.lst and find the name for it's own.
  246.  
  247.       Of course it would have been better if I could use the nodelist
  248.       index files of FrontDoor or any other known nodelistcompiler,
  249.       but their structures seem to be very, very secret so I had to find
  250.       the most suitable solution. This is the reason why it might take
  251.       quite a while to find a Sysop's name when you entered only a node-
  252.       number. But I didn't want to create another hundreds of kilobytes
  253.       *.idx files or whatever to be a few seconds faster...
  254.  
  255.       IMPORTANT: you need a sorted list!! You can use QSORT to do this.
  256.  
  257.  
  258.     ■ LISTS: define filelists for scanning (see SCAN/FULL SCAN)
  259.  
  260.       REGISTERED VERSION only!
  261.  
  262.       If selected, a requester window will popp up:
  263.  
  264.       ╒═════════════════════════════════════[ FUSL Filelist-Setup ]═╕
  265.       │                                                             │
  266.       │ PATH & NAME                                ALIAS            │
  267.       │                                                             │
  268.       │ 0: C:\FD\RA\RATOOLS\03100010.TXT           MINE             │
  269.       │ 1: G:\STUFF\FILELIST\03100019.OLD          ROBERT           │
  270.       │ 2: G:\STUFF\FILELIST\BUENTER.OLD           BUENTER          │
  271.       │ 3: G:\STUFF\FILELIST\GROOT.OLD             DE.GROOT         │
  272.         .
  273.         .
  274.         .
  275.       Here you can define up to 10 filelists with the FULL path & name.
  276.       You also HAVE TO define a handle for each filelist. This makes live
  277.       easier...
  278.  
  279.       See REQUESTING WITH FUSL for more informations!
  280.  
  281.  
  282.     ■ PACKER: define packer
  283.  
  284.       REGISTERED VERSION only!
  285.  
  286.       Here another window will popp up:
  287.  
  288.       ╒═════════════════════════[ FUSL DE-ARC  Setup ]═╕
  289.       │                                                │
  290.       │ NAME & OPTIONS                                 │
  291.       │                                                │
  292.       │ ARC: PAK E                                     │
  293.       │ ZIP: e:\tools\packer\PKUNZIP                   │
  294.       │ ZOO: ZOO -E                                    │
  295.       │ LZH: LHA E                                     │
  296.       │ PAK: PAK E                                     │
  297.       │ ARJ: ARJ E                                     │
  298.       │                                                │
  299.       ╘════════════════════════════════════════════════╛
  300.  
  301.       Define your decompress programs here. If the program can be found
  302.       in the Dos-Path you don't need to specify the path.
  303.  
  304.       FUSL will create a temporary subdirectory and de-compress the
  305.       filelist(s). This file and subdir will be deleted after
  306.       requested operation (File-request or compare filelists).
  307.  
  308.  
  309.     ■ SWAPPING: enable/disable disk/EMS swapping
  310.  
  311.       Selecting this, you'll get another window:
  312.  
  313.       ╒══════════════════════════════════════════[ Swapping ]═╕
  314.       │                                                       │
  315.       │ Swapping    : ON                                      │
  316.       │ Use EMS     : YES                                     │
  317.       │ Path        : /                                       │
  318.       │                                                       │
  319.       ╘═══════════════════════════════════════════════════════╛
  320.  
  321.       · Swapping: ON/OFF enables/disable swapping
  322.       · Use EMS : YES/NO, FUSL will dedect and use LIM EMS for swapping
  323.       · Path    : define path here for diskswapping if no or not enough
  324.                   LIM EMS memory available (slow!).
  325.  
  326.       FUSL will swap itself to disk/EMS when entering a dosshell or when
  327.       it is necessary to uncompress a filelist.
  328.  
  329.       Remaining code in memory will be 800 bytes in best case!!!
  330.  
  331.  
  332.  
  333.     REQUESTING WITH FUSL
  334.     ----------------------------------------------------------------------
  335.  
  336.     Ok, now let us talk about the main feature of FUSL. The requesting of
  337.     files:-)
  338.  
  339.     Select Request/Request List from the menu. After you selected
  340.     a filelist to request from, FUSL will uncompress it, if necessary.
  341.     If there were 2 or more files in the archive, FUSL will ask you again
  342.     for the filelist you want to look at.
  343.  
  344.     FUSL will display the filelist in a window. Here the you can use the
  345.     usual keys for moving in the file:
  346.  
  347.     PAGEUP    - page up       HOME        - beginning of file
  348.     PAGEDOWN  - page down     END         - end of file
  349.     CURSOR UP - scroll up     CURSOR DOWN - scroll down
  350.  
  351.     Any other key - except the F-keys listed below will caus a 'page-down'.
  352.  
  353.     At the bottom of the screen you will find a list of function keys
  354.     available:
  355.  
  356.     F1-Request F2-Search F3-Password F4-Req/Scan F5-Req/FullScan ESC-Exit
  357.  
  358.     F4 & F5 are available in the REGISTERED VERSION only!
  359.  
  360.     ■ F1  - tag files for requesting one or more files
  361.  
  362.     ■ F2  - scan the file for a string. FUSL will scan forward the
  363.             loaded file for 'searchstring'. You can easy 'research' by
  364.             pressing F2 again.
  365.  
  366.     ■ F3  - if a system requires a password to request use this.
  367.             e.g.: file select is  FUSL136.ZIP, defined password is
  368.                   'GRMMPF'. The request msg would read:
  369.                   FUSL120.ZIP !GRMMPF
  370.  
  371.     ■ F4  - scan the first filelist (number 0 in setup) for the file
  372.             which is tagged. In most cases this will be your own
  373.             filelist. So FUSL prevents you from requesting files you
  374.             allready have:-)
  375.             File extensions are ignored!
  376.  
  377.     ■ F5  - FUSL will scan all the filelists you have set up for the
  378.             tagged file. You can skip scanning the currently filelist
  379.             by pressing SPACE.
  380.             File extensions are ignored!
  381.  
  382.     ■ ESC - quit the filelist/requesting.
  383.  
  384.     Up to 40 files can be requested! FUSL will generate several messages
  385.     if necessary.
  386.  
  387.     If you press ESC and there are file(s) selected for requesting FUSL
  388.     will pop up another requester:
  389.  
  390.         ╒════════════════════════════[ Generate Request ]═╕
  391.         │                                                 │
  392.         │ Files: 2                                        │
  393.         │                                                 │
  394.         │ Bytes: 40028      Time at 9600:  0.33 min       │
  395.         │                                                 │
  396.         │ From Address: 1:105/7                           │
  397.         │ Sysop's Name: Dan Dimick                        │
  398.         │                                                 │
  399.         │ Edit / review files - [y,N]                     │
  400.         ╘═[ Filelist: DIMICK.TXT ]════════════════════════╛
  401.  
  402.  
  403.     If you have not defined the parameters of the system to request from
  404.     (menu Request/Get from) FUSL will ask here for these.
  405.  
  406.     When you want to edit/delete some files you requested press 'Y' at
  407.     the prompt...
  408.  
  409.     When you are ready to create the file-request, answer 'Y' or ENTER
  410.     at the 'Generate request message' prompt. If you press ESC you can
  411.     edit and/or change the message with EDIT/BUFFER.
  412.  
  413.     The EDIT/MESSAGE menu can be used to edit/change an allready created
  414.     request message. Press ENTER to edit message or DEL to delete
  415.     existing message.
  416.  
  417.     You can send a user defined msg with the file request. All
  418.     you need to do: generate a file called FUSL.MSG which has
  419.     to reside in the directory where FUSL.EXE can be found.
  420.  
  421.         e.g.:
  422.  
  423.         Dear %TOfirstNAME% !
  424.  
  425.         Thank you for allowing the file request!
  426.  
  427.                 %FROMfirstNAME% %FROMlastNAME, (%NODE%)
  428.  
  429.  
  430.         %TOfirstNAME%   = FIRST name of the sysop to receive
  431.         %TOlastNAME%    = LAST  name of the sysop to receive
  432.         %FROMfirstNAME% = Your FIRST name
  433.         %FROMlastNAME%  = Your LAST  name
  434.         %TONODE%        = Address of the system to request files from
  435.         %FROMNODE%      = Your address
  436.  
  437.     The generated request-message will have the following default
  438.     message attributes: PVT CRASH FILE REQ KILL
  439.  
  440.     Of course only as long as you didn't edit them with the menu
  441.     MSGSTATUS.
  442.  
  443.     After generating the message in your netmail directory, FUSL will
  444.     cause Frontdoor to rescan and accept your mail. If you have set up
  445.     Binkley as a mailer, FUSL will perform the 'rescan command' you
  446.     have to enter when selected Rescan - YES. eg.: QM PACK
  447.  
  448.  
  449.  
  450.     COMPARING FILELISTS WITH FUSL
  451.     ----------------------------------------------------------------------
  452.  
  453.     Select Request/Filelists to compare 2 filelistings. If these
  454.     filelistings contain different files, they will be shown on the
  455.     screen and a file 'differ.txt' will be generated in the current
  456.     working directory. After processing you are prompted to rename
  457.     'differ.txt'.
  458.  
  459.  
  460.  
  461.     THE CREDITS
  462.     ----------------------------------------------------------------------
  463.  
  464.     Many thanks to:
  465.  
  466.         ■ Robert for his ideas, bug reports and support!
  467.           Dan for BinkleyTerm betatesting and his support.
  468.  
  469.         ■ my glorious BETATESTEAM:
  470.  
  471.           Robert Maierhofer       2:310/19
  472.           Erich Jeckl             2:310/10.5
  473.           Dan Dimick              1:105/7
  474.           Werner Schlagnitweit    2:310/3
  475.  
  476.         ■ my girlfriend Maria, her tolerance for my hobby made this thing
  477.           possible!
  478.  
  479.  
  480.  
  481.     PRODUCT INFORMATION & ACKNOWLEDGEMENTS
  482.     ---------------------------------------------------------------------
  483.  
  484.     Microsoft C
  485.     CXL-library         Mike Smedley
  486.     Spawno30            Ralf Brown
  487.  
  488.     Frontdoor           Joaquim Homrighausen
  489.     BinkleyTerm
  490.     Qmail               Greg Dawson
  491.     Parselst            Bob Hartman
  492.     Golded              Odinn Sorensen
  493.     DESQview            Quarterdeck Office Systems
  494.  
  495.  
  496.  
  497.  
  498.     APPENDIX A - INPUT FIELD EDITING KEYS
  499.     ---------------------------------------------------------------------
  500.  
  501.           Key                  Action
  502.           ---                  ------
  503.         LeftArrow             cursor left
  504.         RightArrow            cursor right
  505.         UpArrow               cursor up
  506.         DownArrow             cursor down
  507.         Ctrl-LeftArrow        word left
  508.         Ctrl-RightArrow       word right
  509.         Tab                   field right
  510.         Shift-Tab             field left
  511.         Enter                 process field
  512.         Ctrl-Enter            process all fields
  513.         Decimal (.)           move to right side of decimal point
  514.         Home                  beginning of field
  515.         End                   end of field line / end of field
  516.         Ctrl-Home             beginning of first field
  517.         Ctrl-End              end of last field
  518.         Ins                   toggle field insert mode
  519.         Del                   delete character at cursor
  520.         BackSpace             delete character left
  521.         Ctrl-BackSpace        delete word left
  522.         Ctrl-R                restore field to original contents
  523.         Ctrl-T                delete word right
  524.         Ctrl-U                delete to end of field
  525.         Ctrl-Y                delete to end of last field
  526.         Esc                   abort data entry (if Escape checking is on)
  527.  
  528.