From owner-freebsd-doc Tue Mar 19 11:52:11 2002 Delivered-To: freebsd-doc@freebsd.org Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id A98E637B429 for ; Tue, 19 Mar 2002 11:51:54 -0800 (PST) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id 53415BD4F; Tue, 19 Mar 2002 11:51:54 -0800 (PST) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id LAA23391; Tue, 19 Mar 2002 11:51:51 -0800 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id g2JJpRi35175; Tue, 19 Mar 2002 11:51:27 -0800 (PST) (envelope-from swear@blarg.net) To: Hiten Pandya Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/35949: [PATCH] rtprio(1) man page uses incorrect english References: <200203191050.g2JAo4139312@freefall.freebsd.org> From: swear@blarg.net (Gary W. Swearingen) Date: 19 Mar 2002 11:51:26 -0800 In-Reply-To: <200203191050.g2JAo4139312@freefall.freebsd.org> Message-ID: Lines: 34 User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii 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 Hiten Pandya writes: > Hmm, OK. If you guys think the patch is not worth it to go into the > rtprio(1) man page, and the previous english is/was correct, then you > can close the PR with success. Otherwise I can submit another patch > which has the type of clarity wanted (the comma stuff). 8-) Everything I've read welcomes such PRs and many, lowest priority, innocous mispellings are the first PRs to get dealt with. Go for it. As for the offending paragraph: There is in FreeBSD no way to ensure that a process page is present in memory therefore the process may be stopped for pagein (see mprotect(2), madvise(2)). it would be better as There is, in FreeBSD, no way to ensure that a process page is present in memory, therefore the process might be stopped for pagein. See mprotect(2) and madvise(2). (as "in FreeBSD" is a sort of parenthetical clause and "might" expresses probability better than "may" which usually expresses permission),, or better (as was suggested previously): In FreeBSD, there is no way ... Many would omit the comma, but I put commas where I pause in speech. One could argue that "In FreeBSD" is dragging in a comment on a VM design issue that has no place in this manual. One could also argue that the whole paragraph doesn't belong this manual because it really has nothing to do with the design or implementation of the program, nor even its specification. Note that the "process" referred to is not the "rtprio" process. Any fix of the "bug" would be almost certainly be done in another program. (Maybe the paragraph should be in a "Comments" section. You can bet that some people wouldn't be happy with the paragraph's deletion.) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message