home *** CD-ROM | disk | FTP | other *** search
/ Power Programming / powerprogramming1994.iso / progtool / bbsdoors / bvote.arc / BVOTE.DOC next >
Text File  |  1989-08-28  |  9KB  |  231 lines
  1.  
  2. BVote 0.1
  3. (c) 1989 Bogusware & Chris Rowley, all rights reserved
  4.  
  5. Chris Rowley
  6. 11808 Canfield Rd
  7. Potomac, MD  20854
  8. (301) 762-8486 home voice
  9. (301) 848-0727 school voice
  10. (301) 340-9048 home data (Random Factor II)
  11.  
  12. Disclaimer & Use
  13. ----------------
  14. BVote was written because I downloaded some other putz's voting booth program
  15. and the weasel wanted twenty-five bucks to register it and get utilities
  16. to alter booths.  Big schmeal!  Twenty-five bucks!  And the stinker would
  17. kick out ANSi crap all the time whether I wanted it or not.  So I said, "In
  18. keeping with the fine Bogusware tradition of my past utilities FileUtil
  19. and more, I'll write something that's FREE, that comes with source code,
  20. and has every feature that anyone could want except for that guy in
  21. Rhode Island who needed it to sort punctuation but that's another story."
  22. So here it is, in pure, undiluted form, messy source code and all.  The
  23. major feature of 0.2 will be new, improved, partially-documented code!
  24. Woo!  Won't that be spiffy?
  25.  
  26. So, of course, you are free to use this program any way you want.  Want to
  27. change all the obnoxious text messages to random profanity?  Feel free.
  28. Want to add new bugs and blame me for them?  Fine.  I don't care.  Because
  29. that's our attitude here at Bogusware.  In case you didn't know it,
  30. at Bogusware we say, "Man, if I had to pay for that, that'd be bogus!"
  31. Communications are for fun-loving guys!  Monetary masochists!  Running
  32. a BBS is a social thing.  As Judd Nelson said, "Demented and sad... but
  33. social."  Such is BVote.
  34.  
  35. So, the only disclaimer I can say is that we can only pray that running
  36. BVote doesn't cause yer computer to smoke, burst into flames, become
  37. possesed by the demon from the ninth level of hell or randomly dial
  38. 976 numbers.  BVote, like me, is as innocent as a new-born lamb.  So
  39. don't blame it.  BVote doesn't crash computers, people do.
  40.  
  41. Features
  42. --------
  43. BVote is a multi-use voting booth designed to be all things to all people.
  44. It is designed for use with QuickBBS, but it'll work with anything that
  45. creates the DORINFO1.DEF file which has the users name on line 6 and 7 and
  46. their security level on line 10.  It will also run in local mode with
  47. no DORINFO1.DEF which allows the user to enter a name and get instant
  48. sysop access.  This allows easy local testing, debugging, and maintenance.
  49. BVote needs some sorta driver, I use DOORWAY, an EXCELLENT shareware
  50. package that tracks time, carrier, and even intercepts direct-screen writes.
  51. If you want to write doors and don't want to touch your COM ports, buy
  52. this excellent package.
  53.  
  54. BVote uses no fixed files, allowing you to have as many different "polling
  55. places" as you like.  Each polling place can have up to 99 booths (if
  56. Messy-DOS were a real operating system like AmigaDOS we wouldn't have this
  57. filename length problem), and each booth can have up to 20 responses.
  58. The sysop can be the only one who can create booths if ya want, but it
  59. is much more fun to let users add booths.  You can view results, and vote
  60. in two different ways, including the preferred 'scan' mode that goes
  61. from most recent to oldest question.  You may prevent users from voting
  62. more than once.  There is a complete log kept.  All aspects of every booth
  63. can be modifed by the sysop.
  64.  
  65. Getting Started
  66. ---------------
  67. Just type 'bvote [filename]' where fileame is the 1-8 character polling
  68. place name.  If you don't include this, BVote will report that there
  69. is nothing to do.
  70.  
  71. If [filename] is new, you will be asked whether or not you really want
  72. to create a new polling place.  If you say yes, you will be asked the
  73. following questions:
  74.  
  75. Only allow people to vote once?
  76.      If you enable this option, BVote will allow creators of booths to set 
  77.      whether or not usres can vote more than once in their booth.
  78.  
  79. Allow users to add responses?
  80.      If enabled, creators of booths can determine whether the responses
  81.      to their booths are fixed or not.
  82.      
  83. Allow multi-line choices?
  84.      Enabled means questions and responses can be 1 to 3 lines instead of 
  85.      only one.
  86.      
  87. Minimum security to create a booth?
  88.      Just what it says, the security required to add a booth.
  89.      
  90. Minimum sysop security?
  91.      Security level required to access 'Revise Booths' and 'Log' commands.
  92.      
  93. Once these parameters are set, a few files are created:
  94.      [filename].pp  -- info on the polling place
  95.      [filename].vb  -- questions, responses, results
  96.      [filename].log -- log of recent user activity
  97.      
  98. When new booths are added, if the tracking option is enabled a file 
  99. called [filename].Uxx will be created where 'xx' is the number of the 
  100. booth.  This file tracks each name to prevent duplicate voters.
  101.  
  102. You may optionally create a [filename].wel file that will be displayed 
  103. to users with pertinent info, etc.
  104.  
  105. The Menu
  106. --------
  107. To the sysop, the menu appears as:
  108.  
  109. [L] List booths and results                [V] Vote in booths
  110. [S] Scan booths newest to oldest           [G] Goodbye
  111. [E] Enter a new booth                      [R] Revise a booth
  112. [1] View booth logs                        [2] Kill booth logs
  113.  
  114. The commands are summarized below.  Options L, V, S and G are shown
  115. to all security levels, option E to those of ADDSEC or above, and
  116. options R, 1 and 2 to those of SYSSEC or above.
  117.  
  118. List Booths
  119. -----------
  120. This option automatically displays a list of all booths, first to last.
  121. An option line appears as follows:
  122.  
  123. Which One? [1-xx,L=list]
  124.  
  125. The user may type the booth number to review the results of, or L to
  126. re-list the booths.
  127.  
  128. Vote in Booths
  129. --------------
  130. This option displays a list of all booths, first to last, then offers
  131. the same option line as in List Booths.  After choosing a valid booth,
  132. the following option line is displayed:
  133.  
  134. Your choice? [1-xx,99,L=list,K=kill,R=reply,0=quit]
  135.  
  136. Option 99 is displayed only if the user may add a response.  Option K
  137. only appears if a sysop is on or the user who created the booth is on.
  138.  
  139. The choice is possible response 1 to however many.  99 allows the user
  140. to add a new response and add one vote to its count.  L re-lists the
  141. possible responses.  K marks the booth for deletion.  R allows the
  142. user to create a new booth that references the previous question.  For
  143. example, the booth that asked "How many sheep was Melvin with last
  144. night?" might get someone to ask "Was that group of sheep Melvin's
  145. family?"  0 quits out of the response mode.
  146.  
  147. Scan Booths
  148. -----------
  149. This option starts with the most recent questions, pauses with the
  150. above option line, and moves on the next oldest question
  151.  
  152. Goodbye
  153. -------
  154. Confirms that the user wants to log off, allows optional one-line to
  155. next caller.
  156.  
  157. Enter New Booth
  158. ---------------
  159. Allows user to create a new booth.
  160.  
  161. First the user is allowed to enter the question.  If multi-line is
  162. allowed, this question may be 1 to 3 75 character lines otherwise
  163. one line.
  164.  
  165. The user is then prompted for some stats about the booth.  First, the
  166. user specifies whether or not his or her name should appear above the
  167. question.  Next, if add-on responses are allowed in the polling place,
  168. the user can specify whether they are allowed for this booth.  Similar
  169. questions for user tracking and multiple-lines follow.
  170.  
  171. Next, up to 20 responses may be entered, a minimum of 2 required.
  172.  
  173. Revise a Booth
  174. --------------
  175. This sysop maintenance tool allows every aspect of every booth to be
  176. altered.  It's not too friendly at the moment.  The following record
  177. is displayed:
  178.  
  179. Record #x of of y
  180. [1] question line 1
  181.     question line 2
  182.     question line 3
  183. [2] created by: name (date)
  184. [3] Response to question: z
  185. [4] Track: T/F [5] Killed: T/F [6] Addons: T/F
  186. [7] Titleit: T/F [8] Multi: T/F
  187. [9] Alter votes (m total) [0] Alter responses (n available)
  188. [Q] Quit [+] Next record [-] Previous record [J] Jump
  189.  
  190. Options are 0-9, Q, J, + and -.  Q quits to the main menu.  + and -
  191. increment and decrement x respectively.  J allows you to jump to record
  192. x.  Option 4 to 8 are toggles.  1 allows you to change the question, 2
  193. changes the creator's name.
  194.  
  195. 9 allows you to change the number of votes recorded for each response.
  196.  
  197. 0 allows you to change the actual text of the different responses.
  198.  
  199. List log
  200. --------
  201. Display useage log.
  202.  
  203. Kill log
  204. --------
  205. Deletes active log.
  206.  
  207. Theory
  208. ------
  209. There is none.  Other than that voting booths are fun.  Have fun with
  210. BVote.
  211.  
  212. Conclusion
  213. ----------
  214. This is release 0.1.  It was written in less than 20 hours spread over
  215. two weeks (I was in Ocean City for a week, eh?).  I'm sure there are
  216. bugs, missing features, etc.  Drop me a line by mail, phone, or message.
  217.  
  218. BVote, (c) 1989 Bogusware, All Rights Reserved.
  219. All contents are freely redistributable.  If you muck up the code,
  220. please don't reupload it and screw someone over, eh?  If you have
  221. problems, I'll search my code, but if someone has tampered, what am I
  222. to do?
  223.  
  224. Bogusware.
  225. "Man, if I had to pay for this, that'd be bogus."
  226.  
  227. Any contributions for this program (which are not requested, but if ya
  228. send 'em in, I gotta do sumpin' with 'em) will be donated to your
  229. choice of (a) The Get Steve Laid Fund or (b) Gamma Omnicron Delta beer
  230. fund.
  231.