Date: Sun, 18 Oct 2009 02:38:15 -0500 (CDT) From: Scott Bennett <bennett@cs.niu.edu> To: freebsd-questions@freebsd.org, Polytropon <freebsd@edvax.de> Cc: PJ <af.gourmet@videotron.ca> Subject: Re: I hate to bitch but bitch I must Message-ID: <200910180738.n9I7cFth006705@mp.cs.niu.edu>
next in thread | raw e-mail | index | archive | help
On Sat, 17 Oct 2009 05:18:48 +0200 Polytropon <freebsd@edvax.de> wrote:
>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
^
^^^
^^^^^
^^^^^^^
^^^
^^^
^^^
^^^
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 *
**********************************************************************
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200910180738.n9I7cFth006705>