version 0.44 (by Andreas Neuper)

[FAPG] / fapg.1

diff --git a/fapg.1 b/fapg.1
index a9af76f..6b575e7 100644 (file)
--- a/fapg.1
+++ b/fapg.1
@@ -1,7 +1,7 @@
 .\" 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
@@ -18,7 +18,7 @@ fapg \- Fast Audio Playlist Generator
 .SH DESCRIPTION
 .B fapg
 is a tool to generate list of audio files (Wav, MP2, MP3, Ogg, etc) in various 
-formats (M3U, PLS, HTML, etc).  It is very useful if you have a large amount 
+formats (M3U, PLS, XSPF, HTML, RSS, etc).  It is very useful if you have a large amount 
 of audio files and you want to quickly and frequently build a playlist.
 .P
 It is coded in C to be as fast as possible, and does not use any specific 
@@ -29,10 +29,10 @@ formats.
 
 .SH OPTIONS
 .IP -b|--backslash
-Replace the '/' with '\' in Unix path. 
+Replace the '/' with '\\' in Unix path. 
 .IP -d|--debug
 Display useful messages if the program fails ;) 
-.IP -f|--format=m3u|pls|html
+.IP -f|--format=m3u|pls|xspf|html|rss|pla|txx
 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). 
+.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:
@@ -62,7 +66,7 @@ on the server containing the files is
 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
@@ -70,6 +74,18 @@ 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
 
+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.
+
 
 .SH AUTHOR
 Antoine Jacquet <royale@zerezo.com>, http://royale.zerezo.com/fapg/.