commit 3264d2e25ece5df7cb7e1015aae82d156c058e36
from: rsc <devnull@localhost>
date: Sun Jan 23 22:55:46 2005 UTC

document core and stack

commit - d925d643cba25a7a3b7f530a42fb8dbc4e2f176e
commit + 3264d2e25ece5df7cb7e1015aae82d156c058e36
blob - b0a5b16152443512e1c909fa634b87af5b2c9e9f
blob + 51d235fbdcb73861cd14a96ae7a977ac1244f648
--- man/man1/core.1
+++ man/man1/core.1
@@ -4,9 +4,6 @@ core \- print information about dead processes
 .SH SYNOPSIS
 .B core
 [
-.B -s
-]
-[
 .I dir
 |
 .I corefile
@@ -27,11 +24,18 @@ in that directory.
 .PP
 For each core file read,
 .I core
-prints the date and time the core was generated,
-the command that generated it, and, if the
-.B -s
-option is given, a short stack trace
-at the time of the core dump.
+prints the command
+.B stack
+.IR file ,
+the date and time the core was generated,
+and
+the command that generated it.
+The
+.B stack
+command, if run, prints a stack trace of the 
+executing thread at the time of the core dump;
+see
+.IR db (1).
 .PP
 If no arguments are given,
 .I core
@@ -49,7 +53,3 @@ searches the current directory.
 .IR acid (1),
 .IR db (1),
 .IR core (5)
-.SH BUGS
-The
-.B -s
-option is not implemented.
blob - 38c8fc14455da3b294fa9519cc90126268b4cb00
blob + 5d0945d1357eb9ca5b2db39c64255d06fe36c52c
--- man/man1/db.1
+++ man/man1/db.1
@@ -6,6 +6,16 @@ db \- debugger
 [
 .I option ...
 ]
+[
+.I textfile
+]
+[
+.I pid
+|
+.I corefile
+]
+.PP
+.B stack
 [
 .I textfile
 ]
@@ -77,6 +87,13 @@ When a
 is given, the memfile map is associated with it;
 otherwise the map is undefined and accesses to it
 are not permitted.
+.PP
+.I Stack
+takes the same arguments as
+.IR db .
+It prints a stack trace (see the
+.B $c
+command below) and then exits.
 .PP
 Commands to
 .I db
@@ -939,7 +956,8 @@ is one the breakpoint will fire.
 Beware that local variables may be stored in registers; see the
 BUGS section.
 .SH "SEE ALSO"
-.IR acid (1)
+.IR acid (1),
+.IR core (1)
 .SH SOURCE
 .B \*9/src/cmd/db
 .SH DIAGNOSTICS