From 4952ec9f38d39c8947375bd2600fac646ccd1526 Mon Sep 17 00:00:00 2001
From: Guilhem Moulin <guilhem.moulin@ens-lyon.org>
Date: Sat, 18 Feb 2012 16:58:29 +0100
Subject: doc

---
 videoadd.pl | 47 ++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 44 insertions(+), 3 deletions(-)

diff --git a/videoadd.pl b/videoadd.pl
index 36ebf85..1914ddd 100755
--- a/videoadd.pl
+++ b/videoadd.pl
@@ -7,7 +7,7 @@
 # See http://sam.zoy.org/wtfpl/COPYING for more details.
 
 
-$VERSION = "0.1, 17 February 2012";
+$VERSION = "0.2, 18 February 2012";
 
 use Getopt::Long qw/:config noauto_abbrev nogetopt_compat no_ignore_case
                             permute bundling auto_version auto_help/;
@@ -55,8 +55,9 @@ videoadd.pl - add movies to your collection
 
 =head1 SYNOPSIS
 
-B<videoadd.pl> [B<-s>] [B<--ignore-db>] [B<--dont-sort>] [B<-i> I<crit>]
-[B<-o> I<key=value>...] [B<-q>] I<filename>
+B<videoadd.pl> [B<-s>] [B<-u>] [B<--ignore-db>] [B<--dont-sort>] [B<-i> I<crit>]
+[B<-o> I<key=value>...] [B<--only=>I<field,field,>...] [B<--exclude=>I<field,field,>...]
+[B<-q>] (I<filename>|I<title>|I<id>|I<IMDBID>)
 
 =head1 DISCLAIMER
 
@@ -92,6 +93,10 @@ The database is then updated with the new movie (unless B<--ignore-db>
 is set), which in turn is put in the right place of the above hierarchy
 (unless B<--dont-sort> is set).
 
+The argment is matched against the file names, titles, IDs and IMDBIDs
+of your database. If found, then the database is merely updated (and the
+hierachy is unchanged) with the new data.
+
 =head1 OPTIONS
 
 =over 8
@@ -100,6 +105,10 @@ is set), which in turn is put in the right place of the above hierarchy
 
 Mark the movie as seen for the I<userid> of the configuration file.
 
+=item B<-u>, B<--unseen>
+
+Mark the movie as unseen for the I<userid> of the configuration file.
+
 =item B<--ignore-db>
 
 Do not connect to the database, hence do not update it with the new
@@ -123,6 +132,38 @@ Override data with the I<value> provided.
 Valid I<key>s are I<title>, I<language >, I<imdbid>, I<year>, I<imgurl>,
 I<director>, I<genres>, I<country>, I<plot>, I<rating>, I<istv>.
 
+=item B<--only=>I<field,field,>...
+
+Update only the given fields of the database. Known fields are
+I<title>, I<subtitle>, I<language>, I<imdbid>, I<year>, I<imgurl>,
+I<director>, I<actors>, I<country>, I<plot>, I<genres>, I<rating>,
+I<filename>, I<filesize>, I<filedate>, I<video_codec>, I<audio_codec>,
+I<video_width>, I<video_height>, I<runtime>, I<custom1>, I<custom2>,
+I<custom3>, I<custom4>.
+
+Two meta-fields are also available:
+
+=over 4
+
+=item *
+
+I<imdb>, which stands for
+I<title>, I<subtitle>, I<language>, I<imdbid>, I<year>, I<imgurl>,
+I<director>, I<actors>, I<country>, I<plot>, I<genres>, I<rating>, and
+
+=item *
+
+I<file>, which stands for
+I<filename>, I<filesize>, I<filedate>, I<video_codec>, I<audio_codec>,
+I<video_width>, I<video_height>, I<runtime>, I<language>.
+
+=back
+
+=item B<--exclude=>I<field,field,>...
+
+Do not update the given fields of the database. See B<--only> above for
+details.
+
 =item B<-q>, B<--quiet>
 
 Do not print the final URL for the freshly added movie.
-- 
cgit v1.2.3