home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / citadel2 / aabuyme.doc next >
Text File  |  1989-12-01  |  4KB  |  85 lines
  1. /************************************************************************/
  2. /*                  aaBuyMe.doc                */
  3. /************************************************************************/
  4.  
  5. /************************************************************************/
  6. /*                History                 */
  7. /*                                    */
  8. /* 87Mar01 orc    Modified for Citadel-68.                */
  9. /* 85Apr27 HAW    Modified for Citadel-86.                */
  10. /* 82Dec06 CrT    Created.                        */
  11. /************************************************************************/
  12.  
  13. /************************************************************************/
  14. /*                Audience                */
  15. /*                                    */
  16. /* People considering installing the Citadel BB system.         */
  17. /************************************************************************/
  18.  
  19. /************************************************************************/
  20. /*                Purpose                 */
  21. /*                                    */
  22. /*  Impart a sense of the flavor, structure and purpose of the system.    */
  23. /************************************************************************/
  24.  
  25.     Citadel is a room-structured message system.  The fundamental
  26. design goal is to provide a congenial forum conducive to interesting
  27. discussions.  The software is intended to be as unobtrusive, unintrusive
  28. and unconstraining as possible.  In software as elsewhere, good engineering
  29. is whatever gets the job done without calling attention to itself.
  30.  
  31.     The fundamental design metaphor is that of a building consisting of
  32. a series of independent rooms, each of which hosts a discussion devoted
  33. to a particular topic.    Messages are stored and retrieved in chronological
  34. order within each room.  Messages are formatted to the caller's screen width.
  35.  
  36.      Callers may travel freely between the rooms,
  37. reading old messages and posting new ones.  New rooms may be created
  38. at will, and old ones are deleted when they empty of messages.
  39.  
  40.     People familiar with other electronic message systems may wish
  41. to compare Citadel rooms with EIES conferences, ArpaNet mailing
  42. lists, individual "linear" BB systems or whatever;  the parallels
  43. are not exact but the functions are similar.
  44.  
  45.     The fundamental Goto, Read and Enter commands have been streamlined
  46. as much as possible.  The message display format has a minimum of
  47. unnecessary noise:  the topic is implicit in the message's location
  48. within a room, no explicit TO field is present, no message ID # is
  49. printed, no redundant "END OF MESSAGE" blurbs etc.  The most common Goto,
  50. Read and Enter commands are all single-key.  Citadel automatically
  51. skips rooms which have no new messages, and old messages in the
  52. current room.  (Less concise commands are of course available to
  53. override this.)
  54.  
  55.     Citadel Version 1 offered no more than the above, and was
  56. quite well recieved.  Version 2 left the basic structure unchanged,
  57. but added some additional peripheral capabilites.  Private person-to-
  58. person mail is now supported.  Private rooms can host restricted
  59. conferences.  Once visited, private rooms behave exactly like regular
  60. rooms to the participants, but they are not accessable to others who
  61. don't know the name of the room.  The sysop can set up some rooms to
  62. be windows onto designated disk/directories.  These directory
  63. rooms support the usual message functions, but also allow one to
  64. to do directory listings by wildcard match, or to upload and download
  65. files via Ward Christensen's protocol.    Various rough edges have been
  66. smoothed off.  The message code has been reworked to support automatic
  67. networking of Citadel nodes.
  68.  
  69.  
  70.     Citadel-68 is written in Alycon C. The distributed system can be
  71. installed and run without recompilation in most cases.    Citadel
  72. needs an Atari ST and an auto-answer modem.
  73.  
  74.     The source files run to about 150K, the .tos files to about 100K.  In a
  75. functioning system, the room and userlog files together take about
  76. 150K, and one would normally like about 200K for message text, to
  77. keep the wraparound time longer than a week.  The code is a simple
  78. public-domain release:    it can be used without fee in commercial
  79. systems, repackaged and sold, or whatever takes your fancy.  (As
  80. a matter of good form, a pointer to the parent code would be nice,
  81. of course.)  The translator takes no responsibility for the correctness,
  82. reliability, security, use, abuse, contents or clientele of any
  83. Citadel-68 installation (nor does the author of the original Citadel which
  84. this comes from).
  85.