secstore(1): add DIAGNOSTICS section

[plan9front.git] / sys / man / 1 / 5e

diff --git a/sys/man/1/5e b/sys/man/1/5e
index 543080af040648a13694811437a70bd63fc3dd7e..45adbd6298aeb9b792e9701febd08d65b5dfb175 100644 (file)
--- a/sys/man/1/5e
+++ b/sys/man/1/5e
@@ -14,15 +14,16 @@
 .I 5e
 simulates the execution of an ARM binary in a Plan 9 environment.
 Unlike its predecessor
-.IR 5i (1)
+.IR vi (1)
 it supports, among others, the syscalls
-.IR rfork (2)
+rfork (see
+.IR fork (2))
 and
 .IR exec (2),
-i.e. it allows execution of threaded programs, e.g.
+which allows for the execution of threaded programs (e.g.,
 .IR rio (1)
 or
-.IR catclock (1).
+.IR catclock (1)).
 .PP
 .I 5e
 executes the specified binary
@@ -40,7 +41,7 @@ and
 .BR /rc/bin .
 .PP
 Unlike
-.IR 5i (1),
+.IR vi (1),
 .IR 5e (1)
 does not provide built-in debugging facilities.
 It
@@ -89,12 +90,12 @@ Supplying
 causes failing processes to call
 .IR abort (2)
 instead of
-.IR sysfatal (2),
-but see below.
+.I sysfatal.
+See below.
 .SH SOURCE
 .B /sys/src/cmd/5e
 .SH SEE ALSO
-.IR 5i (1)
+.IR vi (1)
 .SH BUGS
 The host is required to be little endian and is assumed to have a floating point implementation conforming to IEEE 754.
 
@@ -111,14 +112,16 @@ Careless use of the
 .B LDREX
 and
 .B STREX
-instructions can lead to deadlock, however a real processor is supposed behave undefined in these cases.
+instructions can lead to deadlock, while the
+.I ARM Architecture Reference Manual
+indicates a real processor will exhibit undefined behavior in these cases.
 
-Accesses spanning segment boundaries will be treated like page faults.
-Many syscalls like
+Accesses spanning segment boundaries will be treated as page faults.
+Many syscalls such as
 .IR pread (2)
-will shuffle data around (in most cases unnecessarily), if invoked on potentially shared segments of variable length, in particular the bss segment.
+will shuffle data around (in most cases unnecessarily) if invoked on potentially shared segments of variable length, in particular the bss segment.
 
-FPA emulation leaves much to desire, rounding modes are ignored, all calculations are performed at extended precision.
+FPA emulation leaves much to be desired, rounding modes are ignored, all calculations are performed at extended precision.
 Floating point exceptions crash the emulator.
 
 Several syscalls, most notably the
@@ -133,5 +136,8 @@ emulation is more than unsatisfactory.
 
 The
 .I text
-argument should behave more like it would if it was entered in
+argument should behave more like it would if it had been entered as an argument to
 .IR rc (1).
+.SH HISTORY
+.I 5e
+first appeared in 9front (June, 2011).