Menu
▾
▴
[Pmplib-commits] SF.net SVN: pmplib: [379] trunk/webpage/easypmp.html
|
From: <suc...@us...> - 2007-02-18 19:07:30
|
Revision: 379
http://svn.sourceforge.net/pmplib/?rev=379&view=rev
Author: sucknblow
Date: 2007-02-18 11:07:28 -0800 (Sun, 18 Feb 2007)
Log Message:
-----------
Update html version of manual page
Modified Paths:
--------------
trunk/webpage/easypmp.html
Modified: trunk/webpage/easypmp.html
===================================================================
--- trunk/webpage/easypmp.html 2007-02-18 18:42:22 UTC (rev 378)
+++ trunk/webpage/easypmp.html 2007-02-18 19:07:28 UTC (rev 379)
@@ -10,26 +10,29 @@
</dl>
<a name="lbAB" id="lbAB"> </a>
<h2>NAME</h2>
-easypmp - create music databases used by portable media
-players<br />
+easypmp - create music databases and playlists used by portable
+media players<br />
<a name="lbAC" id="lbAC"> </a>
<h2>SYNOPSIS</h2>
-<b>easypmp</b> [<b>-c</b>|<b>-u</b>] [<b>-p</b>] [<b>-m</b>]
-[<b>-t</b> <i>csv-word-list</i>] [<b>-R</b> [<b>-L</b>
-<i>level</i>]] [<b>-d</b> <i>device-id</i>]
-[<i>mount-point</i>]<br />
-<b>easypmp</b> [<b>-h</b>|<b>-v</b>|<b>-l</b>]
+<b>easypmp</b> [<b>-c</b>|<b>-u</b>] [<b>-t</b>
+<i>csv-word-list</i>] [<b>-p</b> [<b>-P</b> <i>source-dir</i>]
+[<i>-r</i>] [<i>-f</i>] [<i>-i</i>]] [<b>-R</b> [<b>-L</b>
+<i>level</i>]] [<b>-d</b> <i>device-id</i>] [<b>-s</b>
+<i>name:value</i>] [<b>-e</b> <i>system-encoding</i>] [<b>-w</b>
+<i>tag-encoding]</i> [<i>mount-point</i>]<br />
+<b>easypmp</b> [<b>-h</b>|<b>-x</b>|<b>-v</b>|<b>-l</b>]
<p><a name="lbAD" id="lbAD"> </a></p>
<h2>DESCRIPTION</h2>
<b>easypmp</b> is a command line utility used to create and
-maintain the music database on a variety of portable media players.
+maintain the music database and playlists on a variety of portable
+media players.
<p>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. <b>easypmp</b> exists to create
-that database, based on the tracks and playlists that are stored on
-the player.</p>
+music database and playlists, based on the tracks and playlists
+that are stored on the player.</p>
<p>Normally, <b>easypmp</b> is able to detect the type of any
supported media player automatically. It does so by comparing the
files and directories found at the specified mount point with the
@@ -60,8 +63,11 @@
iRiver H10 MTP (with emergency connect mode)</li>
<li>iRiver H10Jr. UMS</li>
<li>iRiver U10 UMS</li>
+<li>iRiver E10 UMS</li>
<li>MEDION MDJuke220 and MDJuke440</li>
<li>Samsung YH-820, YH-920 and YH-925</li>
+<li>MSI MEGA PLAYER 540</li>
+<li>Philips HDD6320</li>
</ul>
<p>Note that some of the iRiver devices listed above may not
support UMS as shipped. For example, in Europe and the United
@@ -107,29 +113,46 @@
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.</p>
+updated. If the meta-data in existing files has changed,
+<b>easypmp</b> tries to reflect the changes in the database even
+when using this option.</p>
</dd>
<dt class="c1">-p, --playlist</dt>
<dd>Many programs for playing music allow playlists to be created
and saved on disk, ready to be played later. Such playlists
-frequently have a <b>.m3u</b> 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.
-<p>When the <b>-p</b>/<b>--playlist</b> option is specified,
-<b>easypmp</b> 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 <b>DESCRIPTION</b> section above for information
-on how to determine the playlist directory for a particular media
-player).</p>
-</dd>
-<dt class="c1">-m, --music</dt>
-<dd>The <b>-m</b>/<b>--music</b> option is similar to the
-<b>-p</b>/<b>--playlist</b> option. However, instead of searching
-the playlist directory on the media player for playlists, it
-searches in the music directory on the player instead.</dd>
+frequently have a <b>.m3u</b> or <b>.pls</b> 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 <b>-p</b>/<b>--playlist</b> option is specified,
+<b>easypmp</b> will search the playlist directory on the device or
+the directory specified by <b>-P</b>/<b>--playlist-source</b>
+option for playlists that can be converted into a form that the
+media player can read (see the <b>DESCRIPTION</b> section above for
+information on how to determine the playlist directory for a
+particular media player).</dd>
+<dt><b>-P</b> <i>directory</i>,
+--playlist-source=<i>directory</i></dt>
+<dd>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.</dd>
+<dt class="c1">-r, --reconvert</dt>
+<dd>Overwrite the existing playlists to force conversion.</dd>
+<dt class="c1">-f, --find-missing</dt>
+<dd>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,
+<b>easypmp</b> selects a music file with a path name that is the
+most similar to the original one.</dd>
+<dt class="c1">-i, --skip-missing</dt>
+<dd>Skip missing music files in a playlist. Setting this option
+indicates <b>easypmp</b> 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.</dd>
<dt class="c1">-R, --repr</dt>
<dd>Output a textual representation of the music database on
standard output. This option is seldom used: it may be useful for
@@ -149,6 +172,21 @@
includes the `device identifier' for each device. For more
information on the device identifier, see the <b>-d</b>
option.</dd>
+<dt><b>-s</b> <i>name</i>:<i>value</i>,
+--set=<i>name</i>:<i>value</i></dt>
+<dd>Overwrites the value of a variable set by the driver. The
+following is the list of variables.
+<dl compact="compact">
+<dd>
+<dl compact="compact">
+<dt class="c1">pmp_music</dt>
+<dd>Relative path to music directory from the mount point.</dd>
+<dt class="c1">pmp_playlist</dt>
+<dd>Relative path to playlist directory from the mount point.</dd>
+</dl>
+</dd>
+</dl>
+</dd>
<dt><b>-d</b> <i>device-id</i>, --device=<i>device-id</i></dt>
<dd>Specifies a device identifier for the player. The device
identifier is used to determine where <b>easypmp</b> looks for
@@ -181,8 +219,20 @@
modify music files, it only has an effect on the music
database.</p>
</dd>
+<dt class="c1">-e, --encoding=system-encoding</dt>
+<dd>Specify a character encoding used by the operating system.
+<b>easypmp</b> 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.</dd>
+<dt class="c1">-w, --tagencoding=tag-encoding</dt>
+<dd>Specify a character encoding for parsing non-unicode tags.
+<b>easypmp</b> 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".</dd>
<dt class="c1">-h, --help</dt>
<dd>Show summary of options.</dd>
+<dt class="c1">-x, --help-variable</dt>
+<dd>Show the list of variables.</dd>
<dt class="c1">-v, --version</dt>
<dd>Show version of program.</dd>
</dl>
@@ -211,8 +261,9 @@
<p><br />
<a name="lbAH" id="lbAH"> </a></p>
<h2>AUTHORS</h2>
-<b>easypmp</b> was written by Nyaochi , who also wrote an initial
-POSIX port using the Cygwin environment.
+<b>easypmp</b> was written by Naoaki Okazaki <nyaochi at
+users.sourceforge.net>, who also wrote an initial POSIX port
+using the Cygwin environment.
<p>This manual page was written by Martin Ellis , who also
contributed bug fixes for the POSIX port.</p>
-Time: 18:04:26 GMT, August 12, 2006
+Time: 19:10:45 GMT, February 18, 2007
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
