From owner-freebsd-questions@FreeBSD.ORG  Sat Oct 17 03:18:51 2009
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
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 7C69B106566B
	for <freebsd-questions@freebsd.org>;
	Sat, 17 Oct 2009 03:18:51 +0000 (UTC)
	(envelope-from freebsd@edvax.de)
Received: from mx01.qsc.de (mx01.qsc.de [213.148.129.14])
	by mx1.freebsd.org (Postfix) with ESMTP id 39B9B8FC12
	for <freebsd-questions@freebsd.org>;
	Sat, 17 Oct 2009 03:18:51 +0000 (UTC)
Received: from r55.edvax.de (port-92-195-71-245.dynamic.qsc.de [92.195.71.245])
	by mx01.qsc.de (Postfix) with ESMTP id 09B893CB09;
	Sat, 17 Oct 2009 05:18:49 +0200 (CEST)
Received: from r55.edvax.de (localhost [127.0.0.1])
	by r55.edvax.de (8.14.2/8.14.2) with SMTP id n9H3Invf005513;
	Sat, 17 Oct 2009 05:18:49 +0200 (CEST)
	(envelope-from freebsd@edvax.de)
Date: Sat, 17 Oct 2009 05:18:48 +0200
From: Polytropon <freebsd@edvax.de>
To: Warren Block <wblock@wonkity.com>
Message-Id: <20091017051848.07c7e66a.freebsd@edvax.de>
In-Reply-To: <alpine.BSF.2.00.0910162048300.84957@wonkity.com>
References: <4AD8EB8F.9010900@videotron.ca>
	<20091017010758.088b8b8c.freebsd@edvax.de>
	<4AD9016E.20302@videotron.ca> <20091017000439.GA25910@stainmore>
	<alpine.BSF.2.00.0910162048300.84957@wonkity.com>
Organization: EDVAX
X-Mailer: Sylpheed 2.4.7 (GTK+ 2.12.1; i386-portbld-freebsd7.0)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Cc: PJ <af.gourmet@videotron.ca>, Polytropon <freebsd@edvax.de>,
	"freebsd-questions@freebsd.org" <freebsd-questions@freebsd.org>,
	Bob Hall <rjhjr0@gmail.com>
Subject: Re: I hate to bitch but bitch I must
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Polytropon <freebsd@edvax.de>
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 17 Oct 2009 03:18:51 -0000

On Fri, 16 Oct 2009 20:59:18 -0600 (MDT), Warren Block <wblock@wonkity.com> wrote:
> I understand it, but see ambiguity in the word "should".  Easy enough to 
> rewrite:
> 
> BUGS
> This utility does not work on active file systems.
> 
> 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.


-- 
Polytropon
Magdeburg, Germany
Happy FreeBSD user since 4.0
Andra moi ennepe, Mousa, ...