version 0.21

* manpage was added (thank you Thomas Kappler)

diff --git a/CHANGELOG b/CHANGELOG
new file mode 100644 (file)
index 0000000..0a4b8e5
--- /dev/null
+++ b/CHANGELOG
@@ -0,0 +1,15 @@
+Change log file for fapg
+
+version 0.21   (2004-05-01)
+       * manpage was added (thank you Thomas Kappler) 
+
+version 0.2    (2004-02-14)
+       * more compatible with ID3 headers (some bug fixes)
+       * faster to parse MP3 files (nicer buffering)
+       * end of line are in DOS format when using the --windows flag (thank you Lukasz Wiechec)
+
+version 0.1    (2003-10-05)
+       * initial release
+
+version 0.0    (2003-10-01)
+       * beta pre-release
\ No newline at end of file

diff --git a/Makefile b/Makefile
index 7dbdd60..2949454 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -1,6 +1,7 @@
 PRE = /usr/local
 BIN = $(PRE)/bin
-DOC = $(PRE)/doc/fapg
+DOC = $(PRE)/share/doc/fapg
+MAN = $(PRE)/share/man/man1
 
 fapg:fapg.c
        gcc -o fapg fapg.c
@@ -9,10 +10,12 @@ clean:
        rm -f fapg
 
 install:fapg
-       mkdir -p $(BIN) $(DOC)
+       mkdir -p $(BIN) $(DOC) $(MAN)
        cp -f fapg $(BIN)
        cp -f COPYING README $(DOC)
+       cp -f fapg.1 $(MAN)
 
 uninstall:
        rm -f $(BIN)/fapg
        rm -rf $(DOC)
+       rm -f $(MAN)/fapg.1

diff --git a/README b/README
index 29bec50..64966e0 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-FAPG 0.2 (Fast Audio Playlist Generator)
+FAPG 0.21 (Fast Audio Playlist Generator)
 site: http://royale.zerezo.com/fapg/
 mail: royale@zerezo.com
 

diff --git a/fapg.1 b/fapg.1
new file mode 100644 (file)
index 0000000..096ddcf
--- /dev/null
+++ b/fapg.1
@@ -0,0 +1,69 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH FAPG 1 "APRIL 2004" Linux "User Manuals"
+
+.SH NAME
+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] 
+.I /path/to/mp3/dir1 
+.B [
+.I /path/to/mp3/dir2 
+.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 
+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 
+audio library (like ID3Lib).  This allow you to deploy it faster and easier, 
+and to have better performances since the less informations are loaded.
+On the other hand, this tool is not (yet) compatible with all the known 
+formats.
+
+.SH OPTIONS
+.IP -b|--backslash
+Replace the '/' with '\' in Unix path. 
+.IP -d|--debug
+Display useful messages if the program fails ;) 
+.IP -f|--format=m3u|pls|html
+Choose which format of playlist you want to generate (default is m3u). 
+.IP -o|--output=/path/to/file.m3u
+Choose the name of the playlist file to generate (default behavior is 
+to display on standard output). 
+.IP -p|--prefix=/the/prefix
+Replace the Unix path with another string (useful to give a Samba path 
+for example). 
+.IP -r|--recursive
+Recursively read the subdirectories. 
+.IP -w|--windows
+Replace all Unix characters with Windows characters. 
+
+.SH EXAMPLES
+Generate a PLS playlist for an album:
+.B fapg --format=pls --output=~/path/to/album/list.pls ~/path/to/album
+ 
+You have a file server using Samba which shares a large amount of 
+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
+:
+.B fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\server\mp3\' --recursive --windows /samba/mp3
+ 
+An HTML playlist for an album:
+.B fapg --output=fapg.html ~/path/to/album
+
+
+.SH AUTHOR
+Antoine Jacquet <royale@zerezo.com>, http://royale.zerezo.com/fapg/. 
+Manpage by Thomas Kappler <thomas.kappler@stud.uni-karlsruhe.de>.

