MFC:

* top.X

  revision 1.15
  Document the -C option of top(1), which has been added to the source
  and the usage message of top, but not to the manpage.

  Pointy hat to:  keramida
  Reminded by:    ru
  MFC after:      1 week

* top.c

  revision 1.18
  Bring SYNOPSIS in line with usage().
  ----------
  revision 1.19
  Re-add option -C to usage().

Approved by:	re (hrs)

contrib/top/top.X

@@ -10,7 +10,7 @@ top \- display and update information about the top cpu processes
 .SH SYNOPSIS
 .B top
 [
-.B \-SbiInqutv
+.B \-bCHIinqStuv
 ] [
 .BI \-d count
 ] [
@@ -62,6 +62,18 @@ is redirected to a file, it acts as if it were being run on a dumb
 terminal.
 .SH OPTIONS
 .TP
+.B \-C
+Toggle CPU display mode.
+By default top displays the weighted CPU percentage in the WCPU column
+(this is the same value that
+.IR ps (1)
+displays as CPU).
+Each time
+.B \-C
+flag is passed it toggles between \*(lqraw cpu\*(rq mode
+and \*(lqweighted cpu\*(rq mode, showing the \*(lqCPU\*(rq or
+the \*(lqWCPU\*(rq column respectively.
+.TP
 .B \-S
 Show system processes in the display.  Normally, system processes such as
 the pager and the swapper are not shown.  This option makes them visible.

contrib/top/top.c

@@ -395,9 +395,10 @@ char *argv[];
 		break;
 
 	      default:
-		fprintf(stderr, "\
-Top version %s\n\
-Usage: %s [-CHISbinqut] [-d x] [-s x] [-o field] [-U username] [number]\n",
+		fprintf(stderr,
+"Top version %s\n"
+"Usage: %s [-bCHIinqStuv] [-d count] [-m io | cpu] [-o field] [-s time]\n"
+"       [-U username] [number]\n",
 			version_string(), myname);
 		exit(1);
 	    }