version 0.37

[FAPG] / fapg.1

diff --git a/fapg.1 b/fapg.1
index 8b3588f..955eb52 100644 (file)
--- a/fapg.1
+++ b/fapg.1
@@ -1,7 +1,7 @@
 .\" Process this file with
 .\" groff -man -Tascii foo.1
 .\"
 .\" Process this file with
 .\" groff -man -Tascii foo.1
 .\"

-.TH FAPG 1 "APRIL 2004" Linux "User Manuals"
+.TH FAPG 1 "JANUARY 2007" Linux "User Manuals"

 
 .SH NAME
 fapg \- Fast Audio Playlist Generator
 
 .SH NAME
 fapg \- Fast Audio Playlist Generator


@@ -32,7 +32,7 @@ formats.
 Replace the '/' with '\' in Unix path. 
 .IP -d|--debug
 Display useful messages if the program fails ;) 
 Replace the '/' with '\' in Unix path. 
 .IP -d|--debug
 Display useful messages if the program fails ;) 

-.IP -f|--format=m3u|pls|html|rss
+.IP -f|--format=m3u|pls|html|rss|pla

 Choose which format of playlist you want to generate (default is m3u). 
 .IP -g|--genre=#:#:...
 Choose which genres (numerical values only) will be included in the generated playlist (default is all).
 Choose which format of playlist you want to generate (default is m3u). 
 .IP -g|--genre=#:#:...
 Choose which genres (numerical values only) will be included in the generated playlist (default is all).


@@ -50,6 +50,10 @@ Recursively read the subdirectories.
 Replace all Unix characters with Windows characters. 
 .IP -x|--exclude=#:#:...
 Choose which genres (numerical values only) will be excluded in the generated playlist (default is none). 
 Replace all Unix characters with Windows characters. 
 .IP -x|--exclude=#:#:...
 Choose which genres (numerical values only) will be excluded in the generated playlist (default is none). 

+.IP -c|--command=<intern|...>
+External binary or script that produces additional fields for RSS feeds (slow).
+.IP -s|--stdin
+Read filenames and/or directories from standard input instead of command line.

 
 .SH EXAMPLES
 Generate a PLS playlist for an album:
 
 .SH EXAMPLES
 Generate a PLS playlist for an album:


@@ -62,7 +66,7 @@ on the server containing the files is
 and is visible on the Windows network as 
 .I \\\\\\\\server\\\\mp3
 :
 and is visible on the Windows network as 
 .I \\\\\\\\server\\\\mp3
 :

-.B fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\\\\\\\server\\\\mp3\\\\' --recursive --windows /samba/mp3
+.B cd /samba/mp3 && fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\\\\\\\server\\\\mp3\\\\' --recursive --windows ./

  
 An HTML playlist for an album:
 .B fapg --output=fapg.html ~/path/to/album
  
 An HTML playlist for an album:
 .B fapg --output=fapg.html ~/path/to/album


@@ -70,9 +74,16 @@ An HTML playlist for an album:
 A playlist that contains all your classical tracks may receive the genres to include (or exclude) in one or multiple portions
 .B fapg --genre=32:105 --genre=106:104:103 /path/to/all/music
 
 A playlist that contains all your classical tracks may receive the genres to include (or exclude) in one or multiple portions
 .B fapg --genre=32:105 --genre=106:104:103 /path/to/all/music
 

-Generate a podcasting XML file:
-.B fapg --output=dir.xml -f rss -r --prefix=http://thisserver/basedir path/to/mp3
-Please note that in all given directories ( and in /rss ) files called podcast.jpg are referenced.
+Generate a podcasting XML file using an external program rss.sh to generate a detailed description:
+.B fapg --output=dir.xml -f rss -c /usr/local/bin/rss.sh -r --prefix=http://thisserver/basedir path/to/mp3
+
+Generate a playlist that will work on a Sansa e200 series MP3 player:
+.B fapg -f pla -o /path/to/playlist.pla /path/to/all/music
+
+if command starts with
+.I intern
+the build-in description (Author,Title,Link) is generated.
+Please note that in all given directories ( and in ...basedir/xml ) files called podcast.jpg are referenced.

 Many header fields are set to defaults using environment variables like LOGNAME or LANG.
 
 
 Many header fields are set to defaults using environment variables like LOGNAME or LANG.