From owner-cvs-all Mon Oct 28 11:34:29 2002 Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BBC3237B401; Mon, 28 Oct 2002 11:34:28 -0800 (PST) Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6B4B243E42; Mon, 28 Oct 2002 11:34:28 -0800 (PST) (envelope-from rwatson@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.12.6/8.12.6) with ESMTP id g9SJXMmV022601; Mon, 28 Oct 2002 11:33:22 -0800 (PST) (envelope-from rwatson@repoman.freebsd.org) Received: (from rwatson@localhost) by repoman.freebsd.org (8.12.6/8.12.6/Submit) id g9SJXM9f022600; Mon, 28 Oct 2002 11:33:22 -0800 (PST) Message-Id: <200210281933.g9SJXM9f022600@repoman.freebsd.org> From: Robert Watson Date: Mon, 28 Oct 2002 11:33:22 -0800 (PST) To: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: cvs commit: src/share/man/man9 style.9 X-FreeBSD-CVS-Branch: HEAD Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG rwatson 2002/10/28 11:33:22 PST Modified files: share/man/man9 style.9 Log: Clarify style(9) WRT comments following #endif, #else. The closing comment is required only for long conditionally defined code sections, with the exception of lint cases. Attempt to document also the logic for using '!' before the SOMETIMESSOMETHGINGHERE. The goal of these comments is to make complex cases more comprehensible, not to require them in all cases. The rules here are derived from behavior used in 90+% of the kernel source code. Reviewed by and discussed with: jhb, bde, mike Revision Changes Path 1.94 +63 -1 src/share/man/man9/style.9 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message