home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DSDVTE13.ZIP / DSD-VOTE.DOC < prev    next >
Text File  |  1993-05-12  |  8KB  |  242 lines
  1.  
  2.                       Dominion Software Designers
  3.                          User Voting Door V1.3
  4.  
  5.          (c) Copyright 1992,93 Craig Westbury & David Neighbour
  6.         
  7.  
  8.     INTRODUCTION
  9.     ~~~~~~~~~~~~
  10.  
  11.     DSD Vote is a Remote-Access V1.11/V2.0 Compatible user surveying
  12.     BBS Door that allows users to create questions for other
  13.     users to annonymously vote on.
  14.  
  15.     
  16.     DISCLAIMER
  17.     ~~~~~~~~~~
  18.  
  19.     DSD VOTE HOLDS WITH IT NO GUARENTEES EXCEPT THAT IT WILL OCCUPY
  20.     DISK SPACE.  THE AUTHORS CAN NOT AND WILL NOT BE HELD RESPONSIBLE
  21.     FOR ANY DAMAGE OF HARDWARE OR LOSS OF SOFTWARE THAT OCCOURS FROM
  22.     THE USAGE OF DSD VOTE.  USEAGE IS AT YOUR OWN RISK.
  23.  
  24.     But despite this we have endevoured to make this software as BUG
  25.     free as we can and hope that you have no problems using it on
  26.     your system.
  27.  
  28.     
  29.     DISTRIBUTION
  30.     ~~~~~~~~~~~~
  31.     
  32.     DSD VOTE V1.3 is SHAREWARE, unlike versions 1.0 and 1.1,
  33.     it is now SHAREWARE as I have found myself spending alot of
  34.     time adding things that were wanted.
  35.  
  36.     Registration of DSD-VOTE is detailed in the registration form
  37.     included in this package and is only $15 Australian.
  38.  
  39.     You may pass the Unregistered version on to anyone, as the
  40.     Unregistered version is freely distributable as long as
  41.     this documentation acompanies it.
  42.  
  43.     UPDATING
  44.     ~~~~~~~~
  45.  
  46.         if you are updating from DSD-VOTE V1.1 this is IMPORTANT if you
  47.         are updating from V1.2+ then this is irrelevant.
  48.  
  49.  
  50.     If you are updating from an earlier version of DSD VOTE then it
  51.     is very important that you run UPDATE12.EXE before you install
  52.     the new DSD VOTE V1.3.
  53.     The structure of the Question file has changed slightly so to
  54.     accomodate this I have written the UPDATE program to change
  55.     your data so you do not need to scrap it.
  56.     The Command Line usage of UPDATE12 is
  57.     UPDATE12 <filename>
  58.     where filename is the full path and name of your DSD VOTE
  59.     (DSD-VOTE.QUE) question file.  Once this has been run DSD-VOTE 
  60.     should run nicely.
  61.  
  62.  
  63.     REGISTRATION
  64.     ~~~~~~~~~~~~
  65.  
  66.     On registering DSD VOTE you will recieve a key file called
  67.     DSD-UTL1.KEY.  This keyfile will 'unlock' the registered
  68.     features of any DSD Door in the Utilities 1 Pack, which are
  69.     currently DSD-BANK and DSD-VOTE.
  70.  
  71.     See the REGISTER form for more info.
  72.  
  73.     
  74.     REQUIREMENTS
  75.     ~~~~~~~~~~~~
  76.  
  77.     DSD VOTE should run on any MS-DOS compatible XT/AT Computer.
  78.     It should work with MOST video modes, and in 512K ram computers.
  79.  
  80.     For people who are multi-tasking it requires SHARE.EXE to be loaded
  81.     so it can share it's datafiles if 2 people are using it at the same
  82.     time.
  83.  
  84.     You will also need a FOSSIL communications driver (like BNU by
  85.     David Nugent) as DSD VOTE uses the FOSSIL for all communications
  86.     routines.  If no fossil is in memory when you run DSD-VOTE it
  87.     will complain about it and will not run.
  88.  
  89.     Otherwise you need a BBS program that creates a DORINFO drop file
  90.     or a converter so that DSD VOTE can get the users information.
  91.  
  92.     
  93.     SETTING UP
  94.     ~~~~~~~~~~
  95.  
  96.     Create a Directory somewhere, copy DSD-VOTE.EXE and DSD-VOTE.DOC 
  97.     into that directory and you have installed DSD-VOTE !
  98.  
  99.     You will then need to create an exit from your BBS, we use a 
  100.     Remote Access menu exit type 7, to run a batch file to run DSD VOTE
  101.  
  102.     e.g.    Type 7 Execute - *C *M /C DSD-VOTE.BAT
  103.  
  104.     and the batch file looks something like this -
  105.  
  106.     C:
  107.     cd C:\BBS\DSD-VOTE
  108.     DSD-VOTE -D=C:\BBS\NODE1\DORINFO1.DEF -S=200
  109.     cd C:\BBS\NODE1
  110.  
  111.     Multi-Line systems do not need to do anything more than point the
  112.     -D= parameter to the right DORINFO file for each node, DSD VOTE
  113.     will let any number of people use it at the same time quite hapily.
  114.  
  115.  
  116.     COMMAND LINE PARAMETERS
  117.     ~~~~~~~~~~~~~~~~~~~~~~~
  118.  
  119.     You may use several command parameters with DSD VOTE
  120.  
  121.  
  122.         -D=<dorinfo path>
  123.         -----------------
  124.  
  125.         This specifies the path to find the dorinfo file, 
  126.         for multiple nodes you can multiple batch files to
  127.         call DSD VOTE each one indicating a different dorinfo path.
  128.  
  129.         e.g. Line 1    - DSD-VOTE -D=C:\BBS\NODE1\DORINFO1.DEF
  130.              Line 2    - DSD-VITE -D=C:\BBS\NODE2\DORINFO1.DEF
  131.              etc
  132.  
  133.         -A=<alternate file path>
  134.         ------------------------
  135.  
  136.         This specifies the path to look for and store the data files
  137.         DSD-VOTE.PLY and DSD-VOTE.QUE, if the files are not found
  138.         or cannot be created in this alternate path they will
  139.         default back to the Current Directory.
  140.  
  141.         e.g. DSD-VOTE -A=C:\BBS\DSD-VOTE\SET1\
  142.             Will store the datafiles in SET1 directory.
  143.              DSD-VOTE
  144.             Will store the datafiles in the current directory.
  145.  
  146.         -S=<security level>
  147.         -------------------
  148.  
  149.         This is the security level that if the user entering DSD VOTE
  150.         has this security or better then they will be given the
  151.         Delete question option.  This defaults to 1,000,000
  152.  
  153.         e.g. DSD-VOTE -S=200
  154.             User with security 200 or greater can delete questions.
  155.              DSD-VOTE
  156.             Users with security 1000000 or greater can delete.
  157.  
  158.         -N=<pack number>
  159.         ----------------
  160.     
  161.         This specifies the number of questions to pack the question
  162.         data file to.  It is used in conjuction with the PACK option.
  163.         Range of 20 to 95.
  164.  
  165.         PACK
  166.         ----
  167.  
  168.         If the word pack is on the command line then DSD VOTE will go
  169.         into maintainance mode and will first delete any questions
  170.         that have been marked for deleteing and then it will cut the
  171.         question file back to the number of questions specified
  172.         with the -N= option.  This will default to 90.
  173.  
  174.         If you do not run the pack option and users manage to enter
  175.         100 questions then they will not be allowed to enter any
  176.         more.
  177.  
  178.         e.g. DSD-VOTE -N=30 PACK
  179.             Delete marked questions and pack to 30 questions.
  180.              DSD-VOTE PACK -A=C:\BBS\VOTE\SET1
  181.             Delete marked questions and pack to 90 questions
  182.             the data file contained in SET1 directory.
  183.  
  184.                 The Pack option is a bit slow, but it has to update
  185.                 question pointers for each question for every user.
  186.                 This takes alot of cross-referencing.  This is needed
  187.                 to keep the ONCE only voting system running OK.
  188.  
  189.     A NOTE ON DELETION
  190.     ~~~~~~~~~~~~~~~~~~
  191.  
  192.     When a user is given Delete security (as specified in the -S= 
  193.     option), then they will be given the (D)elete option on any 
  194.     question.  If they Press D the question will then come up to
  195.     any user as CENSORED.  It is not deleted right there and then.
  196.     Any user with Delete access may then Toggle the deleted question
  197.     just by pressing D again.
  198.  
  199.     It is not until the PACK option is run will the question actually
  200.     be deleted.
  201.  
  202.     In this case if you see a question that has been deleted by a user
  203.     you may toggle the delete to read it, and then chose for yourself.
  204.  
  205.     BUT as soon as a PACK option is run, it will be deleted if left 
  206.     with the Delete flag on that question.                
  207.  
  208.     For even more ease, the DSD-VOTE PACK option can be added to your
  209.     nightly event to delete questions and continually trim the
  210.     question file.
  211.  
  212.  
  213.         SYSOP KEYS
  214.         ~~~~~~~~~~
  215.  
  216.         Two special keys are available to the SYSOP
  217.  
  218.         ALT-K, kick user out of the door back to the BBS.
  219.         ALT-C, SYSOP chat with user, sometimes this will make you
  220.                wait until a polite time to break in.
  221.  
  222.         
  223.     CONTACTS
  224.     ~~~~~~~~
  225.  
  226.     To contact Dominion Software Designers you can post us a letter!
  227.  
  228.     Address  :  PO BOX 664, BRIGHTON, SOUTH AUSTRALIA, 5048, AUSTRALIA
  229.  
  230.     You could call our BBS -
  231.  
  232.     The Dominion Multi-Line   :  61-8-377-1983 (14400)
  233.  
  234.     Echo Mail at -
  235.  
  236.     Fidonet  :  3:800/863            Worldnet  :  61:9000/517
  237.  
  238.     or E-Mail Craig Westbury 
  239.  
  240.     Internet  :  cjwestbu@teaching.cs.adelaide.edu.au
  241.  
  242.