* Add example to man page about recursive modification of directories.

  Closes: #390099

2 files changed, 21 insertions, 5 deletions

diff --git a/debian/changelog b/debian/changelog
index ef136b2..f622821 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -13,6 +13,8 @@ moreutils (0.28) UNRELEASED; urgency=low
   * vidir: Add support for unlinking directories. To recursivly delete
     a directory and its contents, pipe find to vidir, and delete the directory
     and its contents in the editor. Closes: #412176
+  * Add example to man page about recursive modification of directories.
+    Closes: #390099
 
  -- Joey Hess <joeyh@debian.org>  Sat, 02 Feb 2008 17:02:35 -0500
 
diff --git a/vidir b/vidir
index bf674f4..7d382b2 100755
--- a/vidir
+++ b/vidir
@@ -33,6 +33,25 @@ Verbosely display the actions taken by the program.
 
 =back
 
+=head1 EXAMPLES
+
+=over 4
+
+=item vidir
+
+=item vidir *.jpeg
+
+Typical uses.
+
+=item find | vidir -
+
+Edit subdirectory contents too. To delete subdirectories,
+delete all their contents and the subdirectory itself in the editor.
+
+=item find -type f | vidir -
+
+Edit all files under the current directory and subdirectories.
+
 =head1 ENVIRONMENT VARIABLES
 
 =over 4
@@ -47,11 +66,6 @@ Also supported to determine what editor to use.
 
 =back
 
-=head1 BUGS
-
-Does not support deletion of directories. Does not support recursive
-editing of contents of a directory.
-
 =head1 AUTHOR
 
 Copyright 2006 by Joey Hess <joey@kitenet.net>