-## DESCRIPTION
-
-*fusefile* 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.
-
-The fragment arguments include the filename of a source file, and
-optionally start and end byte positions. All in all there five
-variations:
-
- * __filename__ include all of the file.
-
- * __filename/__ include all of the file named with "/" in the pathname. This case requires a final "/", since the last "/" separates the filename from the position details.
-
- * __filename/from__ include the file from the given start position, to end.
-
- * __filename/-to__ include the file from beginning to the given end position (not included).
-
- * __filename/from:to__ include the file from the given start position, up to the given end position (not included).
-
-## EXAMPLES
-
-.Insert file "y" into file "x" at position 1200:
-
- $ fusefile -ononempty x x/:1200 y x/1200:
-
-That mount will shadow the original file "x", and presents the
-fused file instead.
-
-.Make file y be a swap of the beginning and end of file "x", at position 2442:
-
- $ fusefile y x/2442: x/:2442
-
-.Replace a partition in an image file with a different file
-
- $ partx -oNR,START,SECTORS disk.raw
- NR START SECTORS
- 1 2048 2097152
- 2 2099200 409600
- 3 2508800 14268383
- # Replace partition 2 of 409600 sectors from 2099200 with
- # the file "insert.fat" clipped to 409600 sectors.
- $ fusefile -ononempty disk.raw \
- disk.raw/0:$(( 2099200*512 )) \
- insert.fat/0:$(( 409600*512 )) \
- disk.raw/$(( (2099200+409600)*512 )):
-
-
-## NOTES
-
-Note that **fusefile** opens the nominated source file(s) before bind
-mounting. With the fuse option __-ononempty__ 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
-file changes or reduces in size "behind" the fused file, then anything
-may happen.
-
-If the mountpoint file doesn't exist, then **fusefile** creates it and
-removes it when unmounted.
-
-Unmounting is done with "fusermount -u __fused file__" as usual.