Just to add to the confusion: async

[Giorgos Keramidas]

On 2006-09-04 20:22, John Andrewartha <mulgajohn at bigpond.com> wrote:
> Try this version.
> Good English 5 lines and says it all

Sorry but no.

First of all, make sure you Cc: me and use *reply* to the message,
otherwise your message/followup may be lost in the noise.  This would be
a terrible shame, if the suggestions you are making are cool :-/
> async
> 
> Caution is advised when using this command.
> All I/O to the file system should be done asynchronously to
> ensuring maintaining the full integrity of the file system.
> The use of the 'async' flag by an application may cause unrecoverable
> data loose and corrupt the disk beyond recovery.

Unfortunately, there are quite a few points which are not so good here:

    + "to ensuring" ?

    + "ensuring maintaining" ?

    + What is "full integrity" and how does it compare to "non-full"?

    + The "async" flag is not used by an application, but it a property
      of a mount point

    + "data loss" is spelled differently

    + The disk is not corrupted by 'async'.  The disk should still work
      fine after a newfs operation.  The filesystem though, is another
      story.

If you fix the above points, and *still* want to help, I would be
honestly grateful to see the fixed version, as this part of the manpage
has already caused far too many people to waste too much time, so we
should just fix it and move on.

Thank you for taking the time to write.  I really appreciate any help
and I am grateful that you did spend the time to think about a good way
to write this :)

-- Giorgos

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20060904/4a81f0a3/attachment.sig>