more man page/readme changes

README.md

@@ -16,19 +16,30 @@ promises for program execution
 
 # DESCRIPTION
 
-The
 **abstain**
-utility executes a
+executes a
 *binary*
 with
 (optional)
 *arguments*
 using
 pledge(2)
 *execpromises*.
-By default, it will do so with all
+Unlike
+pledge(2)'s
+syntax of specifying arguments for
+*addition*,
+**abstain**'s
+*promises*
+are listed for
+*subtraction*.
+This means that without any
+**-p**
+*promises*,
+the maximal number of
+pledge(2)
 *promises*
-allowed.
+are permitted.
 (This doesn't mean that no restrictions are imposed by
 pledge(2).)
 To disallow
@@ -39,6 +50,25 @@ in a comma-separated list and/or with multiple
 **-p**
 arguments.
 
+**abstain**
+imposes a
+pledge(2)
+*promise set*
+on the application
+*as a whole*.
+Depending on the nature of the application, it could fail to launch or abort execution at a later stage when a
+pledge(2)
+violation occurs.
+
+Due to the nature of
+*execpromises*,
+the restrictions will propagate to children of the application and new processes spawned by
+execve(2)
+(see the
+make(1)
+example below)
+.
+
 The
 'error'
 *promise*
@@ -58,24 +88,6 @@ execvp(3)
 and the
 *execpromises*.
 
-**abstain**
-imposes a
-pledge(2)
-*promise set*
-on the application as a whole.
-Depending on the nature of the application, it could fail to launch or abort execution at a later stage when a
-pledge(2)
-violation occurs.
-
-Due to the nature of
-*execpromises*,
-the restrictions will propagate to children of the application and new processes spawned by
-execve(2)
-(see the
-make(1)
-example below)
-.
-
 # EXAMPLES
 
 Prohibit file system modification:

abstain.1

@@ -13,9 +13,8 @@ promises for program execution
 .Op Fl p Ar promise Ns Op Ar ,promise,...
 .Ar binary Op Ar arguments Ar ...
 .Sh DESCRIPTION
-The
 .Nm
-utility executes a
+executes a
 .Ar binary
 with
 .Pq optional