Updated a few of the /doc files -- Rumble

changelog

@@ -646,4 +646,4 @@ Version 3.53 release: July, 2007
 Version 3.52 release: April, 2007
 Version 3.51 release: February, 2007
 Version 3.5 release: December, 2006
-See releases.txt for a full release history.
+See releases.txt for older versions of CircleMUD not released by TBA.

doc/README

@@ -8,18 +8,14 @@ http://www.circlemud.org
 ftp://ftp.circlemud.org
 
 Both of these sites are outdated and no longer maintained. The latest 
-information and downloads can be found at the CWG forums and download
+information and downloads can be found at:
-section: 
+http://tbamud.com
-http://cwg.lazuras.org/modules.php?name=Forums
-
 
 Downloading tbaMUD
 ---------------------
 
 You can find the current version of tbaMUD at the following URL:
-
+http://tbamud.com
-http://cwg.lazuras.org/modules.php?name=Downloads
-
 
 Compiling
 -------------------

doc/debugging.txt

@@ -148,6 +148,54 @@ requires a fair amount of knowledge about assembly language programming.
 
 6 Using GDB
 
+When debugging NEVER EVER run the autorun script. It will mask your debugging
+output - the log output will be redirected, etc. 
+
+Either 
+a) run your executable directly: "bin/circle". Crash the mud. Then run gdb on 
+the core file: "gdb ../bin/circle core.#" if there is one. If there isn't, then
+
+b) run your executable through gdb: "gdb bin/circle", "run" (**) (if you get a 
+SIGPIPE stop here, "cont" once). Crash the mud. 
+
+Do a backtrace - "bt" - and repeat the following until you can't go higher: 
+"list" followed by "up". 
+
+Thus, a typical debugging session looks like this: 
+
+gdb bin/circle 
+<gdb output> 
+gdb> run 
+<mud log - it's usually helpful to include the last couple of lines.> 
+Program received SIGSEV in some_function(someparamaters)  somefile.c:1223 
+gdb> bt 
+#0 0x234235 some_function(someparamaters)  somefile.c:1223 
+#1 0x343353 foo(bar) foo.c:123 
+#2 0x12495b baz(0x0000000) baz.c:3 
+gdb> list 
+1219 
+1220    foobar = something_interesting(); 
+1221 
+1222    foobar = NULL; 
+1223    free(foobar); 
+1224  } 
+1225 
+1226 
+1227  next_function_in_somefile_c(void) 
+gdb> up 
+frame #1  0x343353 foo(bar) foo.c:123 
+gdb> list 
+<similar output to the above, but different file> 
+gdb> up 
+frame #2 0x12495b baz(0x0000000) baz.c:3 
+gdb> list 
+<similar output to the above, but different file> 
+gdb> up 
+You are already at the top frame. 
+
+If this doesn't solve your problem post it on the forums at http://tbamud.com
+and ask for help. Include all the gdb output and your tbaMUD version.
+
 GDB has some online help, though it is not the best.  It does at least give
 a summary of commands and what they're supposed to do.  What follows is
 Sammy's short intro to gdb with some bughunting notes following it:

doc/releases.txt

@@ -11,6 +11,8 @@ to rec.games.mud.diku which originally anounced CircleMUD as a publically
 available MUD source code. 
 
 Release history:
+Version 3.56 release: April, 2008
+Version 3.55 release: January, 2008
 Version 3.54 release: December, 2007
 Version 3.53 release: July, 2007
 Version 3.52 release: April, 2007

doc/syserr.txt

@@ -1,19 +1,23 @@
+If you have any additions, corrections, ideas, or bug reports please stop by the
+Builder Academy at telnet://tbamud.com:9091 or email rumble@tbamud.com -- Rumble
+
    There are many common errors that can be created by changing things in the
 code or having  builders try inappropriate things. Here are a few, this list
 will be continually developed. If you have any additions or corrections please 
 stop by the Builder Academy at telnet://tbamud.com:9091 or email: 
 rumble@tbamud.com -- Rumble
 
