Updated a few of the /doc files -- Rumble

This commit is contained in:
Rumble 2008-04-19 22:02:57 +00:00
parent cd7886a221
commit 1a8c04e46f
9 changed files with 105 additions and 1186 deletions

View file

@ -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.

1131
doc/FAQ

File diff suppressed because it is too large Load diff

View file

@ -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
section:
http://cwg.lazuras.org/modules.php?name=Forums
information and downloads can be found at:
http://tbamud.com
Downloading tbaMUD
---------------------
You can find the current version of tbaMUD at the following URL:
http://cwg.lazuras.org/modules.php?name=Downloads
http://tbamud.com
Compiling
-------------------

View file

@ -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:

View file

@ -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

View file

@ -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)
2. SYSERR: Object # (oedit-s-desc) doesn't have drink type as last alias.
3. SYSERR: Mob # both Aggressive and Aggressive_to_Alignment.
4. SYSERR: Object # (oedit-s-desc) has out of range level #.
5. SYSERR: Object # (oedit-s-desc) has negative weight (-2147483644).
SYSERR: Object # (oedit-s-desc) has out of range level #2147483647.
6. SYSERR: Object # (oedit-s-desc) uses 'UNDEFINED' spell #.
7. SYSERR: Object # (oedit-s-desc) contains (5) more than maximum (3).
8. Char is already equipped: (medit-s-desc), (oedit-s-desc)
9. SYSERR: Attempt to assign spec to non-existant mob #
1. Errant Rooms (show error command)
2. SYSERR: Object # (oedit-s-desc) doesn't have drink type as last alias.
3. SYSERR: Mob # both Aggressive and Aggressive_to_Alignment.
4. SYSERR: Object # (oedit-s-desc) has out of range level #.
5. SYSERR: Object # (oedit-s-desc) has negative weight (-2147483644).
SYSERR: Object # (oedit-s-desc) has out of range level #2147483647.
6. SYSERR: Object # (oedit-s-desc) uses 'UNDEFINED' spell #.
7. SYSERR: Object # (oedit-s-desc) contains (5) more than maximum (3).
8. Char is already equipped: (medit-s-desc), (oedit-s-desc)
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
------------

View file

@ -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

View file

@ -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.
~
$~

View file

@ -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.
~
$~