svn commit: r328154 - head/share/man/man9

Warner Losh imp at FreeBSD.org
Thu Jan 18 22:20:32 UTC 2018


Author: imp
Date: Thu Jan 18 22:20:30 2018
New Revision: 328154
URL: https://svnweb.freebsd.org/changeset/base/328154

Log:
  Make igor happier with this file:
  o Don't use contractions.
  o Add common after e.g. where needed

Modified:
  head/share/man/man9/style.9

Modified: head/share/man/man9/style.9
==============================================================================
--- head/share/man/man9/style.9	Thu Jan 18 22:13:53 2018	(r328153)
+++ head/share/man/man9/style.9	Thu Jan 18 22:20:30 2018	(r328154)
@@ -26,7 +26,7 @@
 .\"	From: @(#)style	1.14 (Berkeley) 4/28/95
 .\" $FreeBSD$
 .\"
-.Dd November 16, 2017
+.Dd January 18, 2018
 .Dt STYLE 9
 .Os
 .Sh NAME
@@ -365,7 +365,7 @@ struct foo {
 	struct foo	*next;		/* List of active foo. */
 	struct mumble	amumble;	/* Comment for mumble. */
 	int		bar;		/* Try to align the comments. */
-	struct verylongtypename *baz;	/* Won't fit in 2 tabs. */
+	struct verylongtypename *baz;	/* Does not fit in 2 tabs. */
 };
 struct foo *foohead;			/* Head of global foo list. */
 .Ed
@@ -382,7 +382,7 @@ struct foo {
 	LIST_ENTRY(foo)	link;		/* Use queue macros for foo lists. */
 	struct mumble	amumble;	/* Comment for mumble. */
 	int		bar;		/* Try to align the comments. */
-	struct verylongtypename *baz;	/* Won't fit in 2 tabs. */
+	struct verylongtypename *baz;	/* Does not fit in 2 tabs. */
 };
 LIST_HEAD(, foo) foohead;		/* Head of global foo list. */
 .Ed
@@ -431,7 +431,7 @@ alphabetical unless there is a compelling reason to us
 ordering.
 .Pp
 Functions that are used locally in more than one module go into a
-separate header file, e.g.\&
+separate header file, e.g.,\&
 .Qq Pa extern.h .
 .Pp
 Do not use the
@@ -512,7 +512,7 @@ Code which is unreachable for non-obvious reasons may 
 .Bd -literal
 	while ((ch = getopt(argc, argv, "abNn:")) != -1)
 		switch (ch) {		/* Indent the switch. */
-		case 'a':		/* Don't indent the case. */
+		case 'a':		/* Do not indent the case. */
 			aflag = 1;	/* Indent case body one tab. */
 			/* FALLTHROUGH */
 		case 'b':
@@ -726,7 +726,7 @@ not:
 .Pp
 Do not use
 .Ic \&!
-for tests unless it is a boolean, e.g.\& use:
+for tests unless it is a boolean, e.g.,\& use:
 .Bd -literal
 if (*p == '\e0')
 .Ed
@@ -763,7 +763,7 @@ Old-style function declarations look like this:
 .Bd -literal
 static char *
 function(a1, a2, fl, a4)
-	int a1, a2;	/* Declare ints, too, don't default them. */
+	int a1, a2;	/* Declare ints, too, do not default them. */
 	float fl;	/* Beware double vs. float prototype differences. */
 	int a4;		/* List in order declared. */
 {


More information about the svn-src-head mailing list