Andreas/tbamud
1
0
Fork 0
mirror of https://github.com/tbamud/tbamud.git synced 2025-12-29 05:28:48 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated a few of the /doc files -- Rumble

Browse source
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
Download patch file Download diff file Expand all files Collapse all files

1131
doc/FAQ
View file

File diff suppressed because it is too large Load diff

10
doc/README
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
-------------------

48
doc/debugging.txt
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:

2
doc/releases.txt
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

24
doc/syserr.txt
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
------------