added examples

diff --git a/overlay-diskfile.8.adoc b/overlay-diskfile.8.adoc
index 8f39cbb78776546f8a15e40ff73f825c4b17ec42..739e05be0dacfc6e18fc32363f475938310fef8d 100644 (file)
--- a/overlay-diskfile.8.adoc
+++ b/overlay-diskfile.8.adoc
@@ -4,6 +4,7 @@ overlay-diskfile(8)
 :revdate: {sys:date "+%Y-%m-%d %H:%M:%S"}
 :COLON: :
 :EQUALS: =
+:BANG: !
 
 NAME
 ----
@@ -11,8 +12,7 @@ overlay-diskfile - Support for using diskfile filesystem.
 
 SYNOPSIS
 --------
-LOWER=!*overlay-diskfile* _mount/path_ [ _diskfile_ [ _index_ ] ]
-UPPER=!*overlay-diskfile* _mount/path_ [ _diskfile_ [ _index_ ] ]
+*overlay-diskfile* _mount/path_ [ _diskfile_ [ _index_ ] ]
 
 DESCRIPTION
 -----------
@@ -60,7 +60,7 @@ LOWER=!overlay-diskfile mnt/some/path disk.img 2
 The above mounts the second partition onto +mnt+ and provides the path
 +mnt/some/path+ that as the LOWER filesystem.
 
-.Use a while diskfile as UPPER and WORK.
+.Use second partition diskfile filesystem subtrees for UPPER and WORK.
 ====
 ----
 UPPER=!overlay-diskfile mnt/some/upper/path disk.img 2
@@ -69,7 +69,8 @@ WORK= mnt/some/work/path
 ====
 
 The above mounts the second partition of disk.img and uses
-+mnt/some/upper/path+ as UPPER and +mnt/some/work/path+ as WORK.
++mnt/some/upper/path+ as UPPER and +mnt/some/work/path+ as WORK. Note
+that UPPER and WORK must always be subtrees from the same filesystem.
 
 
 SEE ALSO