home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / VORV11.EXE / VOTE.DOC < prev    next >
Text File  |  1993-12-20  |  34KB  |  721 lines

  1.  
  2.  
  3.                               Vote-O-Rama v1.0
  4.                     (c) 1993  by Datagen Software Designs
  5.                      written & programmed by John Dailey
  6.  
  7.  
  8.  
  9.                             WARRANTY and DISCLAIMER
  10.                             ───────────────────────
  11.  
  12.           This  software  is  provided  AS IS without any expressed or
  13.           implied warranties whatsoever. No warranty of fitness for  a
  14.           particular  purpose  is offered. The author of this software
  15.           cannot be held responsible for DIRECT, INDIRECT  INCIDENTAL,
  16.           CONSEQUENTIAL,  or  ANY OTHER damages due to your ability or
  17.           inability to use this software, even if the author has  been
  18.           advised of the possibility of such damages. The user assumes
  19.           full responsibility for the use of this software.
  20.  
  21. Files Included In This Package:
  22. ───────────────────────────────
  23.  
  24.  
  25.      VOTE    .EXE ─── Vote-O-Rama v1.0 Executable.
  26.      VOTE    .HLP ─── Vote-O-Rama v1.0 On-Line Help File.
  27.      VOTE    .DOC ─── Vote-O-Rama v1.0 Documentation.
  28.      VOTE    .REG ─── Registration Form
  29.      SAMPLE  .EXE ─── Self-Extracting Example Voting Database.
  30.           SAMPLE.MSG ─── Sample Login Message
  31.           SAMPLE.VOT ─── Default Information For Voting Questions.
  32.           SAMPLE.DAT ─── Voting Questions And Results Data.
  33.           SAMPLE.1 -
  34.           SAMPLE.5   ─── User Information For Questions 1 - 5.
  35.  
  36.      [10 Files]
  37.  
  38. Files Created By Vote-O-Rama:
  39. ─────────────────────────────
  40.  
  41.  
  42.      datafile.VOT - Contains Default Information For Voting Questions.
  43.                     This file must remain in the directory that you will
  44.                     be running Vote-O-Rama from.  All other files may be in
  45.                     their own directory together.
  46.  
  47.      datafile.DAT - Contains All Voting Questions And Result Data.
  48.      datafile.LOG - Contains A Log Of All Activity For A Voting Area.
  49.      datafile.1 ...
  50.      datafile.xxx - Contains Voter Information For Questions.
  51.  
  52.      Under DORINFOx.DEF BBS Software:
  53.  
  54.      VOTEDISP.ANS - Output files to notify users of new questions
  55.      VOTEDISP.ASC
  56.  
  57.  
  58. Files Used By Vote-O-Rama
  59. ─────────────────────────
  60.  
  61.      datafile.MSG - Welcome Message To Be Displayed.
  62.      datafile.HLP - Help File For Specific Voting Area.
  63.      filename.LST - Specifies A List Of Voting Areas For Checking During
  64.                      Logon Batch File.
  65.  
  66. What Is Vote-O-Rama?
  67. ────────────────────
  68.  
  69.     Vote-O-Rama is a unique voting door for WWIV, QuickBBS, and Remote Access
  70. (or any software that either creates DORINFOx.DEF or CHAIN.TXT information
  71. files) systems that makes voting on your bbs much more fun!  It can be used as
  72. a total replacement for WWIV's built in voting system, and offers as many and
  73. more features, including the following:
  74.  
  75.   o Support for both DORINFOx.DEF, and CHAIN.TXT BBS Software!
  76.  
  77.   o Support for up to 999 voting questions per voting area, each with a
  78.      maximum of 30 responses for each question!  Each question may be up to
  79.      three lines long, and each response may also be up to three lines long.
  80.  
  81.   o Multiple voting area support!  Allows the sysop to create different areas
  82.      to vote in.  Voting areas are only limited by disk space.
  83.  
  84.   o Support to allow users to add questions based on their security level.
  85.      When a new voting area is created, the sysop can specify a minimum
  86.      security level for users that may create new questions.
  87.  
  88.   o Support to allow users to add responses to questions.  As each question
  89.      is created, the creator can choose whether or not to allow other users
  90.      to add responses to their question, assuming the sysop has configured
  91.      Vote-O-Rama to allow this.
  92.  
  93.   o Ability to allow users to vote more than once, or only one time, at the
  94.      sysop's and/or creator of a question discression.
  95.  
  96.   o Ability to allow users to vote "in response to" another voting question.
  97.  
  98.   o Support for scanning questions not voted on, and letting users know
  99.      what questions they've already voted on or questions that they've voted
  100.      on, but are allowed multiple votes, and questions that are marked for
  101.      deletion.
  102.  
  103.   o Utility for sysops and/or co-sysops to maintain, update, and change
  104.      questions and question data on-line, including ability to modify the
  105.      total number of votes for each response.
  106.  
  107.   o Ability to output a text file of voting results for questions within a
  108.      voting area.
  109.  
  110.   o Ability to assign a user to be sysop of a voting area, allowing him or
  111.      her to control sysop functions.
  112.  
  113.   o A log file utility to keep track, and show you what each user votes on,
  114.      when users add questions, when sysops pack the data file and more.
  115.  
  116.   o Security level settings to allow certain users or co-sysops access to
  117.      higher functions within Vote-O-Rama.
  118.  
  119.   o Built in split-screen chat mode, and ability to drop user from your bbs
  120.      or exit them from Vote-O-Rama at the touch of a button.
  121.  
  122.   o ANSI and NON-ANSI support!
  123.  
  124. Command Line Parameters:
  125. ────────────────────────
  126.  
  127.     Vote-O-Rama requires two command-line parameters in order to function
  128. properly as a door, but there are other options to help the sysop out.  Here
  129. is a complete list of command line parameters:
  130.  
  131.     VOTE.EXE <data file name> <door info file>
  132.              <data file name> LOCAL
  133.              <data file name>|@<data file list name> <door info file> /C
  134.  
  135.     The first listed above is used to run the program as an on-line program.
  136. <data file name> are the first eight characters for the voting database that
  137. Vote-O-Rama is to use, and <door info file> refers to the location and full
  138. filename of your BBS' user information file (either DORINFOx.DEF or
  139. CHAIN.TXT).
  140.  
  141.     The second example is used if you wish to run Vote-O-Rama from DOS to
  142. test it out or whatnot.  Again, <data file name> is the name of the voting
  143. database files, but instead of <door info file> put the word 'LOCAL'
  144. following.  Upon login, Vote-O-Rama will ask you which user to login as and
  145. will assign a sysop security level to you for that login only.
  146.  
  147.     The last option is added to notify users.  Using this option in
  148. conjunction with your logon batch file will tell users if they have questions
  149. in <data file name> that they have not voted on.  Note that using the '/C'
  150. parameter in this fashion does not use communications routines, and will not
  151. lock up when DOS calls are used (for WWIV software) in the logon batch file,
  152. or in a chains entry that uses DOS calls.  The <data file list name> in this
  153. parameter is very handy for sysops that have multiple voting areas.  Under
  154. normal circumstances, sysops would have to put an entry in their logon batch
  155. file for each voting area to check for each user, each time having to load
  156. up Vote-O-Rama!  This may get very slow, thus a special feature was added.
  157.  
  158.     You can create a file in the form of *.LST that is a simple text file
  159. with each line containing an eight-character voting area name.  For example,
  160. a typical *.LST file might look like this:
  161.  
  162.     GENERAL
  163.     SAMPLE
  164.     BBS
  165.  
  166.     Assuming the sysop has three voting areas with data files "GENERAL,"
  167. "SAMPLE," and "BBS."  Using this list, you can have Vote-O-Rama check EACH of
  168. these areas in succession without having to reload the program.  Simply place
  169. an at symbol (@) in front of the *.LST name on the command line when using
  170. the "/C" option, and Vote-O-Rama will refer to that list for the voting area
  171. data file names!  For example, if the above *.LST file was named VOTING.LST,
  172. the following command line would use that file to check voting data files in
  173. the logon batch file:
  174.  
  175.     VOTE @VOTING CHAIN.TXT /C
  176.  
  177.     "VOTE" loads Vote-O-Rama, and the "@VOTING" specifies to use the voting
  178. area names in the VOTING.LST file.  "CHAIN.TXT" is the name and location of
  179. the BBS' information file, and the "/C" tells Vote-O-Rama to check to see if
  180. the user on-line has questions to vote on.  This feature only works when
  181. using the "/C" option.
  182.  
  183.     If you're using WWIV, the software will automatically send the screen
  184. output through the modem.  In the case of any other software, Vote-O-Rama
  185. will create two output files in the current directory that you can display to
  186. the user to let them know if they have questions to vote on:
  187.  
  188.     VOTEDISP.ANS
  189.     VOTEDISP.ASC
  190.  
  191.     The .ANS file is for ANSI users, of course, and the .ASC for ASCII users.
  192. Vote-O-Rama overwrites these files each time it is ran, so there is no need
  193. to delete them.  You may delete them if you want to, it's purely your option,
  194. but is not required.
  195.  
  196.     Sysops that want to let users know of new questions, and who are using
  197. DORINFOx.DEF BBS software will need to edit their logon menu-type or batch
  198. file.  In other words, the menu, or batch file that is ran when the user logs
  199. on will need to have two commands added to it:
  200.  
  201.     The first menu command should shell and run Vote-O-Rama with the following
  202.     command line:
  203.  
  204.         VOTE <voting area> DORINFOx.DEF /C
  205.  
  206.     The second menu command should display an ASCII or ANSI file to the user.
  207.  
  208.     An optional command line parameter allows you to turn off CTS/RTS flow
  209. control.  Although this option is included, you should find no need to use
  210. it.  High-speed modems should NOT turn it off at all, otherwise, remote users
  211. of the program will get garbage while in the door.  To turn off CTS/RTS flow
  212. control, simply append a "/M" to the end of your command line.  For example:
  213.  
  214.     VOTE GENERAL CHAIN.TXT /M
  215.  
  216.     Will turn off CTS/RTS flow control.
  217.  
  218. Installation Of Vote-O-Rama:
  219. ────────────────────────────
  220.  
  221.     Installing Vote-O-Rama is quite simple.  First, create a subdirectory off
  222. of your main bbs directory (we'll assume your using "VOTE" as the name for
  223. that subdirectory), or if you have an area for on-line programs, create a
  224. subdirectory from there.  Unarchive the Vote-O-Rama files into that
  225. subdirectory.
  226.  
  227.     If you wish to keep your voting data files in another subdirectory, which
  228. is suggested, you should make another directory for those files at this time,
  229. preferably within your Vote-O-Rama subdirectory.
  230.  
  231.     Next, you will need to make a batch file to call the program from your
  232. WWIV chains menu, or create a menu option that runs the program.  This is
  233. where installation gets involved.  Whether or not you are planning on having
  234. more than one voting area does not make Vote-O-Rama more difficult to
  235. install.
  236.  
  237.     First, you will need to create a batch file in your main BBS directory.
  238. Here, we will assume that the directory is "C:\WWIV" (or C:\RA).  We will
  239. be passing two parameters into this batch file, the first being the name of
  240. the voting area, and the location and name of the door information
  241. file that the BBS creates.
  242.  
  243.     As you know, Vote-O-Rama takes two command line parameters.  The name of
  244. the voting area data files, and the location and name of door information
  245. file, in that order.  Instead of defining each voting area in different batch
  246. files, we will be making a batch file that can run any voting area, thus
  247. taking up less drive space, and making the addition of new voting areas much
  248. simpler.
  249.  
  250.     Here is a sample batch file:
  251.  
  252.     @ECHO OFF
  253.     CD VOTE
  254.     VOTE %1 %2
  255.     CD ..
  256.  
  257.     The first line is optional, but merely shuts off screen output during the
  258. batch file execution.  The second line changes into the subdirectory that
  259. we've created to hold Vote-O-Rama's program files.  The third line executes
  260. Vote-O-Rama passing in two variables which we will tell it later, and
  261. finally, the last line returns to the main BBS directory, assuming that's
  262. where we were when the batch file was ran.
  263.  
  264.     The %1 and %2 in the third line will be replaced automatically when we
  265. call the program from our on-line program area.  After you've created your
  266. batch file, put the Vote-O-Rama program files in their directory, you'll need
  267. to either enter the program in your CHAINS area (WWIV) or create a menu
  268. option for it.
  269.  
  270.     Insert a new program, and describe your voting area.  It is recommended
  271. that you use a descriptive name for an area, rather than just putting
  272. "Vote-O-Rama" for your description.  For example, if you're creating a voting
  273. area that will be about your BBS, name the description "General BBS Voting
  274. Questions" or something similar.
  275.  
  276.  
  277. If you're installing from WWIV:
  278.  
  279.     Next, for the filename, place the name of your batch file followed by an
  280. eight letter name for your voting data files (in the above example, you might
  281. put "GENERAL" as the data file names), followed by a %1.  This %1 will be
  282. replaced by WWIV with the location and name of CHAIN.TXT.
  283.  
  284.     For example:
  285.  
  286.     Description : General BBS Voting Questions
  287.     Filename    : <batch file name> GENERAL %1
  288.  
  289.     Ansi is NOT required for the use of Vote-O-Rama!  Users that do not have
  290. ANSI will see almost the same things as users with ANSI, save the ANSI colors.
  291. DOS calls should NOT be used!  Vote-O-Rama implements its own communication
  292. routines and will therefore lock up if DOS calls are used.  All other
  293. information is optional to the sysop, including the shrink function.  It is
  294. not recommended that you shrink if you do not need to.
  295.  
  296.     Description : General BBS Voting Questions
  297.     Filename    : VOTE GENERAL %1
  298.     ANSI        : Optional
  299.     DOS Calls   : NOT Used
  300.     Shrink      : Optional
  301.  
  302.     Setting up Vote-O-Rama this way easily allows us to add more voting areas
  303. in the future using the same batch file to call the program.  All that is
  304. needed is to put a different voting area name in the chains menu, followed
  305. by a %1.
  306.  
  307.  
  308. If you're installing from another BBS type:
  309.  
  310.     Be sure to use a type 7 or 15 exit from RA or QBBS.  You'll also need to
  311. enter the filename of your batch file as your optional data followed with the
  312. necessary command line parameters:
  313.  
  314.           <batch file name> <voting area name> <door information file name>
  315.  
  316.     For example:
  317.  
  318.           VOTE GENERAL DORINFO1.DEF
  319.  
  320.  
  321.     After you've installed Vote-O-Rama, you need to run it at least on time
  322. to initialize the voting data files and add a few questions for your users,
  323. assuming you're creating an area for yourself.  Otherwise, you can let your
  324. users create the questions for you, but you will still need to go into the
  325. program one time to create the data files and make sure that it is working
  326. okay.
  327.  
  328.     When creating a new voting area, Vote-O-Rama will ask you if you wish to
  329. do so, and then proceed to ask a few questions concerning the operation of
  330. this specific voting area.
  331.  
  332.     First, is a descriptive line about the voting area.  It is wise to put
  333. the same thing that you've entered in your chains entry for the description
  334. here, but you may put anything you like.  This line will be displayed at the
  335. top of screen when the user is at the main menu of Vote-O-Rama.
  336.  
  337.     Next, are questions concerning the configuration of this voting area.
  338.  
  339.     Allow Only One Vote Per User - will make Vote-O-Rama only allow one vote
  340.      per user.  This option is global to all questions, meaning that if set
  341.      to true (only one vote per person), all questions will only be allowed
  342.      on vote per person, but if set to false (more than one vote allowed),
  343.      creators of questions will be prompted as to whether or not they wish to
  344.      allow multiple votes.
  345.  
  346.     Allow Multi-Line Questions - This option tells Vote-O-Rama whether or not
  347.      to allow questions and responses of more than one line (maximum of three
  348.      lines).  Again, this option works similar to the previous one.  If set
  349.      to yes, creators of questions will be asked whether or not they wish to
  350.      allow multi-line responses, and if set to no, multi-line responses
  351.      and/or questions will not be allowed anywhere.
  352.  
  353.     Allow Users To Add Responses - This option tells Vote-O-Rama whether or
  354.      not users will be able to create responses to voting questions.  Again,
  355.      the creator of a question will choose if he or she wishes to allow users
  356.      to add responses, but they will only be given that choice if this option
  357.      is set to yes.
  358.  
  359.     Maximum Responses - This sets the maximum number of responses that a
  360.      question will have, ranging from a minimum of 2, to a maximum of 30.
  361.  
  362.     Security Level To Add Questions - This sets the minimum security level
  363.      that a user must have to add questions into the current voting database.
  364.      Minimum for this setting is 0 (for all users), and the maximum is 255
  365.      for WWIV software, and 32000 for others.
  366.  
  367.     Security Level For Sysop - This sets the minimum security level that a
  368.      user must have to access the sysop functions of Vote-O-Rama.  This
  369.      allows a sysop to allow his co-sysops or another user to be 'in control'
  370.      of a specific voting area based on his or her security level.  Again,
  371.      minimum value for this is 0 and the maximum is 255 for WWIV software,
  372.      and 32000 for others.
  373.  
  374.     Define User Sysop - Allows you to define a specific user to have sysop
  375.      security.  If you would like a user to run a voting area for you, or for
  376.      any reason that you would want a user to access sysop functions within
  377.      Vote-O-Rama, you would put their BBS handle or real name here.
  378.  
  379.  
  380.     After all questions are answered, Vote-O-Rama will initialize it's files.
  381. It is a good idea from there to create at least one or two questions to get
  382. the ball rolling if you are going to allow your users to add questions, and
  383. if not, you may want to go ahead and add all your questions that you can
  384. think of at this point.
  385.  
  386.     Along with the data files that Vote-O-Rama creates, you can create a
  387. plain ASCII file of any length with an introduction into each specific voting
  388. area.  By naming that file with the same eight letters of your voting
  389. database files, adding an extension of .MSG, and placing it in the same
  390. directory as your data files, Vote-O-Rama will show that file with screen
  391. pausing when a user enters the door.  This could be handy for an explanation
  392. of the voting questions, a disclaimer, or just a 'note from the sysop.'  For
  393. example, if your voting area name was GENERAL as in the above examples, you
  394. would name this file GENERAL.MSG, and put it in the directory as all the
  395. other files for that voting database.
  396.  
  397.     Also, you may create a different help file for each voting area instead
  398. of the one included with Vote-O-Rama.  To do so, simply create a plain ASCII
  399. text file, name it with the first 8 characters of your voting area, with an
  400. extension of '.HLP,' and place it in the directory with the voting area's
  401. data files.  That help file will be displayed instead of the default
  402. VOTE.HLP file.
  403.  
  404.     Don't worry if you don't have time to initialize Vote-O-Rama.  It will
  405. not allow a user who doesn't have a 100 security level or above to initialize
  406. it for you.  It will let the user know that the sysop has not yet initialized
  407. that voting area, and will return to the BBS.
  408.  
  409. Running The Program:
  410. ────────────────────
  411.  
  412.     After login, and after the 'last voter message' (assuming there is one),
  413. Vote-O-Rama's main menu will appear with a sysop information bar at the
  414. bottom of the screen.  This bar shows the current user in the door, and the
  415. keys used to return a user to the BBS, drop the user completely (hang up on
  416. them), or initiate chat mode with the user.
  417.  
  418.     Depending on what security level the current user has, the menu will show
  419. different things, but we will look at the main menu as a whole.  Menus that
  420. require a certain security level will be mentioned.
  421.  
  422.  
  423.     [L]ist Questions/Results - The first menu option does exactly what it
  424.      says.  Choosing this will list out all current voting questions, and
  425.      allow the user to select one to view the voting results of.  Questions
  426.      are listed one after the other, with:
  427.  
  428.          (*) an asteric next to question that have not been voted on by that
  429.              user,
  430.          (+) a plus sign if the user has voted, but multiple votes are
  431.              allowed, and
  432.          (-) a minus sign if a question is marked for deletion.  This mark
  433.              is only shown to users that have sysop security within
  434.              Vote-O-Rama.
  435.  
  436.      If a voting question was created "in response to" another question, that
  437.      question number it is responding to will be displayed underneath the
  438.      question.
  439.  
  440.  
  441.     [V]ote On Questions - This option will allow a user to select a question
  442.      to vote on.  Questions are listed in the same manner as when listing the
  443.      questions to see the results.  After selecting the question to vote on,
  444.      the question and its responses will be displayed.  If a user has already
  445.      voted, his choice will be highlighted from the rest of the list.  A
  446.      prompt will be shown with different options on it.  A user may either
  447.      enter:
  448.  
  449.          a number to choose as their vote,
  450.          '99' - to add their own response if the creator of the question has
  451.                 allowed users to add responses,
  452.          [K] - to mark a question for deletion if the created it,
  453.          [R] - to create a new voting question in response to the current one
  454.                (only if user has security level to add questions), and
  455.          [Q] - to quit voting and return to the list of questions prompt.
  456.  
  457.  
  458.     [S]can Questions Not Voted - Allows a user to scan through the questions
  459.      that they have not yet voted on.  This option does not list the
  460.      questions out in a list, but instead displays each question with a
  461.      prompt.  Users may either vote on the question, or skip it.
  462.  
  463.      Users will get basically the same prompt as displayed when they are
  464.      voting on a question while scanning, except for the [ENTER] to skip a
  465.      question.  Skipping a question will allow the user to not vote on a
  466.      question, but continue scanning through the rest of the available
  467.      voting questions.
  468.  
  469.     [E]nter A New Question - This option will allow a user to create a new
  470.      question.  The user must have the minimum security level entered by the
  471.      sysop to add questions in order to do this.  The maximum number of
  472.      questions per voting area is 999.  Depending on Vote-O-Rama's current
  473.      settings, the user will be asked their question, and then a few
  474.      questions, including if they wish to have their name associated with
  475.      this question.  Answering yes to that question will place the line
  476.      <user name> Asks: above the question.  For example:
  477.  
  478.          "John Doe Asks:"
  479.  
  480.      After answering all questions, the user will be prompted for available
  481.      responses.  The minimum number of responses is 2, and the maximum is
  482.      dependent on what the sysop has configured Vote-O-Rama to allow.  The
  483.      log file will record the activity of creating a new question.
  484.  
  485.  
  486.     [R]evise Questions - Allows a user with a sysop security level to look
  487.      directly at the voting question database, with the ability to delete
  488.      questions, modify votes, responses, and more.  See the section on
  489.      revising questions for more information.
  490.  
  491.  
  492.     [C]onfigure Vote-O-Rama - Allows a user with a sysop security level to
  493.      modify the current settings of the program.  Choosing this option allows
  494.      setting of a specific user to be a sysop, and setting options such as
  495.      multiple line questions/responses, sysop security level, etc.
  496.  
  497.  
  498.     [D]isplay Voting Log File - This option will display the current .LOG
  499.      file for a voting area with screen pauses.  A user must have sysop
  500.      security in order to do this function.
  501.  
  502.  
  503.     [K]ill Voting Log File - This option will delete the .LOG file for the
  504.      current voting area from disk.  As with displaying the log file, a user
  505.      must have the pre-defined sysop security to access this function.
  506.      Killing the log file will erase the log file, and start a new one with
  507.      the first line being a message that the current user deleted the log
  508.      file.
  509.  
  510.     [M]ake Voting Data File - This option, available to sysop security
  511.      defined users, will allow you to create a text file that lists each
  512.      question, and which users voted for each response.  Very handy to find
  513.      out who voted what.
  514.  
  515.     [P]resent Voting Data File - This option will display the Voting Data
  516.      File if it's available.
  517.  
  518.     [H]elp On Vote-O-Rama - Brings up on-line help for any user.  If a .HLP
  519.      file has been created for the current voting area, that file will be
  520.      displayed, otherwise, choosing this option will display the included help
  521.      text file (VOTE.HLP) with screen pausing, giving the major functions and
  522.      how to operate them.
  523.  
  524.      You may wish to create help files if your voting questions are difficult
  525.      to understand or cover complicated subjects.
  526.  
  527.  
  528.     [Q]uit To BBS - Allows the user to quit Vote-O-Rama and return to the
  529.      bbs.  If the user wishes, he or she may also leave a one-line message to
  530.      the next voter.  Vote-O-Rama will ask if the user is sure before exiting
  531.      the program.
  532.  
  533. Revising Questions:
  534. ───────────────────
  535.  
  536.     To help with the maintenance of voting questions, a menu option available
  537. to security level defined sysops called "Revise Questions" can be used.
  538. Choosing this option from the main menu will allow you to modify every
  539. feature about a specific voting question, or allow you to delete questions.
  540.  
  541.     After choosing this option, a screen will be shown that consists of
  542. information concerning the current question.  Each option has a number by it
  543. that may be pressed to toggle or change the option.
  544.  
  545.     [1] The Voting Question.  The first menu choice allows you to
  546.     specifically change the voting question.
  547.  
  548.     [2] The Question Creator.  This option allows you to change who created
  549.     the question.  It will not check if the user exists, so ANY name is
  550.     valid.  Have fun!
  551.  
  552.     [3] In Response To.  This menu selection allows you to modify which
  553.     question the current question is in response to.  Selecting '0' will make
  554.     the question not in response to any question.
  555.  
  556.     [4] Allow More Than One Vote.  A toggle.  Choosing this option will
  557.     toggle the current state.
  558.  
  559.     [5] Marked For Deletion.  This option will say "YES" if the current
  560.     question is marked to be deleted.  Refer to the option labeled '~' for
  561.     more information.
  562.  
  563.     [6] Allow Responses.  This option will allow/disallow addition of voting
  564.     responses for the current question from users.
  565.  
  566.     [7] Associate The Users Name.  This option will enable/disable the
  567.     display of the users name when displaying the question for voting.
  568.  
  569.     [8] Allow Multi-Line Responses.  This option will allow/disallow the use
  570.     of multi-line question responses.
  571.  
  572.     [V] Alter Votes.  This selection will allow you to modify the number of
  573.     votes that each response has received.  Each response will be displayed
  574.     with its number of votes in parenthesis.  Pressing ENTER will leave the
  575.     value unchanged, while entering any other number will change the number
  576.     of votes.  Please note that altering votes is offered as a remedy for
  577.     problems with voters accidently voting for the wrong response, or the
  578.     like.  Deleting votes from a response will NOT delete a users name from
  579.     that vote, meaning their will still be actual votes if there were votes,
  580.     and the votes was decreased to zero.
  581.  
  582.     [R] Alter Responses.  This menu selection will allow you to add, remove,
  583.     and modify the current responses.  When modifying an existing response,
  584.     pressing ENTER without entering anything will leave the response
  585.     unchanged.
  586.  
  587.     [~] Pack Data File.  This option will delete all questions that are
  588.     currently marked for deletion, removing them PERMANENTLY from the voting
  589.     data file.  You will be asked if you are sure before processing.
  590.  
  591.     [J] Jump.  Allows you to jump to a specific voting question number.
  592.  
  593.     [+] Next.  Will move through the voting data file to the next question.
  594.     Pressing ENTER at the main Revision prompt will execute this option.
  595.  
  596.     [-] Previous.  Will move backwards throughout the voting data file to the
  597.     previous question.
  598.  
  599.     [Q] Quit.  Exits the revision menu and returns you to Vote-O-Rama's main
  600.     menu.
  601.  
  602. Re-Configuring A Voting Area:
  603. ─────────────────────────────
  604.  
  605.     At times, you may find it necessary to assign a new Users Sysop, deleted
  606. the logoff message, or just reconfigure Vote-O-Rama.  To do this, you can
  607. press the "C" key from the main menu to Configure Vote-O-Rama.  This option
  608. is only available to users with sysop defined security.
  609.  
  610.     From this menu, you can define all voting area information that was
  611. defined when you first initiated the voting data files for that area.  The
  612. last option will allow you to view and/or delete the logoff message.  If you
  613. modify any of the question-specific information, such as maximum responses,
  614. only questions created after you've set the new value will be affected.
  615. Questions that are already created will remain unchanged.
  616.  
  617.     If you wish to change the directory where the voting data files are
  618. stored, you will first need to create that directory, and copy the voting
  619. data files into that directory.  The voting data files are all the files for
  620. a voting area, EXCEPT for the area file with a ".VOT" extension.  The file
  621. with the ".VOT" extension MUST be in the directory that you are running
  622. Vote-O-Rama from, otherwise, it will not function properly.
  623.  
  624. The Sysop Function Keys:
  625. ────────────────────────
  626.  
  627.     While a user is inside Vote-O-Rama, there are many keys available only on
  628. the sysop's end.  These function keys may be used at any time during the
  629. execution of Vote-O-Rama, and where applicable, will restore the screen after
  630. their function is complete.
  631.  
  632.     Returning a user to the BBS instantly (F4) - Pressing the F4 function key
  633.     will exit Vote-O-Rama and return the user to the BBS instantly.  All
  634.     important data files are closed before exiting the door, so no data will
  635.     be lost.
  636.  
  637.     Hanging up on the user (F5) - Pressing the F5 function key will hang up
  638.     on the user after a burst of 'line noise.'  After closing files,
  639.     Vote-O-Rama will return to the BBS, and from there, the board will reset.
  640.  
  641.     Temporary Sysop (F9) - At times, you may need to fix something within
  642.     Vote-O-Rama while another user without sysop security is on-line.  Using
  643.     this function key will temporarily give the user sysop security within
  644.     Vote-O-Rama, allowing all the functions of adding questions, revising,
  645.     and running the configuration routines.  The sysop bar will flash the
  646.     users security level if they are currently in temporary sysop mode.
  647.     Press F9 to toggle this function on and off.
  648.  
  649.     Split-screen chat (F10) - Pressing this key will engage a split-screen
  650.     chat with the current user on-line in Vote-O-Rama.  Press ESCape to exit
  651.     chat mode.  Vote-O-Rama will restore the screen to the point where chat
  652.     mode was initiated.
  653.  
  654.     DOS Shell (Shift + F10) - At times, you may need for some reason to be
  655.     able to drop to your operating system for a few minutes.  Pressing this
  656.     set of keys will do just that, allowing you to do just about anything
  657.     from DOS.  Type EXIT to return to Vote-O-Rama.  Again, the screen will be
  658.     restored to the point where Vote-O-Rama left off.
  659.  
  660. Registration Of Vote-O-Rama:
  661. ────────────────────────────
  662.  
  663.     Vote-O-Rama is being distributed under the shareware concept.  After a
  664. trial period of 30 days, you should register this program with Datagen
  665. Software Designs.  Simply fill out the enclosed registration form and send
  666. it with the registration fee of $5 (five) U.S. to the address listed on the
  667. form.
  668.  
  669.     Registration of Vote-O-Rama entitles you to free upgrades of the same
  670. version number: ie. 1.xx, will place your sysop name and your bbs name in the
  671. program, and give you a spot on the Datagen Software Designs preferred mailing
  672. list.  Registration also will help Datagen Software Designs to continue their
  673. efforts to produce low-cost, quality shareware.  It may also give you a warm,
  674. fuzzy feeling in your heart!
  675.  
  676. Support BBS Information:
  677. ────────────────────────
  678.  
  679.     For information on becoming a respectable Datagen Software Designs support
  680. Bulletin Board System, simply mail the below address, with the following
  681. information:
  682.  
  683.    (Note - you must include all information.)
  684.  
  685.         BBS Name,
  686.         BBS Phone Number,
  687.         BBS Type and Version,
  688.         BBS Net/Node (if applicable)
  689.         Disk Size (5 1/4" or 3 1/2")
  690.         Sysop Name,
  691.         Sysop Real Name,
  692.         Sysop Address,
  693.         Sysop Age,
  694.         How Long Your System Has Been Up,
  695.         And finally, your reason for wanting to become a support BBS.
  696.  
  697.     Sysop's requesting to become a support board will be notified as soon as
  698. possible on their request, and if accepted, will be eligible to receive
  699. Datagen's Support BBS Newsletter, technical support on all Datagen products,
  700. and MUCH more!  Send requests to:
  701.  
  702.         Support BBS Information
  703.         Datagen Software Designs
  704.         1732 Wind Drift Rd.
  705.         Orlando, FL  32809
  706.  
  707.     Questions, comments, complaints, or to receive a complete listing and
  708. description of all Datagen products, you may mail John Dailey through
  709. Compuserve at 73124,2612 or by U.S. mail at the below address.
  710.  
  711.     Thank you for your support!
  712.  
  713.         Vote-O-Rama v1.0
  714.         C/O John Dailey
  715.         1732 Wind Drift Rd.
  716.         Orlando, FL  32809
  717.  
  718.  
  719.  [EOF]
  720.  
  721.