[Pmplib-commits] SF.net SVN: pmplib: [148] trunk/frontend/easypmp/cui/easypmp.1

[<suc...@us...>]

Revision: 148
Author:   sucknblow
Date:     2006-07-29 10:47:45 -0700 (Sat, 29 Jul 2006)
ViewCVS:  http://svn.sourceforge.net/pmplib/?rev=148&view=rev

Log Message:
-----------
Document the -t/--strip-words option.

Modified Paths:
--------------
    trunk/frontend/easypmp/cui/easypmp.1
Modified: trunk/frontend/easypmp/cui/easypmp.1
===================================================================
--- trunk/frontend/easypmp/cui/easypmp.1	2006-07-29 16:17:38 UTC (rev 147)
+++ trunk/frontend/easypmp/cui/easypmp.1	2006-07-29 17:47:45 UTC (rev 148)
@@ -16,8 +16,10 @@
 easypmp \- create music databases used by portable media players
 .SH SYNOPSIS
 .B easypmp
-.RB [ -c | -u "] [" -p "] [" -m "] [" -R " [" -L 
-.IR level "] ]"
+.RB [ -c | -u "] [" -p "] [" -m "] [" -t
+.IR csv-word-list ]
+.RB [ -R " [" -L 
+.IR level "]]"
 .RB [ -d
 .IR device-id ]
 .RI [ mount-point ]
@@ -164,6 +166,29 @@
 identifier because it is normally detected automatically, based on the
 names of system files and directories on the device.
 .TP
+.B \-t \fIcsv-word-list\fP, \-\-strip-words=\fIcsv-word-list\fP
+Specify a list of words to remove from the start of artist names when
+adding new tracks to the database.  The list of words should be
+comma-separated: that is, a comma (,) should be used to between each
+word.
+
+For example, \fBeasypmp\ -ct\ the\fP will strip the word 'The' 
+from the start of artist names.  Hence, 'The\ Proclaimers'
+and 'The\ Cat\ Empire' will appear in the music database
+as 'Proclaimers' and 'Cat\ Empire' respectively.
+
+The list is not limited to individual words.  Phrases that include
+spaces may also be specified from the command line, by including the
+whole list in quotes, separating each word or phrase by a comma.  For
+example: \fBeasypmp -ct 'the,pipes and drums of'\fP.
+
+When used with the \fB\-u\fP/\fB\-\-update\fP option, only new tracks
+that are not already in the database are affected by this option.  To
+use this option with all tracks, including those that already exist in
+the database, it is necessary to re-build the database with
+\fB\-c\fP/\fB\-\-create\fP.  This option does not modify music files,
+it only has an effect on the music database.
+.TP
 .B \-h, \-\-help
 Show summary of options.
 .TP


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.