man

2 files changed, 70 insertions, 28 deletions

diff --git a/videodb.rc b/videodb.rc
index dad2f22..198b60a 100644
--- a/videodb.rc
+++ b/videodb.rc
@@ -1,7 +1,7 @@
-#########################################################################
-# This is a sample configuration file for video-*. Extend it and rename #
-# it to `~/.videodb.rc'                                                 # 
-#########################################################################
+########################################################################
+# This is a sample configuration file for video*. Extend it and rename #
+# it to `~/.videodb.rc'                                                # 
+########################################################################
 
 videodir  => catdir($HOME,'video'),
 driver    => 'mysql',
diff --git a/videomv.pl b/videomv.pl
index 1d192c8..d579f9a 100755
--- a/videomv.pl
+++ b/videomv.pl
@@ -42,7 +42,7 @@ die "Error: No such directory: `" .$directors. "'.\n" unless -d $symlinks;
 
 =head1 NAME
 
-videomv.pl - Move your videos to or within your collection.
+videomv.pl - move your videos to or within your collection
 
 =head1 SYNOPSIS
 
@@ -52,7 +52,7 @@ I<path/to/oldfile> [{I<MOVIES>,I<DIRECTORS/director/>}I</>[I<newfile>]]
 =head1 DESCRIPTION
 
 Your collection is assumed to have the following structure: two
-folders, here I<DIRECTORS> and I<MOVIES> that have the same parent.
+folders, I<DIRECTORS> and I<MOVIES>, that have the same parent.
 I<DIRECTORS> contains one subdirectory for each director, and each movie
 lies (B<as a regular file>) in the subdirectory of its director.
 The folder I<MOVIES> contains symlinks - one for each movie - that target
@@ -91,15 +91,22 @@ actions will be performed:
 
 =over 4
 
+=item *
 
-=item * The old target will be renamed to I<DIRECTORS/director/newfile>,
+The old target will be renamed to I<DIRECTORS/director/newfile>,
 
-=item * the old symlink will be deleted,
+=item *
 
-=item * a new symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
+The old symlink will be deleted,
+
+=item *
+
+A new symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
 will be created, and
 
-=item * the filename in the database will be updated.
+=item *
+
+The filename in the database will be updated.
 
 =back
 
@@ -118,16 +125,24 @@ Otherwise, the following actions will be performed:
 
 =over 4
 
-=item * The old target will be moved to I<DIRECTORS/newdirector/newfile>,
+=item *
+
+The old target will be moved to I<DIRECTORS/newdirector/newfile>,
 (or to I<DIRECTORS/newdirector/oldfile> if I<newfile> was not given),
 
-=item * the old symlink will be deleted,
+=item *
+
+The old symlink will be deleted,
 
-=item * a new symlink I<MOVIES/newfile> -> I<../DIRECTORS/newdirector/newfile>
+=item *
+
+A new symlink I<MOVIES/newfile> -> I<../DIRECTORS/newdirector/newfile>
 (or -> I<../DIRECTORS/newdirector/oldfile> if I<newfile> was not given)
 will be created, and
 
-=item * the filename in the database will be updated unless I<oldfile>=I<newfile>.
+=item *
+
+The filename in the database will be updated unless I<oldfile>=I<newfile>.
 
 =back
 
@@ -141,15 +156,23 @@ actions will be performed:
 
 =over 4
 
-=item * The old target I<DIRECTORS/director/oldfile> will be renamed to
+=item *
+
+The old target I<DIRECTORS/director/oldfile> will be renamed to
 I<DIRECTORS/director/newfile>,
 
-=item * the old symlink will be deleted,
+=item *
+
+The old symlink will be deleted,
+
+=item *
 
-=item * a new symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
+A new symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
 will be created, and
 
-=item * the filename in the database will be updated.
+=item *
+
+The filename in the database will be updated.
 
 =back
 
@@ -168,15 +191,23 @@ Otherwise, the following actions will be performed:
 
 =over 4
 
-=item * The old target I<../DIRECTORS/olddirector/oldfile> will be moved to
+=item *
+
+The old target I<../DIRECTORS/olddirector/oldfile> will be moved to
 I<../DIRECTORS/newdirector/newfile>,
 
-=item * the old symlink will be deleted,
+=item *
+
+The old symlink will be deleted,
 
-=item * a new symlink I<MOVIES/newfile> -> I<../DIRECTORS/newdirector/newfile>
+=item *
+
+A new symlink I<MOVIES/newfile> -> I<../DIRECTORS/newdirector/newfile>
 will be created, and
 
-=item * the filename in the database will be updated unless I<oldfile>=I<newfile>.
+=item *
+
+The filename in the database will be updated unless I<oldfile>=I<newfile>.
 
 =back
 
@@ -191,14 +222,20 @@ In case of success, the following actions will be performed:
 
 =over 4
 
-=item * I<oldfile> will be moved to I<DIRECTORS/director/newfile>
+=item *
+
+I<oldfile> will be moved to I<DIRECTORS/director/newfile>
 (or to I<DIRECTORS/director/oldfile> if I<newfile> was not given),
 
-=item * a symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
+=item *
+
+A symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
 (or I<MOVIES/oldfile> -> I<../DIRECTORS/director/oldfile> if I<newfile>
 was not given) will be created, and
 
-=item * the filename in the database will be updated unless I<oldfile>=I<newfile>.
+=item *
+
+The filename in the database will be updated unless I<oldfile>=I<newfile>.
 
 =back
 
@@ -214,15 +251,20 @@ The following actions will be performed:
 
 =over 4
 
-=item * I<oldfile> will be moved to I<DIRECTORS/director/newfile>
+=item *
+
+I<oldfile> will be moved to I<DIRECTORS/director/newfile>
 (or to I<DIRECTORS/director/oldfile> if I<newfile> was not given),
 
-=item * a symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
+=item *
+
+A symlink I<MOVIES/newfile> -> I<../DIRECTORS/director/newfile>
 (or I<MOVIES/oldfile> -> I<../DIRECTORS/director/oldfile> if the second
 argument was not given) will be created,
 
-=item * the filename in the database will be updated unless I<oldfile>=I<newfile>.
+=item * 
 
+The filename in the database will be updated unless I<oldfile>=I<newfile>.
 
 =back