Add README and m fixes to man page

Signed-off-by: Mattias Andrée <maandree@kth.se>

2 files changed, 36 insertions, 6 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..01c8b13
--- /dev/null
+++ b/README
@@ -0,0 +1,35 @@
+NAME
+	asroot - run a process as the root user
+
+SYNOPSIS
+	asroot [-e] command [argument] ...
+
+DESCRIPTION
+	The asroot utility asks for the user's password and runs the specified
+	command with sanitised and updated environment variables.
+
+	Only users in the wheel group are allowed to run the asroot utility,
+	unless it is installed with non-standard permissions.
+
+OPTIONS
+	The asroot utility conforms to the Base Definitions volume of
+	POSIX.1-2017, Section 12.2, Utility Syntax Guidelines.
+
+	The following option is supported:
+
+	-e	Keep the environment variables as is. Neither sanitise nor
+		update them.
+
+OPERANDS
+	The following operands are supported:
+
+	command
+		The command that shall be run with as the root user. This will
+		be both the process image and the process's zeroth command line
+		argument.
+
+	argument ...
+		Command line arguments for the command to run.
+
+SEE ALSO
+	sudo(8), doas(1), su(1)
diff --git a/asroot.8 b/asroot.8
index 4492fc1..3df9149 100644
--- a/asroot.8
+++ b/asroot.8
@@ -12,7 +12,7 @@ asroot - run a process as the root user
 .SH DESCRIPTION
 The
 .B asroot
-utility as for the user's password and runs the
+utility asks for the user's password and runs the
 specified
 .I command
 with sanitised and updated environment variables.
@@ -117,11 +117,6 @@ None.
 .SH EXAMPLES
 None.
 
-.SH CONFORMING TO
-The
-.B asroot
-utility is non-standard utility.
-
 .SH RATIONALE
 None.