revise argument processing

[rrq/fusefile.git] / fusefile.8

diff --git a/fusefile.8 b/fusefile.8
index 5dba7e47ea60b6476cff4d7f10761f0d3fbb130e..e2577c195a4073653d7b64a8eb1481177f7a1ad9 100644 (file)
--- a/fusefile.8
+++ b/fusefile.8
@@ -1,17 +1,19 @@
 .mso www.tmac
 .TH fusefile 8
 .SH NAME
 .mso www.tmac
 .TH fusefile 8
 .SH NAME

-fusefile \- FUSE file mount for combining file fragments read-only
+fusefile \- FUSE file mount for combining file fragments

 
 .SH SYNOPSIS
 .B fusefile \fR[fuse options\fR] \fBmountpoint\fR \fIfilename/from-to\fR ...
 
 .SH DESCRIPTION
 
 
 .SH SYNOPSIS
 .B fusefile \fR[fuse options\fR] \fBmountpoint\fR \fIfilename/from-to\fR ...
 
 .SH DESCRIPTION
 

-\fBfusefile\fR is FUSE file mount that presents a series of fragments of
-other files as a contiguous concatenation. It bind mounts a driver on
-top of the file mountpoint to present the nominated file fragments as
-a single, contiguous file.
+\fBfusefile\fR is FUSE file mount that presents a series of fragments
+of other files as a contiguous concatenation. It bind mounts a driver
+on top of the file mountpoint to present the nominated file fragments
+as a single, contiguous file. It accepts over-writing on the fused
+file which gets distributed accordingly to the fragments, but cannot
+change size.

 
 The fragment arguments include the filename of a source file, and
 optionally start and end byte positions. All in all there five
 
 The fragment arguments include the filename of a source file, and
 optionally start and end byte positions. All in all there five


@@ -52,11 +54,12 @@ Make file y be a swap of the beginning and end of file "x", at position 2442:
 
 .SH NOTES
 
 
 .SH NOTES
 

-Note that \fBfusefile\fR opens the nominated source file(s) before bind
-mounting. With the fuse option \fI-ononempty\fR it will bind over an
-non-empty file, which may be useful. The source file descriptors
+Note that \fBfusefile\fR opens the nominated source file(s) before
+bind mounting. With the fuse option \fI-ononempty\fR it will bind over
+an non-empty file, which may be useful. The source file descriptors

 remain open, but the source fragments are not recomputed. If a source
 remain open, but the source fragments are not recomputed. If a source

-file changes or reduces in size, anything may happen.
+file changes the fused file will present the new content. If a source
+is reduced in size, access will be inconsistent.

 
 If the mountpoint file doesn't exist, then \fBfusefile\fR creates it,
 and removes it when unmounted.
 
 If the mountpoint file doesn't exist, then \fBfusefile\fR creates it,
 and removes it when unmounted.