Make sure all possible EXIT STATUS values are listed,

none are listed multiple times, and polish the wording.
Incompleteness and potential for confusion noticed by millert@.
Using feedback from jmc@ and millert@.

1 files changed, 16 insertions, 15 deletions

diff --git a/usr.bin/env/env.1 b/usr.bin/env/env.1
index 55cc707279c..5b6c4d999f2 100644
--- a/usr.bin/env/env.1
+++ b/usr.bin/env/env.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: env.1,v 1.18 2010/09/29 07:44:56 jmc Exp $
+.\"	$OpenBSD: env.1,v 1.19 2014/03/08 01:42:17 schwarze Exp $
 .\" Copyright (c) 1980, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -30,7 +30,7 @@
 .\"
 .\"	from: @(#)printenv.1	6.7 (Berkeley) 7/28/91
 .\"
-.Dd $Mdocdate: September 29 2010 $
+.Dd $Mdocdate: March 8 2014 $
 .Dt ENV 1
 .Os
 .Sh NAME
@@ -82,28 +82,29 @@ The
 utility exits with one of the following values:
 .Bl -tag -width Ds
 .It 0
-.Ar utility
-was invoked and completed successfully.
-In this case the exit code is returned by the utility itself, not
-.Nm .
-If no utility was specified, then
 .Nm
-completed successfully and returned the exit code itself.
+completed successfully and, if
+.Ar utility
+was specified, it was invoked and completed successfully too.
 .It 1
 An invalid command line option was passed to
-.Nm .
-.It 1\(en125
+.Nm
+and
+.Ar utility
+was not invoked, or
+.Ar utility
+was invoked but failed with exit status 1.
+.It 2\(en125, 128\(en255
 .Ar utility
-was invoked but failed in some way;
+was invoked but failed with this exit status;
 see its manual page for more information.
-In this case the exit code is returned by the utility itself, not
-.Nm .
 .It 126
 .Ar utility
-was found but could not be invoked.
+was found but could not be invoked, or it was invoked but failed
+with exit status 126.
 .It 127
 .Ar utility
-could not be found.
+could not be found, or it was invoked but failed with exit status 127.
 .El
 .Sh SEE ALSO
 .Xr execvp 3 ,