Some synced man(1) pages and the source.

Notes:
Fri Dec 9 10:32:05 EST 2005 rsc
    Thanks for finding these.  
    
    The changes aren't quite right, though.
    Please fix the below issues and then resubmit.
    
    - acid(1) begins with the usage message from acid
      above the .TH line.
    
    - the -r option to acid seems worthless.  it should
      be dropped instead of documented.  i suspect it predates
      rdbfs.  it certainly doesn't do anything interesting.
    
    - you changed the name "libfile" or "library" to "module",
      in the man page, which is fine, but you left "library" in
      the text.
    
    - acme(1)'s synopsis dropped the fact that you can give acme a
      list of files to open.
    
    - acme's usage should list the files too (it never did)
    
    - ascii(1) should use ".B b" not ".BI b".  only use .BI etc.
      if there is more than one argument.
    
    - the standard form (not always followed) of a usage line is
      usage: name [singleletteroptions] [option arg] [option arg] etc.
    
      the singleletteroptions should be sorted alphabetically,
      and the option args should also be sorted alphabetically.
    
      so the bc usage should be bc [-cdls] [file ...].
    
    - the -d option to bc enables debugging output, not debugging.
      saying it enables debugging sounds like it makes it possible
      to use acid or db on it.  factotum is the only program in the
      system with an option to enable debugging.  it's a small point.
    
    Thanks again.
    Russ


Reference: /n/sources/patch/sorry/man1-sync0
Date: Thu Dec  8 11:08:14 CET 2005
Reviewed-by: rsc

--- /sys/man/1/acid	Thu Dec  8 11:01:28 2005
+++ /sys/man/1/acid	Thu Dec  8 11:01:22 2005
@@ -1,16 +1,21 @@
+acid [-l module] [-m machine] [-qrw] [-k] [pid] [file]
+
 .TH ACID 1
 .SH NAME
 acid, truss, trump \- debugger
 .SH SYNOPSIS
 .B acid
 [
-.BI -l " libfile
+.BI -l " module
 ]
 [
-.B -wq
-] [
-.B -m
-.I machine
+.BI -m " machine
+]
+[
+.B -qrw
+]
+[
+.B -k
 ] [
 .I pid
 ]
@@ -49,10 +54,13 @@
 .B -w
 Allow the textfile to be modified.
 .TP
+.B -r
+Debug the kernel state of a textfile.
+.TP
 .B -q
 Print variable renamings at startup.
 .TP
-.BI -l " library
+.BI -l " module
 Load from 
 .I library
 at startup; see below.
--- /sys/src/cmd/acid/main.c	Thu Dec  8 11:01:49 2005
+++ /sys/src/cmd/acid/main.c	Thu Dec  8 11:01:43 2005
@@ -22,7 +22,7 @@
 void
 usage(void)
 {
-	fprint(2, "usage: acid [-l module] [-m machine] [-qrw] [-k] [pid] [file]\n");
+	fprint(2, "usage: acid [-l module] [-m machine] [-qrw] [-k] [pid] [textfile]\n");
 	exits("usage");
 }
 
--- /sys/man/1/acme	Thu Dec  8 11:02:16 2005
+++ /sys/man/1/acme	Thu Dec  8 11:02:09 2005
@@ -20,10 +20,8 @@
 ]
 [
 .B -l
-.I file
-|
-.I file
-\&... ]
+.I loadfile
+]
 .LP
 .B win
 [
--- /sys/src/cmd/acme/acme.c	Thu Dec  8 11:02:48 2005
+++ /sys/src/cmd/acme/acme.c	Thu Dec  8 11:02:41 2005
@@ -101,7 +101,7 @@
 		break;
 	default:
 	Usage:
-		fprint(2, "usage: acme -a -c ncol -f fontname -F fixedwidthfontname -l loadfile\n");
+		fprint(2, "usage: acme [-ab] [-c ncol] [-f varfont] [-F fixfont] [-l loadfile]\n");
 		exits("usage");
 	}ARGEND
 
--- /sys/man/1/ascii	Thu Dec  8 11:03:19 2005
+++ /sys/man/1/ascii	Thu Dec  8 11:03:15 2005
@@ -7,7 +7,11 @@
 .B -8
 ]
 [
-.BI -oxdb n
+.BI -oxd
+]
+[
+.BI -b
+.I n
 ]
 [
 .B -nct
--- /sys/src/cmd/ascii.c	Thu Dec  8 11:03:56 2005
+++ /sys/src/cmd/ascii.c	Thu Dec  8 11:03:53 2005
@@ -112,7 +112,7 @@
 void
 usage(void)
 {
-	fprint(2, "usage: %s [-8] [-xod | -b8] [-ncst] [--] [text]\n", argv0);
+	fprint(2, "usage: %s [-8] [-oxd] [-b n] [-nct] [text]\n", argv0);
 	exits("usage");
 }
 void
--- /sys/man/1/awk	Thu Dec  8 11:04:37 2005
+++ /sys/man/1/awk	Thu Dec  8 11:04:32 2005
@@ -4,23 +4,30 @@
 .SH SYNOPSIS
 .B awk
 [
-.BI -F fs
+.BI -safe
+]
+[
+.BI -d
+]
+[
+.BI -F
+.I fs
 ]
 [
 .BI -v
 .I var=value
 ]
 [
-.BI -mr n
+.BI -mr
+.I n
 ]
 [
-.BI -mf n
+.BI -mf
+.I n
 ]
 [
 .B -f
 .I prog
-[
-.I prog
 ]
 [
 .I file ...
@@ -66,6 +73,9 @@
 .IR fs
 option defines the input field separator to be the regular expression
 .IR fs .
+The
+.B \-safe
+option specifies to not set the ENVIRON variable.
 .PP
 An input line is normally made up of fields separated by white space,
 or by regular expression
--- /sys/src/cmd/awk/main.c	Thu Dec  8 11:05:22 2005
+++ /sys/src/cmd/awk/main.c	Thu Dec  8 11:05:18 2005
@@ -57,7 +57,7 @@
 
 	cmdname = argv[0];
 	if (argc == 1) {
-		fprintf(stderr, "Usage: %s [-f programfile | 'program'] [-Ffieldsep] [-v var=value] [files]\n", cmdname);
+		fprintf(stderr, "Usage: %s [-safe] [-d] [-F fs] [-v var=value] [-mr n] [-mf n] [-f prog] [file ...]\n", cmdname);
 		exit(1);
 	}
 	signal(SIGFPE, fpecatch);
--- /sys/man/1/bc	Thu Dec  8 11:06:08 2005
+++ /sys/man/1/bc	Thu Dec  8 11:06:04 2005
@@ -4,13 +4,7 @@
 .SH SYNOPSIS
 .B bc
 [
-.B -c
-]
-[
-.B -l
-]
-[
-.B -s
+.B -dcls
 ]
 [
 .I file ...
@@ -32,6 +26,9 @@
 of calculation results; all output is via the
 .B print
 command.
+The
+.B -d
+argument enables debugging.
 .PP
 The following syntax for 
 .I bc
--- /sys/src/cmd/bc.y	Thu Dec  8 11:07:09 2005
+++ /sys/src/cmd/bc.y	Thu Dec  8 11:07:03 2005
@@ -956,7 +956,7 @@
 			sflag++;
 			break;
 		default:
-			fprint(2, "Usage: bc [-l] [-c] [file ...]\n");
+			fprint(2, "Usage: bc [-dcls] [file ...]\n");
 			exits("usage");
 		}
 		argc--;