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