home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / w / wonder10.zip / WONDER.DOC < prev    next >
Text File  |  1993-03-13  |  63KB  |  1,355 lines

  1.  
  2.  
  3.  
  4.                               W o n d e r W h o
  5.                               -----------------
  6.  
  7.                                 Version 1.00
  8.                           Released March 12th, 1993
  9.  
  10.                   I  Wonder  Who  Transfered  That  File ?
  11.                   Shareware program door for PCBoard v14.x
  12.  
  13.          Copyright (C) 1993 by José De Almeida. All Rights Reserved.
  14.                  P.O.Box 4185. 1504 Lisboa Codex. Portugal.
  15.  
  16.  
  17.  
  18.                               --- OVERVIEW ---
  19.  
  20.  
  21.  
  22.   Thank you for giving a try to  WonderWho door. I strongly hope this software
  23.   pleases you to use, as it pleased  me to develop. You won't regret your most
  24.   valuable time giving it a try, I'm sure !
  25.  
  26.   WonderWho is  a PCBoard v14.x (or  higher) door. There are  two (that I know
  27.   of)  similar doors  to WonderWho:  ProWho and  Origin. WonderWho  is not  an
  28.   enhanced release of  either those two first generation doors.  It is a brand
  29.   new second and  latest generation concept for "I  Wonder Who Transfered That
  30.   File?" door. The concept stands for tranfers, not only limited to uploads or
  31.   downloads.
  32.  
  33.   It  provides 38  online rich  menu  commands.  Users can  search trough  the
  34.   Bulletin Board  System transfer log file  (usually named DOWNLOAD.TXT) using
  35.   30 different,  specific and powerful commands.  WonderWho provides different
  36.   commands for  uploaded, downloaded and both  entries in a separated  way (10
  37.   online  commands for  each case).  Users can  search for specific usernames,
  38.   filenames, dates, protocols, average CPS, errors. For files transfered since
  39.   a  specific date.  Raw searches   (enhanced ProWho  style). Verbose  list of
  40.   transfers, and count transfer entries. Output data is column formatted.
  41.  
  42.   Users can, in most search commands, specify  up to 10 search patterns at the
  43.   same time! It runs fast and it's extremely easy to use !
  44.  
  45.   WonderWho implements enhanced statistics. After each search is performed, it
  46.   displays  to the  user almost  an entire  screen of  interesting statistics.
  47.   Entries scanned,  entries found, total uploaded  and downloaded files, older
  48.   and newer  filedate and name, worst,  best and average number  of errors and
  49.   CPS, etc, etc.
  50.  
  51.   That's what your users get. Now, about what you, SysOp, get.
  52.  
  53.   WonderWho its as  easy to install as a  door can be. It really  have a "plug
  54.   and play" configuration  (as every door should be). The  only thing you need
  55.   to configure  is the door batch  file. One single line,  two parameters. And
  56.   that's all!
  57.  
  58.   WonderWho supports multi-node  systems. Depending on the way  you do things,
  59.   you need just  one door batch file in  the server node. The same  door batch
  60.   file can work for all nodes.
  61.  
  62.   WonderWho  supports multi-language  for  almost  everything. It  follows the
  63.   PCBoard rules.  Display files, such as  Welcome, News, Main Menu,  Quit, all
  64.   Help files, etc. You can have one file for each language if you want. And if
  65.   you don't, WonderWho will work fine with its default and original files.
  66.  
  67.   WonderWho supports  multi-node configuration. In the  configuration file you
  68.   will find dozens of powerful  options. You can specify filenames, individual
  69.   security levels for  each command, command names, etc,  etc. You can specify
  70.   global options or language specific options for all commands and things.
  71.  
  72.   But  only if  you want  to. Furthermore,  originally, all  those options are
  73.   disabled (I repeat: DISABLED) in  the door and language configuration files!
  74.   And WonderWho works  100% fine this way! But if  you want, WonderWho permits
  75.   you to configure almost anything you  want in lots of different ways. Global
  76.   configurations and language configurations mixed together. You simply ENABLE
  77.   the  options,  and  set  them  to  what  best  suits  you. Then you will get
  78.   virtually full control of WonderWho. Nothing could be more simple than this.
  79.  
  80.   WonderWho also  provides all the  SysOp functions. You  can test it  locally
  81.   (outside of PCBoard environment). You get  built-in chat, DOS shell, and all
  82.   the other conventional SysOp hot-keys.
  83.  
  84.   WonderWho is a fully functional Shareware program. Nothing is crippled.
  85.  
  86.   And more, more, more, more things, lots of things !
  87.  
  88.  
  89.  
  90.                           --- COPYRIGHT NOTICE ---
  91.  
  92.  
  93.  
  94.   WonderWho is Copyright (C) 1993 by José De Almeida.
  95.  
  96.   WonderWho, its accompanying documentation, and all other files that are part
  97.   of the package,  have been released as Shareware. It  is NOT a public domain
  98.   or freeware program.
  99.  
  100.   No part of WonderWho may be  modified, altered, reverse engineered, sold, or
  101.   distributed in any form which would involve some sort of trade without prior
  102.   written permission from the Author.
  103.  
  104.  
  105.  
  106.                              --- DISCLAIMER ---
  107.  
  108.  
  109.  
  110.   This program is provided "as is" without warranty of any kind.
  111.  
  112.   In addition, the Author specifically  disclaims all warranties, expressed or
  113.   implied, including but not limited  to implied warranties of merchantability
  114.   and fitness for a particular purpose and WonderWho license granted herein in
  115.   particular, and  without limiting operation  of WonderWho gram  license with
  116.   respect to any particular application, use, or purpose.
  117.  
  118.   In no event shall the Author be liable for any loss of profit, lost savings,
  119.   commercial damage, or other incidental  or consequential damages arising out
  120.   of  the use  or inability  to use   WonderWho even  if the  Author, José  De
  121.   Almeida, or an  authorized distributor of WonderWho has  been advised of the
  122.   possibility of such damages, or for any claim by any other party.
  123.  
  124.  
  125.  
  126.                                --- LICENSE ---
  127.  
  128.  
  129.  
  130.   SysOps  are granted  a limited  license  to  use WonderWho,  as a  Shareware
  131.   product. This gives you the chance to  try WonderWho for a 30 day evaluation
  132.   period.  If  you  continue  to  use  WonderWho  beyond  this period, you are
  133.   required to register.
  134.  
  135.   Information  on  becoming  a  registered  user  of  WonderWho  can  be found
  136.   elsewhere in this file.
  137.  
  138.   All  users are  granted a  limited license  to copy  WonderWho only  for the
  139.   purpose of allowing others to evaluate it, subject to the above restrictions
  140.   as well as these:
  141.  
  142.       ■ WonderWho must be distributed in an unmodified form, including all the
  143.         files listed in the documentation.
  144.  
  145.         Particularly,  SysOps  MUST  keep  inside  the  archive  the  original
  146.         FILE_ID.DIZ description file, as it is distributed by the Author. This
  147.         will give BBS users the correct  and same good description for all BBS
  148.         users over the world.
  149.  
  150.       ■ WonderWho  may not be included  with any other product  for any reason
  151.         whatsoever without prior written consent from José De Almeida.
  152.  
  153.       ■ No charge or payment may be accepted for WonderWho.
  154.  
  155.   Bulletin  Board  System  Operators  may  post  WonderWho  on  their  BBS for
  156.   downloading  by their  users without  written permission,  only if the above
  157.   conditions  are met,  and only  if  no  special fee  is necessary  to access
  158.   WonderWho files (a general fee to  access the BBS is acceptable).
  159.  
  160.   Distributors  of Shareware  and Public  Domain software  MUST obtain written
  161.   permission  from  José  De  Almeida  before  distributing WonderWho and must
  162.   follow  the  above  conditions.  Permission  is  almost always granted; this
  163.   requirement is  necessary to ensure protection  for the Author and  users of
  164.   WonderWho from unscrupulous individuals.
  165.  
  166.  
  167.  
  168.                        --- REGISTRATION / ORDERING ---
  169.  
  170.  
  171.  
  172.   Registering  the WonderWho  allows you  to use  the product  after the trial
  173.   period.  A  limited  support  is   available  to  unregistered  users.  Most
  174.   importantly,  registered  users  know  they  are  helping  to make sure that
  175.   high-quality Shareware like WonderWho continues to be offered at low cost.
  176.  
  177.   Here it is the registration prices and methods for WonderWho:
  178.  
  179.       ■ Registration,  includes  one 3.5"  low density  diskette (720 KBytes),
  180.         containing a  registered copy (latest  release) of WonderWho,  send by
  181.         mail.
  182.  
  183.             Price: US $20 (or 3,000$00 if inside Portugal)
  184.  
  185.             Notes: This is the normal method. Will take a week or so.
  186.                    But,  since  SkyShip  BBS,  the  wordwide  support  BBS for
  187.                    WonderWho, located in Lisbon, Portugal,  is a member of the
  188.                    RIME  Network,  you  can  also  receive,  if you wish, your
  189.                    registration through  the network as well.  Just state what
  190.                    your RIME#  is in the  ORDER.FRM, and the  SysOp of SkyShip
  191.                    BBS  will  send  the  registration  to  you  as soon as the
  192.                    payment is received. It takes only a single day.
  193.  
  194.       ■ Registration,  includes  one 3.5"  low density  diskette (720 KBytes),
  195.         containing a  registered copy (latest  release) of WonderWho,  send by
  196.         DHL express mail service.
  197.  
  198.             Price: US $80 (available for United States of America only)
  199.  
  200.             Notes: This is the express method. It will take 2 days or so.
  201.  
  202.   Payment may  be only in  the form of  check. The register  is valid for  all
  203.   future releases of WonderWho.
  204.  
  205.   Unfortunately, in  Portugal we still are  very limited in the  use of credit
  206.   cards,  such as  VISA. For  the moment,  it is  not possible  to accept VISA
  207.   payments  in any  Bulletin Board  Systems, like  the SkyShip  BBS where  the
  208.   program receives its worldwide support.  So, in Portugal we cannot implement
  209.   Credit Card doors to assist users in order to quickly pay Shareware programs.
  210.   That is a pity, but this is how things are right now.
  211.  
  212.   Once registered, WonderWho no  longer displays the '(unregistered)' message,
  213.   and no longer delays for 15 seconds after a user quits the door.
  214.  
  215.   So, to  place an order, you  must print and fill  an order form on  the file
  216.   ORDER.FRM. Please remember that, besides  other things, you MUST specify the
  217.   name to which  door is registered. That is, the  name WonderWho will display
  218.   to the user when he/she quits the  door or enter the [VER]sion command. This
  219.   name is limited to 32 case-sensitive  characters, and MUST be the EXACT name
  220.   as  is specifyed  in PCBOARD.DAT  line #94  (your board's  name). Be careful
  221.   about this, otherwise door will remain un-registered.
  222.  
  223.  
  224.  
  225.                           --- CUSTOMER SUPPORT ---
  226.  
  227.  
  228.  
  229.   Full support to users of WonderWho  is available through two major channels.
  230.   If  you wish  contact the  Author with  questions, suggestions, problems, or
  231.   other comments:
  232.  
  233.       ■ Call the WonderWho's worldwide support Bulletin Board System:
  234.  
  235.             SKYSHIP BBS
  236.             ----------------------
  237.             SysOp : Mario Pozzetti
  238.  
  239.             Node #1: 351-1-3527623 * 24h
  240.                      USR HST Dual Standard V32Bis * 2400-16,800
  241.             Node #2: 351-1-3151435 * 24h
  242.                      USR HST Dual Standard V32Bis * 2400-14,400
  243.             Node #3: 351-1-3151436 * 24h
  244.                      USR HST V42Bis * 1200-14,400
  245.  
  246.         Here I can be reached in the following conferences:
  247.  
  248.             (LOCAL): SUPPORT
  249.             RIME   : PCBSUPPORT
  250.                      PCBHINTS
  251.             INTELEC: BBSDOORS
  252.  
  253.       ■ Call the Portugal co-support Bulletin Board System:
  254.  
  255.             THE IMAGE BANK BBS
  256.             -------------------
  257.             SysOp: Jose Almeida
  258.  
  259.             Node #1: 351-1-7786640 * 20-24h (Tue & Thu 20-01:30h)
  260.                      Intel SatisFAXtion Modem /400e * 1200-14,400
  261.  
  262.                      P.O.Box 4185.  1504 Lisboa Codex.  Portugal.
  263.  
  264.         Here I can be reached in the following conference:
  265.  
  266.             (LOCAL): WONDERWHO
  267.  
  268.   The  Author offers  limited support  to unregistered  users of WonderWho, in
  269.   order to  help them get  WonderWho installed for  evaluation. If you  have a
  270.   problem  installing  or  using  WonderWho,  and  you  have  read this entire
  271.   documentation  and HISTORY.DOC  file (please  do read  it before  requesting
  272.   help; usually many problems can be cleared  up by finding the answer in it),
  273.   then feel free to request help through any of the channels mentioned above.
  274.  
  275.   The Author  of WonderWho will make  an attempt to answer  all mail received,
  276.   but please be aware that registered users have first priority for support.
  277.  
  278.  
  279.  
  280.                            --- FILES INCLUDED ---
  281.  
  282.  
  283.  
  284.   The WonderWho is distributed in a archive ZIP file. Please do not change the
  285.   archive  contents or  add any  file. The  archive name  is WONDER10.ZIP, and
  286.   contains the following files:
  287.  
  288.       ■ WONDER.EXE   - Door program
  289.       ■ WONDER.DOC   - SysOp's manual (this file you are reading)
  290.       ■ HISTORY.DOC  - Version history
  291.       ■ LICENSE.DOC  - License agreement
  292.       ■ ORDER.FRM    - Order form (to register the door)
  293.       ■ FILE_ID.DIZ  - Description  file  for  PCBoard  systems (please do not
  294.                        delete  or change  this  file;  this file  provides the
  295.                        Author's description of the archive)
  296.       ■ WONDER       - Sample PCBoard door script file.
  297.       ■ WONDER.CFG   - Door configuration file.
  298.       ■ WW_LANG      - Door language configuration file.
  299.       ■ WW_TEST.BAT  - Sample door local test batch file.
  300.       ■ $DOOR.ERR    - Sample door log error file.
  301.       ■ WW_WELC      - Default door Welcome file.
  302.       ■ WW_NEWS      - Default door News file.
  303.       ■ WW_MENU      - Default door Menu file.
  304.       ■ WW_QUIT      - Default door Quit file.
  305.       ■ WW_H_AA      - Default door help for command All: Average CPS.
  306.       ■ WW_H_AC      - Default door help for command All: Count.
  307.       ■ WW_H_AD      - Default door help for command All: Date.
  308.       ■ WW_H_AE      - Default door help for command All: Errors.
  309.       ■ WW_H_AF      - Default door help for command All: File.
  310.       ■ WW_H_AP      - Default door help for command All: Protocol.
  311.       ■ WW_H_AR      - Default door help for command All: Raw.
  312.       ■ WW_H_AS      - Default door help for command All: Since date.
  313.       ■ WW_H_AU      - Default door help for command All: Username.
  314.       ■ WW_H_AV      - Default door help for command All: Verbose.
  315.       ■ WW_H_DA      - Default door help for command Downloads: Average cps.
  316.       ■ WW_H_DC      - Default door help for command Downloads: Count.
  317.       ■ WW_H_DD      - Default door help for command Downloads: Date.
  318.       ■ WW_H_DE      - Default door help for command Downloads: Errors.
  319.       ■ WW_H_DF      - Default door help for command Downloads: File.
  320.       ■ WW_H_DP      - Default door help for command Downloads: Protocol.
  321.       ■ WW_H_DR      - Default door help for command Downloads: Raw.
  322.       ■ WW_H_DS      - Default door help for command Downloads: Since date.
  323.       ■ WW_H_DU      - Default door help for command Downloads: Username.
  324.       ■ WW_H_DV      - Default door help for command Downloads: Verbose.
  325.       ■ WW_H_G       - Default door help for command Goodbye.
  326.       ■ WW_H_H       - Default door help for command Help.
  327.       ■ WW_H_M       - Default door help for command Mode graphics.
  328.       ■ WW_H_PRO     - Default door help for command PROfile.
  329.       ■ WW_H_Q       - Default door help for command Quit.
  330.       ■ WW_H_UA      - Default door help for command Uploads: Average cps.
  331.       ■ WW_H_UC      - Default door help for command Uploads: Count.
  332.       ■ WW_H_UD      - Default door help for command Uploads: Date.
  333.       ■ WW_H_UE      - Default door help for command Uploads: Errors.
  334.       ■ WW_H_UF      - Default door help for command Uploads: File.
  335.       ■ WW_H_UP      - Default door help for command Uploads: Protocol.
  336.       ■ WW_H_UR      - Default door help for command Uploads: Raw.
  337.       ■ WW_H_US      - Default door help for command Uploads: Since date.
  338.       ■ WW_H_UU      - Default door help for command Uploads: Username.
  339.       ■ WW_H_UV      - Default door help for command Uploads: Verbose.
  340.       ■ WW_H_VER     - Default door help for command VERsion information.
  341.       ■ WW_H_WHO     - Default door help for command WHO is on?.
  342.       ■ WW_H_X       - Default door help for command eXpert mode.
  343.       ■ TD_FILES.ZIP - Original default display files in TheDraw v4.51 format.
  344.                        Includes Welcome, News, Menu  and Quit screen files, as
  345.                        well as all the Help files.
  346.  
  347.  
  348.  
  349.                            --- VERSION HISTORY ---
  350.  
  351.  
  352.  
  353.   Please read the HISTORY.DOC file where all updates to the WonderWho door are
  354.   described in detail.
  355.  
  356.  
  357.  
  358.                  --- SYSTEM REQUIREMENTS & COMPATIBILITY ---
  359.  
  360.  
  361.  
  362.   WonderWho requires PCBoard version 14.x (as many nodes as you want) in order
  363.   to  work properly.  Off course,  I can't  guarantee this  current version of
  364.   WonderWho runs on later versions of PCBoard other than 14.x, but it probably
  365.   will.  But, this  is not  an  important  matter, because  if any  changes of
  366.   PCBoard are made in the upcoming future, WonderWho will follow those changes
  367.   in future updates.
  368.  
  369.   Other requirements:
  370.  
  371.       ■ MS-DOS v3.3 or later
  372.       ■ IBM AT 286 or higher
  373.  
  374.   WonderWho requires about 191 KBytes of RAM in order to work.
  375.  
  376.  
  377.  
  378.                             --- INSTALLATION ---
  379.  
  380.  
  381.  
  382.   Installing WonderWho in  you system is a very  simple procedure. It probably
  383.   takes less than 5 minutes, including tests. Install WonderWho as you usually
  384.   install any  other PCBoard door. But,  let me describe all  the installation
  385.   procedures in short steps.
  386.  
  387.   Let me assume that your PCBoard home directory is C:\PCB.
  388.  
  389.  
  390.       1. Create a directory to put all the door files. For instance:
  391.  
  392.              C:\WONDER
  393.  
  394.       2. Extract the WonderWho ZIP archive to a directory. All files.
  395.  
  396.       3. Edit the WONDER. file. This is the PCBoard door batch file to run the
  397.          door. An ASCII text file. Here you must specify the door path for the
  398.          EXE  program,  the  door  path  for  its  configuration file, and the
  399.          PCboard directory. Here is an example of the batch file contents:
  400.  
  401.              @ECHO OFF
  402.              C:\WONDER\WONDER.EXE C:\WONDER\WONDER.CFG %PCBDRIVE%%PCBDIR%
  403.              ┌──────────────────┤ ┌──────────────────┤ ┌────┤
  404.              │                    │                    │
  405.              │                    │                    │
  406.              Location of          Location of door     Location of PCBoard
  407.              door EXE program     configuration file   node directory (you
  408.                                   (where all the rest  may use those two
  409.                                   of the door files    PCBoard's environment
  410.                                   should be located)   sets, if you wish)
  411.  
  412.          NOTE: If, and  only if, in PCSetup, you use  the Shell to door option
  413.                set to  N, then you  must add  another  line at the  end of the
  414.                file. You must call BOARD.BAT again in order to reload PCBoard.
  415.                Like this:
  416.  
  417.                    @ECHO OFF
  418.                    C:\WONDER\WONDER.EXE C:\WONDER\WONDER.CFG %PCBDRIVE%%PCBDIR%
  419.                    BOARD.BAT
  420.  
  421.          If you run  a multinode system, it is possible  to have just one door
  422.          batch file shared by all nodes. Simply use, as you may see above, the
  423.          following expression (only in PCBoard v14.5a or later):
  424.  
  425.              %PCBDRIVE%%PCBDIR%
  426.  
  427.          instead  of  specifying  the  PCBoard  node  directory as C:\PCB, for
  428.          instance. But if you really specify C:\PCB instead od the environment
  429.          sets, then you must have one door  batch file for each node, which is
  430.          not necessary at all.
  431.  
  432.          This really doesn't matter for  WonderWho itself. Depends only on the
  433.          way you have  things done, and the way  you like to do things.  But I
  434.          want you to do things right and easy.
  435.  
  436.          NOTE:  WonderWho never,  ever, changes  the directory.  So, you don't
  437.                 need, in the door batch  file, to change the current directory
  438.                 from the  PCboard node directory  to the WonderWho  directory,
  439.                 and then back before returning to PCBoard.
  440.  
  441.       4. You do not need to edit or make any changes to the door configuration
  442.          file WONDER.CFG  or to the door  language specific configuration file
  443.          WW_LANG. Only option listed in line  #1 of WONDER.CFG is working. All
  444.          other  options are  (indeed) disabled,  because they  are the same as
  445.          WonderWho defaults.
  446.  
  447.          It is  plug and play, and  everything should work 100%  fine. So, you
  448.          don't have  to care about this  for the moment, and  leave both files
  449.          unchanged. I will explain these files later in this file.
  450.  
  451.       5. Run the PCboard's PCSetup program. You need to add the WonderWho door
  452.          to the door list. Go to the Main Board Configuration screen, and edit
  453.          the DOORS file. Here is an example:
  454.  
  455.                                            USER DOOR
  456.             Filename   Password  Sec Login SYS  SYS  Shell Path to DOOR files
  457.            ══════════ ══════════ ═══ ═════ ════ ════ ═════ ═══════════════════
  458.           1) WONDER               10   N    N    N     Y   C:\WONDER
  459.  
  460.          WonderWho requires about 191 KBytes of RAM. So, you can run WonderWho
  461.          using any of the Shell options  PCBoard lets you specify. Even if you
  462.          specify the Y option, which means  'Yes, shell out to the DOOR (gives
  463.          faster  return from  door)', WonderWho  will run  fine, and about 140
  464.          KBytes of RAM will still be available.
  465.  
  466.          So, it's up to you. WonderWho works fine in either way.
  467.  
  468.       6. Edit the  WW_TEST.BAT batch file. This is the  local test batch file.
  469.          This means you can test WonderWho outside PCBoard. Here is an example
  470.          of the file contents:
  471.  
  472.              @ECHO OFF
  473.              WONDER WONDER.CFG C:\PCB LOCAL
  474.  
  475.          This assumes that you are running  this batch file from the WonderWho
  476.          directory.  The LOCAL  parameter (which  must be  in uppercase) tells
  477.          WonderWho that you are testing the door locally.
  478.  
  479.       7. Run the WW_TEST.BAT batch file. You are about to perform a local test
  480.          to the  door, outside PCBoard. Find  out if everything runs  fine, by
  481.          entering  several  commands.  It  will  be  ok,  unless  you make any
  482.          mistakes anywhere.
  483.  
  484.       8. Now, run PCBoard and test WonderWho locally but inside PCBoard. If it
  485.          runs fine, then you are in business (and I think you will).
  486.  
  487.   And that's all !!!
  488.  
  489.   Didn't I say that you would take less than 5 minutes ? ;)
  490.  
  491.  
  492.  
  493.                        --- MULTI-LANGUAGE SUPPORT ---
  494.  
  495.  
  496.  
  497.   WonderWho fully supports multi-language following PCBoard rules for files.
  498.  
  499.   You may have one set of files for each language you use in your BBS. Here it
  500.   is  a list  of the  files of  a language  set, that  WonderWho implements in
  501.   multi-language support:
  502.  
  503.       ■ WW_LANG      - Door language configuration file.
  504.       ■ WW_WELC      - Default door Welcome file.
  505.       ■ WW_NEWS      - Default door News file.
  506.       ■ WW_MENU      - Default door Menu file.
  507.       ■ WW_QUIT      - Default door Quit file.
  508.       ■ WW_H_*       - Default door help files for all commands.
  509.  
  510.   At the present, the WonderWho package only provides one default set of files
  511.   for the English language.
  512.  
  513.   WonderWho reads information  about the current language used  by a user from
  514.   PCBoard's PCBOARD.DAT configuration file. Your default language set of files
  515.   must not have extension names (as  in all PCBoard files). All other language
  516.   sets  of files  must have  an extension  name, accordingly  to what you have
  517.   defined in the  PCBML.DAT multi-language file which lists  all the languages
  518.   available in your system.
  519.  
  520.   Let  me explain  some situations  in order  to you  understand how WonderWho
  521.   works in this matter.
  522.  
  523.   Suppose your default language is English. So, files referring to the English
  524.   language must  not have any extension  names. Suppose you also  have another
  525.   language available in your system: for example, French. And you defined that
  526.   french files have .FRE extension names.
  527.  
  528.   Now, a user logs on in your  BBS and selects your system's default language,
  529.   which  is English.  WonderWho finds  no  problem.  It will  use the  package
  530.   bundled files, which are the english set of files, without extension names.
  531.  
  532.   Suppose the user  is a frenchman, and selects its  native language, which is
  533.   french :). And  you did create all the  French set of files, which  have the
  534.   .FRE extension name.  WonderWho will use all the .FRE  files, instead of the
  535.   default set of files without any extension name.
  536.  
  537.   Suppose you  have not created  the French set  of files. Well,  in this case
  538.   WonderWho will always try to first locate the .FRE files. Because it doesn't
  539.   find the .FRE files,  it will then try to use the  default set of files, the
  540.   ones without extension name. So, you have no problem.
  541.  
  542.   Even if  you have lots  of languages  defined  in PCBoard you  don't need to
  543.   create any  set of files for  those languages. WonderWho will  work fine and
  544.   use the default set of files: English.
  545.  
  546.   Suppose you have  created part of the French  set of files. Let me  say that
  547.   you only have  created the Welcome, News, Main Menu  and Quit files, but you
  548.   didn't  create the  French Help  files, because  it takes  a lot  of time to
  549.   translate them.  WonderWho will have no  problem with this. It  will use the
  550.   .FRE files which are available, and  will use the default English files when
  551.   it doesn't find the according .FRE file.
  552.  
  553.   If some  SysOp translates a complete  set of files for  a specific language,
  554.   please upload these  files to SkyShip BBS, or  send them to me by  mail in a
  555.   diskette. I will appreciate very much your attention, and will include these
  556.   files in the next version of WonderWho.
  557.  
  558.  
  559.  
  560.                        --- CHANGING DISPLAY FILES ---
  561.  
  562.  
  563.  
  564.   The  WonderWho  package  provides  all  the  original  files for the English
  565.   language  set.  That  is,  besides  including  the  files  that are actually
  566.   displayed by  the door to the  user, and which are  @X PCBoard's color coded
  567.   files (not ANSI), the package also  includes the original TheDraw files used
  568.   in order to create the final files which are displayed to the user.
  569.  
  570.   You should not use ANSI files.  In WonderWho, the ProKit routines, which are
  571.   responsible for displaying  the files, don't support ANSI  files when not in
  572.   color mode. So display files must always be @X color coded files.
  573.  
  574.   TheDraw is the best program ever made to design text screens. It's very easy
  575.   to use, yet quite powerful. I  designed all the WonderWho display files with
  576.   it.  TheDraw uses  its own  file format  (but it  can save  in several  file
  577.   formats,  including ANSI,  .COM, etc),  which usually  have a  .TD extension
  578.   name. That's what you will find in the TD_FILES.ZIP archive bundled with the
  579.   WonderWho package.
  580.  
  581.   So,  if you  want to  change the  display files,  I advise  you to  edit the
  582.   original files in TheDraw. After make the changes you want, first you should
  583.   save the TheDraw file in order to update.
  584.  
  585.   You can use the  latest version of TheDraw (v4.60) in order  to save all the
  586.   files you create or change in the @X color coded format.
  587.  
  588.  
  589.  
  590.                                --- MACROS ---
  591.  
  592.  
  593.  
  594.    WonderWho supports 'macros'  in all the files that can  be displayed to the
  595.    user. Here it is a list of all the macros (in alphabetical order):
  596.  
  597.  
  598.        MACRO NAME           DESCRIPTION
  599.        ----------           ------------
  600.        $@$            - File list pathname for dsz
  601.        $B$            - Modem open baud rate
  602.        $BLUE$         - Blue color
  603.        $C$            - Connect bps
  604.        $CLREOL$       - Clear to end of line
  605.        $CONF$         - Conference number with mail waiting
  606.        $CONFNUM$      - Current conference number
  607.        $CYAN$         - Cyan color
  608.        $DEFAULT$      - The default color
  609.        $DISP-fname$   - Display specified text file
  610.        $FIRST$        - Caller's first name
  611.        $HELPFILE$     - Interpret remainder of file as multi-topic HELP file
  612.        $GRAY$         - Gray color
  613.        $GREEN$        - Green color
  614.        $IFMEMBER-nn$  - YES or NO is the caller member of specified conf no.
  615.        $LASTMSGNO$    - Higher message number
  616.        $MAGENTA$      - Magenta color
  617.        $MAIL$         - Mail file name
  618.        $MSGCOUNT$     - Active message count
  619.        $N$            - Port number 0=local, 1..4
  620.        $NAME$         - Caller's full name =- @USER@
  621.        $NO$           - Literally "NO"
  622.        $NODE$         - Current node number
  623.        $NOMACS$       - Disable macros for remainder of display
  624.        $NONSTOP$      - Display the rest of the file non-stop
  625.        $PLAY$         - Playpen directory
  626.        $R$            - Result filename for batches
  627.        $RED$          - Red color
  628.        $SCRATCH$      - Scratch file name
  629.        $SYSOP$        - Sysop name
  630.        $TIME$         - Minutes left
  631.        $WHITE$        - White color
  632.        $YELLOW$       - Yellow color
  633.        $YES$          - Literally "YES"
  634.        @BEEP@         - Speaker beep, control-g
  635.        @BOARDNAME@    - The name of your BBS
  636.        @BPS@          - Estimated connect bps
  637.        @BYTELIMIT@    - Bytes allowed from PWRD file
  638.        @BYTESLEFT@    - Remaining bytes available for download for that day
  639.        @CITY@         - City and state of caller (all caps)
  640.        @CLS@          - Clear screen
  641.        @DATAPHONE@    - Caller's business/data phone number
  642.        @DAYBYTES@     - Bytes downloaded so far that day
  643.        @DLBYTES@      - Total bytes downloaded - all calls
  644.        @DLFILES@      - Total files downloaded - all calls
  645.        @EVENT@        - Time of next scheduled event
  646.        @EXPDATE@      - Subscription expiration date
  647.        @FIRST@        - First name of the user (first letter capitalized)
  648.        @HOMEPHONE@    - Caller voice phone number
  649.        @INCONF@       - Conference the caller is currently in
  650.        @LASTDATEON@   - Last date on (mm-dd-yy format)
  651.        @LASTTIMEON@   - Last time on (hh:mm format)
  652.        @MORE@         - Forces a "MORE" prompt
  653.        @NUMCALLS@     - Total number of callers in system
  654.        @NUMTIMESON@   - Number of times on system
  655.        @SECURITY@     - Users current security level including conf. add.
  656.        @SYSDATE@      - Host date in (mm-dd-yy format)
  657.        @SYSTIME@      - Host system in (hh:mm format)
  658.        @TIMELEFT@     - Time remaining that call incl. all credits, etc.
  659.        @TIMELIMIT@    - Time allowed from PWRD file
  660.        @TIMEUSED@     - Minutes used since logon
  661.        @UPBYTES@      - Total bytes uploaded - all calls
  662.        @UPFILES@      - Total files uploaded - all calls
  663.        @USER@         - Complete name of the caller (first & last - all caps)
  664.        @WAIT@         - Force a "press enter to continue" prompt
  665.        @X             - Pcboard 14.5 compatible colored codes
  666.  
  667.  
  668.  
  669.                          --- CONFIGURATION FILE ---
  670.  
  671.  
  672.  
  673.   WonderWho is very easy to install and  configure, as I already said, and you
  674.   already noticed.
  675.  
  676.   Nevertheless, if after you installed the  door in your system, you feel that
  677.   the  default configuration  seems to  run the  door ok,  and if it perfectly
  678.   suits your needs, you  don't have do to anything else. This  is what I think
  679.   it will probably happen. And if it does,  well, I may say that I made things
  680.   the way it  should be. So, forget the configuration  file, you don't need to
  681.   make any changes.
  682.  
  683.   But, on the other hand, if it doesn't  seem to be fine (which will be rather
  684.   strange), or if the default configuration  doesn't suit your needs, then you
  685.   must make some changes.
  686.  
  687.   Changing  the  configuration  file  it's  an  easy  task.  You will do it in
  688.   seconds. The  default configuration file bundled  with the WonderWho package
  689.   is named WONDER.CFG. The configuration filename  can have any name you want,
  690.   as long as permitted by MS-DOS. For  a list of valid filenames, please refer
  691.   to your MS-DOS User's Guide.
  692.  
  693.   You  can even  have one  configuration file  for each  node, but,  as I said
  694.   before, it is  not necessary (but it can  be done). And if you  just want to
  695.   have one configuration file (as you  probably will), simply follow the rules
  696.   mentioned above in the Installation chapter.
  697.  
  698.   But,  if you  wish to  have a  different configuration  file for  each node,
  699.   proceed as follows, but be aware that  things can be done in other ways than
  700.   the one I will describe in the next two steps.
  701.  
  702.       1. Re-edit the  door batch file, by default named  WONDER. Here it is an
  703.          example of what the contents should be:
  704.  
  705.              @ECHO OFF
  706.              C:\WONDER\WONDER.EXE C:\WONDER\WONDER.%PCBNODE% %PCBDRIVE%%PCBDIR%
  707.  
  708.          In this  examples, all the  configuration files will  have the WONDER
  709.          filename, but there  will be different file extension  names for each
  710.          node. For instance:
  711.  
  712.              WONDER.1
  713.              WONDER.2
  714.              ...
  715.              WONDER.999
  716.  
  717.          But this requires only one door batch file, because this example uses
  718.          the  PCBoard  environment  set  (created  by  PCBoard  itself)  named
  719.          %PCBNODE%. So MS-DOS  will replace that variable for  the proper node
  720.          number, and  WonderWho will read  the correct configuration  file for
  721.          each specific node.
  722.  
  723.       2. Create  all the WonderWho configuration  files for all the  nodes you
  724.          have  installed in  your system.  Leave all  these files  in the same
  725.          directory where you store all other WonderWho files. Just that!
  726.  
  727.   WonderWho provides you  dozens of door options that  you can set accordingly
  728.   to  your  specific  needs.  Here  it  is  a  list  of  all options WonderWho
  729.   recognizes in the configuration file, as well as a short description of each
  730.   option:
  731.  
  732.       ■ INTERRUPT | BIOS   - Communications driver type (only in line #1)
  733.  
  734.       ■ DLD_DIR=           - Transfer filepath, name and extension
  735.       ■ LANG_FILE=         - Language filename
  736.  
  737.       ■ WELCOME_FILE=      - Welcome filename
  738.       ■ NEWS_FILE=         - News filename
  739.       ■ NEWS_LIMIT=        - News file date limit
  740.       ■ MENU_FILE=         - Menu filename
  741.       ■ QUIT_FILE=         - Quit filename
  742.  
  743.       ■ LOGOFF=            - Logoff
  744.       ■ CALLER_LOG=        - Caller's log
  745.  
  746.       ■ OP_LEVEL_X=        - Expert mode
  747.       ■ OP_LEVEL_M=        - Mode (color/mono)
  748.       ■ OP_LEVEL_H=        - Help
  749.       ■ OP_LEVEL_G=        - Goodbye
  750.       ■ OP_LEVEL_PRO=      - Profile user
  751.       ■ OP_LEVEL_WHO=      - Who is on?
  752.  
  753.       ■ OP_LEVEL_UU=       - Uploads: user name
  754.       ■ OP_LEVEL_UF=       - Uploads: file name
  755.       ■ OP_LEVEL_UD=       - Uploads: date
  756.       ■ OP_LEVEL_US=       - Uploads: since date
  757.       ■ OP_LEVEL_UP=       - Uploads: protocol letters
  758.       ■ OP_LEVEL_UE=       - Uploads: transfer errors
  759.       ■ OP_LEVEL_UA=       - Uploads: average CPS
  760.       ■ OP_LEVEL_UR=       - Uploads: raw
  761.       ■ OP_LEVEL_UV=       - Uploads: verbose
  762.       ■ OP_LEVEL_UC=       - Uploads: count
  763.  
  764.       ■ OP_LEVEL_DU=       - Downloads: user name
  765.       ■ OP_LEVEL_DF=       - Downloads: file name
  766.       ■ OP_LEVEL_DD=       - Downloads: date
  767.       ■ OP_LEVEL_DS=       - Downloads: since date
  768.       ■ OP_LEVEL_DP=       - Downloads: protocol letters
  769.       ■ OP_LEVEL_DE=       - Downloads: transfer errors
  770.       ■ OP_LEVEL_DA=       - Downloads: average CPS
  771.       ■ OP_LEVEL_DR=       - Downloads: raw
  772.       ■ OP_LEVEL_DV=       - Downloads: verbose
  773.       ■ OP_LEVEL_DC=       - Downloads: count
  774.  
  775.       ■ OP_LEVEL_AU=       - All: user name
  776.       ■ OP_LEVEL_AF=       - All: file name
  777.       ■ OP_LEVEL_AD=       - All: date
  778.       ■ OP_LEVEL_AS=       - All: since date
  779.       ■ OP_LEVEL_AP=       - All: protocol letters
  780.       ■ OP_LEVEL_AE=       - All: transfer errors
  781.       ■ OP_LEVEL_AA=       - All: average CPS
  782.       ■ OP_LEVEL_AR=       - All: raw
  783.       ■ OP_LEVEL_AV=       - All: verbose
  784.       ■ OP_LEVEL_AC=       - All: count
  785.  
  786.       ■ OP_NAME_X=         - Expert mode
  787.       ■ OP_NAME_M=         - Mode (color/mono)
  788.       ■ OP_NAME_H=         - Help
  789.       ■ OP_NAME_Q=         - Quit
  790.       ■ OP_NAME_G=         - Goodbye
  791.       ■ OP_NAME_PRO=       - Profile user
  792.       ■ OP_NAME_WHO=       - Who is on?
  793.  
  794.       ■ OP_NAME_UU=        - Uploads: user name
  795.       ■ OP_NAME_UF=        - Uploads: file name
  796.       ■ OP_NAME_UD=        - Uploads: date
  797.       ■ OP_NAME_US=        - Uploads: since date
  798.       ■ OP_NAME_UP=        - Uploads: protocol letters
  799.       ■ OP_NAME_UE=        - Uploads: transfer errors
  800.       ■ OP_NAME_UA=        - Uploads: average CPS
  801.       ■ OP_NAME_UR=        - Uploads: raw
  802.       ■ OP_NAME_UV=        - Uploads: verbose
  803.       ■ OP_NAME_UC=        - Uploads: count
  804.  
  805.       ■ OP_NAME_DU=        - Downloads: user name
  806.       ■ OP_NAME_DF=        - Downloads: file name
  807.       ■ OP_NAME_DD=        - Downloads: date
  808.       ■ OP_NAME_DS=        - Downloads: since date
  809.       ■ OP_NAME_DP=        - Downloads: protocol letters
  810.       ■ OP_NAME_DE=        - Downloads: transfer errors
  811.       ■ OP_NAME_DA=        - Downloads: average CPS
  812.       ■ OP_NAME_DR=        - Downloads: raw
  813.       ■ OP_NAME_DV=        - Downloads: verbose
  814.       ■ OP_NAME_DC=        - Downloads: count
  815.  
  816.       ■ OP_NAME_AU=        - All: user name
  817.       ■ OP_NAME_AF=        - All: file name
  818.       ■ OP_NAME_AD=        - All: date
  819.       ■ OP_NAME_AS=        - All: since date
  820.       ■ OP_NAME_AP=        - All: protocol letters
  821.       ■ OP_NAME_AE=        - All: transfer errors
  822.       ■ OP_NAME_AA=        - All: average CPS
  823.       ■ OP_NAME_AR=        - All: raw
  824.       ■ OP_NAME_AV=        - All: verbose
  825.       ■ OP_NAME_AC=        - All: count
  826.  
  827.   For a more  extensive description of each option  listed above, please refer
  828.   to the Options Description chapter, or  to the WONDER.CFG and WW_LANG files,
  829.   where you will find all the  necessary informations you will need about each
  830.   one.
  831.  
  832.   You don't have to specify all the  options mentioned. Only the ones you want
  833.   to  be different  than the  default assumed  by WonderWho.  All the  default
  834.   specifications  for  each  options  are  also  listed  in the WONDER.CFG and
  835.   WW_LANG files.
  836.  
  837.   Except  for the  INTERRUPT |  BIOS option  which is  required at  line #1 of
  838.   WONDER.CFG, all the options can be place  in the file in any order you want.
  839.   It can be even repeated (if they are, WonderWho will always use the last one
  840.   it reads).
  841.  
  842.   Please note that:
  843.  
  844.       ■ You should  edit this file using any reliable  ASCII text editor, such
  845.         as Norton Editor, MicroStar, QEdit, etc.
  846.  
  847.       ■ All  options names and  specifications are case-insensitive.  That is,
  848.         you may enter them either in uppercase or lowercase.
  849.  
  850.       ■ Each  line  must  not  exceed  255  characters.  Everything
  851.         past  that column is discarded.
  852.  
  853.       ■ Empty lines are discarded. You may leave as many empty lines
  854.         as you wish.
  855.  
  856.       ■ In a line, everything after (and  including) a ; character is
  857.         interpreted as a comment, and will be discarded.
  858.  
  859.       ■ You  may leave as many  spaces as you want  before a statement. Spaces
  860.         before a statement will be discarded.
  861.  
  862.   WonderWho reads  text files very quickly.  Users will not notice  for delays
  863.   while the door  is reading the configuration file. But,  if you want an even
  864.   faster  access to  the configuration  file, remove  all empty  and commented
  865.   lines. I don't strongly des-advise you to to do this. Comments where made to
  866.   tell you  the meanings and  rules for each  option, and if  you don't delete
  867.   them, they will  be there, waiting for you,  by the time you need  them. And
  868.   time,... will always come... :)
  869.  
  870.   I  think  you  will  find  this  kind  of  configuration  file  very easy to
  871.   understand and to change.
  872.  
  873.  
  874.  
  875.                    --- LANGUAGE CONFIGURATION FILE(S) ---
  876.  
  877.  
  878.  
  879.   A language configuration  file is almost the same  as the door configuration
  880.   file is. The routine used to read and process this file is the the very same
  881.   that is used to read and to process the configuration file.
  882.  
  883.   Nevertheless, there are a couple of major differences:
  884.  
  885.       ■ The language  configuration file is always read  (and processed) after
  886.         the door configuration file is  read (and processed). So, every option
  887.         specified in  the language configuration file  will overwrite the door
  888.         internal default for  that option, and also overwrite  the same option
  889.         if specified in the configuration file.
  890.  
  891.       ■ The  language  configuration  file  concerns  to  the PCBoard  current
  892.         language extension the caller is  using. WonderWho treats the language
  893.         configuration  file  as  is  described  in  the Multi-Language Support
  894.         chapter.
  895.  
  896.         So,  you can  have one  language configuration  file for each language
  897.         installed in your system
  898.  
  899.       ■ The  INTERRUPT | BIOS option  is the only option  not available in the
  900.         language configuration file.  If that option is found,  it will not be
  901.         processed.
  902.  
  903.   WonderWho provides  a default language configuration  file named WW_LANG. As
  904.   it happens with the default  door configuration file WONDER.CFG, all options
  905.   are disabled, because they are originally the internal WonderWho defaults.
  906.  
  907.   So,  if  you  want,  you  can  set  a  certain  number  of  options  in  the
  908.   door configuration file (which acts  like global options for all languages),
  909.   and  set  another  number  of  options  concerning  a specific language. For
  910.   instance, you may  specify in the language configuration  file the names for
  911.   each option.  This assumes that  you have decided  to create different  Main
  912.   Menu display screens for each language and changed the names of all options.
  913.  
  914.   Well, the way  WonderWho treats the WONDER.CFG door  configuration file, and
  915.   WW_LANG configuration file(s) gives you  complete power of most of WonderWho
  916.   operations.
  917.  
  918.  
  919.  
  920.                          --- OPTIONS DESCRIPTION ---
  921.  
  922.  
  923.  
  924.   Here are  the detailed descriptions  for all options  available in the  door
  925.   configuration file WONDER.CFG and the language configuration file WW_LANG:
  926.  
  927.       ■ INTERRUPT | BIOS                             Communication driver type
  928.         ----------------------------------------------------------------------
  929.  
  930.         The  first   line  of  the   door  configuration  file   MUST  be  the
  931.         communication driver type. This can be one of the following:
  932.  
  933.             ■ INTERRUPT  (the best, fastest)
  934.             ■ BIOS       (if interrupts fail to work)
  935.  
  936.         Default: There is no default for this option. You must specify it.
  937.  
  938.       ■ DLD_DIR=                        Transfer filepath, name and extension.
  939.         ----------------------------------------------------------------------
  940.  
  941.         This is the file location and name of PCBoard's transfer summary file.
  942.         If  you  don't  specify  this  option,  then  WonderWho  will  use the
  943.         information  stored in  the PCBOARD.DAT  file related  to the specific
  944.         node.
  945.  
  946.         Specifying  this option  will  make  WonderWho ignore  the information
  947.         stored in PCBOARD.DAT, which is the default procedure.
  948.  
  949.         Default: What is specified in PCBOARD.DAT file.
  950.  
  951.       ■ LANG_FILE=                                           Language filename
  952.         ----------------------------------------------------------------------
  953.  
  954.         This is  the filename only (no  extension) of the file  that will have
  955.         the name of  the Main Menu commands available  in WonderWho. This file
  956.         must be located in the same  directory where the WonderWho config file
  957.         is located. You cannot specify  the file extension. The maximum length
  958.         for this name is 8 characters long.
  959.  
  960.         Default: WW_LANG
  961.         Note   : You may disable this option by specifying NONE.
  962.  
  963.       ■ WELCOME_FILE=                                         Welcome filename
  964.         ----------------------------------------------------------------------
  965.  
  966.         This is  the filename only  (no extension) of  the file that  is first
  967.         displayed  to the  user when  he enters  the door.  This file  must be
  968.         located  in the  same directory   where the  WonderWho config  file is
  969.         located. You cannot specify the file extension. The maximum length for
  970.         this name is 8 characters long.
  971.  
  972.         Default: WW_WELC
  973.         Note   : You may disable this option by specifying NONE.
  974.  
  975.       ■ NEWS_FILE=                                               News filename
  976.         ----------------------------------------------------------------------
  977.  
  978.         This  is the  filename only  (no extension)  of the  NEWS file that is
  979.         displayed  after  the  WELCOME  file.  This  file  shows  to  the user
  980.         information  about the  features of  the latest  version of WonderWho.
  981.         This file  must be located in  the same directory where  the WonderWho
  982.         config  file is  located. You  cannot specify  the file extension. The
  983.         maximum length for this name is 8 characters long.
  984.  
  985.         Default: WW_NEWS
  986.         Notes  : You may disable this option by specifying NONE.
  987.                  If  WonderWho  doesn't  find  this  file,  no  error  will be
  988.                  returned.
  989.  
  990.       ■ NEWS_LIMIT=                                       News file date limit
  991.         ----------------------------------------------------------------------
  992.  
  993.         This option controls  the date until WonderWho will  still display the
  994.         WW_NEWS news file to the users. You have two chances:
  995.  
  996.             1. Always display the file
  997.                (set NEWS_LIMIT=@FOREVER@)
  998.  
  999.             2. Specify  a  month, day  and year  after which  the file will no
  1000.               longer be displayed to the user.
  1001.  
  1002.         Default: @FOREVER@
  1003.         Notes  : You may disable this option by specifying NONE.
  1004.                  When specifying  a date, you  *MUST* insert a  zero character
  1005.                  when the  month or day  are less than  10. Date *MUST*  be 10
  1006.                  characters long. No check will be performed on this. The file
  1007.                  date format is: yyyy-mm-dd.
  1008.  
  1009.       ■ MENU_FILE=                                               Menu filename
  1010.         ----------------------------------------------------------------------
  1011.  
  1012.         This is the  filename only (no extension) of the  Main Menu. This file
  1013.         must be located in the same  directory where the WonderWho config file
  1014.         is located. You cannot specify  the file extension. The maximum length
  1015.         for this name is 8 characters long.
  1016.  
  1017.         Default: WW_MENU
  1018.         Notes  : You may disable this option by specifying NONE.
  1019.  
  1020.       ■ QUIT_FILE=                                               Quit filename
  1021.         ----------------------------------------------------------------------
  1022.  
  1023.         This is the  filename only (no extension) of the  Main Menu. This file
  1024.         must be located in the same  directory where the WonderWho config file
  1025.         is located. You cannot specify  the file extension. The maximum length
  1026.         for this name is 8 characters long.
  1027.  
  1028.         Default: WW_QUIT
  1029.         Notes  : You may disable this option by specifying NONE.
  1030.  
  1031.       ■ LOGOFF=                                                         Logoff
  1032.         ----------------------------------------------------------------------
  1033.  
  1034.         This is  how WonderWho will  act after the  user enters the  [G]oodbye
  1035.         command, that  is, what file will  be displayed to the  user at logoff
  1036.         time. You have two possible chances to configure this feature:
  1037.  
  1038.             1. Show   the  logoff  script   questionnaire  as   specified   in
  1039.                PCBOARD.DAT. (set LOGOFF=@PCB@)
  1040.  
  1041.             2. Show  a specific file. (set  LOGOFF=complete path and filename,
  1042.                but  no  extension,  these  means  support  for  multi-language
  1043.                systems!)
  1044.  
  1045.         Default: @PCB@
  1046.         Notes  : You may disable this option by specifying NONE.
  1047.  
  1048.       ■ CALLER_LOG=                                               Caller's log
  1049.         ----------------------------------------------------------------------
  1050.  
  1051.         This is where you specify if you  want WonderWho to save data into the
  1052.         CALLER's log file. WonderWho can save  all commands the user type into
  1053.         the file, and it follows the PCBoard style and file format.
  1054.  
  1055.         Here  follows an  example, which  I think  is self-explanatory.  JAwho
  1056.         specific lines are the ones marked with a "->".
  1057.  
  1058.               "**************************************************************"
  1059.               "02-24-93 (09:03) (1) JOSE ALMEIDA (Local) (G)                 "
  1060.               "      Caller Number: 880                                      "
  1061.               "      Caller Security: 110                                    "
  1062.               "      Opened Door (WONDER) at 09:03                           "
  1063.           ->  "      (AU)  # 1: JOSE ALMEIDA                                 "
  1064.           ->  "      (UF)  # 1: WONDER14.ZIP                                 "
  1065.           ->  "            # 2: WONDER15.ZIP                                 "
  1066.           ->  "            # 3: WONDER16.ZIP                                 "
  1067.           ->  "      (DC)  Count entries                                     "
  1068.           ->  "      (PRO) View user profile                                 "
  1069.           ->  "      (X)   Expert mode is now on                             "
  1070.           ->  "      (M)   Graphics mode is now off                          "
  1071.           ->  "      (VER) Program version info                              "
  1072.           ->  "      (H)   Help about: (PRO)                                 "
  1073.           ->  "      (G)   Goodbye (from inside door)                        "
  1074.               "      Minutes Used: 1                                         "
  1075.               "02-24-93 (09:04) (1) JOSE ALMEIDA Off Automatically           "
  1076.               "**************************************************************"
  1077.  
  1078.         All search entries are logged, except for the [Q]uit command. Trailing
  1079.         characters past  each log entry are  filled with ASCII #255  for clear
  1080.         output, and in order to allow the  file to be edit without any problem
  1081.         caused by ASCII text editors discarding trailing space characters. All
  1082.         call entries  are saved prior  to execute the  command, for convenient
  1083.         debug operations.
  1084.  
  1085.         WonderWho will not save to the CALLER LOG file when in Local Test mode
  1086.         (when  you  pass  the  word  "LOCAL"  as  the  third  parameter to the
  1087.         program).  But ProKit  itself does  this anyway,  if a  "Keyboard Time
  1088.         Expired!" takes place.
  1089.  
  1090.         Default: YES
  1091.         Notes  : You may disable this option by specifying NO.
  1092.  
  1093.       ■ (Varies)                                                  Option names
  1094.         ----------------------------------------------------------------------
  1095.  
  1096.         Here  you can  specify different  names for  all primary commands. You
  1097.         cannot specify the  name for the [VER]sion command.  Each command name
  1098.         cannot exceed 3 characters length. Everything past the third character
  1099.         will be discarded.
  1100.  
  1101.         Default: Unless you specify differently, all option names are the ones
  1102.                  listed after the 'OP_NAME_' word.
  1103.         Notes :  If you wish to  disable a command, set  the security level to
  1104.                  anything higher than a user can have (usually SysOp's level).
  1105.  
  1106.         Here is a list of all option names:
  1107.  
  1108.             ■ OP_NAME_X=     - Expert mode
  1109.             ■ OP_NAME_M=     - Mode color/mono
  1110.             ■ OP_NAME_H=     - Help (secondary command: 'HELP')
  1111.             ■ OP_NAME_Q=     - Quit (secondary command: 'QUIT')
  1112.             ■ OP_NAME_G=     - Goodbye (secondary commands: 'G Y' and 'BYE')
  1113.             ■ OP_NAME_PRO=   - Profile user (secondary command: 'PROFILE')
  1114.             ■ OP_NAME_WHO=   - Who is on?
  1115.  
  1116.             ■ OP_NAME_UU=    - Uploads: user name
  1117.             ■ OP_NAME_UF=    - Uploads: file name
  1118.             ■ OP_NAME_UD=    - Uploads: date
  1119.             ■ OP_NAME_US=    - Uploads: since date
  1120.             ■ OP_NAME_UP=    - Uploads: protocol letters
  1121.             ■ OP_NAME_UE=    - Uploads: transfer errors
  1122.             ■ OP_NAME_UA=    - Uploads: average CPS
  1123.             ■ OP_NAME_UR=    - Uploads: raw
  1124.             ■ OP_NAME_UV=    - Uploads: verbose
  1125.             ■ OP_NAME_UC=    - Uploads: count
  1126.  
  1127.             ■ OP_NAME_DU=    - Downloads: user name
  1128.             ■ OP_NAME_DF=    - Downloads: file name
  1129.             ■ OP_NAME_DD=    - Downloads: date
  1130.             ■ OP_NAME_DS=    - Downloads: since date
  1131.             ■ OP_NAME_DP=    - Downloads: protocol letters
  1132.             ■ OP_NAME_DE=    - Downloads: transfer errors
  1133.             ■ OP_NAME_DA=    - Downloads: average CPS
  1134.             ■ OP_NAME_DR=    - Downloads: raw
  1135.             ■ OP_NAME_DV=    - Downloads: verbose
  1136.             ■ OP_NAME_DC=    - Downloads: count
  1137.  
  1138.             ■ OP_NAME_AU=    - All: user name
  1139.             ■ OP_NAME_AF=    - All: file name
  1140.             ■ OP_NAME_AD=    - All: date
  1141.             ■ OP_NAME_AS=    - All: since date
  1142.             ■ OP_NAME_AP=    - All: protocol letters
  1143.             ■ OP_NAME_AE=    - All: transfer errors
  1144.             ■ OP_NAME_AA=    - All: average CPS
  1145.             ■ OP_NAME_AR=    - All: raw
  1146.             ■ OP_NAME_AV=    - All: verbose
  1147.             ■ OP_NAME_AC=    - All: count
  1148.  
  1149.       ■ (Varies)                                        Option security levels
  1150.         ----------------------------------------------------------------------
  1151.  
  1152.         Here  you  can  specify  different  security  levels  for  all primary
  1153.         commands, except for the [VER]sion and [Q]uit commands.
  1154.  
  1155.         Default: Unless  you specify differently, all  security levels are set
  1156.                  to 0 by default.
  1157.  
  1158.         Here it is a list of all level options:
  1159.  
  1160.             ■ OP_LEVEL_X=    - Expert mode
  1161.             ■ OP_LEVEL_M=    - Mode (color/mono)
  1162.             ■ OP_LEVEL_H=    - Help
  1163.             ■ OP_LEVEL_G=    - Goodbye
  1164.             ■ OP_LEVEL_PRO=  - Profile user
  1165.             ■ OP_LEVEL_WHO=  - Who is on?
  1166.  
  1167.             ■ OP_LEVEL_UU=   - Uploads: user name
  1168.             ■ OP_LEVEL_UF=   - Uploads: file name
  1169.             ■ OP_LEVEL_UD=   - Uploads: date
  1170.             ■ OP_LEVEL_US=   - Uploads: since date
  1171.             ■ OP_LEVEL_UP=   - Uploads: protocol letters
  1172.             ■ OP_LEVEL_UE=   - Uploads: transfer errors
  1173.             ■ OP_LEVEL_UA=   - Uploads: average CPS
  1174.             ■ OP_LEVEL_UR=   - Uploads: raw
  1175.             ■ OP_LEVEL_UV=   - Uploads: verbose
  1176.             ■ OP_LEVEL_UC=   - Uploads: count
  1177.  
  1178.             ■ OP_LEVEL_DU=   - Downloads: user name
  1179.             ■ OP_LEVEL_DF=   - Downloads: file name
  1180.             ■ OP_LEVEL_DD=   - Downloads: date
  1181.             ■ OP_LEVEL_DS=   - Downloads: since date
  1182.             ■ OP_LEVEL_DP=   - Downloads: protocol letters
  1183.             ■ OP_LEVEL_DE=   - Downloads: transfer errors
  1184.             ■ OP_LEVEL_DA=   - Downloads: average CPS
  1185.             ■ OP_LEVEL_DR=   - Downloads: raw
  1186.             ■ OP_LEVEL_DV=   - Downloads: verbose
  1187.             ■ OP_LEVEL_DC=   - Downloads: count
  1188.  
  1189.             ■ OP_LEVEL_AU=   - All: user name
  1190.             ■ OP_LEVEL_AF=   - All: file name
  1191.             ■ OP_LEVEL_AD=   - All: date
  1192.             ■ OP_LEVEL_AS=   - All: since date
  1193.             ■ OP_LEVEL_AP=   - All: protocol letters
  1194.             ■ OP_LEVEL_AE=   - All: transfer errors
  1195.             ■ OP_LEVEL_AA=   - All: average CPS
  1196.             ■ OP_LEVEL_AR=   - All: raw
  1197.             ■ OP_LEVEL_AV=   - All: verbose
  1198.             ■ OP_LEVEL_AC=   - All: count
  1199.  
  1200.  
  1201.  
  1202.                                 --- TOOLS ---
  1203.  
  1204.  
  1205.  
  1206.   This program was  written using Borland's Turbo Pascal  version 6.0. Besides
  1207.   this outstanding compiler,  I also used several other  programs, such as (in
  1208.   alphabetical order):
  1209.  
  1210.       ■ PCBoard 14.5a
  1211.             Copyright by Clark Development Company
  1212.  
  1213.       ■ PKLite Professional v1.12
  1214.             Copyright by PKWare Inc.
  1215.  
  1216.       ■ PKZip v2.04g
  1217.             Copyright by PKWare Inc.
  1218.  
  1219.       ■ TheDraw v4.60
  1220.             Copyright by TheSoft Programming and Ian E. Davis
  1221.  
  1222.   I also used  the following libraries or source  code (again, in alphabetical
  1223.   order):
  1224.  
  1225.       ■ ProKit v3.44
  1226.             Copyright by Samuel H.Smith
  1227.  
  1228.       ■ The HeartWare Toolkit v2.00 for Turbo Pascal
  1229.             Copyright by José De Almeida & Luis Correia
  1230.  
  1231.  
  1232.  
  1233.                    --- OTHER SOFTWARE FROM THE AUTHOR ---
  1234.  
  1235.  
  1236.  
  1237.   Besides  the WonderWho  door, I   also released  other software,  either as
  1238.   Shareware or Freeware programs. All  this software are available at SkyShip
  1239.   BBS (see Costumer Support chart for phone numbers).
  1240.  
  1241.   Here is a list (in alphabetical order) and brief descriptions:
  1242.  
  1243.       ■ JAJumbo v1.09                                                Shareware
  1244.         ----------------------------------------------------------------------
  1245.  
  1246.         For Colorado  Jumbo Streamers. Easy  of use. Very  very fast. Pulldown
  1247.         menus interface. True arrow mouse  support in text mode. Screen fades.
  1248.         Internal  palette and  font re-definition.  On-line help  and built-in
  1249.         screen saver.  Backup single, multiple  or all hard-disk  disk drives,
  1250.         restores  multiple volumes  in a  single command.  Format. Batch  file
  1251.         support for user-specific tasks.  And more! Fully functional shareware
  1252.         program.
  1253.  
  1254.         Filename: JAJUMBO9.*
  1255.  
  1256.       ■ JAvga v1.00                                                   Freeware
  1257.         ----------------------------------------------------------------------
  1258.  
  1259.         This is  a VGA text  based demo program.  This is not  an utility, but
  1260.         only a very interesting and  amazing programing exercise. Includes VGA
  1261.         extremely fast  and best implemented  palette fades in  and fades out.
  1262.         "True" arrow mouse cursor (Norton  a-like). 6 Built-in text portuguese
  1263.         fonts,  but they  work code-page  independently. 2  Text fonts will be
  1264.         displayed on screen  at the same time, using  VGA programing features.
  1265.         This means  512 different characters  on screen at  the same time.  16
  1266.         Background  colors (not  only 8).  Toggle character  blink on/off. And
  1267.         remember, everything this program does, no  matter what it is, is done
  1268.         deliberately. It have no bugs, whatsoever.
  1269.  
  1270.         Filename: JAVGA.*
  1271.  
  1272.       ■ TagMail v0.16ß                                               Shareware
  1273.         ----------------------------------------------------------------------
  1274.  
  1275.         Utility  program  that  works  with  virtually  any  DOS off-line mail
  1276.         reader. Automatically  inserts in a message  your signature (any kind,
  1277.         any size) and a tagline (any size, multiple lines). Easy to configure,
  1278.         works in  completely silent mode. More  than 34,000 Taglines available
  1279.         in dozens of pre-compiled taglines.
  1280.  
  1281.         Filename: TAGM016B.*
  1282.  
  1283.       ■ The Image Bank BBS Clip Art Library v1.00                     Freeware
  1284.         ----------------------------------------------------------------------
  1285.  
  1286.         Compilation  of  266  Clip  art  files  in  the following graphic file
  1287.         formats:
  1288.  
  1289.             ■ PCC - for DeluxePaint and PC PaintBrush
  1290.             ■ ST  - for NeoPaint
  1291.             ■ GIF - for other drawing programs.
  1292.  
  1293.         Lots of  nice and very small  clip art images, and  dozens of ready to
  1294.         use  Microsoft Windows-alike  push buttons.  Includes catalogs  of all
  1295.         images for easy view.
  1296.  
  1297.         Filename: TIBCA100.*
  1298.  
  1299.       ■ The Wallpaper Library release WL3024                         Shareware
  1300.         ----------------------------------------------------------------------
  1301.  
  1302.         The world's biggest wallpaper  library available for Microsoft Windows
  1303.         v3.x,  featuring 3,024  tiled  .BMP  wallpapers in  256-colors format,
  1304.         meaning about 32 MBytes of images. More than 1,300 new wallpapers than
  1305.         the previous release. SuperVGA required.
  1306.  
  1307.         Filenames: WL3024*.*   (14 file archives)
  1308.  
  1309.  
  1310.  
  1311.                            --- SPECIAL THANKS ---
  1312.  
  1313.  
  1314.  
  1315.   In a first place, I would like to express my gratitude to Mr.Mário Pozzetti,
  1316.   SysOp of SkyShip BBS (the world-wide support BBS for WonderWho). And this is
  1317.   more than a special  thanks. I would like to thank him  for all he have done
  1318.   in its wonderful BBS for the  Portuguese Shareware globally speaking, for my
  1319.   other Shareware programs in particular,  and for WonderWho door specifically
  1320.   nowadays.  Without  his  initial  encouragement,  and  continuous and closet
  1321.   attendance  providing me  almost all  the informations  I needed  to develop
  1322.   WonderWho.
  1323.  
  1324.   I  would  like  to  express  my  gratitude  to  the  following  persons  (in
  1325.   alphabetical order):
  1326.  
  1327.       ■ Mr.Afonso Vicente:
  1328.             SysOp of Intriga Internacional BBS.
  1329.  
  1330.       ■ Mr.Carlos Batista
  1331.             Author of a Shareware mail utility called MailDB.
  1332.  
  1333.       ■ Mr.Luis Silva and Mr.Pedro Chaves:
  1334.             SysOps of MsMac BBS, and distributors of Clark Development Company
  1335.             Inc. products, such as PCBoard, for Portugal.
  1336.  
  1337.       ■ Mr.Pedro Duarte:
  1338.             Author of a Shareware communication program called LusoComm.
  1339.  
  1340.       ■ Mr.Pedro Pinheiro
  1341.  
  1342.       ■ Mr.Tiago Pascoal
  1343.  
  1344.   All these  folks helped me  a lot in  testing the WonderWho  door, giving me
  1345.   reports of problems and bugs when found, new ideas to implement, etc, either
  1346.   as  SysOps on  their BBS,  or as  simple users  of the  door. I hope I'm not
  1347.   forgetting anyone.
  1348.  
  1349.   And finally, last  but not least, Mr. Samuel Smith,  Author of the wonderful
  1350.   ProKit library used in WonderWho.
  1351.  
  1352.  
  1353.  
  1354. [end-of-file]
  1355.