20071011-1132

2 files changed, 16 insertions, 15 deletions

diff --git a/man/1/0intro b/man/1/0intro
index 0689e614..4d7335a1 100644
--- a/man/1/0intro
+++ b/man/1/0intro
@@ -164,18 +164,18 @@ Volume 2 contains papers and other documentation about Inferno.
 .PP
 The back of this volume contains a permuted index.
 .SH DIAGNOSTICS
+On successful execution, a process can simply exit.
 Programs (modules) that wish to return error status to
 the command interpreters
 .IR sh (1)
 and
 .IR mash (1)
-do so by executing a
-.IR sys-raise
-(see
-.IR sys-exception (2))
-with an error string starting with
+do so by raising a special exception (eg, using the
+.B raise
+statement in Limbo).
+The exception's value is a string
+beginning with the text
 .RB ` fail: '.
-On successful execution, a process can simply exit.
 .SH SEE ALSO
 .IR intro (2),
 .IR intro (3),
diff --git a/man/1/sh-std b/man/1/sh-std
index b3367c7f..bfaa0873 100644
--- a/man/1/sh-std
+++ b/man/1/sh-std
@@ -334,8 +334,9 @@ raises the exception
 will be truncated if it is longer than
 that allowed by
 .I raise
-(see
-.IR sys-exception (2)).
+(128 bytes in
+.IR utf (6)
+representation).
 Control will be transferred to the innermost
 rescue block in the same process that
 matches
@@ -365,13 +366,13 @@ matching
 where
 .I pattern
 is of the same form accepted by
-.I rescue
-(see
-.IR sys-exception (2));
-i.e. an exact match, or a prefix
-followed by an asterisk
-.RB ( * )
-which will match an exception starting with the prefix.
+Limbo's
+.B exception
+handling statement.
+Specifically, the pattern is a string that matches literally,
+except that a trailing
+.RB ` * '
+character will match any sequence of characters.
 If an exception is caught,
 .B rescue
 executes