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

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Revision: 332
          http://svn.sourceforge.net/pmplib/?rev=332&view=rev
Author:   nyaochi
Date:     2007-02-10 20:19:38 -0800 (Sat, 10 Feb 2007)

Log Message:
-----------
Updated man page.

Modified Paths:
--------------
    trunk/pmplib/frontend/easypmp/cui/easypmp.1

Modified: trunk/pmplib/frontend/easypmp/cui/easypmp.1
===================================================================

--- trunk/pmplib/frontend/easypmp/cui/easypmp.1	2007-02-10 18:39:35 UTC (rev 331)
+++ trunk/pmplib/frontend/easypmp/cui/easypmp.1	2007-02-11 04:19:38 UTC (rev 332)
@@ -1,5 +1,5 @@
 .\"                                      Hey, EMACS: -*- nroff -*-
-.TH EASYPMP 1 "July  29, 2006"
+.TH EASYPMP 1 "Feb  11, 2007"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -11,30 +11,38 @@
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
 .SH NAME
-easypmp \- create music databases used by portable media players
+easypmp \- create music databases and used by portable media players
 .SH SYNOPSIS
 .B easypmp
-.RB [ -c | -u "] [" -p "] [" -m "] [" -t
+.RB [ -c | -u "] [" -t
 .IR csv-word-list ]
+.RB [ -p " [" -P
+.IR source-dir "] [" -r "] [" -f "] [" -i "]]" 
 .RB [ -R " [" -L 
 .IR level "]]"
 .RB [ -d
 .IR device-id ]
+.RB [ -s
+.IR name:value ]
+.RB [ -e
+.IR system-encoding ]
+.RB [ -w
+.IR tag-encoding]
 .RI [ mount-point ]
 .br
-.BR "easypmp " [ -h | -v | -l ]
+.BR "easypmp " [ -h | -x | -v | -l ]
 
 .SH DESCRIPTION
 \fBeasypmp\fP is a command line utility used to create and maintain the
-music database on a variety of portable media players.
+music database and playlists on a variety of portable media players.
 
 Many portable music players allow the user to browse tracks by artist,
 album, genre, predefined playlists etc.  In order to do this
 efficiently, they require a database of track information.  Without
 this database, the player may require the user to browse tracks using
-only the directory structure.  \fBeasypmp\fP exists to create that
-database, based on the tracks and playlists that are stored on the
-player.
+only the directory structure.  \fBeasypmp\fP exists to create music
+database and playlists, based on the tracks and playlists that are
+stored on the player.
 
 Normally, \fBeasypmp\fP is able to detect the type of any supported
 media player automatically.  It does so by comparing the files and
@@ -66,9 +74,13 @@
    * iRiver H10 MTP (with emergency connect mode)
    * iRiver H10Jr. UMS
    * iRiver U10 UMS
+   * iRiver E10 UMS
    * MEDION MDJuke220 and MDJuke440
    * Samsung YH-820, YH-920 and YH-925
+   * MSI MEGA PLAYER 540
+   * Philips HDD6320
 
+
 Note that some of the iRiver devices listed above may not support UMS
 as shipped.  For example, in Europe and the United States, the iRiver
 U10 ships with support for a proprietary file transfer protocol called
@@ -112,30 +124,52 @@
 to read the meta-data in music files that were not on the device the
 last time the database was updated.  Thus this option is a faster way
 creating the music database when only a few tracks on the device have
-been changed since the database was last created or updated.  However,
-if the meta-data in existing files has changed, this may not be
-reflected in the database when using this option.
+been changed since the database was last created or updated.
+If the meta-data in existing files has changed, \fBeasypmp\fP tries
+to reflect the changes in the database even when using this option.
 .TP
 .B \-p, \-\-playlist
 Many programs for playing music allow playlists to be created and
 saved on disk, ready to be played later.  Such playlists frequently
-have a \fB.m3u\fP extension.  However, the playlists saved by most
-programs cannot be used directly on portable media players.  Instead,
-it is necessary to convert (or `compile') each playlist into a format
-that the media player can read.
-
+have a \fB.m3u\fP or \fB.pls\fP extension.
+However, the playlists saved by most programs cannot be used directly
+on portable media players.
+Instead, it is necessary to convert (or `compile') each playlist into
+a format that the media player can read.
 When the \fB\-p\fP/\fB\-\-playlist\fP option is specified,
-\fBeasypmp\fP will search the playlist directory on the device for
-playlists that can be converted into a form that the media player can
-read (see the \fBDESCRIPTION\fP section above for information on how
-to determine the playlist directory for a particular media player).
+\fBeasypmp\fP will search the playlist directory on the device or
+the directory specified by \fB\-P\fP/\fB\-\-playlist\-source\fP
+option for playlists that can be converted into a form that the media
+player can read (see the \fBDESCRIPTION\fP section above for
+information on how to determine the playlist directory for a
+particular media player).
 .TP
-.B \-m, \-\-music
-The \fB\-m\fP/\fB\-\-music\fP option is similar to the
-\fB\-p\fP/\fB\-\-playlist\fP option.  However, instead of searching
-the playlist directory on the media player for playlists, it searches
-in the music directory on the player instead.
+.B \-P \fIdirectory\fP, \-\-playlist\-source=\fIdirectory\fP
+Specifies the location in which the source playlists are stored.
+Changing the location to a directory on the computer means on-the-fly
+playlist conversion without transferring source playlist files on the
+device.
 .TP
+.B \-r, \-\-reconvert
+Overwrite the existing playlists to force conversion.
+.TP
+.B \-f, \-\-find\-missing
+Find music files described in a playlist with broken references.
+Setting this
+option tries to correct the location of a music file referred to by
+a playlist by searching for the music file in the music directories that
+have the same file name.
+Finding two or more music files that have the target file name,
+\fBeasypmp\fP selects a music file with a path name that is the most
+similar to the original one.
+.TP
+.B \-i, \-\-skip\-missing
+Skip missing music files in a playlist.
+Setting this option indicates \fBeasypmp\fP to continue the playlist
+conversion only with music files found in the player.
+The default behavior for a missing music file is to cancel the
+conversion for the playlist.
+.TP
 .B \-R, \-\-repr
 Output a textual representation of the music database on standard
 output.  This option is seldom used: it may be useful for debugging
@@ -149,13 +183,25 @@
 depends on the type of media player in use.  Currently, the only
 values of \fIlevel\fP that may produce different results are 0 and 1.
 .TP
-.B \-l, \-\-list-device
+.B \-l, \-\-list\-device
 Shows the list of supported devices.  This includes the names of the
 directories where music and playlists are expected to be found and the
 playlist extension used by each device.  The list also includes the
 `device identifier' for each device.  For more information on the
 device identifier, see the \fB-d\fR option.
 .TP
+.B \-s name:value, \-\-set=name:value
+Overwrites the value of a variable set by the driver.
+The following is the list of variables.
+.RS
+.TP
+.B pmp_music
+Relative path to music directory from the mount point.
+.TP
+.B pmp_playlist
+Relative path to playlist directory from the mount point.
+.RE
+.TP
 .B \-d \fIdevice\-id\fP, \-\-device=\fIdevice\-id\fP
 Specifies a device identifier for the player.  The device identifier
 is used to determine where \fBeasypmp\fP looks for music files and
@@ -187,9 +233,25 @@
 \fB\-c\fP/\fB\-\-create\fP.  This option does not modify music files,
 it only has an effect on the music database.
 .TP
+.B \-e, \-\-encoding=system\-encoding
+Specify a character encoding used by the operating system.
+\fBeasypmp\fP converts path/file names from the specified encoding
+into UCS\-2 by using iconv.
+The default value is determined by the automatic detection of the
+system character-encoding.
+.TP
+.B \-w, \-\-tagencoding=tag\-encoding
+Specify a character encoding for parsing non\-unicode tags.
+\fBeasypmp\fP converts non\-unicode tags embedded in ID3v1, ID3v2, and
+Riff WAVE into UCS\-2 encoding by using iconv.
+The default value is "ISO\-8859\-1".
+.TP
 .B \-h, \-\-help
 Show summary of options.
 .TP
+.B \-x, \-\-help\-variable
+Show the list of variables.
+.TP
 .B \-v, \-\-version
 Show version of program.
 .SH EXAMPLES
@@ -223,9 +285,10 @@
 
 .br
 .SH AUTHORS
-\fBeasypmp\fP was written by Nyaochi <nyaochi@ny...@sa...>,
+\fBeasypmp\fP was written by Naoaki Okazaki
+<nyaochi at users.sourceforge.net>,
 who also wrote an initial POSIX port using the Cygwin environment.
 
 This manual page was written by Martin Ellis
-<mar...@kd...>, who also contributed bug fixes for the
-POSIX port.
+<mar...@kd...>,
+who also contributed bug fixes for the POSIX port.


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




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

pmplib-commits