summaryrefslogtreecommitdiff
path: root/utils
diff options
context:
space:
mode:
Diffstat (limited to 'utils')
-rw-r--r--utils/devprobe.c3
-rw-r--r--utils/fsysopts.c3
-rw-r--r--utils/hurdids.c2
-rw-r--r--utils/login.c1
-rw-r--r--utils/portinfo.c3
-rw-r--r--utils/ps.c8
-rw-r--r--utils/settrans.c3
-rw-r--r--utils/showtrans.c6
-rw-r--r--utils/storeinfo.c3
-rw-r--r--utils/vmstat.c3
-rw-r--r--utils/w.c2
-rw-r--r--utils/x.c4
12 files changed, 24 insertions, 17 deletions
diff --git a/utils/devprobe.c b/utils/devprobe.c
index e29e1e32..a0f61733 100644
--- a/utils/devprobe.c
+++ b/utils/devprobe.c
@@ -33,7 +33,8 @@ static const struct argp_option options[] = {
{0}
};
static const char *args_doc = "DEVNAME...";
-static const char *doc = "The exit status is 0 if any devices were found.";
+static const char *doc = "Test for the existance of mach device DEVNAME..."
+ "\vThe exit status is 0 if any devices were found.";
int
main (int argc, char **argv)
diff --git a/utils/fsysopts.c b/utils/fsysopts.c
index 076e2a87..a4cab6b7 100644
--- a/utils/fsysopts.c
+++ b/utils/fsysopts.c
@@ -40,7 +40,8 @@ static struct argp_option options[] =
{0, 0, 0, 0}
};
static char *args_doc = "FILESYS [FS_OPTION...]";
-static char *doc = "The legal values for FS_OPTION depends on FILESYS, but\
+static char *doc = "Get or set command line options for running translator FILESYS."
+"\vThe legal values for FS_OPTION depends on FILESYS, but\
some common ones are: --readonly, --writable, --remount, --sync[=INTERVAL],\
and --nosync.\n\nIf no options are supplied, FILESYS's existing options\
are printed";
diff --git a/utils/hurdids.c b/utils/hurdids.c
index 18eb3c41..26c2d14a 100644
--- a/utils/hurdids.c
+++ b/utils/hurdids.c
@@ -43,7 +43,7 @@ static struct argp_option options[] =
{0}
};
static char *args_doc = 0;
-static char *doc = 0;
+static char *doc = "Show hurd uids/gids.";
/* ---------------------------------------------------------------- */
diff --git a/utils/login.c b/utils/login.c
index 46f9629b..4e0c7d12 100644
--- a/utils/login.c
+++ b/utils/login.c
@@ -108,6 +108,7 @@ static struct argp_option options[] =
};
static char *args_doc = "[USER [ARG...]]";
static char *doc =
+"Exec a program with uids and/or the environment changed appropriately.\v"
"To give args to the shell without specifying a user, use - for USER.\n"
"Current login parameters include HOME, SHELL, USER, NAME, and ROOT.";
diff --git a/utils/portinfo.c b/utils/portinfo.c
index 10f5fe8f..fc0ce214 100644
--- a/utils/portinfo.c
+++ b/utils/portinfo.c
@@ -72,7 +72,8 @@ static const struct argp_option options[] = {
};
static const char *args_doc = "PID [NAME...]";
static const char *doc =
-"If no port NAMEs are given, all ports in process PID are reported (if"
+"Show information about mach ports NAME... (default all ports) in process PID."
+"\vIf no port NAMEs are given, all ports in process PID are reported (if"
" translation is used, then only those common to both processes). NAMEs"
" may be specified in hexadecimal or octal by using a 0x or 0 prefix.";
diff --git a/utils/ps.c b/utils/ps.c
index a688cb37..eb8bfad7 100644
--- a/utils/ps.c
+++ b/utils/ps.c
@@ -90,10 +90,10 @@ static const struct argp_option options[] =
};
char *args_doc = "[PID...]";
-
-char *doc = "The USER, LID, PID, PGRP, and SID arguments may also be comma \
-separated lists. The System V options -u and -g may be accessed with -O and \
---pgrp.";
+char *doc =
+"Show information about processes PID... (default all `interesting' processes)"
+"\vThe USER, LID, PID, PGRP, and SID arguments may also be comma separated"
+" lists. The System V options -u and -g may be accessed with -O and -G.";
int
parse_enum(char *arg, char **choices, char *kind, int allow_mismatches)
diff --git a/utils/settrans.c b/utils/settrans.c
index ff264a5b..93dbdefa 100644
--- a/utils/settrans.c
+++ b/utils/settrans.c
@@ -61,7 +61,8 @@ static struct argp_option options[] =
{0, 0}
};
static char *args_doc = "NODE [TRANSLATOR ARG...]";
-static char *doc = "By default the passive translator is set.";
+static char *doc = "Set the passive/active translator on NODE."
+"\vBy default the passive translator is set.";
/* ---------------------------------------------------------------- */
diff --git a/utils/showtrans.c b/utils/showtrans.c
index d6acfd9d..32aaaa74 100644
--- a/utils/showtrans.c
+++ b/utils/showtrans.c
@@ -42,9 +42,9 @@ static struct argp_option options[] =
};
static char *args_doc = "FILE...";
-
-static char *doc = "A FILE argument of `-' prints the translator on the node \
-attached to standard input.";
+static char *doc = "Show the passive translator of FILE..."
+"\vA FILE argument of `-' prints the translator on the node"
+" attached to standard input.";
/* ---------------------------------------------------------------- */
diff --git a/utils/storeinfo.c b/utils/storeinfo.c
index ba6d0654..86e827be 100644
--- a/utils/storeinfo.c
+++ b/utils/storeinfo.c
@@ -48,7 +48,8 @@ static struct argp_option options[] =
{0, 0}
};
static char *args_doc = "FILE...";
-static char *doc = "With no FILE arguments, the file attached to standard \
+static char *doc = "Show information about storage used by FILE..."
+"\vWith no FILE arguments, the file attached to standard \
input is used. The fields to be printed are separated by colons, in this \
order: PREFIX: KIND: NAME: BLOCK-SIZE: BLOCKS: SIZE: RUNS. If the store is a \
composite one and --children is specified, children are printed on lines \
diff --git a/utils/vmstat.c b/utils/vmstat.c
index c7f7a7af..eb0595f7 100644
--- a/utils/vmstat.c
+++ b/utils/vmstat.c
@@ -48,7 +48,8 @@ static const struct argp_option options[] = {
{0}
};
static const char *args_doc = "[PERIOD [COUNT [HEADER_INTERVAL]]]";
-static const char *doc = "If PERIOD is supplied, then terse mode is"
+static const char *doc = "Show system virtual memory statistics"
+"\vIf PERIOD is supplied, then terse mode is"
" selected, and the output repeated every PERIOD seconds, with cumulative"
" fields given the difference from the last output. If COUNT is given"
" and non-zero, only that many lines are output. HEADER_INTERVAL"
diff --git a/utils/w.c b/utils/w.c
index 0b31385e..73041637 100644
--- a/utils/w.c
+++ b/utils/w.c
@@ -71,7 +71,7 @@ static struct argp_option options[] =
{0, 0}
};
static char *args_doc = "[USER...]";
-static char *doc = 0;
+static char *doc = "Show logged in users and what they are doing";
/* The current time of day. */
static struct timeval now;
diff --git a/utils/x.c b/utils/x.c
index 0e4f7e02..e4e272f4 100644
--- a/utils/x.c
+++ b/utils/x.c
@@ -55,8 +55,8 @@ static struct argp_option options[] =
{0, 0}
};
static char *args_doc = "[USER...]";
-static char *doc =
- "A USER specified as an argument adds (or removes) that user's groups as"
+static char *doc = "Modify authentication of existing processes"
+ "\vA USER specified as an argument adds (or removes) that user's groups as"
" well. When removing groups implied by such an argument, the groups to"
" which uids remaining in the process after any we remove are ignored."
"\nUids and groups specified with options are used as-is.";