New Year's Resolution Maker
Written and (C) 2008 by Sean Dennis
Another Cheepware production!
http://nsbbs.darktech.org
=============================================================================

This program is a BBS door.  If you don't know what that means, then this
program is not meant for you to use.

This door will run on any BBS system that supports 16-bit DOS doors, a
FOSSIL driver and one of the following dropfile formats: DOOR.SYS,
DORINFO1.DEF or SFDOORS.DAT.


-> LICENSE
   -------
   New Year's Resolution Maker (C) 2008 Sean Dennis (hausmaus@darktech.org).
   All rights reserved.
   
   This program is freeware, meaning you may use it without charge, but the
   program and its associated  files remain the property  of Sean  Dennis.
   
   Under this license, you cannot:
   
    * Reverse engineer this program by any means
    * Charge a fee for the use of this program (this includes the use of this 
      door on a pay BBS)
    * Include  this  program as part of a software collection of any kind 
      (excluding BBS filebases) without written permission of the author.
   
   There is no warranty, expressed or implied.  There is no guarentee of future
   support or development of this program and the author is not obligated to
   provide support.
   
   
-> ABOUT THE DOOR
   --------------
   I was thinking about a new door for Christmas and making New Year's
   resolutions came to mind.  The thought of that made me laugh, so I wrote
   this because it would be a fun door to run at Christmas.
        
   Some of the features of this door:
   
    - Supports DOOR.SYS, DORINFO1.DEF and SFDOORS.DAT drop files.

    - DOS, DesqView, Windows, and OS/2 friendly.

    - ANSI.SYS not needed as the door has its own ANSI driver.

    - Reads all needed runtime information from the dropfile, meaning
      no configuration files!
 
  Requirements to run this door:

    - A BBS that is capable of running 16-bit DOS doors and can produce
      DOOR.SYS, DORINFO1.DEF or SFDOORS.DAT dropfiles.  This door DOES
      NOT SUPPORT DORINFOx.DEF dropfiles!

    - A FOSSIL driver.

    - ANSI.SYS is NOT required as the door has its own ANSI driver.

    - The user must have ANSI emulation enabled.
   
    
-> INSTALLATION
   ------------
   Create a directory for the door and unzip this archive into it.
   
   The command line options are:
   
   /Nx      - Node number (i.e. /N2): if you using either the DOOR.SYS or
              SFDOORS.DAT dropfiles, the node number parameter (/Nx) is
              optional since those two dropfiles include the node number 
              as part of the respective dropfile.  If you are using
              DORINFO1.DEF, you will need to pass the node number on the
              command line.
   /D<info> - Full path to dropfile and dropfile type
   /L       - Forces local mode (no dropfile)
   /@       - Toggles screen clearing.  The door will normally
              start with screen clearning enabled, but if you
              use this toggle, screen clearning will be disabled.
   /+       - I like to give credit where credit is due.
   /?       - Shows help screen
      
   FREEDOM /N2 /Dd:\sf\node2\door.sys
   FREEDOM /N2 /Dd:\sf\node2\dorinfo1.def
   FREEDOM /N2 /Dd:\sf\node2\sfdoors.dat /@
   FREEDOM /L
      
   If you are in a local login on your BBS and you run this door, this
   door will know you're in local mode (as evidenced by "Local" showing
   on the status bar at the bottom for the COM port) and run normally as
   if you logged in locally from the command line.  The door will default
   to node 1 unless you specify the node number on the command line.
   
   The use of the node number is OPTIONAL.  The door doesn't need the
   node number to run, but if you set the node number, it will show
   up on the sysop infobar at the bottom.  So it's up to you if you
   want to use the node number or not. 

   An example batch file for single node use:
   
   @echo off
   d:
   cd\bbs
   resolute /dd:\bbs\door.sys
   cd\bbs
   
   In single-line mode, the door defaults to node 1.
   
   An example batch file for multi-node use:
   
   @echo off
   d:
   cd\bbs\node%1
   resolute /n%1 /dd:\bbs\door.sys
   cd\bbs\node%1
   
   You'll need to pass the node number to the batch file.  See your
   BBS documentation on how to do that.
   
   Since I run each node of my multinode SPITFIRE BBS in its own
   directory, I don't use an environmental variable.  I use something
   like this (a batch file, RUNFRE.BAT, called from SF.BAT):
   
   @echo off
   d:
   cd\sf\node2
   resolute /n2 /dd:\sf\node2\sfdoors.dat /@
   cd\sf\node2

   NOTE TO SPITFIRE SYSOPS: Unless you use this door in your door section,
   DO NOT USE SFDOORS.DAT!  Use DOOR.SYS, not DORINFO1.DEF.  You'd think
   a SPITFIRE sysop would know that, but I've been proven wrong. :)
      
   A quick note about the status bar you see when the door is running on
   your BBS with a remote caller...the status bar looks like this:

    <door and author information>
    <caller name>     <node #> <OS> <COM port> <emulation> <KP> <TL>

   It's easy to understand, but there's a few things you should know:

     - <OS> will always show as "DOS" under Windows.  If you're running
         the door under OS/2, it will say "OS/2".
     - <KP> is the number of seconds since the last keypress.
     - <TL> is the time left before the door kicks the user off.
     - If you login locally to the door and do not enter a name at the 
         local login prompt, <caller name> will be blank.
     - If you login locally to the door, <COM port> will say "Local".
   
   
-> NOTES
   -----
   There's nothing customizable in this door.
   
   
-> CREDITS AND THANKS
   ------------------
   "New Year's Resolution Maker" was written using Turbo Pascal 7.0 (RTE200 
   patched) using the FKFOSSIL doorkit under Windows XP Professional.  The EXE
   was compressed with aPack.
   
   This door uses the following code:
     - aPack (C) 1997-2000 by Joergen Ibsen-all rights reserved.
       For more information about aPack please visit 
       http://www.ibsensoftware.com.

     - FKFOSSIL v1.02 (C)1993-1994 by Tim Strike and Forbidden Knights Systems.
     - PTG (C) Doug Renyolds (modified by me).
      
   Thanks to Michael Preslar and Larry Athey for contributing code and to
   my beta team for doing what they do.
   
   If you'd like to see more Cheepware, please visit my website at
   http://nsbbs.darktech.org.  If you'd like the latest and greatest and
   are a member of Fidonet, ask your uplink about subscribing to the
   CH_WARE filebone.
   
   If you'd like to contact me, you can do so via email at
   hausmaus@darktech.org.  You may also contact me via netmail at
   1:18/200@Fidonet or 618:618/1@Micronet.  I can be found
   in Fidonet in the BBS_CARNIVAL and DOORGAMES echoes.
      
   Thank you for using Cheepware.  Support your local BBS scene...and
   if there isn't one, start one!
   
   -- Sean Dennis
      Cheepware Author
      
<EOF>
      
