9c88249213d31bc548170cb99e87851bec405a74
[citadel.git] / citadel / help / intro
1                   New User's Introduction to the site
2   
3  This is an introduction to the Citadel BBS concept.  It is intended
4 for new users so that they can more easily become acquainted to using
5 Citadel when accessing it in the form of a text-based BBS.  Of
6 course, old users might learn something new each time they read
7 through it.
8  
9  Full help for the BBS commands can be obtained by typing <.H>elp SUMMARY
10   
11  The CITADEL BBS room concept
12  ----------------------------
13    The term BBS stands for "Bulletin Board System".  The analogy is
14 appropriate: one posts messages so that others may read them.  In
15 order to organize the posts, people can post in different areas of the
16 BBS, called rooms.
17    In order to post in a certain room, you need to be "in" that room.
18 Your current prompt is usually the room that you are in, followed the
19 greater-than-sign, such as:
20  
21  Lobby>
22  
23  The easiest way to traverse the room structure is with the "Goto"
24 command, on the "G" key.  Pressing "G" will take you to the next room
25 in the "march list" (see below) that has new messages in it.  You can
26 read these new messages with the "N" key.
27  Once you've "Gotoed" every room in the system (or all of the ones
28 you choose to read) you return to the "Lobby," the first and last room
29 in the system.  If new messages get posted to rooms you've already
30 read during your session you will be brought BACK to those rooms so
31 you can read them.
32  
33  March List
34  ----------
35    All the room names are stored in a march list, which is just a
36 list containing all the room names.  When you <G>oto or <S>kip a
37 room, you are placed in the next room in your march list THAT HAS NEW
38 MESSAGES.  If you have no new messages in any of the rooms on your
39 march list, you will keep going to the Lobby>.  You can choose not to
40 read certain rooms (that don't interest you) by "Z"apping them.  When
41 you <Z>ap a room, you are merely deleting it from your march list (but
42 not from anybody else's).
43  
44    You can use the <.G>oto (note the period before the G.  You can also use
45 <J>ump on some systems) to go to any room in the
46 system.  You don't have to type in the complete name of a room to
47 "jump" to it; you merely need to type in enough to distinguish it from
48 the other rooms.  Left-aligned matches carry a heavier weight, so if you
49 typed (for example) ".Goto TECH", you might be taken to a room called
50 "Tech Area>" even if it found a room called "Biotech/Ethics>" first.
51  
52   To return to a room you have previously <Z>apped, use the <.G>oto command
53 to enter it, and it will be re-inserted into your march list.  In the case
54 of returning to Zapped rooms, you must type the room name in its entirety.
55 REMEMBER, rooms with no new messages will not show on your
56 march list!  You must <.G>oto to a room with no new messages.
57 Incidentally, you cannot change the order of the rooms on your march list.
58 It's the same for everybody.
59  
60  Special rooms
61  -------------
62    There are two special rooms on a Citadel that you should know about.
63   
64    The first is the Lobby>.  It's used for system announcements and other
65 such administrativia.  You cannot <Z>ap the Lobby>.  Each time you first
66 login, you will be placed in the Lobby>.
67  
68    The second is Mail>.  In Mail>, when you post a messages, you are
69 prompted to enter the screen name of the person who you want to send the
70 message to.  Only the person who you send the message to can read the
71 message.  NO ONE else can read it, not even the admins.  Mail> is the
72 first room on the march list, and is un-<Z>appable, so you can be sure
73 that the person will get the message.
74    
75  System admins
76  -------------
77    These people, along with the room admins, keep the site running smoothly.
78
79    Among the many things that admins do are: create rooms, delete
80 rooms, set access levels, invite users, check registration, grant
81 room admin status, and countless other things.  They have access to the
82 Aide> room, a special room only for admins.
83  
84    If you enter a mail message to "Sysop" it will be placed in the
85 Aide> room so that the next admin online will read it and deal with it.
86 Admins cannot <Z>ap rooms.  All the rooms are always on each admin's
87 march list.  Admins can read *any* and *every* room, but they *CAN* *NOT*
88 read other users' Mail!
89   
90  Room admins
91  -----------
92    Room admins are granted special privileges in specific rooms.
93 They are *NOT* true system admins; their power extends only over the
94 rooms that they control, and they answer to the system admins.
95   
96    A room admin's job is to keep the topic of the their room on track,
97 with nudges in the right direction now and then.  A room admin can also
98 move an off topic post to another room, or delete a post, if he/she
99 feels it is necessary. 
100   
101    Currently, very few rooms have room admins.  Most rooms do not need
102 their own specific room admin.  Being a room admin requires a certain
103 amount of trust, due to the additional privileges granted.
104   
105  Citadel messages
106  ----------------
107    Most of the time, the BBS code does not print a lot of messages
108 to your screen.  This is a great benefit once you become familiar
109 with the system, because you do not have endless menus and screens
110 to navigate through.  nevertheless, there are some messages which you
111 might see from time to time.
112   
113   "There were messages posted while you were entering."
114   
115    This is also known as "simulposting."  When you start entering a 
116 message, the system knows where you last left off.  When you save
117 your message, the system checks to see if any messages were entered
118 while you were typing.  This is so that you know whether you need
119 to go back and re-read the last few messages.  This message may appear
120 in any room.
121    
122  "*** You have new mail"
123   
124    This message is essentially the same as the above message, but can
125 appear at any time.  It simply means that new mail has arrived for you while
126 you are logged in.  Simply go to the Mail> room to read it.
127   
128  Who list
129  --------
130    The <W>ho command shows you the names of all users who are currently
131 online.  It also shows you the name of the room they are currently in.  If
132 they are in any type of private room, however, the room name will simply
133 display as "<private room>".  Along with this information is displayed the
134 name of the host computer the user is logged in from.
135