X-Git-Url: http://royale.zerezo.com/git/?p=FAPG;a=blobdiff_plain;f=fapg.1;h=c7ca1ffc83bebb15a87df600ed3c105cb4b94d65;hp=096ddcf1edcfaf3868b7363c8e22fa61797b1d36;hb=refs%2Ftags%2Fv0.35;hpb=f1ebe91895265253a92612eda89900a29e8a4a01

diff --git a/fapg.1 b/fapg.1
index 096ddcf..c7ca1ff 100644
--- a/fapg.1
+++ b/fapg.1
@@ -7,20 +7,18 @@
 fapg \- Fast Audio Playlist Generator
 
 .SH SYNOPSIS
-.B fapg [-b|--backslash] [-d|--debug] [-f|--format=m3u|pls|html] [-o|--output=
-.I /path/to/file.m3u
-.B ] [-p|--prefix=
-.I /the/prefix
-.B ] [-r|--recursive] [-w|--windows] 
+.B fapg [
+.I options
+.B ]
 .I /path/to/mp3/dir1 
 .B [
 .I /path/to/mp3/dir2 
-.B ...] 
+.B ... ]
 
 .SH DESCRIPTION
 .B fapg
-is a tool to generate list of audio files (Wav, MP3, Ogg, etc) in various 
-formats (M3U, PLS, HTML, etc).  It is very useful if you have a large amount 
+is a tool to generate list of audio files (Wav, MP2, MP3, Ogg, etc) in various 
+formats (M3U, PLS, 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 
@@ -34,8 +32,12 @@ formats.
 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|html|rss
 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).
+.IP -n|--nohardlink
+Avoid to parse twice the files because of hardlinks.
 .IP -o|--output=/path/to/file.m3u
 Choose the name of the playlist file to generate (default behavior is 
 to display on standard output). 
@@ -46,6 +48,8 @@ for example).
 Recursively read the subdirectories. 
 .IP -w|--windows
 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). 
 
 .SH EXAMPLES
 Generate a PLS playlist for an album:
@@ -56,13 +60,24 @@ audio files for Windows powered computers using Winamp. The directory
 on the server containing the files is 
 .I /samba/mp3 
 and is visible on the Windows network as 
-.I \\\\\\\server\\\mp3
+.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
 
+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
+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/.