Regularize command headers, update links to standards documents.

38 files changed, 8 insertions, 76 deletions

diff --git a/toys/other/bzcat.c b/toys/other/bzcat.c
index b8e16958..c0c2b96a 100644
--- a/toys/other/bzcat.c
+++ b/toys/other/bzcat.c
@@ -3,8 +3,6 @@
  * bzcat.c - decompress stdin to stdout using bunzip2.
  *
  * Copyright 2007 Rob Landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 USE_BZCAT(NEWTOY(bzcat, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/catv.c b/toys/other/catv.c
index c4479d9c..db54b997 100644
--- a/toys/other/catv.c
+++ b/toys/other/catv.c
@@ -4,7 +4,7 @@
  *
  * Copyright (C) 2006, 2007 Rob Landley <rob@landley.net>
  *
- * Not in SUSv3, but see "Cat -v considered harmful" at
+ * See "Cat -v considered harmful" at
  *   http://cm.bell-labs.com/cm/cs/doc/84/kp.ps.gz
 
 USE_CATV(NEWTOY(catv, "vte", TOYFLAG_USR|TOYFLAG_BIN))
diff --git a/toys/other/chroot.c b/toys/other/chroot.c
index 06823796..003ed072 100644
--- a/toys/other/chroot.c
+++ b/toys/other/chroot.c
@@ -3,8 +3,6 @@
  * chroot.c - Run command in new root directory.
  *
  * Copyright 2007 Rob Landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 USE_CHROOT(NEWTOY(chroot, "^<1", TOYFLAG_USR|TOYFLAG_SBIN))
 
diff --git a/toys/other/chvt.c b/toys/other/chvt.c
index 9afb059b..80eeadc4 100644
--- a/toys/other/chvt.c
+++ b/toys/other/chvt.c
@@ -3,8 +3,6 @@
  * chvt.c - switch virtual terminals
  *
  * Copyright (C) 2008 David Anders <danders@amltd.com>
- *
- * Not in SUSv3.
 
 USE_CHVT(NEWTOY(chvt, "<1", TOYFLAG_USR|TOYFLAG_SBIN))
 
diff --git a/toys/other/clear.c b/toys/other/clear.c
index 8cfceff3..7647f669 100644
--- a/toys/other/clear.c
+++ b/toys/other/clear.c
@@ -3,8 +3,6 @@
  * clear.c - clear the screen
  *
  * Copyright 2012 Rob Landley <rob@landley.net>
- *
- * Not in SUSv4.
 
 USE_CLEAR(NEWTOY(clear, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/count.c b/toys/other/count.c
index 0ec3919d..22a06a1c 100644
--- a/toys/other/count.c
+++ b/toys/other/count.c
@@ -3,8 +3,6 @@
  * count.c - Progress indicator from stdin to stdout
  *
  * Copyright 2002 Rob Landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 USE_COUNT(NEWTOY(count, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/dos2unix.c b/toys/other/dos2unix.c
index 01c90536..07e68055 100644
--- a/toys/other/dos2unix.c
+++ b/toys/other/dos2unix.c
@@ -3,8 +3,6 @@
  * dos2unix.c - convert newline format
  *
  * Copyright 2012 Rob Landley <rob@landley.net>
- *
- * No standard
 
 USE_DOS2UNIX(NEWTOY(dos2unix, NULL, TOYFLAG_BIN))
 USE_DOS2UNIX(OLDTOY(unix2dos, dos2unix, NULL, TOYFLAG_BIN))
diff --git a/toys/other/free.c b/toys/other/free.c
index 99dca86d..b009b8b0 100644
--- a/toys/other/free.c
+++ b/toys/other/free.c
@@ -3,8 +3,6 @@
  * free.c - Display amount of free and used memory in the system.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_FREE(NEWTOY(free, "gmkb", TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/hello.c b/toys/other/hello.c
index 06aa470b..cfab40df 100644
--- a/toys/other/hello.c
+++ b/toys/other/hello.c
@@ -1,10 +1,9 @@
 /* vi: set sw=4 ts=4:
  *
- * hello.c - A hello world program.
+ * hello.c - A hello world program. (Template for new commands.)
  *
  * Copyright 2012 Rob Landley <rob@landley.net>
  *
- * Not in SUSv4/LSB.
  * See http://opengroup.org/onlinepubs/9699919799/utilities/
  * See http://refspecs.linuxfoundation.org/LSB_4.1.0/LSB-Core-generic/LSB-Core-generic/cmdbehav.html
 
diff --git a/toys/other/help.c b/toys/other/help.c
index 5e2b6ec4..2c175552 100644
--- a/toys/other/help.c
+++ b/toys/other/help.c
@@ -1,10 +1,10 @@
 /* vi: set sw=4 ts=4:
  *
- * help.c - Show help for toybox
+ * help.c - Show help for toybox commands
  *
  * Copyright 2007 Rob Landley <rob@landley.net>
  *
- * Not in SUSv3, but exists as a bash builtin.
+ * Often a shell builtin.
 
 USE_HELP(NEWTOY(help, "<1", TOYFLAG_BIN))
 
diff --git a/toys/other/insmod.c b/toys/other/insmod.c
index e794828c..3eae538a 100644
--- a/toys/other/insmod.c
+++ b/toys/other/insmod.c
@@ -3,8 +3,6 @@
  * insmod.c - Load a module into the Linux kernel.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_INSMOD(NEWTOY(insmod, "<1", TOYFLAG_BIN|TOYFLAG_NEEDROOT))
 
diff --git a/toys/other/login.c b/toys/other/login.c
index c2c9ba38..8c542a7e 100644
--- a/toys/other/login.c
+++ b/toys/other/login.c
@@ -4,7 +4,6 @@
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
  *
- * Not in SUSv4.
  * No support for PAM/securetty/selinux/login script/issue/utmp
  * Relies on libcrypt for hash calculation.
 
diff --git a/toys/other/lsmod.c b/toys/other/lsmod.c
index 82dbb589..821243b8 100644
--- a/toys/other/lsmod.c
+++ b/toys/other/lsmod.c
@@ -3,8 +3,6 @@
  * lsmod.c - Show the status of modules in the kernel
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_LSMOD(NEWTOY(lsmod, NULL, TOYFLAG_BIN))
 
diff --git a/toys/other/mdev.c b/toys/other/mdev.c
index b769828f..6d030d14 100644
--- a/toys/other/mdev.c
+++ b/toys/other/mdev.c
@@ -1,11 +1,9 @@
 /* vi:set ts=4:
  *
- * mdev - Mini udev for busybox
+ * mdev.c - Populate /dev directory and handle hotplug events
  *
  * Copyright 2005, 2008 Rob Landley <rob@landley.net>
  * Copyright 2005 Frank Sorenson <frank@tuxrocks.com>
- *
- * Not in SUSv3.
 
 USE_MDEV(NEWTOY(mdev, "s", TOYFLAG_USR|TOYFLAG_BIN|TOYFLAG_UMASK))
 
diff --git a/toys/other/mke2fs.c b/toys/other/mke2fs.c
index 47f31f2d..837ea214 100644
--- a/toys/other/mke2fs.c
+++ b/toys/other/mke2fs.c
@@ -3,8 +3,6 @@
  * mke2fs.c - Create an ext2 filesystem image.
  *
  * Copyright 2006, 2007 Rob Landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 // Still to go: "E:jJ:L:m:O:"
 USE_MKE2FS(NEWTOY(mke2fs, "<1>2g:Fnqm#N#i#b#", TOYFLAG_SBIN))
diff --git a/toys/other/mkswap.c b/toys/other/mkswap.c
index 87c1550f..1e96c196 100644
--- a/toys/other/mkswap.c
+++ b/toys/other/mkswap.c
@@ -3,8 +3,6 @@
  * mkswap.c - Format swap device.
  *
  * Copyright 2009 Rob Landley <rob@landley.net>
- *
- * Not in SUSv4.
 
 USE_MKSWAP(NEWTOY(mkswap, "<1>1", TOYFLAG_SBIN))
 
diff --git a/toys/other/mountpoint.c b/toys/other/mountpoint.c
index 405bb3a5..1bb0b3a7 100644
--- a/toys/other/mountpoint.c
+++ b/toys/other/mountpoint.c
@@ -3,8 +3,6 @@
  * mountpoint.c - Check if a directory is a mountpoint.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_MOUNTPOINT(NEWTOY(mountpoint, "<1qdx", TOYFLAG_BIN))
 
diff --git a/toys/other/netcat.c b/toys/other/netcat.c
index 3da19127..6442c09b 100644
--- a/toys/other/netcat.c
+++ b/toys/other/netcat.c
@@ -1,10 +1,8 @@
 /* vi: set sw=4 ts=4:
  *
- * nc: mini-netcat - Forward stdin/stdout to a file or network connection.
+ * netcat.c - Forward stdin/stdout to a file or network connection.
  *
  * Copyright 2007 Rob Landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 USE_NETCAT(OLDTOY(nc, netcat, USE_NETCAT_LISTEN("tl^L^")"w#p#s:q#f:", TOYFLAG_BIN))
 USE_NETCAT(NEWTOY(netcat, USE_NETCAT_LISTEN("tl^L^")"w#p#s:q#f:", TOYFLAG_BIN))
@@ -26,7 +24,7 @@ config NETCAT
 
 
 config NETCAT_LISTEN
-	bool "netcat sever options (-let)"
+	bool "netcat server options (-let)"
 	default y
 	depends on NETCAT
 	help
diff --git a/toys/other/oneit.c b/toys/other/oneit.c
index 45935918..ff7aa914 100644
--- a/toys/other/oneit.c
+++ b/toys/other/oneit.c
@@ -1,10 +1,8 @@
 /* vi: set sw=4 ts=4:
  *
- * oneit.c, tiny one-process init replacement.
+ * oneit.c - tiny init replacement to launch a single child process.
  *
  * Copyright 2005, 2007 by Rob Landley <rob@landley.net>.
- *
- * Not in SUSv3.
 
 USE_ONEIT(NEWTOY(oneit, "^<1c:p", TOYFLAG_SBIN))
 
diff --git a/toys/other/printenv.c b/toys/other/printenv.c
index 305b3e7d..d5177468 100644
--- a/toys/other/printenv.c
+++ b/toys/other/printenv.c
@@ -3,7 +3,6 @@
  * printenv.c - Print environment variables.
  *
  * Copyright 2012 Georgi Chorbadzhiyski <georgi@unixsol.org>
- *
 
 USE_PRINTENV(NEWTOY(printenv, "0(null)", TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/readlink.c b/toys/other/readlink.c
index 51dbf02f..c579635c 100644
--- a/toys/other/readlink.c
+++ b/toys/other/readlink.c
@@ -3,8 +3,6 @@
  * readlink.c - Return string representation of a symbolic link.
  *
  * Copyright 2007 Rob Landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 USE_READLINK(NEWTOY(readlink, "<1f", TOYFLAG_BIN))
 
diff --git a/toys/other/realpath.c b/toys/other/realpath.c
index 10457cf6..1503c455 100644
--- a/toys/other/realpath.c
+++ b/toys/other/realpath.c
@@ -3,8 +3,6 @@
  * realpath.c - Return the canonical version of a pathname
  *
  * Copyright 2012 Andre Renaud <andre@bluewatersys.com>
- *
- * Not in SUSv4.
 
 USE_REALPATH(NEWTOY(realpath, "<1", TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/rmmod.c b/toys/other/rmmod.c
index d730b45d..cfc978ab 100644
--- a/toys/other/rmmod.c
+++ b/toys/other/rmmod.c
@@ -3,8 +3,6 @@
  * rmmod.c - Remove a module from the Linux kernel.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_RMMOD(NEWTOY(rmmod, "<1wf", TOYFLAG_BIN|TOYFLAG_NEEDROOT))
 
diff --git a/toys/other/setsid.c b/toys/other/setsid.c
index 1b98315c..0f08cc03 100644
--- a/toys/other/setsid.c
+++ b/toys/other/setsid.c
@@ -3,8 +3,6 @@
  * setsid.c - Run program in a new session ID.
  *
  * Copyright 2006 Rob Landley <rob@landley.net>
- *
- * Not in SUSv4.
 
 USE_SETSID(NEWTOY(setsid, "^<1t", TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/sha1sum.c b/toys/other/sha1sum.c
index 3229cd12..e5f336a4 100644
--- a/toys/other/sha1sum.c
+++ b/toys/other/sha1sum.c
@@ -6,8 +6,6 @@
  *
  * Based on the public domain SHA-1 in C by Steve Reid <steve@edmweb.com>
  * from http://www.mirrors.wiretapped.net/security/cryptography/hashes/sha1/
- *
- * Not in SUSv3.
 
 USE_SHA1SUM(NEWTOY(sha1sum, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/swapoff.c b/toys/other/swapoff.c
index fba0de83..cac15732 100644
--- a/toys/other/swapoff.c
+++ b/toys/other/swapoff.c
@@ -3,8 +3,6 @@
  * swapoff.c - Disable region for swapping
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_SWAPOFF(NEWTOY(swapoff, "<1>1", TOYFLAG_BIN|TOYFLAG_NEEDROOT))
 
diff --git a/toys/other/swapon.c b/toys/other/swapon.c
index 16ce8d1f..4b9734e4 100644
--- a/toys/other/swapon.c
+++ b/toys/other/swapon.c
@@ -3,8 +3,6 @@
  * swapon.c - Enable region for swapping
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_SWAPON(NEWTOY(swapon, "<1>1p#<0>32767", TOYFLAG_BIN|TOYFLAG_NEEDROOT))
 
diff --git a/toys/other/tac.c b/toys/other/tac.c
index cd5f83f6..7a8bb4ae 100644
--- a/toys/other/tac.c
+++ b/toys/other/tac.c
@@ -3,8 +3,6 @@
  * tac.c - output lines in reverse order
  *
  * Copyright 2012 Rob Landley <rob@landley.net>
- *
- * Not in SUSv4.
 
 USE_TAC(NEWTOY(tac, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/taskset.c b/toys/other/taskset.c
index 7ac3b572..9b219044 100644
--- a/toys/other/taskset.c
+++ b/toys/other/taskset.c
@@ -3,8 +3,6 @@
  * taskset.c - Retrieve or set the CPU affinity of a process.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * No standard.
 
 USE_TASKSET(NEWTOY(taskset, "<1^pa", TOYFLAG_BIN|TOYFLAG_STAYROOT))
 
diff --git a/toys/other/truncate.c b/toys/other/truncate.c
index dccd3215..aa952b16 100644
--- a/toys/other/truncate.c
+++ b/toys/other/truncate.c
@@ -3,8 +3,6 @@
  * truncate.c - set file length, extending sparsely if necessary
  *
  * Copyright 2011 Rob Landley <rob@landley.net>
- *
- * Not in SUSv4
 
 USE_TRUNCATE(NEWTOY(truncate, "<1s#|c", TOYFLAG_BIN))
 
diff --git a/toys/other/unshare.c b/toys/other/unshare.c
index 1df9b758..bdee66bc 100644
--- a/toys/other/unshare.c
+++ b/toys/other/unshare.c
@@ -3,8 +3,6 @@
  * unshare.c - run command in new context
  *
  * Copyright 2011 Rob Landley <rob@landley.net>
- *
- * Not in SUSv4.
 
 USE_UNSHARE(NEWTOY(unshare, "<1^nium", TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/uptime.c b/toys/other/uptime.c
index 83fb6b1e..dfd62b6c 100644
--- a/toys/other/uptime.c
+++ b/toys/other/uptime.c
@@ -3,8 +3,6 @@
  * uptime.c - Tell how long the system has been running.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_UPTIME(NEWTOY(uptime, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/usleep.c b/toys/other/usleep.c
index 6efc0c16..ff7fe88b 100644
--- a/toys/other/usleep.c
+++ b/toys/other/usleep.c
@@ -3,8 +3,6 @@
  * usleep.c - Wait for a number of microseconds.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * No standard.
 
 USE_USLEEP(NEWTOY(usleep, "<1", TOYFLAG_BIN))
 
diff --git a/toys/other/vmstat.c b/toys/other/vmstat.c
index 2826ced5..b4858227 100644
--- a/toys/other/vmstat.c
+++ b/toys/other/vmstat.c
@@ -3,8 +3,6 @@
  * vmstat.c - Report virtual memory statistics.
  *
  * Copyright 2012 Elie De Brauwer <eliedebrauwer@gmail.com>
- *
- * Not in SUSv4.
 
 USE_VMSTAT(NEWTOY(vmstat, ">2n", TOYFLAG_BIN))
 
diff --git a/toys/other/w.c b/toys/other/w.c
index 50f2283b..097a4386 100644
--- a/toys/other/w.c
+++ b/toys/other/w.c
@@ -3,8 +3,6 @@
  * w.c - shows logged in users
  *
  * Copyright 2012 Gaurang Shastri <gmshastri@gmail.com>
- *
- * Not in SUSv4.
 
 USE_W(NEWTOY(w, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/which.c b/toys/other/which.c
index 4923859c..44b1f568 100644
--- a/toys/other/which.c
+++ b/toys/other/which.c
@@ -3,8 +3,6 @@
  * which.c - Find executable files in $PATH.
  *
  * Copyright 2006 Rob landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 USE_WHICH(NEWTOY(which, "<1a", TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/whoami.c b/toys/other/whoami.c
index 6d9233d1..e6131498 100644
--- a/toys/other/whoami.c
+++ b/toys/other/whoami.c
@@ -3,7 +3,6 @@
  * whoami.c - Print effective user name
  *
  * Copyright 2012 Georgi Chorbadzhiyski <georgi@unixsol.org>
- *
 
 USE_WHOAMI(NEWTOY(whoami, NULL, TOYFLAG_USR|TOYFLAG_BIN))
 
diff --git a/toys/other/yes.c b/toys/other/yes.c
index a44937b3..90bf522d 100644
--- a/toys/other/yes.c
+++ b/toys/other/yes.c
@@ -3,8 +3,6 @@
  * yes.c - Repeatedly output a string.
  *
  * Copyright 2007 Rob Landley <rob@landley.net>
- *
- * Not in SUSv3.
 
 USE_YES(NEWTOY(yes, NULL, TOYFLAG_USR|TOYFLAG_BIN))