diff --git a/fapg.c b/fapg.c
index 9e6063a..adf89ee 100644 (file)
--- a/fapg.c
+++ b/fapg.c
@@ -1,6 +1,28 @@
 /*
- * FAPG 0.2 released under GPL
+ * FAPG version 0.21
+ *
+ * FAPG means Fast Audio Playlist Generator.
+ * It is a tool to generate list of audio files (Wav, MP3, Ogg, etc)
+ * in various formats (M3U, PLS, HTML, etc).
+ * It is very usefull if you have a large amount of audio files
+ * and you want to quickly and frequently build a playlist.
+ *
+ * Copyright (C) 2003-2004  Antoine Jacquet <royale@zerezo.com>
  * http://royale.zerezo.com/fapg/
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
 #include <stdio.h>
@@ -372,7 +394,7 @@ int main(int argc,char **argv)
       printf("[playlist]%s,eol");
       break;
     case 2:
-      printf("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">%s%s<html>%s%s<head>%s<title>Playlist generated by FAPG 0.2</title>%s<meta http-equiv=\"Content-Type\" content=\"text/html; charset=iso-8859-1\" />%s<style type=\"text/css\">%s<!--%s%sbody,td,tr {%s font-family: Verdana, Arial, Helvetica, sans-serif;%s  font-size: 12px;%s  color: #000000;%s}%s%sbody {%s  background: #ffffff;%s}%s%sth {%s  text-align: center;%s  background: #ffcccc;%s  padding-left: 15px;%s  padding-right: 15px;%s  border: 1px #dd8888 solid;%s}%s%std {%s  text-align: center;%s  background: #eeeeee;%s  padding-left: 15px;%s  padding-right: 15px;%s  border: 1px #cccccc solid;%s}%s%sh1 {%s  font-size: 25px;%s}%s%sp {%s  font-size: 10px;%s}%s%sa {%s  color: #993333;%s  text-decoration: none;%s}%s%sa:hover {%s text-decoration: underline;%s}%s%s-->%s</style>%s</head>%s%s<body>%s%s<h1>Playlist</h1>%s%s<table>%s<tr><th>Entry</th><th>Artist</th><th>Title</th><th>Length</th></tr>%s",eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol);
+      printf("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">%s%s<html>%s%s<head>%s<title>Playlist generated by FAPG 0.21</title>%s<meta http-equiv=\"Content-Type\" content=\"text/html; charset=iso-8859-1\" />%s<style type=\"text/css\">%s<!--%s%sbody,td,tr {%s font-family: Verdana, Arial, Helvetica, sans-serif;%s  font-size: 12px;%s  color: #000000;%s}%s%sbody {%s  background: #ffffff;%s}%s%sth {%s  text-align: center;%s  background: #ffcccc;%s  padding-left: 15px;%s  padding-right: 15px;%s  border: 1px #dd8888 solid;%s}%s%std {%s  text-align: center;%s  background: #eeeeee;%s  padding-left: 15px;%s  padding-right: 15px;%s  border: 1px #cccccc solid;%s}%s%sh1 {%s  font-size: 25px;%s}%s%sp {%s  font-size: 10px;%s}%s%sa {%s  color: #993333;%s  text-decoration: none;%s}%s%sa:hover {%s text-decoration: underline;%s}%s%s-->%s</style>%s</head>%s%s<body>%s%s<h1>Playlist</h1>%s%s<table>%s<tr><th>Entry</th><th>Artist</th><th>Title</th><th>Length</th></tr>%s",eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol,eol);
       break;
   }
   for (;optind<argc;optind++)
@@ -386,7 +408,7 @@ int main(int argc,char **argv)
       printf("NumberOfEntries=%d%sVersion=2%s",counter,eol,eol);
       break;
     case 2:
-      printf("</table>%s%s<p>Playlist generated by <a href=\"http://royale.zerezo.com/fapg/\">FAPG 0.2</a></p>%s%s</body>%s%s</html>",eol,eol,eol,eol,eol,eol);
+      printf("</table>%s%s<p>Playlist generated by <a href=\"http://royale.zerezo.com/fapg/\">FAPG 0.21</a></p>%s%s</body>%s%s</html>",eol,eol,eol,eol,eol,eol);
       break;
   }
   exit(0);