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