-1. Errant Rooms (show error command)
+1.  Errant Rooms (show error command)
-2. SYSERR: Object # (oedit-s-desc) doesn't have drink type as last alias.
+2.  SYSERR: Object # (oedit-s-desc) doesn't have drink type as last alias.
-3. SYSERR: Mob # both Aggressive and Aggressive_to_Alignment.
+3.  SYSERR: Mob # both Aggressive and Aggressive_to_Alignment.
-4. SYSERR: Object # (oedit-s-desc) has out of range level #.
+4.  SYSERR: Object # (oedit-s-desc) has out of range level #.
-5. SYSERR: Object # (oedit-s-desc) has negative weight (-2147483644).
+5.  SYSERR: Object # (oedit-s-desc) has negative weight (-2147483644).
-   SYSERR: Object # (oedit-s-desc) has out of range level #2147483647.
+    SYSERR: Object # (oedit-s-desc) has out of range level #2147483647.
-6. SYSERR: Object # (oedit-s-desc) uses 'UNDEFINED' spell #.
+6.  SYSERR: Object # (oedit-s-desc) uses 'UNDEFINED' spell #.
-7. SYSERR: Object # (oedit-s-desc) contains (5) more than maximum (3).
+7.  SYSERR: Object # (oedit-s-desc) contains (5) more than maximum (3).
-8. Char is already equipped: (medit-s-desc), (oedit-s-desc)
+8.  Char is already equipped: (medit-s-desc), (oedit-s-desc)
-9. SYSERR: Attempt to assign spec to non-existant mob #
+9.  SYSERR: Attempt to assign spec to non-existant mob #
+10. No associated object exists when attempting to create a board [vnum #]. 
 
 1: Errant Rooms
 ------------

lib/text/news

@@ -69,7 +69,7 @@ NEW COMMANDS AND NEW MUD BEHAVIOR:
     someone else's name in parentheses in the message header, they will be 
     able to remove the message too.
 
-**  The MIDGAARD MAIL SYSTEM is now complete.  The Post Office is north of the 
+**  The tbaMUD MAIL SYSTEM is now complete.  The Post Office is north of the 
     entrance to the Grunting Boar inn.  Stamps cost 150 coins.
 
 **  Fountains have now been implemented.  You can drink from fountains or fill 

lib/world/obj/257.obj

@@ -929,13 +929,13 @@ A large, sociable bulletin board is mounted on a wall here.~
 0 0 0 0
 0 0 0 0
 E
-box~
-   If you can read this, the drop box is not working.  
-~
-E
 drop box message~
    Use 'look box' to write a message.  
 ~
+E
+box~
+   If you can read this, the drop box is not working.  
+~
 #25797
 board frozen bulletin~
 a frozen bulletin board~
@@ -945,13 +945,13 @@ A large bulletin board is here, carved from a block of ice.~
 0 0 0 0
 0 0 0 0
 E
-board~
-   If you can read this, the board is not working.  
-~
-E
 freeze bulletin~
    Use 'look board' to read the board.  
 ~
+E
+board~
+   If you can read this, the board is not working.  
+~
 #25798
 board holy bulletin~
 a holy bulletin board~
@@ -961,13 +961,13 @@ A large bulletin board is mounted on a wall here.  It glows with a faint aura.~
 0 0 0 0
 0 0 0 0
 E
-board~
-   If you can read this, the board is not working.  
-~
-E
 holy bulletin~
    Use 'look board' to read the board.  
 ~
+E
+board~
+   If you can read this, the board is not working.  
+~
 #25799
 board bulletin~
 a bulletin board~
@@ -977,11 +977,11 @@ A large bulletin board is mounted on a wall here.~
 0 0 0 0
 0 0 0 0
 E
-board~
-   If you can read this, the board is not working.  
-~
-E
 bulletin~
    Use 'look board' to read the board.  
 ~
+E
+board~
+   If you can read this, the board is not working.  
+~
 $~

lib/world/obj/30.obj

@@ -135,13 +135,13 @@ A small sword lies here.~
 0 1 6 11
 3 60 10 0
 E
-sword small~
-   The small sword seems to have an inscription of some sort.
-~
-E
 inscription~
    It says: 'May this sword be a good companion.  '
 ~
+E
+sword small~
+   The small sword seems to have an inscription of some sort.
+~
 #3022
 sword long~
 a long sword~
@@ -535,13 +535,13 @@ A large, sociable bulletin board is mounted on a wall here.~
 0 0 0 0
 0 0 0 0
 E
-board~
-   If you can read this, the board is not working.  
-~
-E
 social bulletin~
    Use 'look board' to read the board.  
 ~
+E
+board~
+   If you can read this, the board is not working.  
+~
 #3097
 boards frozen bulletin gen_boards~
 a frozen bulletin board~
@@ -551,13 +551,13 @@ A large bulletin board is here, carved from a block of ice.~
 0 0 0 0
 0 0 0 0
 E
-board~
-   If you can read this, the board is not working.  
-~
-E
 freeze bulletin~
    Use 'look board' to read the board.  
 ~
+E
+board~
+   If you can read this, the board is not working.  
+~
 #3098
 boards holy bulletin gen_boards~
 a holy bulletin board~
@@ -567,13 +567,13 @@ A large bulletin board is mounted on a wall here.  It glows with a faint aura.~
 0 0 0 0
 0 0 0 0
 E
-board~
-   If you can read this, the board is not working.  
-~
-E
 holy bulletin~
    Use 'look board' to read the board.  
 ~
+E
+board~
+   If you can read this, the board is not working.  
+~
 #3099
 boards bulletin gen_boards~
 a bulletin board~
@@ -583,11 +583,11 @@ A large bulletin board is mounted on a wall here.~
 0 0 0 0
 0 0 0 0
 E
-board~
-   If you can read this, the board is not working.  
-~
-E
 bulletin~
    Use 'look board' to read the board.  
 ~
+E
+board~
+   If you can read this, the board is not working.  
+~
 $~