home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / inner_s / is_read.me < prev    next >
Text File  |  1988-02-06  |  38KB  |  822 lines
  1. IS_READ.ME
  2. **********
  3.  
  4.  I'm not particularly familiar with all the legal ramifications of software
  5. copyright law so I'll express my intent here.  I intend to retain control of
  6. the source to Inner Sanctum for the forseeable future.  The executables are
  7. hereby released to the Public Domain for use at your own risk.  I fully 
  8. support the Public Domain concept and hope software authors will continue to
  9. produce for it.  Please keep all the IS archives intact if you pass them along
  10. to someone else.  So given all that...   
  11.  
  12.  Inner Sanctum v1.75, Copyright (c) 1988 by John D. Walker AKA Ganelius
  13.  
  14.  
  15. INSTALLATION: New Inner Sanctum Sysops
  16. **************************************
  17. First get a hold of the documents available for version 3.0c of Citadel. Almost
  18. all of that will be of use in setting up your bbs.  I'm not going to cover all
  19. of that here.  (Maybe one of the beta testers will volunteer to help out with
  20. documentation?? please?)
  21.  
  22. Make sure you have an AUTO FOLDER set up on your boot disk, and copy
  23. SERINIT.PRG from IS_AUTO.ARC into it.  The rest of the programs in IS_AUTO are
  24. optional.  SERINIT is used to expand the input and output buffers of the serial
  25. port beyond the normal limits.  This makes Ymodem operate more efficiently.
  26.  
  27. Edit the file CTDLCNFG.SYS to handle your situation.  You can work from the
  28. copy in IS_RUN.ARC.  That is the one I use on my system.  Make sure you have
  29. set up directories to match the ones you specify in this file.  NOTE:
  30. networking is not available with Inner Sanctum yet, so do not enable it from
  31. the configuration file, or you'll just crash.
  32.  
  33. Copy all of the files from the IS_HELP.ARC file into the directory you have
  34. configured for them.  Edit them to suit your tastes and objectives.  Some
  35. files to edit:  BANNER.BLB, NOCHAT.BLB, INTRO.BLB, BULL7QA.BLB, POLICY.HLP.
  36.  
  37. Now run the configur utility to create CTDLTABL.SYS from the file you just
  38. edited.
  39.  
  40. The following files should all be in the same root directory of some disk:
  41.   citadel.prg
  42.   ctdltabl.sys (created by the configur utility)
  43.  
  44. Now you should be ready to start up Inner Sanctum...
  45.  
  46.     You should be able to boot it up now. 
  47.     Log in with your aide password and do the following:
  48.         1) .[A]ide [H]alls
  49.            You will arrive at a menu.  Here you can create halls
  50.        and add rooms to them (Window room).
  51.  
  52.         2) .[A]ide [G]roups
  53.            You will arrive at a menu.  Here you can create groups
  54.        and add users to them.  You can also assign or remove
  55.        group protection from halls and rooms.
  56.    
  57.   
  58. If you have problems.  First consult the Citadel 3.0c documentation to see if
  59. it is covered there.  If that doesn't help post a message on my board and I'll
  60. see if I can help.
  61.   
  62.     I'm at "Inner Sanctum One" (206) 363-8592  3/12/2400 baud.
  63.  
  64.     Later, Ganelius
  65.  
  66.  ------------------------------------------------------------------------------
  67.  VERSION LOG
  68.  ------------------------------------------------------------------------------
  69.  
  70.  VERSION 1.00
  71.  ************
  72.  Inner Sanctum first leaves the clone vats for public exposure.  The
  73. software behaves well enough for a mutant to gain some acceptance from
  74. the beta testing public...
  75.  
  76.  VERSION 1.01
  77.  ************
  78.  Several bugs eliminated. The rest is lost to history...
  79.  
  80.  VERSION 1.02
  81.  ************
  82.  What's in version 1.02?  I fixed the bug where it prints an error message 
  83. because it tried to display a message that had already scrolled off the 
  84. system. I fixed the bug where it skipped messages when [R]eply was used. I 
  85. added another option to the stuff for <paused> messages, a [D]isplay again 
  86. option. I fixed a number of bugs involving using [S]top when reading 
  87. things... 
  88.  
  89.  VERSION 1.03
  90.  ************  
  91.  Checks to see if serinit.prg has been installed via the auto folder, and if 
  92. not uses smaller buffers instead of crashing. 
  93.    
  94.  The move files and descriptions option from the aide maintain descriptions 
  95. menu has been implemented for sysops, and remote sysops.  Didn't seem like I 
  96. should turn that one loose for aides... 
  97.  
  98.  I just found and fixed a bug in the file/description move.  It wasn't moving 
  99. the description, unless you changed it.  Now it works right.  Still has some 
  100. rough edges though... 
  101.  
  102.  The [P]ause between messages default at log in is configurable now.
  103.  
  104.  VERSION 1.04
  105.  ************
  106.  On menus again...  I think what I'll do is the following: 
  107.     
  108.  .r!<CR>  will go into the menu as it does now. 
  109.    
  110.  .r!?     will display the letter commands for protocol options. 
  111.    
  112.  .rp      where p is one of the protocol letters will work as suggested in 
  113. previous messages. 
  114.    
  115.  There are two new .mnu files for your \help directory to go along with the 
  116. above changes. 
  117.    
  118.  There is a new bbs.dat file in is_run.arc which includes some interesting new 
  119. ideas. 
  120.   
  121.  A bug in the move file/description aide option has been fixed. 
  122.  
  123.  VERSION 1.05
  124.  ************
  125.  I think I've cleared up the memory bugs from the interpreter.  This should 
  126. make a big difference with the mysterious crashes we have seen.  The current 
  127. version is now v1.05.  I'd recommend putting this one up right away!  Let me 
  128. know if you have any more problems with strange interpreter crashes... 
  129.  
  130.  I'm still working on the adventure stuff.  Looks like there may be some more 
  131. bugs to chase down...  As you can see, the configurable interface option is 
  132. now in on this board.  As soon as I think it works all right I'll set it up 
  133. for download.  With the coming version you will be able to choose from three 
  134. different interfaces:  Citadel-Only, Citadel+Adventure, Adventure-Only. 
  135.  
  136.  VERSION 1.06
  137.  ************
  138.  A configuration option has been added that allows the sysop to specify the
  139. startup interface for Inner Sanctum.  It can now be: Citadel-only,
  140. Citadel and Adventure, or Adventure-only. This requires that the following
  141. line be added to CTDLCNFG.SYS:
  142.  
  143. #define INTERFACE n
  144.  
  145.  Where n is a number from 0 to 2.  The number corresponds to one of the three
  146. interface options above.
  147.  
  148.  There is also a new option on the sysop menu that allows the sysop to change
  149. the interface dynamically.  It goes into effect for the next and subsequent
  150. logins.  It is accessed by typing '!' from the sysop menu. (BTW, did you know
  151. that almost the entire alphabet has been used for sysop options from this menu
  152. by ORC?  Most of it is undocumented and may not even work.  I'll be sorting
  153. through this later.)
  154.  
  155.  NOTE WELL!!!  This version requires the use of the CONFIGUR.TTP program that
  156. comes in IS_RUN.ARC for v1.06.  You will have to edit the CTDLCNFG.SYS properly
  157. and run CONFIGUR with the 'n' parameter to use this version. (I mention this
  158. because one unfortunate soul used an old version of CONFIGUR with a later
  159. version of CITADEL.TTP and as might be expected had many problems with
  160. crashes!).
  161.  
  162.  The sysop option from the aide menu to move files and descriptions will now
  163. post a message in the target room that the file has been moved there. Also a
  164. few cosmetic changes here.  This option will probably be kinda slow on a floppy
  165. system, because it does a lot of things behind the scenes.
  166.  
  167.  The delete option from the same menu will now let you delete both files and
  168. descriptions.  No posting for this one though.
  169.  
  170.  The upload commands have been slightly revised for batch uploads.  As an
  171. example:  .E!Bp  where p can be: [X]modem, [Y]modem, [W]Xmodem.  There is a new
  172. file named wxybatch.mnu that shows up if the following is typed: .E!B? (Looks
  173. kinda peculiar, but .E!? even looks funnier :)  )
  174.  
  175.  The adventure stuff in IS_ADV.ARC has been upgraded to use the new include
  176. files from ADVRUN.ARC.  Note the include file CIT.TXT, which contains the board
  177. specific stuff for the adventure.  The BBS.DAT that comes in IS_RUN.ARC is the
  178. same one I use on my board. Use it if you like.
  179.  
  180.  VERSION 1.07
  181.  ************
  182.  More bugs have been squashed in the adventure interpreter.  Hopefully we are
  183. reaching the end of the line here.
  184.  
  185.  Zerucha's improved protocol drivers have been implemented.  These should 
  186. perform even better and faster.  These drivers are the same ones used in 
  187. release 1.10 of TRANS, which can be obtained through a shareware donation
  188. from Zerucha.
  189.  
  190.  Downloads now display file size in bytes and approximate download time
  191. in minutes before starting... (Not PCP time however...)
  192.  
  193.  The bug where [G]oto does not always display the room name has been
  194. fixed.
  195.  
  196.  A configuration option has been added to the CTDLCNFG.SYS file to allow
  197. sysops to use Hayes modem result codes to automatically determine the 
  198. baud rate.  The following must be added to your config file:
  199.  
  200.     #define HAYESCODES 1
  201.  
  202.  If you want to use it, otherwise you must add:
  203.  
  204.     #define HAYESCODES 0
  205.  
  206.  For regular Citadel baud detection.  You MUST run configur again for this
  207. version with the 'n' parameter.  Note well:  If you use Hayes result codes,
  208. you must set up your modem to return numeric result codes when it connects
  209. with an incoming call.
  210.    
  211.  
  212.  
  213.  VERSION 1.08 
  214.  ************
  215.  With this and later versions the CONFIGUR.TTP utility will display the same
  216. version number as CITADEL.TTP.  (In this case "v1.08").  If it doesn't,
  217. you've got problems!!!
  218.  
  219.  The option to default pause-between-messages has been expanded.  Now the values
  220. for #define MSGPAUSE n, have been changed as follows:
  221.  
  222.     n = 0   disables it completely
  223.     n = 1   defaults it to OFF 
  224.     n = 2   defaults it to ON
  225.  
  226.  Adjust your CTDLCNFG.SYS file for these changes.
  227.  
  228.  The configuration option to use Hayes connection results has been expanded.
  229. Now the values for #define HAYESCODES n, have been changed as follows:
  230.  
  231.     n = 0   use normal Citadel baud detection.
  232.     n = 1   use Hayes numeric result codes.
  233.     n = 2   use "CONNECT n" strings.
  234.  
  235.  Adjust your CTDLCNFG.SYS file accordingly.  Numeric result codes should be
  236. used if preference to "CONNECT n" strings when possible.  If you use these
  237. options, make sure your modem is returning what is expected!!!
  238.  
  239.  Read extended directory will now show the files' date and time.
  240.   
  241.  A new command has been added to display a sorted listing of users.  Try
  242. .ru to see it.  If you are both an aide and a sysop, this listing will show
  243. passwords as well.  I'm not sure how I feel about this, as it endangers
  244. the security for the users, but here it is anyway.
  245.  
  246.  Due to several requests for the features in here so far I'm going to
  247. release it now and move on to another version for the rest of the stuff I
  248. want to do.  So....
  249.  
  250.  
  251.  VERSION 1.20
  252.  ************
  253.  I decided to jump version numbers because this version is a big jump
  254.  in functionality. 
  255.  
  256.  New stuff:  Halls, groups, a conversion program, new configur.ttp
  257.  
  258.  New or revised commands:
  259.  
  260.     .ec    .rs    .kh    .kg    .ag   .ah 
  261.     >      <      +      -      g     c
  262.  
  263.  The conversion program: IS_CNVT.TOS should work to convert any previous
  264.  Inner Sanctum version to V1.20.  It should also work with STadel v3.0c.
  265.  (See notes above for conversion advice.)
  266.  
  267.  Halls are managed by sysops via the .[A]ide [H]alls command from a menu.
  268.  
  269.  Groups are likewise managed via the .[A]ide [G]roup command from a menu.
  270.    
  271.  The chat recording warning message has been removed.
  272.  
  273.  The maximum number of nulls allowed for a user has been set to 25.
  274.  
  275.  The modem init routine has been twiddled.  Now Hayes 2400 baud modems
  276.  and close clones should work with Inner Sanctum.
  277.  
  278.  Twit bits have been added.
  279.  
  280.  Configurable call limits for regular users and twits. 
  281.  
  282.  Optional automatic hall prompt, '>', added to end of roomnames with
  283.  additional accessible halls.  (Can be configured away...)
  284.  
  285.  It is now possible to send public messages to yourself or to no one.
  286.  
  287.  .[E]nter [C]onfiguration now uses defaults for both old and new users.
  288.  
  289.  The adventure interpreter has been removed from this version.  It is going
  290.  to show up in the next version as a doors application. (config note:
  291.  #define INTERFACE 0).
  292.  
  293.  
  294.  VERSION 1.21 (A fix up version)
  295.  ************
  296.  I'm going to put this version out 9/13/87 to fix up a few bugs, and
  297.  address the Twit problem that many of us are facing.
  298.  
  299.  The annoying message that was appearing when you first booted up IS,
  300.  which said "?No Lobby room" or whatever has been fixed.
  301.  
  302.  There are a bunch of new configuration parameters, mostly for twit control:
  303.      #define NEWLIMIT 20         Sets max minutes for new log in.
  304.                                  (disable this one by setting to 0.)
  305.      #define MAXNEW    3         Max msgs new user may enter on call.
  306.      #define MAXTWIT   1         Max msgs twit user may enter on call.
  307.      #define MAXREG   16         Max msgs a regular may enter on call.
  308.                                  (disable this one by setting to 0.)
  309.      #define TWITZAP   1         Zap an errant twit? 
  310.                                    0 = Please don't zap 'em!
  311.                                    1 = Zap 'em with white noise!
  312.                                    2 = Repeatedly list "DORIGHT.BLB"
  313.                                    3 = Do some of both!!
  314.      #define TWITDELAY 60        #seconds to wait with DTR off after
  315.                                  zapping the twit.
  316.  
  317.  So how does all this work, you ask?  Well, if MAXREG is set, and the
  318.  caller reaches the maximum, then they are politely warned and their
  319.  message is saved.  If they have exceeded the limit, they are automatically
  320.  changed to twit status, a message to that effect is put in Aide>, and the
  321.  board hangs up on 'em.  The same kind of thing happens for new callers,
  322.  but this one can't be disabled, so set it high if you don't want it.  When
  323.  a twit hits the maximum, (this could be through progression from regular
  324.  or new!), they are warned first.  If they exceed the maximum, (which could
  325.  be set to zero!), the board decides what to do based on TWITZAP.  If it is
  326.  set to zero, the board logs them off and doesn't save the pending message.
  327.  If it is set to 1 the board goes into the ZapTheTwit() routine, which 
  328.  basically dumps binary garbage out the modem until carrier drops or
  329.  TWITLIMIT has expired, then it goes into the DelayTheTwit() routine, which
  330.  turns DTR off and waits for the number of seconds specified in TWITDELAY.
  331.  In any of these abort situations, the board will reset for new callers,
  332.  when ready. So much for twits...
  333.  
  334.  What else is new?  I have separated the file transfer protocols into a 
  335.  separate program.  The disk location of the new program must be configured
  336.  if you plan on running ANY directory rooms, otherwise (a message-only bbs?)
  337.  you can ignore it. The config data for it is:
  338.      #WXYPATH "d:\wxytr.prg"   (This better match where ya put it!)
  339.  You will need to be sure that you have enough RAM left to load the new
  340.  program or it won't run! (This is preliminary work for doors.) 
  341.  
  342.  The .ru command has been replaced by three new commands:
  343.      .rua   Read Userlog Alphabetic  
  344.      .ruf   Read Userlog Forward by Last log date
  345.      .rur   Read Userlog Reverse by Last log date
  346.  As the date fields in the userlog may not be in clean condition, I have
  347.  added a command to the .ag menu to go in and clean up the dates.  As users
  348.  log in it will clean it self up gradually too.
  349.  
  350.   
  351.  VERSION 1.22  (yet another fix up version)
  352.  ************
  353.  Here is another fix version.  This will hopefully fix the memory problems
  354.  some of us have had with configur.ttp.  I have tested it with a plain 
  355.  520 ST with one DS/DD and no RAM disk.  I successfully managed a 512 entry
  356.  log file.  The problem was memory related, therefore you'll have to be 
  357.  careful with RAM disks.  Try backing yourself up completely first and then
  358.  testing configur n  several times before you rely on it too much.  This is
  359.  one of those cases where I have apparently solved the problem, surrounded
  360.  the problem, but have not yet found the precise cause :(  More on this
  361.  with the next version...
  362.  
  363.  Now on to the fun stuff.  Now we have a mechanism for bulletins on Inner
  364.  Sanctum.  It takes the place of prelog.blb (which no longer displays).  The
  365.  bulletin routines are pretty flexible but a bit unusual and somewhat 
  366.  complicated.  So how do they work?  Ah, glad you asked!
  367.  
  368.  Bulletins are placed in the help directory along with everything else.  They
  369.  have special requirements for their file names.  The file name must take the
  370.  form:  BULLxxxx.BLB.  You may have up to 32 bulletin files active.
  371.  The xxxx part of the filename is a special programmable
  372.  string that informs the routines about what order, how to display it, and to
  373.  whom it should be displayed.  Here are the meanings for the characters in
  374.  xxxx:
  375.          Character 1)  This character controls the sequence of display
  376.                        of the bulletin.  It is required.  It may be any
  377.                        valid character for filenames.
  378.  
  379.          Character 2)  This character controls how the bulletin will be
  380.                        displayed.  It is required and must be one of the
  381.                        following:
  382.  
  383.                        'I' - Cannot be stopped or paused, display it only
  384.                              once per user.
  385.  
  386.                        'X' - Same as 'I', but show it always.
  387.  
  388.                        'S' - Stoppable, pausable, display it only once
  389.                              per user.
  390.  
  391.                        'Y' - Same as 'S', but show it always.
  392.  
  393.                        'P' - A "package" of text files to display. Display
  394.                              them only once per user.  The contents of this
  395.                              bulletin will be filenames for files in the
  396.                              help directory.  Wild cards may be used. i.e.
  397.                              twit*.txt. You can have up to 32 file names
  398.                              in a package.
  399.  
  400.                        'W' - Same as 'P' but show it always.
  401.  
  402.                        'R' - Same as 'P', but only one of the files is
  403.                              randomly selected and displayed.
  404.  
  405.                        'Z' - Same as 'R', but do it all the time.
  406.  
  407.          Character 3)  This character controls who the bulletin(s) will be
  408.                        displayed for.  This character is required and must
  409.                        have one of the following values:
  410.  
  411.                        'A' - All users.
  412.  
  413.                        'T' - Twits only.
  414.  
  415.                        'N' - New users only.
  416.  
  417.                        'S' - Aides only.
  418.  
  419.                        'R' - Regulars only (not aides, twits, or new users)
  420.  
  421.                        '0', '1', '2', '3' - See character 4)
  422.  
  423.          Character 4)  This character is only required if character three
  424.                        is one of the allowed numbers.  In which case the
  425.                        two will form the group number for a group-only
  426.                        bulletin.  You can find the group numbers for your
  427.                        system by selecting the list groups option from
  428.                        .[A]ide [G]roup edits.  The Null group would be
  429.                        indicated by 00, and group 1 would be indicated by
  430.                        01, and so on.
  431.  
  432.  .[E]nter configuration has been modified as well.  It is now possible for
  433.  an expert user to reconfigure the Pause-between-bulletins option, and if
  434.  your system allows it, the Pause-between-messages option.  Unfortunately
  435.  I had to "steal" some unused bits from the existing user log records, so
  436.  they will have random values in them.  New users default to Pause between
  437.  bulletins TRUE.
  438.  
  439.  
  440.  VERSION 1.30 
  441.  ************
  442.  This version provides some interesting new features as well as more 
  443. cosmetic cleanup.
  444.  
  445.     The aide menus have been cleaned up.
  446.     The log out message has been fixed.
  447.     Uploads will now display disk free space just before the (Y/N) prompt.
  448.     The bug in .ec for pause options has been fixed.
  449.     Remote sysops can no longer see passwords when using .rua
  450.  
  451.     DOORS:
  452.     *****
  453.     The user commands for doors are: .[K]nown [D]oors & .[E]nter [D]oor
  454.     The aide command to manage doors is: .[A]ide [P]rograms
  455.     To use doors first make sure that you scratch any old versions of
  456.     ctdldoor.sys from your \sys directory and reconfigure.
  457.     I'll put up a new ARC file called IS_DOORS.ARC containing two doors
  458.     programs I have been testing.  Perhaps some of you will write some
  459.     others for us all?  Doors can be used for console-only programs as
  460.     well as modem programs.  Don't try GEM programs!!!  They will just
  461.     crash the system!!!!
  462.  
  463.     When you "Make" a door, the system will ask you a series of questions
  464.     about the door, i.e.
  465.  
  466.         Door name?  "some door"  (required)
  467.         Door program? "someprog.ttp"   (required)
  468.         Door path? "a:\door"   (required)
  469.         Door help file? "someprog.blb"   (must be in help directory, if used)
  470.         Door arguments? what ever command line arguments are needed or none.
  471.  
  472.     Just answer truthfully and it may work  :)
  473.     You will have to provide group access for the door!
  474.     This is a preliminary version of doors, and you can expect it to
  475.     change later with improvements.
  476.   
  477.  
  478.     FUNCTION KEYS:
  479.     *************
  480.     Or as I like to call them "Hot Keys".  The function keys can now be
  481.     used for a variety of functions, some of which actually work!  (I'm
  482.     not finished with them yet :)  
  483.  
  484.     Function keys may be used except when the caller is in a door or
  485.     in upload or download.  To activate or deactivate the function keys
  486.     use F2.  Once they are active you can use F1 to see what they do.  For
  487.     the most part this will be transparent to the caller.  Here are the
  488.     keys that are set up:
  489.  
  490.         F1:  Display function key descriptions
  491.         F2:  Activate/Deactivate function keys
  492.         F3:  Enter chat mode
  493.         F4:  Toggle chat mode on/off
  494.         F5:  Busy Out the modem
  495.         F6:  Toggle users aide status
  496.         F7:  Enter a door
  497.         F8:  Initialize modem
  498.         F9:  Toggle users twit bit
  499.         F10: Prepare to shutdown system. (kinda works)
  500.         UNDO:  Hangup on 'em
  501.         HELP:  Current callers status
  502.  
  503.    
  504.  
  505.  VERSION 1.60
  506.  ************
  507.  
  508.  Here is how the function keys have been changed:
  509.  
  510.         F1:  Current callers status (much improved)
  511.         F2:  Activate/Deactivate function keys
  512.         F3:  Enter chat mode (much improved!)
  513.         F4:  Toggle chat mode on/off
  514.         F5:  Busy Out the modem
  515.         F6:  Toggle users aide status (works right now)
  516.         F7:  Enter a door (improved)
  517.         F8:  Initialize modem
  518.         F9:  Toggle users twit bit
  519.         F10: Prepare to shutdown system. (works correctly now)
  520.         UNDO:  Hangup on 'em
  521.         HELP:  Display function key descriptions
  522.         HOME:  Reset callers elapsed time and message count.
  523.         (More coming for function keys, stay tuned)
  524.   
  525.  New log in routine:
  526.      Now the initials are requested along with the password for log in.
  527.      This may not be popular with users initially as it will cause some
  528.      confusion.  But it has been done for sound reasons, and I suspect users
  529.      will get used to it after a while.  With the new routine Inner Sanctum
  530.      becomes very much more secure.  The routine is better than those used on
  531.      many mini's and mainframes.  The idea behind it is simple.  If the
  532.      initials or password are not on file log in fails.
  533.      Here is how it is implemented:
  534.  
  535.      [L]ogin   Enter Initials: <your initials> Enter password: <your password>
  536.   
  537.            -OR-
  538.  
  539.      .[L]ogin <your initials>@<your password>
  540.  
  541.            -OR-
  542.   
  543.      .[L]ogin <your initials>;<your password>
  544.   
  545.      The conversion will substitute the users name in the new initials field.
  546.      The users can change that with the new .[E]nter [P]assword routine.
  547.      The new log in routine will also be very useful for the network design
  548.      that is going into Inner Sanctum.  The name prompt will also be checked
  549.      for network node ID's and if one is detected a separate log routine will
  550.      be called to handle net log in.  It will be good.  I think after the above
  551.      you can see why I didn't make this a configurable option like it is in
  552.      STadel.  Hopefully you can train your users to accept it without much
  553.      trouble.  
  554.  
  555.  Maximum Rooms has been expanded to 128 with this version.
  556.  
  557.  Maximum messages per room has been expanded to 128 with this version.
  558.  
  559.  .[R]ead [G]lobal has been fixed.
  560.  
  561.  The modem routines have been twiddled again... (and again!)
  562.  
  563.  The system state of IS is now available via environment strings to
  564.  doors applications (and to net drivers).
  565.  See the IS_IFACE.C file for info on a MWC example of interfacing to IS.
  566.  
  567.  Exclusive messages are now possible in any room except the Lobby.  After
  568.  considerable debugging it seems to be working nicely.  You can use .ee
  569.  to enter exclusive messages from the room prompt.  Public replies are
  570.  no longer supported.  There is now a private reply option, much like
  571.  the reply option in Mail>.
  572.  
  573.  A bug in Door argument passing was discovered and corrected.
  574.  
  575.  The adventure interpreter is back as a doors application.  The Starship
  576.  Columbus adventure seems to work fine with it.  The sysop can go into
  577.  chat mode while in the adventure by hitting the escape key.  You can also
  578.  type at the same time as the caller while in the adventure.  The adventure
  579.  interpreter has a built in time limit of 20 minutes.  If carrier is lost
  580.  during the game, it exits back to IS cleanly.
  581.  
  582.  I am still working on networking.  It is going slowly but well.  I'm 
  583.  going to take my time with it and get it right.
  584.  
  585.  There are many changes to the CTDLCNFG.SYS file.  Please study it and
  586.  make the correct changes in your file.
  587.  
  588.  This version requires quite a bit more space for system files.  A conversion
  589.  program has been provided for IS systems from v1.20 and up to v1.60, but it
  590.  requires plenty of free space in the directories where the system files are.
  591.  You may have to configure your old version to run on a friends HD to do the
  592.  conversion if you are on a small system.  
  593.  
  594.  I will be producing a new alternate version of IS for small systems in the 
  595.  near future.  It will have 48 rooms with 58 msgs/room, but otherwise will
  596.  support all the IS features.
  597.  
  598.  
  599.  VERSION 1.65(R) and 1.65(T)
  600.  ***************************
  601.  This version comes in two models:  Regular and Tiny.  They are functionally
  602.  equivalent.  The only differences are related to the maximum number of rooms
  603.  and the maximum number of messages/room.  For Regular it is 128 and 128.
  604.  For Tiny it is 48 and 58.  Make sure you keep the run time stuff for the
  605.  two models separate, especially if you pass it on to someone else.
  606.  
  607.  Two utilities have been developed: LOGXPAND.PRG and MSGXPAND.PRG.  They
  608.  allow expansion of the Log and Message files respectively.  These utilities
  609.  need more testing, especially the Tiny versions, so work from backups and
  610.  let me know of any problems you encounter.  The conversion utilities for
  611.  the Tiny version are also untested so the same holds.  Work from backups!!!
  612.  Even the Tiny version conversion utilities require work space, so you may
  613.  have to go to a larger system to do it...  The utilities have been included
  614.  in the two arcs for runtime to keep the two models separate.  i.e. 
  615.     IS_RUN.ARC  (The Regular version)
  616.     IS_TINY.ARC (The Tiny version)
  617.  
  618.  Bulletin "Packages" can now handle up to 128 bulletins.  This should make
  619.  random packages more interesting.  There will be a "raw ASCII" mode for
  620.  dumping VT52 laden bulletins or whatever.  The bulletin directory is now
  621.  supported so be sure and set it in the config file and move your bulletin
  622.  stuff in there.  The following additional control characters will allow
  623.  you to set up VT52 graphics files as bulletins for people who have selected
  624.  the VT52 driver option.
  625.  
  626.          Character 2)  This character controls how the bulletin will be
  627.                        displayed.  It is required and must be one of the
  628.                        following:
  629.                            'A' - Raw ASCII dump, one time.
  630.                            'B' - Raw ASCII dump, continual.
  631.  Refer to preceding versions for more info on bulletins. 
  632.   
  633.  The [P]ause command has been removed.  In its place use .rm, thats
  634.  .R(ead) M(ore)  This should eliminate some of the constant confusion over
  635.  the multiple meanings of the 'P' key, and replace it with some temporary
  636.  confusion :)
  637.  
  638.  The .ec command has been changed to include a request for terminal type.
  639.  ANSI and VT52 are now supported as well as "Standard".
  640.  
  641.  A generic set of terminal control commands may now be entered in messages.
  642.  This type of message will display for people configured for VT52 or ANSI. 
  643.  Others will just see the commands.  This option can be disabled by setting
  644.  the new configuration option #MSGGRAPH to 0, else make it 1.  If you don't
  645.  want VT52 sequences sent to your console, you can set the new configuration
  646.  option #CONGRAPH to 0, else set it to 1.  When graphics messages are 
  647.  displayed the bbs will automatically slip into "Pause-between-msgs" mode for
  648.  the duration of the message, and then slip out of it if it was in scroll mode
  649.  before when done with the message.  This was necessary because graphics
  650.  messages can play havoc with the scrolling process.  For more info on this
  651.  see the TERMINAL.HLP file in IS_HELP.ARC.
  652.  
  653.  It is now possible to "broadcast" mail to "Inner Sanctum" as well as
  654.  "Citadel".  This feature puts one message in the message file and lets 
  655.  everyone see it as private mail.  It can be handy for drawing attention
  656.  to changes on your board.
  657.  
  658.  Many minor bugs have been eliminated.  As always, make sure your config
  659.  file is set up properly with the new options.  You can use mine as a model.
  660.  
  661.  
  662.  VERSION 1.70(R) and 1.70(T)
  663.  ***************************
  664.  Here is a list of whats new for this version:
  665.  
  666.  Kermit and Kermit batch downloads are now supported.  Be sure to adjust
  667.  your CTDLCNFG.SYS file to tell IS where Kermit.prg resides on your system.
  668.  
  669.  A couple of changes to the pause-prompt when reading messages.  A user can
  670.  now delete his/her own messages.  Also both public and private replies are
  671.  now supported.
  672.  
  673.  A new popular feature is the addition of a user questionaire.  It must be 
  674.  configured in the CTDLCNFG.SYS file.  Results of the questionaire go into
  675.  a room that you have designated in CTDLCNFG.SYS.  Of course you must create
  676.  the room first.  New users will be asked if they want to answer it.  Old 
  677.  users can access it via  .EU
  678.  
  679.  The terminal driver stuff has been debugged further.  See TERMINAL.HLP in
  680.  IS_HELP.ARC for details.  This hasn't proven particularly popular as yet.
  681.  
  682.  Two new "hot keys": CONTROL-HELP and CONTROL-F1.  The second toggles the
  683.  printer ON and OFF.  When ON, all console text is dumped to the printer as
  684.  well.  If you activate this and your printer is not available it will time
  685.  out and turn OFF. 
  686.  
  687.  By popular demand the minimum length for initials has been reduced from 3
  688.  to 2.
  689.  
  690.  Thomas Zerucha sent the latest update to his file transfer code and it has
  691.  been incorporated in this version.  Thanks Tom.
  692.  
  693.  It is now possible to confiure via CTDLCNFG.SYS to allow Inner Sanctum to
  694.  run as a GEM application.  It isn't pretty yet but it seems to work.  The
  695.  major advantage of this is that it will allow you to run GEM programs from
  696.  Inner Sanctum doors.  So theoretically you can hook up your favorite term
  697.  program as a door (say Flash!) and run it from IS.  (Tell me if it works :)
  698.  
  699.  A number of bugs have been squashed.
  700.  
  701.   
  702.  VERSION 1.75(R), 1.75(T) and 1.75(M)!
  703.  *************************************
  704.  The big news with this release is the multi-tasking version of Inner Sanctum.
  705.  IS 1.75(M) will now run in the background under David Beckemeyer's MT C Shell.
  706.  To use this version you will need MT C Shell, a hard disk, and probably at
  707.  least 2 meg of RAM (you might get away with less...).   Most of the 
  708.  programming for this version was done while IS was running in the background.
  709.  
  710.  Once you are familiar with MT C Shell, and have Inner Sanctum fully installed
  711.  and configured you can run it in the background as follows:
  712.  
  713.    1) Change directory to the Inner Sanctum home directory (where Citadel.prg
  714.     is located).
  715.  
  716.    2) Execute the following command:   citadel -q &
  717.     The -q switch turns off all console I/O so IS will run quietly
  718.     in the background.  Now you can go about your business while IS
  719.     runs.
  720.  
  721.    3) To interact with IS you will need to execute the following commands:
  722.         jobs      /* to get the job number of IS     */
  723.         fg %n    /* where n is the job number    */
  724.         simultaneously press the keys CONTROL+LSHIFT+RSHIFT
  725.  
  726.     This will pull IS out of the background and signal that it should
  727.     turn console I/O back on.  Then you may want to hit F2 to enable
  728.     the function keys, or perhaps escape to enter console mode.
  729.   
  730.    4) Unfortunately there is no means under MT C Shell to put IS back in
  731.     the background at this stage.  To do so, you will have to take the
  732.     board down and resubmit it as a job as in step 2.
  733.   
  734.    5) I've found that switching to the IS AUDIT directory and using the
  735.     following command is quite useful for keeping track of activities
  736.     on the board while I am working:
  737.         tail calllog.sys
  738.     This will show you info on the last callers to the board.  For
  739.     full details use the cat command.
  740.  
  741.    Caveats:  Many programs written for the Atari ST are not compatible
  742.     with a multi-tasking environment.  The authors often resort to using
  743.     many of the interesting system resources on the ST which results in
  744.     conflicts with other programs that you may wish to run.
  745.  
  746.     This problem also manifests with door applications you may wish
  747.     to use with IS.  An example: Space Empire will not run properly
  748.     in the background as it writes directly to the screen.  I have
  749.     worked on the IS port of ADVSYS (by David Betz) to make it compatible.
  750.     I am not aware of any other doors that will run in the background.
  751.  
  752.      David Beckemeyer has produced a document on what is involved in 
  753.     compatibility in a multi-tasking environment.  It can be obtained
  754.     on the BDT support board in San Francisco.  It is recommended 
  755.     reading for this version of IS.
  756.  
  757.     I have been working on another means of background execution with
  758.     the help of Tom Zerucha.  But currently it is not stable enough
  759.     to use.  The idea is to submit IS with I/O redirected to a virtual
  760.     device.  Then another program, which we are calling TERMPIPE can be
  761.     used to interact with IS through the virtual device.  This is a
  762.     very interesting option, and I'll release it later when it becomes
  763.     more stable.
  764.  
  765.    
  766.  Here are some other features that have been added to all three models of IS:
  767.  
  768.    1) The bug which prevented sysop mail from being visible in the Aide room
  769.     has been fixed.
  770.  
  771.    2) There is a new userlog command; .rul  or .R(ead) U(serlog) L(ast 20)
  772.     this shows up to the last twenty callers since the last time the 
  773.     bbs was brought up.
  774.  
  775.    3) The audit file functionality has been expanded.  CALLLOG.SYS now shows
  776.     login time, logout time, each download, each upload, each door 
  777.     executed, and summary session stats.  I'll probably add more to this
  778.     later...  Of course, you'll want to clean up this file more often,
  779.     as it grows much faster.
  780.  
  781.    4) The user questionaire feature from v1.70 has been generalized and 
  782.     expanded by popular demand.  There are two example questionaires
  783.     in IS_BULL.ARC.  They can serve as models for questionaires of
  784.     your own design.  They are "INTRO.BLB" and "BULL7QA.BLB".  The
  785.     first is a special questionaire for user profiles.  You still have
  786.     to configure this one via "CTDLCNFG.SYS", but you can edit the file
  787.     to customize it to your own designs.  All other types of questionaires
  788.     function like bulletins.  (Please review all pertinent remarks above
  789.     for more info on the bulletin set up.)  "BULL7QA.BLB" can serve as
  790.     a model for this type.  The letter 'Q' in the file name serves as
  791.     a trigger to identify the file as a questionaire.  You can also
  792.     use the letter 'V' in that position.  A 'Q' questionaire asks the
  793.     user if he wants to answer it.  A 'V' questionaire is a bit more
  794.     forceful, stating that "The sysop will appreciate your answers".
  795.     The questionaire parser is pretty simple minded, but seems to work
  796.     pretty nicely.  The parser only handles one line at a time, so
  797.     questions are limited to one line at this time.  (It can be a long
  798.     line - max 255 - if your editor supports this).
  799.  
  800.     5) The function key features have been expanded.  (Not available in
  801.     MT background of course).  Check CONTROL-HELP to see them.
  802.  
  803.     6) Zmodem downloads are now supported.  Be sure and adjust CTDLCNFG.SYS
  804.     to indicate where SZ.TTP will be located.
  805.  
  806.     7) A number of obsolete entries have been removed from CTDLCNFG.SYS.
  807.     make sure that your copy is in synch.
  808.   
  809.  A bit of news.  This is likely to be the last release of IS for several
  810.  months.  Efforts are underway to convert IS from a one-man project to
  811.  a group project.  Among the things that the group will tackle are,
  812.  a general cleanup of the code with the aim of making it much more portable.
  813.  Possible ports include: Amiga, IBM/Clonez, MAC, UNIX.  The group is
  814.  also going to tackle the networking situation.
  815.  
  816.    
  817.  VERSION 2.00  (work in progress, yes, we will eventually get here...)
  818.  ************
  819.  Coming:  Networking, Mass delete, improved call limit options,
  820.     and much, much more!  :)
  821.  
  822.