home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / v611docs.zip / VMAIN611.ZIP / VC6-AA < prev    next >
Text File  |  1993-10-08  |  17KB  |  380 lines

  1.                                            VBBS 6.11 Documentation -- 6-A-1
  2.  
  3.  
  4.      ╔════════════════════════════════════════════════════════════════╗
  5.          ║ CHAPTER 6 ANNEX A      MESSAGING FUNCTIONS                     ║
  6.          ╚════════════════════════════════════════════════════════════════╝
  7.  
  8.         The default VBBS setup places all communications functions
  9.      in the Main Menu.  As stated earlier, separate menu displays for
  10.      messaging and/or E-mail (for instance) may easily be customized
  11.      to present whatever type of interface the sysop wishes.  Again,
  12.      see "Customizing VBBS" for more information.
  13.  
  14.  
  15.      Main Menu Commands and What They Do -- Messaging
  16.      ════════════════════════════════════════════════
  17.  
  18.      [L] List Messages        Lists message bases in current
  19.                      topic area, then prompts user
  20.                      to enter a sub, change topics,
  21.                      or quit.
  22.      [P] Post Message        Post a message in the current
  23.                      message base.
  24.      [N] New Message Scan        Allows user to scan all new mes-
  25.                      sages in configured bases.
  26.      [R] Read Sequential        Read messages in current base se-
  27.                      quentially.
  28.      [S] Scan Brief            Scans posts in current base in
  29.                      groups of 10, showing the mes-
  30.                      sage number, author, and subject.
  31.      [J] Join/Ignore Bases        Allows users to set up bases to
  32.                      ignore or mark for scanning.
  33.      [>] Next Base            Move to the next message base in
  34.                      sequence; also activated by [+].
  35.                      Note that a user moving through
  36.                      three consecutive bases using
  37.                      [+] may actually activate his or
  38.                      her modem's hangup string.
  39.      [<] Previous Base        Move to previous base; also acti-
  40.                      vated by [-].
  41.      [#] Change to Base #        Change to a particular message
  42.                      base by entering its number.
  43.      [$] Change Topic        Lists available topic areas, then
  44.                      asks user which one to go to.
  45.  
  46.  
  47.             SETTING UP TOPIC AREAS
  48.             ══════════════════════
  49.  
  50.  
  51.                    Topic areas are used by VBBS to join databases together
  52.            into more manageable groups for sysops and users.  Both message
  53.            databases and file databases can be linked together into
  54.            Database Topic Groups.  By running VCONFIG and choosing option
  55.            3. Database Configuration, you will see the following menu:
  56.  
  57.                                            VBBS 6.11 Documentation -- 6-A-2
  58.  
  59.                           ┌────────────┤Type├────────────┐
  60.                           │       Message Bases          │
  61.                           │       File Directories       │
  62.                           │       Custom Databases       │
  63.                           │       Sort Configuration     │
  64.                           │       Compile Network Info   │
  65.                           └──────────────────────────────┘
  66.  
  67.            VBBS comes preconfigured with three main Database Topic Groups
  68.            already set up: Message Bases, Files Directories, and Custom
  69.            Databases.  Topic Groups are identified by using a letter, A-Z.
  70.            Thus, letter A is already used for the Message Bases, letter F is
  71.            used for File Directories, and letter O was designated for the
  72.            Custom Databases.  Thus, 23 letters are available after VBBS
  73.            is installed for the sysop to use for adding other Database
  74.            Topic Groups. These letters are called DBGroup Identifiers.
  75.  
  76.  
  77.            Adding Topics for Message Bases
  78.            ═════════════════════════════════
  79.  
  80.                 To add another Topic Group to be used for messages, simply
  81.            highlight Message Bases on the Type menu above, and press the
  82.            Return key.  You will then see the following menu:
  83.  
  84.                 ┌─────────────────┤Select Group├───────────────────┐
  85.                 │ A - Main                                         │
  86.                 │                                                  │
  87.                 │                                                  │
  88.                 └[Up ]─[Dwn]─[Enter]=Select─[F1]=SubMenu─[Esc]=Quit┘
  89.                  [Arw] [Arw]
  90.  
  91.            Pressing F1 will bring up the SubMenu:
  92.  
  93.                         ┌──────┤F1 Sub-Menu├───────────┐
  94.                         │    Add New Database Group    │
  95.                         │    Delete Database Group     │
  96.                         │    Edit Topic Name           │
  97.                         └──────────────────────────────┘
  98.  
  99.            Highlighting "Add New Database Group" here will prompt you for
  100.            a topic letter. Choose an unused letter from A-Z, enter the
  101.            name of the Database Topic Group you would like users to see,
  102.            and press Return.
  103.  
  104.            -->  IMPORTANT NOTE:  Be sure to use a unique letter for each
  105.                                  topic group you add since inadvertently
  106.                                  reusing a letter will cause the existing
  107.                                  databases to be linked to the new topic
  108.                                  you have created, as well as the existing
  109.                                  topic.
  110.  
  111.            To add message bases to the new Topic Group you have created,
  112.            simply choose the new topic letter now listed on the Select
  113.            Group menu and add normally as outlined in the "Configuring
  114.            and Editing Databases in VCONFIG" section of this manual.
  115.  
  116.                                            VBBS 6.11 Documentation -- 6-A-3
  117.  
  118.            -->  IMPORTANT NOTE:  Be aware that each Database Topic Group
  119.                                  set up may contain a maximum of 100
  120.                                  databases. Each database itself may hold
  121.                                  up to 32000 entries.
  122.  
  123.  
  124.            Creating Topics for File Directories
  125.            ════════════════════════════════════
  126.            To add new topics for use by file directories, the same
  127.            procedure is followed, except that on the Type menu above,
  128.            you must select File Directories.
  129.  
  130.                         ╔═╗      Before setting up new topic areas, try
  131.                         ╚═╝      to plan ahead and divide the existing
  132.                                  letters between message areas and
  133.                                  file areas.  Since the letters are shared
  134.                                  between both types, a little planning
  135.                                  will save you some reshuffling later on.
  136.  
  137.            Similar to the above, Custom Databases may also be set up. These
  138.            are treated as message type databases in formatting and are
  139.            used mainly in conjuction with specialized scripts to add, for
  140.            example, a quote of the day, random logoff screens, etc.
  141.  
  142.  
  143.            Deleting Topics
  144.            ═══════════════
  145.            To delete Database Topic Groups, again the F1 Sub-Menu allows
  146.            for this; however, you should delete each individual database
  147.            first if it is no longer desired.
  148.  
  149.            -->  IMPORTANT NOTE:  Deleting a Database Topic Group does not
  150.                                  automatically delete the databases which
  151.                                  belong to it.
  152.  
  153.  
  154.            Moving Databases to Different Topic Areas
  155.            ═════════════════════════════════════════
  156.            Once databases are created within a Database Topic Group, it is
  157.            possible to easily move them to a different existing topic area.
  158.            This is accomplished by editing the information for the database
  159.            entry itself.  Option Z) DB Group:  in each database can be
  160.            changed at any time to change a database to another topic.
  161.  
  162.  
  163.            --> IMPORTANT NOTE:   After adding, deleting, or moving any
  164.                                  Database Topic Groups, you must run the
  165.                                  Sort Configuration and Compile Network
  166.                                  Info options on the Type menu for any of
  167.                                  the changes to take effect.
  168.  
  169.                                            VBBS 6.11 Documentation -- 6-A-4
  170.  
  171.      VFSE Full-Screen Editor
  172.      ═══════════════════════
  173.  
  174.         VBBS comes with both a standard line editor and a powerful
  175.      built-in full-screen editor.  The full-screen editor features 36
  176.      text color choices which are enabled by hitting [Ctrl-P], then a
  177.      number from 0 to 9 or a letter from A to Z.  [Ctrl-P] followed by
  178.      a question mark will display a list of color choices.  Other con-
  179.      trol-key options exist for various other functions including cur-
  180.      sor movement, line feeds, line and character deletes, cut-and-
  181.      paste, etc.  These commands may be found in the editor help-file
  182.      by pressing [Ctrl-Z].
  183.         On the top line above the workspace, the user is shown
  184.      the message or E-mail title, the current line number, and the
  185.      insert/overwrite status.  The editor starts in OVR (overwrite)
  186.      mode and can easily be toggled to INS (insert) mode by using
  187.      either the Insert key or [Ctrl-O].
  188.         The VFSE allows user to upload previously-prepared text
  189.      at any time.  Pressing the slash [/] key and supplying a file
  190.      name at the prompt inserts the prepared text into the workspace.
  191.      This is a neat and efficient way for the sysop to create or edit
  192.      .MNU-type menus, system taglines (see "System Taglines" for more 
  193.      information), bulletins, or whatever.
  194.         The full-screen editor is an ANSI-based editor; users who
  195.      have their ANSI preference enabled should be encouraged to use
  196.      the FSE for its superior features.
  197.  
  198.      Message Quoting
  199.      ═══════════════
  200.  
  201.         VBBS features advanced message quoting in messages and in
  202.      E-mail.  Users who reply to posts or E-mail are asked whether
  203.      they wish to quote from the post or E-mail to which they're re-
  204.      plying.  If the user chooses "yes", then a special screen will
  205.      appear, allowing him or her to choose which lines are to be quo-
  206.      ted in the reply.  The user is prompted at each line of the mes-
  207.      sage whether to 
  208.  
  209.         [A]dd that line into the quote workspace,
  210.         [S]kip that line and advance to the next, jump to the
  211.         [N]ext portion of the original message, 
  212.         [R]estart the quoting process (useful in case of an 
  213.             accidental skipped line), or 
  214.         [Q]uit from the quote workspace altogether.
  215.  
  216.          There is a 20-line limit on the amount of previous text that may
  217.      be quoted; upon reaching the 20th line, the quoter automatically
  218.      returns the user to the editor workspace.  The quoted lines are
  219.      prefaced with a bright green ">" symbol.
  220.  
  221.  
  222.                                           VBBS 6.11 Documentation --  6-A-5
  223.  
  224.      ╔═╗    There is a definite "art" to effective quoting.  Beginners
  225.          ╚═╝    sometimes quote more of the original message than is ne-
  226.         cessary, but this decreases with practice, especially in
  227.         networked message bases.  Note that quoted lines may be
  228.         edited to remove extraneous words or phrases; this can
  229.         help the quoter "zero in" on the essence of the quote.
  230.  
  231.  
  232.      Message Threading
  233.      ═════════════════
  234.  
  235.         In addition to quoting, message "threading" exists in all
  236.      message bases.  This allows the user to search for the original
  237.      message in a "thread" (line of discussion) and all replies to
  238.      that message.  It should be noted that the threader searches on
  239.      the title field of the message; if the title has been changed by
  240.      someone replying to the message, the threader will not pick it
  241.      up as a reply.
  242.  
  243.      ╔═╗    In order to facilitate threading on network subs, users
  244.          ╚═╝    and sysops are being encouraged to make titles as descrip-
  245.         tive of the contents as possible; one- or two-word titles
  246.         like "YO!", "Hmmm...", "Why don't...", and the like are
  247.         being discouraged.  Users replying within the context of
  248.         a particular message thread should not change the working
  249.         title if they want it to be included in a thread; if they
  250.         are digressing, changing the subject, or starting a new
  251.         thread, they should come up with a new title.
  252.  
  253.      Message Search
  254.      ══════════════
  255.  
  256.         VBBS messages may be searched in two ways.  Pressing [S]
  257.      from the message submenu prompt will display the next 10 messages
  258.      in sequence.  Following that, pressing [R] will bring up a
  259.      "search" prompt that allows the user to search the message data-
  260.      base by title.
  261.  
  262.      ╔═╗    The [S]can feature is one of the most useful tools a sysop
  263.          ╚═╝    has, especially if her board carries a lot of active net-
  264.         worked message bases.  Scanning titles takes MUCH less
  265.         time than reading EVERY message; this is another argument
  266.         in favor of descriptive message titles.
  267.  
  268.      Message Sub Validation
  269.      ══════════════════════
  270.  
  271.         Each message base may be assigned a "requires validation"
  272.      status from within the DATABASE Configuration of VCONFIG.  This
  273.      is to allow the sysop a degree of control over what goes out
  274.      onto a network from his system.  Some network subs require net 
  275.      validation to be set to "on"; when subscribing to a "secured" 
  276.      sub, the subscribing sysop should inquire about this.
  277.         
  278.      ╔═╗    One caveat about message sub validation:  sysops some-
  279.          ╚═╝    times forget to validate the messages, resulting in a
  280.         pileup of messages, especially on active subs.
  281.  
  282.  
  283.                                           VBBS 6.11 Documentation --  6-A-6
  284.  
  285.  
  286.      Message Sub Moderators
  287.      ══════════════════════
  288.  
  289.         Moderators, sub-ops, and co-sysops can be very useful for
  290.      any BBS.  In local messaging areas, sub-ops can be invaluable as
  291.      discussion leaders, often causing a far greater user participa-
  292.      tion in subs than if those subs were without a moderator.  As
  293.      mentioned above, some network subs require net validation, and 
  294.      often a sysop may not have the time each day to validate the 
  295.      messages in those subs.  In that case, a sub-op can be very use-
  296.      ful in performing those duties for the sysop.  
  297.  
  298.         To designate a user as moderator for a particular sub,
  299.      go into VCONFIG and enter his or her user number in the "Data-
  300.      base Co-sysop" field for that sub.
  301.  
  302.  
  303.      Messaging Sub-Menu
  304.      ══════════════════
  305.  
  306.          While reading messages, a user has several options that
  307.      are presented at each message prompt.  These are hard-coded into
  308.      VBBS, so altering them requires a source-code modification.
  309.  
  310.      [Enter] Next Message        Read the next message.    
  311.        [R]     Reply to Message    Post a public reply to the cur-
  312.                      rent message.
  313.        [A]   Read Message Again    Re-read the current message.
  314.        [D]   Delete Message        Delete the current message.
  315.       [###]  Jump to Number ###    Entering a number will take you
  316.                      to that message number.
  317.        [S]   Scan Next 10 Mes-      Show the titles of the next 10
  318.          sages              messages.  This is a very use-
  319.                      ful feature, especially on ac-
  320.                      tive message bases.
  321.        [B]   Bypass Sub (Quick    If you're doing a quick-scan, [N]
  322.                   Scan)             from the main menu, this will
  323.                      move you to the next sub with-
  324.                      out having to read all the mes-
  325.                      sages in the current sub.  If
  326.                      you find yourself using this
  327.                      option a lot, you might consider
  328.                      using the [J]oin/Ignore Bases
  329.                      command to configure your new-
  330.                      message scan.
  331.        [E]   Send E-mail Reply    Send a private E-mail to the au-
  332.                      thor of the current message.
  333.                      His/her network address is in
  334.                      the message header.
  335.        [Q]   Quit Reading Mes-      Returns to the Communications
  336.          sages             Menu.
  337.  
  338.                                           VBBS 6.11 Documentation --  6-A-7
  339.  
  340.        [+]   Thread Forward        Search for replies to current
  341.                      message (if any).  Quite use-
  342.                      ful in eliminating redundant
  343.                      replies; if someone's asking
  344.                      a question, use this to check
  345.                      to see whether someone else
  346.                      has already answered it to
  347.                      your satisfaction.
  348.        [-]   Thread Backward    Search for the original post that
  349.                      prompted the reply you're rea-
  350.                      ding now (if any).
  351.      ──────── Sysop ──────────
  352.  
  353.        [X]   Extract Text        Allows sysop to extract the text
  354.                      of a message for later reading
  355.                      or printing.  Sysop is prompted
  356.                      for a filename (.PST is a good
  357.                      extension to use, as it won't
  358.                      be confused with .TXT files).
  359.                      Sysops beware:  liberal use of
  360.                      this function can greatly bloat
  361.                      your Main VBBS directory!  :-)
  362.        [M]   Move Message        Moves message to a different sub.
  363.                      Useful for combatting off-topic
  364.                      posts, or for bringing in rele-
  365.                      vant posts from other subs.
  366.                      
  367.  
  368.        [P]     Toggle Permanent    Toggles current message between
  369.                      permanent/non-permanent.  This
  370.                      is quite useful in making the
  371.                      first message of a sub a "sub
  372.                      rules/policies" post.
  373.  
  374.      A word on message threading:  if a thread-search fails to find an
  375.      original or a reply, it doesn't mean there ISN'T one; the thread
  376.      function searches by TITLE.  If someone has entered a related
  377.      message under a different title, it will not show up as relating
  378.      to the current thread.
  379.  
  380.