X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=guestfish-actions.pod;h=ee8e82477bc4bb2385a23b4ea0ea03eb37c686c3;hp=3945fb10186348b8767f4fffbcaf30fd8c6838ab;hb=1fc41b39dac877ccec1284da8bb14baa4df368b8;hpb=d1df2f342489bbbba086cae2bb95971c8e404cad

diff --git a/guestfish-actions.pod b/guestfish-actions.pod
index 3945fb1..ee8e824 100644
--- a/guestfish-actions.pod
+++ b/guestfish-actions.pod
@@ -514,6 +514,35 @@ The exact command which runs is C<file -bsL path>.  Note in
 particular that the filename is not prepended to the output
 (the C<-b> option).
 
+=head2 find
+
+ find directory
+
+This command lists out all files and directories, recursively,
+starting at C<directory>.  It is essentially equivalent to
+running the shell command C<find directory -print> but some
+post-processing happens on the output, described below.
+
+This returns a list of strings I<without any prefix>.  Thus
+if the directory structure was:
+
+ /tmp/a
+ /tmp/b
+ /tmp/c/d
+
+then the returned list from C<find> C</tmp> would be
+4 elements:
+
+ a
+ b
+ c
+ c/d
+
+If C<directory> is not a directory, then this command returns
+an error.
+
+The returned list is sorted.
+
 =head2 fsck
 
  fsck fstype device