From owner-freebsd-questions@FreeBSD.ORG Sun Oct 18 07:39:19 2009 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D7D6E106568F for ; Sun, 18 Oct 2009 07:39:19 +0000 (UTC) (envelope-from bennett@cs.niu.edu) Received: from mp.cs.niu.edu (mp.cs.niu.edu [131.156.145.41]) by mx1.freebsd.org (Postfix) with ESMTP id 928328FC1B for ; Sun, 18 Oct 2009 07:39:19 +0000 (UTC) Received: from mp.cs.niu.edu (bennett@localhost [127.0.0.1]) by mp.cs.niu.edu (8.14.3/8.14.3) with ESMTP id n9I7cFOm006706; Sun, 18 Oct 2009 02:38:15 -0500 (CDT) Date: Sun, 18 Oct 2009 02:38:15 -0500 (CDT) From: Scott Bennett Message-Id: <200910180738.n9I7cFth006705@mp.cs.niu.edu> To: freebsd-questions@freebsd.org, Polytropon Cc: PJ Subject: Re: I hate to bitch but bitch I must X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Oct 2009 07:39:19 -0000 On Sat, 17 Oct 2009 05:18:48 +0200 Polytropon wrote: >On Fri, 16 Oct 2009 20:59:18 -0600 (MDT), Warren Block wrote: >> I understand it, but see ambiguity in the word "should". Easy enough to >> rewrite: >> >> BUGS ^ ^^^ ^^^^^ ^^^^^^^ ^^^ ^^^ ^^^ ^^^ Please note that the section header that reads "BUGS" is the operative word here. >> This utility does not work on active file systems. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The above is the sole bug described in the "BUGS" section. (The other entry in this section is quite obviously just a silly play on words, not a bug.) >> >> Now here's my challenge to PJ: use send-pr(1) or the web PR interface at >> http://www.freebsd.org/send-pr.html to submit this as a doc bug report. >> >> That's how FreeBSD gets better, and how you help the next person in the >> same situation. > >That's a good advice, because in this particular situation, >the utility in question does NOT work on active file systems, >it refuses to do so and throws the proper error message. > >There are cases where a program should work (under certain >circumstances), but if a specified setting is not met, it >works incorrectly (but still works), like using dump on a >filesystem that's changing - usually producing a defective >dump file that cannot be properly restored. > >For completeness: If a program does not work, the manual >should not say "it should work", but "it does not work" >regarding a given situation. The problem has nothing to do with the documention or any translation problem, as I see it. The problem is simply the failure of the OP to read the section title, which clearly says, "BUGS". Now please, all of you, stop spamming the list with all this nonsense. The very first respondent could well have pointed out the problem, and that would have been the end of the matter. Scott Bennett, Comm. ASMELG, CFIAG ********************************************************************** * Internet: bennett at cs.niu.edu * *--------------------------------------------------------------------* * "A well regulated and disciplined militia, is at all times a good * * objection to the introduction of that bane of all free governments * * -- a standing army." * * -- Gov. John Hancock, New York Journal, 28 January 1790 * **********************************************************************