Help text for the <.H>elp: commands in the text client, has been moved *into* the...
authorArt Cancro <ajc@citadel.org>
Sun, 24 Apr 2016 13:32:10 +0000 (09:32 -0400)
committerArt Cancro <ajc@citadel.org>
Sun, 24 Apr 2016 13:32:10 +0000 (09:32 -0400)
citadel/help/admin [deleted file]
citadel/help/floors [deleted file]
citadel/help/intro [deleted file]
citadel/help/mail [deleted file]
citadel/help/network [deleted file]
citadel/help/policy [deleted file]
citadel/help/software [deleted file]
citadel/help/summary [deleted file]
textclient/src/commands.c
textclient/src/include/help.h [new file with mode: 0644]

diff --git a/citadel/help/admin b/citadel/help/admin
deleted file mode 100644 (file)
index 0a084db..0000000
+++ /dev/null
@@ -1,30 +0,0 @@
-The following commands are available only to Admins.  A subset of these
-commands are available to room aides when they are currently in the room
-they are room aide for.
-
- <.> <A>dmin <K>ill this room   (Delete the current room)
- <.> <A>dmin <E>dit this room   (Edit the current room's parameters)
- <.> <A>dmin <W>ho knows room   (List users with access to this room)
- <.> <A>dmin edit <U>ser        (Change user's access level, password, etc.)
- <.> <A>dmin <V>alidate new users   (Process new user registrations)
- <.> <A>dmin enter <I>nfo file      (Create/change this room's banner)
- <.> <A>dmin <R>oom <I>nvite user   (Grant access to an invitation-only room)
- <.> <A>dmin <R>oom <K>ick out user (Revoke access to an invitation-only room)
- <.> <A>dmin <F>ile <D>elete        (Delete a file from the room's directory)
- <.> <A>dmin <F>ile <S>end over net (Transmit a file to another node)
- <.> <A>dmin <F>ile <M>ove          (Move a file to another room's directory)
- <.> <A>dmin <M>essage edit:        (Edit system banners)
- <.> <A>dmin <P>ost                 (Post a message on behalf of another user)
- <.> <A>dmin <S>ystem configuration <G>eneral   (Edit global site config)
- <.> <A>dmin <S>ystem configuration <I>nternet  (Edit Internet domains)
- <.> <A>dmin <S>ystem configuration check <M>essage base   (Internal checks)
- <.> <A>dmin <S>ystem configuration <N>etwork   (Netting with other Citadels)
- <.> <A>dmin <S>ystem configuration network <F>ilter list
- <.> <A>dmin <T>erminate server <N>ow          (Shut down Citadel server now)
- <.> <A>dmin <T>erminate server <S>cheduled    (Shut down Citadel server later)
- <.> <A>dmin mailing <L>ist recipients         (For mailing list rooms)
- <.> <A>dmin mailing list <D>igest recipients  (For mailing list rooms)
- <.> <A>dmin <N>etwork room sharing     (Replication with other Citadels)
- In addition, the <M>ove and <D>elete commands are available at the
-message prompt.
diff --git a/citadel/help/floors b/citadel/help/floors
deleted file mode 100644 (file)
index 2758e4c..0000000
+++ /dev/null
@@ -1,43 +0,0 @@
- Floors
- ------
-   Floors in Citadel are used to group rooms into related subject areas,
-just as rooms are used to group messages into manageable groups.
-   You, as a user, do NOT have to use floors.  If you choose not to, you suffer
-no penalty; you will not lose access to any rooms.  You may use .EC or ;C (the
-latter is easier to use) to decide if you want to use floors.  Feel free to
-experiment.
-   Floor options are accessed two ways.  First, if you are in floor mode, the
-<G>oto and <S>kip commands take you to the next room with new messages on the
-current floor; if there are none left, then the system will automatically
-switch floors (and let you know) and put you in the first room with new messages
-on that level.  (Notice that your pattern of basic use of Citadel therefore
-doesn't really change.)
-   Direct access to floor options is via the use of a ";" command.
-The following commands are currently available (more can be
-added if needed):
- <;C>onfigure
- This command toggles your floor mode.
- <;G>oto FLOORNAME
- This command causes the system to take you to the named floor.
- <;K>nown rooms on floors
- List all rooms on all floors.  This is a very readable way to get a list of
-all rooms on the system.
- <;S>kip FLOORNAME
- This command causes the system to mark all rooms on the current floor as
-Skipped and takes you to the floor that you specify.
- <;Z>Forget floor
-   This command causes you to forget all the rooms currently on the current
-floor.  Unfortunately, it doesn't apply to rooms that are subsequently created
-or moved to this floor.  (Sorry.)
-   Feel free to experiment, you can't hurt yourself or the system with the
-floor stuff unless you ZForget a floor by accident.
diff --git a/citadel/help/intro b/citadel/help/intro
deleted file mode 100644 (file)
index 9c88249..0000000
+++ /dev/null
@@ -1,135 +0,0 @@
-                  New User's Introduction to the site
-  
- This is an introduction to the Citadel BBS concept.  It is intended
-for new users so that they can more easily become acquainted to using
-Citadel when accessing it in the form of a text-based BBS.  Of
-course, old users might learn something new each time they read
-through it.
- Full help for the BBS commands can be obtained by typing <.H>elp SUMMARY
-  
- The CITADEL BBS room concept
- ----------------------------
-   The term BBS stands for "Bulletin Board System".  The analogy is
-appropriate: one posts messages so that others may read them.  In
-order to organize the posts, people can post in different areas of the
-BBS, called rooms.
-   In order to post in a certain room, you need to be "in" that room.
-Your current prompt is usually the room that you are in, followed the
-greater-than-sign, such as:
- Lobby>
- The easiest way to traverse the room structure is with the "Goto"
-command, on the "G" key.  Pressing "G" will take you to the next room
-in the "march list" (see below) that has new messages in it.  You can
-read these new messages with the "N" key.
- Once you've "Gotoed" every room in the system (or all of the ones
-you choose to read) you return to the "Lobby," the first and last room
-in the system.  If new messages get posted to rooms you've already
-read during your session you will be brought BACK to those rooms so
-you can read them.
- March List
- ----------
-   All the room names are stored in a march list, which is just a
-list containing all the room names.  When you <G>oto or <S>kip a
-room, you are placed in the next room in your march list THAT HAS NEW
-MESSAGES.  If you have no new messages in any of the rooms on your
-march list, you will keep going to the Lobby>.  You can choose not to
-read certain rooms (that don't interest you) by "Z"apping them.  When
-you <Z>ap a room, you are merely deleting it from your march list (but
-not from anybody else's).
-   You can use the <.G>oto (note the period before the G.  You can also use
-<J>ump on some systems) to go to any room in the
-system.  You don't have to type in the complete name of a room to
-"jump" to it; you merely need to type in enough to distinguish it from
-the other rooms.  Left-aligned matches carry a heavier weight, so if you
-typed (for example) ".Goto TECH", you might be taken to a room called
-"Tech Area>" even if it found a room called "Biotech/Ethics>" first.
-  To return to a room you have previously <Z>apped, use the <.G>oto command
-to enter it, and it will be re-inserted into your march list.  In the case
-of returning to Zapped rooms, you must type the room name in its entirety.
-REMEMBER, rooms with no new messages will not show on your
-march list!  You must <.G>oto to a room with no new messages.
-Incidentally, you cannot change the order of the rooms on your march list.
-It's the same for everybody.
- Special rooms
- -------------
-   There are two special rooms on a Citadel that you should know about.
-  
-   The first is the Lobby>.  It's used for system announcements and other
-such administrativia.  You cannot <Z>ap the Lobby>.  Each time you first
-login, you will be placed in the Lobby>.
-   The second is Mail>.  In Mail>, when you post a messages, you are
-prompted to enter the screen name of the person who you want to send the
-message to.  Only the person who you send the message to can read the
-message.  NO ONE else can read it, not even the admins.  Mail> is the
-first room on the march list, and is un-<Z>appable, so you can be sure
-that the person will get the message.
-   
- System admins
- -------------
-   These people, along with the room admins, keep the site running smoothly.
-
-   Among the many things that admins do are: create rooms, delete
-rooms, set access levels, invite users, check registration, grant
-room admin status, and countless other things.  They have access to the
-Aide> room, a special room only for admins.
-   If you enter a mail message to "Sysop" it will be placed in the
-Aide> room so that the next admin online will read it and deal with it.
-Admins cannot <Z>ap rooms.  All the rooms are always on each admin's
-march list.  Admins can read *any* and *every* room, but they *CAN* *NOT*
-read other users' Mail!
-  
- Room admins
- -----------
-   Room admins are granted special privileges in specific rooms.
-They are *NOT* true system admins; their power extends only over the
-rooms that they control, and they answer to the system admins.
-  
-   A room admin's job is to keep the topic of the their room on track,
-with nudges in the right direction now and then.  A room admin can also
-move an off topic post to another room, or delete a post, if he/she
-feels it is necessary. 
-  
-   Currently, very few rooms have room admins.  Most rooms do not need
-their own specific room admin.  Being a room admin requires a certain
-amount of trust, due to the additional privileges granted.
-  
- Citadel messages
- ----------------
-   Most of the time, the BBS code does not print a lot of messages
-to your screen.  This is a great benefit once you become familiar
-with the system, because you do not have endless menus and screens
-to navigate through.  nevertheless, there are some messages which you
-might see from time to time.
-  
-  "There were messages posted while you were entering."
-  
-   This is also known as "simulposting."  When you start entering a 
-message, the system knows where you last left off.  When you save
-your message, the system checks to see if any messages were entered
-while you were typing.  This is so that you know whether you need
-to go back and re-read the last few messages.  This message may appear
-in any room.
-   
- "*** You have new mail"
-  
-   This message is essentially the same as the above message, but can
-appear at any time.  It simply means that new mail has arrived for you while
-you are logged in.  Simply go to the Mail> room to read it.
-  
- Who list
- --------
-   The <W>ho command shows you the names of all users who are currently
-online.  It also shows you the name of the room they are currently in.  If
-they are in any type of private room, however, the room name will simply
-display as "<private room>".  Along with this information is displayed the
-name of the host computer the user is logged in from.
-  
diff --git a/citadel/help/mail b/citadel/help/mail
deleted file mode 100644 (file)
index 34841a5..0000000
+++ /dev/null
@@ -1,19 +0,0 @@
-To send mail on this system, go to the Mail> room (using the command .G Mail)
-and press E to enter a message.  You will be prompted with:
- Enter Recipient:
-   At this point you may enter the name of another user on the system.  Private
-mail is only readable by the sender and recipient.  There is no need to delete
-mail after it is read; it will scroll out automatically.
-  
-   To send mail to another user on the Citadel network, simply type the
-user's name, followed by @ and then the system name. For example,
-  
- Enter Recipient: Joe Schmoe @ citadrool
-  
-  If your account is enabled for Internet mail, you can also send email to
-anyone on the Internet here.  Simply enter their address at the prompt:
-  
- Enter Recipient: ajc@herring.fishnet.com
diff --git a/citadel/help/network b/citadel/help/network
deleted file mode 100644 (file)
index 4a2ce39..0000000
+++ /dev/null
@@ -1,4 +0,0 @@
-  Welcome to the network. Messages entered in a network room will appear in
-that room on all other systems carrying it (The name of the room, however,
-may be different on other systems).
diff --git a/citadel/help/policy b/citadel/help/policy
deleted file mode 100644 (file)
index 6dfecc8..0000000
+++ /dev/null
@@ -1,3 +0,0 @@
- < this new user policy resides in ./messages/newuser > 
diff --git a/citadel/help/software b/citadel/help/software
deleted file mode 100644 (file)
index 5a084ad..0000000
+++ /dev/null
@@ -1,5 +0,0 @@
-   Citadel is the premier "online community" (i.e. Bulletin Board System)
-software.  It runs on all POSIX-compliant systems, including Linux.  It is an
-advanced client/server application, and is being actively maintained.
-   For more info, visit UNCENSORED! BBS at uncensored.citadel.org
diff --git a/citadel/help/summary b/citadel/help/summary
deleted file mode 100644 (file)
index bc07591..0000000
+++ /dev/null
@@ -1,110 +0,0 @@
-Extended commands are available using the period ( . ) key. To use
-a dot command, press the . key, and then enter the first letter of
-each word in the command. The words will appear as you enter the keys.
-You can also backspace over partially entered commands. The following
-commands are available:
-
- <.> <H>elp:    Displays help files.  Type .H followed by a help file
-                name.  You are now reading <.H>elp SUMMARY
- <.> <G>oto:    Jumps directly to the room you specify.  You can also
-                type a partial room name, just enough to make it unique,
-                and it'll find the room you're looking for.  As with the
-                regular <G>oto command, messages in the current room will
-                be marked as read.
- <.> <S>kip, goto:    This is similar to <.G>oto, except it doesn't mark
-                      messages in the current room as read.
- <.> list <Z>apped rooms      Shows all rooms you've <Z>apped (forgotten)
-
-  
- Terminate (logoff) commands:
- <.> <T>erminate and <Q>uit               Log off and disconnect.
- <.> <T>erminate and <S>tay online        Log in as a different user.
- Read commands:
-
- <.> <R>ead <N>ew messages                Same as <N>ew
- <.> <R>ead <O>ld msgs reverse            Same as <O>ld
- <.> <R>ead <L>ast five msgs              Same as <L>ast5
- <.> read <L>ast:                         Allows you to specify how many
-                                          messages you wish to read.
-
- <.> <R>ead <U>ser listing:               Lists all users on the system if
-                                          you just hit enter, otherwise
-                                          you can specify a partial match
-
- <.> <R>ead <T>extfile formatted          File 'download' commands.
- <.> <R>ead file using <X>modem   
- <.> <R>ead file using <Y>modem   
- <.> <R>ead file using <Z>modem   
- <.> <R>ead <F>ile unformatted   
- <.> <R>ead <D>irectory   
-
- <.> <R>ead <I>nfo file                   Read the room info file.
- <.> <R>ead <B>io                         Read other users' "bio" files.
- <.> <R>ead <C>onfiguration               Display your 'preferences'.
- <.> <R>ead <S>ystem info                 Display system statistics.
-
- Enter commands:
-
- <.> <E>nter <M>essage                    Post a message in this room.
- <.> <E>nter message with <E>ditor        Post using a full-screen editor.
- <.> <E>nter <A>SCII message              Post 'raw' (use this when "pasting"
-                                          a message from your clipboard).
-
- <.> <E>nter <P>assword                   Change your password.
- <.> <E>nter <C>onfiguration              Change your 'preferences'.
- <.> <E>nter a new <R>oom                 Create a new room.
- <.> <E>nter re<G>istration               Register (name, address, etc.)
- <.> <E>nter <B>io                        Enter/change your "bio" file.
-
- <.> <E>nter <T>extfile                   File 'upload' commands.
- <.> <E>nter file using <X>modem   
- <.> <E>nter file using <Y>modem   
- <.> <E>nter file using <Z>modem   
-  
-  
-  Wholist commands:
- <.> <W>holist <L>ong             Same as <W>ho is online, but displays
-                                  more detailed information.
- <.> <W>holist <R>oomname         Masquerade your room name (other users
-                                  see the name you enter rather than the
-                                  actual name of the room you're in)
- <.> <W>holist <H>ostname         Masquerade your host name
- <.> <E>nter <U>sername           Masquerade your user name (Admins only)
- <.> <W>holist <S>tealth mode     Enter/exit "stealth mode" (when in stealth
-                                  mode you are invisible on the wholist)
- Floor commands (if using floor mode)
- ;<C>onfigure floor mode            - turn floor mode on or off
- ;<G>oto floor:                     - jump to a specific floor
- ;<K>nown rooms                     - list all rooms on all floors
- ;<S>kip to floor:                  - skip current floor, jump to another
- ;<Z>ap floor                       - zap (forget) all rooms on this floor
- Administrative commands: 
- <.> <A>dmin <K>ill this room   
- <.> <A>dmin <E>dit this room   
- <.> <A>dmin <W>ho knows room   
- <.> <A>dmin edit <U>ser   
- <.> <A>dmin <V>alidate new users   
- <.> <A>dmin enter <I>nfo file   
- <.> <A>dmin <R>oom <I>nvite user  
- <.> <A>dmin <R>oom <K>ick out user  
- <.> <A>dmin <F>ile <D>elete  
- <.> <A>dmin <F>ile <S>end over net  
- <.> <A>dmin <F>ile <M>ove  
- <.> <A>dmin <M>essage edit:   
- <.> <A>dmin <P>ost   
- <.> <A>dmin <S>ystem configuration   
- <.> <A>dmin <T>erminate server <N>ow
- <.> <A>dmin <T>erminate server <S>cheduled
index 4fe088316685f4eaeb22d26bda1542a82ab13253..fecdd8c534ef39478c3d998c1c4e390c5eddd5f9 100644 (file)
@@ -2,7 +2,7 @@
  * This file contains functions which implement parts of the
  * text-mode user interface.
  *
- * Copyright (c) 1987-2012 by the citadel.org team
+ * Copyright (c) 1987-2016 by the citadel.org team
  *
  * This program is open source software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3.
@@ -60,7 +60,7 @@
 #include "routines2.h"
 #include "rooms.h"
 #include "client_chat.h"
-////#include "citadel_dirs.h"
+#include "help.h"
 #include "tuiconfig.h"
 //#ifndef HAVE_SNPRINTF
 //#include "snprintf.h"
@@ -1192,11 +1192,24 @@ void stty_ctdl(int cmd)
 
 
 /*
- * display_help()  -  help file viewer
+ * display_help()  -  help text viewer
  */
 void display_help(CtdlIPC *ipc, char *name)
 {
-       formout(ipc, name);
+       int i;
+       int num_helps = sizeof(helpnames) / sizeof(char *) ;
+
+       for (i=0; i<num_helps; ++i) {
+               if (!strcasecmp(name, helpnames[i])) {
+                       fmout(screenwidth, NULL, helptexts[i], NULL, 0);
+                       return;
+               }
+       }
+
+       scr_printf("'%s' not found.  Enter one of:\n", name);
+       for (i=0; i<num_helps; ++i) {
+               scr_printf("  %s\n", helpnames[i]);
+       }
 }
 
 
diff --git a/textclient/src/include/help.h b/textclient/src/include/help.h
new file mode 100644 (file)
index 0000000..b49c642
--- /dev/null
@@ -0,0 +1,388 @@
+//
+// Help files for the text client are now embedded directly into the client.
+// Copyright (c) 1988-2016 by Art Cancro and the citadel.org developers.
+// This program is gleefully made available to the world under the terms of
+// the GNU General Public License v3, with the following three modifications:
+// 1. The name of our favorite operating system is 'Linux,' not 'GNU/Linux.'
+// 2. The name of our favority type of software is 'open source,' not 'free software.'
+// 3. Richard Stallman is a fan of Bernie Sanders and therefore a complete idiot.
+//
+
+char *helpnames[] = {
+       "admin",
+       "floors",
+       "intro",
+       "mail",
+       "network",
+       "policy",
+       "software"
+};
+
+char *helptexts[] = {
+
+"The following commands are available only to Admins.  A subset of these\n"
+"commands are available to room aides when they are currently in the room\n"
+"they are room aide for.\n"
+"\n"
+" <.> <A>dmin <K>ill this room   (Delete the current room)\n"
+" <.> <A>dmin <E>dit this room   (Edit the current room's parameters)\n"
+" <.> <A>dmin <W>ho knows room   (List users with access to this room)\n"
+" <.> <A>dmin edit <U>ser        (Change user's access level, password, etc.)\n"
+" <.> <A>dmin <V>alidate new users   (Process new user registrations)\n"
+" <.> <A>dmin enter <I>nfo file      (Create/change this room's banner)\n"
+" <.> <A>dmin <R>oom <I>nvite user   (Grant access to an invitation-only room)\n"
+" <.> <A>dmin <R>oom <K>ick out user (Revoke access to an invitation-only room)\n"
+" <.> <A>dmin <F>ile <D>elete        (Delete a file from the room's directory)\n"
+" <.> <A>dmin <F>ile <S>end over net (Transmit a file to another node)\n"
+" <.> <A>dmin <F>ile <M>ove          (Move a file to another room's directory)\n"
+" <.> <A>dmin <M>essage edit:        (Edit system banners)\n"
+" <.> <A>dmin <P>ost                 (Post a message on behalf of another user)\n"
+" <.> <A>dmin <S>ystem configuration <G>eneral   (Edit global site config)\n"
+" <.> <A>dmin <S>ystem configuration <I>nternet  (Edit Internet domains)\n"
+" <.> <A>dmin <S>ystem configuration check <M>essage base   (Internal checks)\n"
+" <.> <A>dmin <S>ystem configuration <N>etwork   (Netting with other Citadels)\n"
+" <.> <A>dmin <S>ystem configuration network <F>ilter list\n"
+" <.> <A>dmin <T>erminate server <N>ow          (Shut down Citadel server now)\n"
+" <.> <A>dmin <T>erminate server <S>cheduled    (Shut down Citadel server later)\n"
+" <.> <A>dmin mailing <L>ist recipients         (For mailing list rooms)\n"
+" <.> <A>dmin mailing list <D>igest recipients  (For mailing list rooms)\n"
+" <.> <A>dmin <N>etwork room sharing     (Replication with other Citadels)\n"
+" \n"
+" In addition, the <M>ove and <D>elete commands are available at the\n"
+"message prompt.\n"
+
+,
+
+" Floors\n"
+" ------\n"
+"   Floors in Citadel are used to group rooms into related subject areas,\n"
+"just as rooms are used to group messages into manageable groups.\n"
+" \n"
+"   You, as a user, do NOT have to use floors.  If you choose not to, you suffer\n"
+"no penalty; you will not lose access to any rooms.  You may use .EC or ;C (the\n"
+"latter is easier to use) to decide if you want to use floors.  Feel free to\n"
+"experiment.\n"
+" \n"
+"   Floor options are accessed two ways.  First, if you are in floor mode, the\n"
+"<G>oto and <S>kip commands take you to the next room with new messages on the\n"
+"current floor; if there are none left, then the system will automatically\n"
+"switch floors (and let you know) and put you in the first room with new messages\n"
+"on that level.  (Notice that your pattern of basic use of Citadel therefore\n"
+"doesn't really change.)\n"
+" \n"
+"   Direct access to floor options is via the use of a ';' command.\n"
+"The following commands are currently available (more can be\n"
+"added if needed):\n"
+" \n"
+" <;C>onfigure\n"
+" This command toggles your floor mode.\n"
+" \n"
+" <;G>oto FLOORNAME\n"
+" This command causes the system to take you to the named floor.\n"
+" \n"
+" <;K>nown rooms on floors\n"
+" List all rooms on all floors.  This is a very readable way to get a list of\n"
+"all rooms on the system.\n"
+" \n"
+" <;S>kip FLOORNAME\n"
+" This command causes the system to mark all rooms on the current floor as\n"
+"Skipped and takes you to the floor that you specify.\n"
+" \n"
+" <;Z>Forget floor\n"
+"   This command causes you to forget all the rooms currently on the current\n"
+"floor.  Unfortunately, it doesn't apply to rooms that are subsequently created\n"
+"or moved to this floor.  (Sorry.)\n"
+" \n"
+"   Feel free to experiment, you can't hurt yourself or the system with the\n"
+"floor stuff unless you ZForget a floor by accident.\n"
+
+,
+
+"                  New User's Introduction to the site\n"
+"  \n"
+" This is an introduction to the Citadel BBS concept.  It is intended\n"
+"for new users so that they can more easily become acquainted to using\n"
+"Citadel when accessing it in the form of a text-based BBS.  Of\n"
+"course, old users might learn something new each time they read\n"
+"through it.\n"
+" \n"
+" Full help for the BBS commands can be obtained by typing <.H>elp SUMMARY\n"
+"  \n"
+" The CITADEL BBS room concept\n"
+" ----------------------------\n"
+"   The term BBS stands for 'Bulletin Board System'.  The analogy is\n"
+"appropriate: one posts messages so that others may read them.  In\n"
+"order to organize the posts, people can post in different areas of the\n"
+"BBS, called rooms.\n"
+"   In order to post in a certain room, you need to be 'in' that room.\n"
+"Your current prompt is usually the room that you are in, followed the\n"
+"greater-than-sign, such as:\n"
+" \n"
+" Lobby>\n"
+" \n"
+" The easiest way to traverse the room structure is with the 'Goto'\n"
+"command, on the 'G' key.  Pressing 'G' will take you to the next room\n"
+"in the 'march list' (see below) that has new messages in it.  You can\n"
+"read these new messages with the 'N' key.\n"
+" Once you've 'Gotoed' every room in the system (or all of the ones\n"
+"you choose to read) you return to the 'Lobby,' the first and last room\n"
+"in the system.  If new messages get posted to rooms you've already\n"
+"read during your session you will be brought BACK to those rooms so\n"
+"you can read them.\n"
+" \n"
+" March List\n"
+" ----------\n"
+"   All the room names are stored in a march list, which is just a\n"
+"list containing all the room names.  When you <G>oto or <S>kip a\n"
+"room, you are placed in the next room in your march list THAT HAS NEW\n"
+"MESSAGES.  If you have no new messages in any of the rooms on your\n"
+"march list, you will keep going to the Lobby>.  You can choose not to\n"
+"read certain rooms (that don't interest you) by 'Z'apping them.  When\n"
+"you <Z>ap a room, you are merely deleting it from your march list (but\n"
+"not from anybody else's).\n"
+" \n"
+"   You can use the <.G>oto (note the period before the G.  You can also use\n"
+"<J>ump on some systems) to go to any room in the\n"
+"system.  You don't have to type in the complete name of a room to\n"
+"'jump' to it; you merely need to type in enough to distinguish it from\n"
+"the other rooms.  Left-aligned matches carry a heavier weight, so if you\n"
+"typed (for example) '.Goto TECH', you might be taken to a room called\n"
+"'Tech Area>' even if it found a room called 'Biotech/Ethics>' first.\n"
+" \n"
+"  To return to a room you have previously <Z>apped, use the <.G>oto command\n"
+"to enter it, and it will be re-inserted into your march list.  In the case\n"
+"of returning to Zapped rooms, you must type the room name in its entirety.\n"
+"REMEMBER, rooms with no new messages will not show on your\n"
+"march list!  You must <.G>oto to a room with no new messages.\n"
+"Incidentally, you cannot change the order of the rooms on your march list.\n"
+"It's the same for everybody.\n"
+" \n"
+" Special rooms\n"
+" -------------\n"
+"   There are two special rooms on a Citadel that you should know about.\n"
+"  \n"
+"   The first is the Lobby>.  It's used for system announcements and other\n"
+"such administrativia.  You cannot <Z>ap the Lobby>.  Each time you first\n"
+"login, you will be placed in the Lobby>.\n"
+" \n"
+"   The second is Mail>.  In Mail>, when you post a messages, you are\n"
+"prompted to enter the screen name of the person who you want to send the\n"
+"message to.  Only the person who you send the message to can read the\n"
+"message.  NO ONE else can read it, not even the admins.  Mail> is the\n"
+"first room on the march list, and is un-<Z>appable, so you can be sure\n"
+"that the person will get the message.\n"
+"   \n"
+" System admins\n"
+" -------------\n"
+"   These people, along with the room admins, keep the site running smoothly.\n"
+"\n"
+"   Among the many things that admins do are: create rooms, delete\n"
+"rooms, set access levels, invite users, check registration, grant\n"
+"room admin status, and countless other things.  They have access to the\n"
+"Aide> room, a special room only for admins.\n"
+" \n"
+"   If you enter a mail message to 'Sysop' it will be placed in the\n"
+"Aide> room so that the next admin online will read it and deal with it.\n"
+"Admins cannot <Z>ap rooms.  All the rooms are always on each admin's\n"
+"march list.  Admins can read *any* and *every* room, but they *CAN* *NOT*\n"
+"read other users' Mail!\n"
+"  \n"
+" Room admins\n"
+" -----------\n"
+"   Room admins are granted special privileges in specific rooms.\n"
+"They are *NOT* true system admins; their power extends only over the\n"
+"rooms that they control, and they answer to the system admins.\n"
+"  \n"
+"   A room admin's job is to keep the topic of the their room on track,\n"
+"with nudges in the right direction now and then.  A room admin can also\n"
+"move an off topic post to another room, or delete a post, if he/she\n"
+"feels it is necessary. \n"
+"  \n"
+"   Currently, very few rooms have room admins.  Most rooms do not need\n"
+"their own specific room admin.  Being a room admin requires a certain\n"
+"amount of trust, due to the additional privileges granted.\n"
+"  \n"
+" Citadel messages\n"
+" ----------------\n"
+"   Most of the time, the BBS code does not print a lot of messages\n"
+"to your screen.  This is a great benefit once you become familiar\n"
+"with the system, because you do not have endless menus and screens\n"
+"to navigate through.  nevertheless, there are some messages which you\n"
+"might see from time to time.\n"
+"  \n"
+"  'There were messages posted while you were entering.'\n"
+"  \n"
+"   This is also known as 'simulposting.'  When you start entering a \n"
+"message, the system knows where you last left off.  When you save\n"
+"your message, the system checks to see if any messages were entered\n"
+"while you were typing.  This is so that you know whether you need\n"
+"to go back and re-read the last few messages.  This message may appear\n"
+"in any room.\n"
+"   \n"
+" '*** You have new mail'\n"
+"  \n"
+"   This message is essentially the same as the above message, but can\n"
+"appear at any time.  It simply means that new mail has arrived for you while\n"
+"you are logged in.  Simply go to the Mail> room to read it.\n"
+"  \n"
+" Who list\n"
+" --------\n"
+"   The <W>ho command shows you the names of all users who are currently\n"
+"online.  It also shows you the name of the room they are currently in.  If\n"
+"they are in any type of private room, however, the room name will simply\n"
+"display as '<private room>'.  Along with this information is displayed the\n"
+"name of the host computer the user is logged in from.\n"
+
+,
+
+"To send mail on this system, go to the Mail> room (using the command .G Mail)\n"
+"and press E to enter a message.  You will be prompted with:\n"
+" \n"
+" Enter Recipient:\n"
+" \n"
+"   At this point you may enter the name of another user on the system.  Private\n"
+"mail is only readable by the sender and recipient.  There is no need to delete\n"
+"mail after it is read; it will scroll out automatically.\n"
+"  \n"
+"   To send mail to another user on the Citadel network, simply type the\n"
+"user's name, followed by @ and then the system name. For example,\n"
+"  \n"
+" Enter Recipient: Joe Schmoe @ citadrool\n"
+"  \n"
+"  If your account is enabled for Internet mail, you can also send email to\n"
+"anyone on the Internet here.  Simply enter their address at the prompt:\n"
+"  \n"
+" Enter Recipient: ajc@herring.fishnet.com\n"
+
+,
+
+"  Welcome to the network. Messages entered in a network room will appear in\n"
+"that room on all other systems carrying it (The name of the room, however,\n"
+"may be different on other systems).\n"
+
+,
+
+" < this new user policy resides in ./messages/newuser > \n"
+
+,
+
+"   Citadel is the premier 'online community' (i.e. Bulletin Board System)\n"
+"software.  It runs on all POSIX-compliant systems, including Linux.  It is an\n"
+"advanced client/server application, and is being actively maintained.\n"
+" \n"
+"   For more info, visit UNCENSORED! BBS at uncensored.citadel.org\n"
+
+,
+
+"Extended commands are available using the period ( . ) key. To use\n"
+"a dot command, press the . key, and then enter the first letter of\n"
+"each word in the command. The words will appear as you enter the keys.\n"
+"You can also backspace over partially entered commands. The following\n"
+"commands are available:\n"
+"\n"
+" <.> <H>elp:    Displays help files.  Type .H followed by a help file\n"
+"                name.  You are now reading <.H>elp SUMMARY\n"
+" \n"
+" <.> <G>oto:    Jumps directly to the room you specify.  You can also\n"
+"                type a partial room name, just enough to make it unique,\n"
+"                and it'll find the room you're looking for.  As with the\n"
+"                regular <G>oto command, messages in the current room will\n"
+"                be marked as read.\n"
+" \n"
+" <.> <S>kip, goto:    This is similar to <.G>oto, except it doesn't mark\n"
+"                      messages in the current room as read.\n"
+" \n"
+" <.> list <Z>apped rooms      Shows all rooms you've <Z>apped (forgotten)\n"
+"\n"
+"  \n"
+" Terminate (logoff) commands:\n"
+" \n"
+" <.> <T>erminate and <Q>uit               Log off and disconnect.\n"
+" <.> <T>erminate and <S>tay online        Log in as a different user.\n"
+" \n"
+" \n"
+" Read commands:\n"
+"\n"
+" <.> <R>ead <N>ew messages                Same as <N>ew\n"
+" <.> <R>ead <O>ld msgs reverse            Same as <O>ld\n"
+" <.> <R>ead <L>ast five msgs              Same as <L>ast5\n"
+" <.> read <L>ast:                         Allows you to specify how many\n"
+"                                          messages you wish to read.\n"
+"\n"
+" <.> <R>ead <U>ser listing:               Lists all users on the system if\n"
+"                                          you just hit enter, otherwise\n"
+"                                          you can specify a partial match\n"
+"\n"
+" <.> <R>ead <T>extfile formatted          File 'download' commands.\n"
+" <.> <R>ead file using <X>modem   \n"
+" <.> <R>ead file using <Y>modem   \n"
+" <.> <R>ead file using <Z>modem   \n"
+" <.> <R>ead <F>ile unformatted   \n"
+" <.> <R>ead <D>irectory   \n"
+"\n"
+" <.> <R>ead <I>nfo file                   Read the room info file.\n"
+" <.> <R>ead <B>io                         Read other users' 'bio' files.\n"
+" <.> <R>ead <C>onfiguration               Display your 'preferences'.\n"
+" <.> <R>ead <S>ystem info                 Display system statistics.\n"
+"\n"
+" \n"
+" Enter commands:\n"
+"\n"
+" <.> <E>nter <M>essage                    Post a message in this room.\n"
+" <.> <E>nter message with <E>ditor        Post using a full-screen editor.\n"
+" <.> <E>nter <A>SCII message              Post 'raw' (use this when 'pasting'\n"
+"                                          a message from your clipboard).\n"
+"\n"
+" <.> <E>nter <P>assword                   Change your password.\n"
+" <.> <E>nter <C>onfiguration              Change your 'preferences'.\n"
+" <.> <E>nter a new <R>oom                 Create a new room.\n"
+" <.> <E>nter re<G>istration               Register (name, address, etc.)\n"
+" <.> <E>nter <B>io                        Enter/change your 'bio' file.\n"
+"\n"
+" <.> <E>nter <T>extfile                   File 'upload' commands.\n"
+" <.> <E>nter file using <X>modem   \n"
+" <.> <E>nter file using <Y>modem   \n"
+" <.> <E>nter file using <Z>modem   \n"
+"  \n"
+"  \n"
+"  Wholist commands:\n"
+" \n"
+" <.> <W>holist <L>ong             Same as <W>ho is online, but displays\n"
+"                                  more detailed information.\n"
+" <.> <W>holist <R>oomname         Masquerade your room name (other users\n"
+"                                  see the name you enter rather than the\n"
+"                                  actual name of the room you're in)\n"
+" <.> <W>holist <H>ostname         Masquerade your host name\n"
+" <.> <E>nter <U>sername           Masquerade your user name (Admins only)\n"
+" <.> <W>holist <S>tealth mode     Enter/exit 'stealth mode' (when in stealth\n"
+"                                  mode you are invisible on the wholist)\n"
+" \n"
+" \n"
+" Floor commands (if using floor mode)\n"
+" ;<C>onfigure floor mode            - turn floor mode on or off\n"
+" ;<G>oto floor:                     - jump to a specific floor\n"
+" ;<K>nown rooms                     - list all rooms on all floors\n"
+" ;<S>kip to floor:                  - skip current floor, jump to another\n"
+" ;<Z>ap floor                       - zap (forget) all rooms on this floor\n"
+" \n"
+" \n"
+" Administrative commands: \n"
+" \n"
+" <.> <A>dmin <K>ill this room   \n"
+" <.> <A>dmin <E>dit this room   \n"
+" <.> <A>dmin <W>ho knows room   \n"
+" <.> <A>dmin edit <U>ser   \n"
+" <.> <A>dmin <V>alidate new users   \n"
+" <.> <A>dmin enter <I>nfo file   \n"
+" <.> <A>dmin <R>oom <I>nvite user  \n"
+" <.> <A>dmin <R>oom <K>ick out user  \n"
+" <.> <A>dmin <F>ile <D>elete  \n"
+" <.> <A>dmin <F>ile <S>end over net  \n"
+" <.> <A>dmin <F>ile <M>ove  \n"
+" <.> <A>dmin <M>essage edit:   \n"
+" <.> <A>dmin <P>ost   \n"
+" <.> <A>dmin <S>ystem configuration   \n"
+" <.> <A>dmin <T>erminate server <N>ow\n"
+" <.> <A>dmin <T>erminate server <S>cheduled\n"
+
+};