From owner-freebsd-doc Tue Sep 25 9:20: 9 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (unknown [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 58CD837B409 for ; Tue, 25 Sep 2001 09:20:02 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f8PGK2060169; Tue, 25 Sep 2001 09:20:02 -0700 (PDT) (envelope-from gnats) Date: Tue, 25 Sep 2001 09:20:02 -0700 (PDT) Message-Id: <200109251620.f8PGK2060169@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: swear@blarg.net (Gary W. Swearingen) Subject: Re: docs/30809: fdisk(8) cleanup Reply-To: swear@blarg.net (Gary W. Swearingen) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/30809; it has been noted by GNATS. From: swear@blarg.net (Gary W. Swearingen) To: Piet Delport Cc: FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/30809: fdisk(8) cleanup Date: 25 Sep 2001 08:45:19 -0700 > .Pp > -When called with no arguments, it prints the sector 0 partition table. > +When called with no arguments, ^^^^^^^^^ Should be "options". (The only argument is "disk".) > -The flags > +The > .Fl i > or ^^ Should be "and"; "or" sounds like the writer doesn't know which flag. > The syntax of this file is very simple. Each line is either a comment or > -a specification, and whitespace (except for newlines) are ignored: > +a specification, and whitespace (except for newlines) is not significant: How about: > +a specification, as follows. Newlines are part of the presumed definition of a line and shouldn't be mentioned (or if the handling is weird, it needs much more discussion). Whitespace IS significant and is NOT ignored and explaining it carefully shouldn't be required in every man page. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message