audiolink-cvs Mailing List for AudioLink
Status: Alpha
Brought to you by:
amitshah
Menu
▾
▴
audiolink-cvs — CVS commit list
You can subscribe to this list here.
| 2003 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
(118) |
Oct
(20) |
Nov
(48) |
Dec
(30) |
|---|
|
From: <ami...@us...> - 2003-12-07 19:07:09
|
Update of /cvsroot/audiolink/audiolink/web
In directory sc8-pr-cvs1:/tmp/cvs-serv32438
Modified Files:
documents.html
Log Message:
alfilldb, alsearch documentation now point to the html docs. Also added audiolink link
Index: documents.html
===================================================================
RCS file: /cvsroot/audiolink/audiolink/web/documents.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** documents.html 12 Nov 2003 08:04:24 -0000 1.3
--- documents.html 7 Dec 2003 19:07:06 -0000 1.4
***************
*** 26,34 ****
TODO List</a></li>
! <p><li><a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/audiolink/audiolink/Documentation/alfilldb_usage.txt?rev=HEAD&content-type=text/vnd.viewcvs-markup">
Usage information for alfilldb</a> (the script that handles
addition of information in the database)</li>
! <p><li><a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/audiolink/audiolink/Documentation/alsearch_usage.txt?rev=HEAD&content-type=text/vnd.viewcvs-markup">
Usage information for alsearch</a> (the script that searches the
database for specific songs)</li>
--- 26,39 ----
TODO List</a></li>
! <p><li><a href="audiolink_doc.html">
! Usage information for audiolink</a> (the script that sets up
! the configuration file and the AudioLink databases for first
! use. Also contains general overall information about AudioLink).</li>
!
! <p><li><a href="alfilldb_doc.html">
Usage information for alfilldb</a> (the script that handles
addition of information in the database)</li>
! <p><li><a href="alsearch_doc.html">
Usage information for alsearch</a> (the script that searches the
database for specific songs)</li>
|
|
From: <ami...@us...> - 2003-12-07 18:59:22
|
Update of /cvsroot/audiolink/audiolink/web
In directory sc8-pr-cvs1:/tmp/cvs-serv30715
Modified Files:
index.html
Log Message:
release 0.05
Index: index.html
===================================================================
RCS file: /cvsroot/audiolink/audiolink/web/index.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -d -r1.18 -r1.19
*** index.html 12 Nov 2003 08:09:49 -0000 1.18
--- index.html 7 Dec 2003 18:59:19 -0000 1.19
***************
*** 166,192 ****
<td width="2%"> </td>
! <td valign="top">
<center><h3>News</h3></center><br>
<ul>
! <li>Version 0.04 <a
! href="http://sourceforge.net/forum/forum.php?forum_id=324918">
released</a>. Get it <a
! href="http://sourceforge.net/project/showfiles.php?group_id=89886&release_id=195208">here</a>.</li>
<p><li>See <a
! href="http://sourceforge.net/project/shownotes.php?release_id=195208">what's
! new</a> in v0.04</li>
!
! <p><li>The mailing lists are now working; subscribe to the <a
! href="http://lists.sourceforge.net/mailman/listinfo/audiolink-users">users'
! mailing list</a> for reporting problems or success to the AudioLink
! team. Subscribe to the <a
! href="http://lists.sourceforge.net/mailman/listinfo/audiolink-devel">devel
! mailing list</a> if you are interested in the development of AudioLink.</li>
! <p><li>The CVS is now working fine. You can browse the code and
! checkout using anonymous pserver. The instructions and links are
! available <a
! href="http://sourceforge.net/cvs/?group_id=89886">here</a>.</li>
</ul>
--- 166,182 ----
<td width="2%"> </td>
! <td valign="top" width="20%">
<center><h3>News</h3></center><br>
<ul>
! <li>Version 0.05 <a
! href="https://sourceforge.net/forum/forum.php?forum_id=335037">
released</a>. Get it <a
! href="https://sourceforge.net/project/showfiles.php?group_id=89886&release_id=201928">here</a>.</li>
<p><li>See <a
! href="https://sourceforge.net/project/shownotes.php?release_id=201928">what's
! new</a> in v0.05</li>
! <p><li>New! Debian package <a href="http://prdownloads.sourceforge.net/audiolink/audiolink_0.05-1_all.deb?download">available</a> with the release of v0.05!</li>
</ul>
|
|
From: <ami...@us...> - 2003-12-06 15:02:37
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv17490 Modified Files: VERSION Log Message: update for 0.05 Index: VERSION =================================================================== RCS file: /cvsroot/audiolink/audiolink/VERSION,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** VERSION 5 Dec 2003 17:24:52 -0000 1.4 --- VERSION 6 Dec 2003 15:02:34 -0000 1.5 *************** *** 1 **** ! AudioLink version 0.05 20031205 --- 1 ---- ! AudioLink version 0.05 20031206 |
|
From: <ami...@us...> - 2003-12-06 14:57:43
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv16566 Modified Files: Makefile Log Message: $(Q)uieten stuff that wasn't. Index: Makefile =================================================================== RCS file: /cvsroot/audiolink/audiolink/Makefile,v retrieving revision 1.23 retrieving revision 1.24 diff -C2 -d -r1.23 -r1.24 *** Makefile 5 Dec 2003 14:27:38 -0000 1.23 --- Makefile 6 Dec 2003 14:57:40 -0000 1.24 *************** *** 81,87 **** # Install it install: prepare_install man ! install code/alfilldb $(BIN) ! install code/alsearch $(BIN) ! install code/audiolink $(BIN) # Generate HTML documentation --- 81,87 ---- # Install it install: prepare_install man ! $(Q)install code/alfilldb $(BIN) ! $(Q)install code/alsearch $(BIN) ! $(Q)install code/audiolink $(BIN) # Generate HTML documentation *************** *** 99,104 **** # Commit latest and tag the CVS with the release info cvs: version ! cvs ci -m "version $(ALVER)" VERSION ! cvs tag rel_$(VERSION)$(SUBLEVEL) #------------------------------------------------------------------------------ --- 99,104 ---- # Commit latest and tag the CVS with the release info cvs: version ! $(Q)cvs ci -m "version $(ALVER)" VERSION ! $(Q)cvs tag rel_$(VERSION)$(SUBLEVEL) #------------------------------------------------------------------------------ |
|
From: <ami...@us...> - 2003-12-06 14:53:13
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv16036 Modified Files: FEATURES Log Message: added all the features supported till now Index: FEATURES =================================================================== RCS file: /cvsroot/audiolink/audiolink/FEATURES,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** FEATURES 5 Dec 2003 17:26:03 -0000 1.1 --- FEATURES 6 Dec 2003 14:53:10 -0000 1.2 *************** *** 1,4 **** Features in AudioLink: ! * Support for ogg files --- 1,18 ---- Features in AudioLink: ! * Support for cataloging music files of types Ogg Vorbis and MP3 ! ! * Stores information about music files in a MySQL database ! ! * Stores much more information than traditional ID3 tags, like the ! composer, lyricist, name of artists, band, etc. ! ! * Support for extracting comments, ID3 information from files. ! ! * Support for writing data entered by you back to the file (in case of ! MP3, only the fields which are supported are written back. For Ogg ! Vorbis files, all the data entered by you go back as comments). + * Creation of playlists in form of symbolic links (shortcuts) to the + original music files. This is a very convenient way of storing + playlists. |
|
From: <ami...@us...> - 2003-12-05 17:26:05
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv22820 Added Files: FEATURES Log Message: list features of AudioLink --- NEW FILE: FEATURES --- Features in AudioLink: * Support for ogg files |
|
From: <ami...@us...> - 2003-12-05 17:25:34
|
Update of /cvsroot/audiolink/audiolink/Documentation In directory sc8-pr-cvs1:/tmp/cvs-serv22740 Added Files: alfilldb_doc.html alsearch_doc.html audiolink_doc.html Log Message: documents --- NEW FILE: alfilldb_doc.html --- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>alfilldb - Add/update information of music files in the AudioLink database</title> <link rev="made" href="mailto:root@localhost" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alfilldb - Add/update information of music files in the AudioLink database</span></strong></big> </td></tr> </table> <p><a name="__index__"></a></p> <!-- INDEX BEGIN --> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#description">DESCRIPTION</a></li> <li><a href="#options">OPTIONS</a></li> <li><a href="#examples">EXAMPLES</a></li> <li><a href="#caveats">CAVEATS</a></li> <li><a href="#see_also">SEE ALSO</a></li> <li><a href="#bugs">BUGS</a></li> <li><a href="#author">AUTHOR</a></li> <li><a href="#copyright">COPYRIGHT</a></li> </ul> <!-- INDEX END --> <hr /> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="name">NAME</a></h1> <p>alfilldb - Add/update information of music files in the AudioLink database</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <p><strong>alfilldb</strong> [<em>OPTION</em>]... <em>/path/to/songs/</em>...</p> <p><strong>alfilldb</strong> [<em>OPTION</em>]... <em>--file=/path/to/song</em>...</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="description">DESCRIPTION</a></h1> <p>You can use this script to add or update information about your music files (MP3 or Ogg Vorbis) in the AudioLink database. This information will be used when you use the <em>alsearch(1)</em> program to search for particular music. This program is part of the <em>audiolink(1)</em> package.</p> <p>The path given for the location of individual files or directories must be an absolute path (paths with ~ are allowed). Relative paths are not allowed. See the <a href="#examples">examples</a> section for more information.</p> <p>The user and password options have to be specified to gain access to the database. See the ``<em>more information</em>'' section in the <em>audiolink(1)</em> man page for the various ways in which you can specify them.</p> <p>Options that are used repetitively during different invocations of the program (like the user, password options) may be put in the config file. See the <em>audiolink(1)</em> man page for details on the config file.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="options">OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dadd_2donly"><strong>--add-only</strong></a></strong><br /> </dt> <dd> Only the information about new songs will be added to the database; information about existing songs will not be updated. </dd> <p></p> <dt><strong><a name="item__2d_2dfile_3dxxx"><strong>--file</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Works on just a single file instead of a directory. If this argument is given, the /path/to/dirs is not considered. (You can have more than one of these). </dd> <p></p> <dt><strong><a name="item__2d_2dhelp"><strong>--help</strong></a></strong><br /> </dt> <dd> Brief usage information </dd> <p></p> <dt><strong><a name="item__2d_2dhost_3dxxx"><strong>--host</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Connects to the MySQL server on the given host. Default is localhost. </dd> <p></p> <dt><strong><a name="item__2d_2dno_2dprompt"><strong>--no-prompt</strong></a></strong><br /> </dt> <dd> Don't prompt for anything. Songs which do not have information for mandatory fields (eg., song title) will not be added to the database. </dd> <p></p> <dt><strong><a name="item__2d_2dpass_3dxxx"><strong>--pass</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Password for accessing the database </dd> <p></p> <dt><strong><a name="item__2d_2dprompt_3dxxx"><strong>--prompt</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Prompt for input if there isn't enough information in the song (ID3 or Ogg Vorbis comments). </dd> <dd> <p>The parameters that prompt accepts are:</p> </dd> <dl> <dt><strong><a name="item_basic"><em>basic</em></a></strong><br /> </dt> <dd> Prompts just for the album name and the artist/band name </dd> <p></p> <dt><strong><a name="item_limited"><em>limited</em></a></strong><br /> </dt> <dd> Prompts for album, artist/band, genre and year fields </dd> <p></p> <dt><strong><a name="item_most"><em>most</em></a></strong><br /> </dt> <dd> Prompt for all the fields except the Male, Female Artists and the Track number </dd> <p></p> <dt><strong><a name="item_paranoid"><em>paranoid</em></a></strong><br /> </dt> <dd> Prompt for all the fields, including Male Artist (1/2), Female Artist (1/2), Track Number. </dd> <p></p></dl> <dt><strong><a name="item__2ds_2c__2d_2dna"><strong>-s</strong>, <strong>--na</strong></a></strong><br /> </dt> <dd> Simulate or no-act mode: doesn't update the database. </dd> <p></p> <dt><strong><a name="item__2d_2dupd_2donly"><strong>--upd-only</strong></a></strong><br /> </dt> <dd> Only entries in the database will be updated from the input the user gives. Make sure you don't use the --no-prompt option along with this one... else you won't get anything done! </dd> <p></p> <dt><strong><a name="item__2d_2dupd_2dsong"><strong>--upd-song</strong></a></strong><br /> </dt> <dd> Update the tags in the file, ie, ID3 for MP3, comments for Ogg Vorbis. </dd> <p></p> <dt><strong><a name="item__2d_2duser_3dxxx"><strong>--user</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Username for accessing the database </dd> <p></p> <dt><strong><a name="item__2d_2dverbose"><strong>--verbose</strong></a></strong><br /> </dt> <dd> Displays some extra information while processing files </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="examples">EXAMPLES</a></h1> <dl> <dt><strong><a name="item_alfilldb__2d_2dadd_2donly__2fhome_2fuser_2ftmp_2fs"><code>alfilldb --add-only /home/user/tmp/songs/</code></a></strong><br /> </dt> <dd> This invocation will scan the /home/user/tmp/songs directory recursively for new songs only. Songs already existing in the database will not be considered. </dd> <p></p> <dt><strong><a name="item_alfilldb__2d_2dupd_2donly__2d_2dprompt_3dmost__7e_"><code>alfilldb --upd-only --prompt=most ~/tmp/songs/</code></a></strong><br /> </dt> <dd> This invocation will scan the $(HOME)/tmp/songs directory recursively for the current user for incomplete information in the database. </dd> <p></p> <dt><strong><a name="item_alfilldb__7euser_2ftmp_2fsongs_2f"><code>alfilldb ~user/tmp/songs/</code></a></strong><br /> </dt> <dd> This invocation will scan the /home/user/tmp/songs folder for music files; will add new entries to the database as well as update the existing ones. </dd> <p></p> <dt><strong><a name="item_alfilldb__2d_2dfile_3d_7e_2ftmp_2fsongs_2fsomefile"><code>alfilldb --file=~/tmp/songs/somefile.ogg --file=~/tmp/songs/otherfile.mp3</code></a></strong><br /> </dt> <dd> This invocation will just add (or update) information about the files $(HOME)/tmp/songs/somefile.ogg and $(HOME)/tmp/songs/otherfile.mp3. </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="caveats">CAVEATS</a></h1> <p>If the <strong>--prompt</strong> option is not specified, <strong>alfilldb</strong> will just prompt for the title of the song being processed. The title information is asked only if the ID3 tag or the Vorbis comment doesn't contain the title. This behavior can be overriden by the --no-prompt option, and in this case, the entry for the file will not be made, since the song title is a mandatory field for storing song information in the datbase.</p> <p>If neither of <strong>--add-only</strong> or <strong>--upd-only</strong> are specified, the default action is to add new entries as well as update existing ones.</p> <p>If the ID3 tags or Vorbis comments for a file were updated after entries were made in the AudioLink database, they will not be reflected in the database. If you want to maintain consistency, it is advised that you keep the database updated (by using the <strong>--upd-only</strong> option) and then update the ID3 tag in the MP3 or the comment in the Ogg Vorbis file (by running <strong>alfilldb</strong> with the <strong>--upd-only</strong> option).</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <em><a href="audiolink_doc.html">audiolink(1)</a></em>, <em><a href="alsearch_doc.html">alsearch(1)</a></em><p>The current version of this man page is available on the AudioLink website at <<a href="http://audiolink.sourceforge.net/">http://audiolink.sourceforge.net/</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="bugs">BUGS</a></h1> <p>Report bugs related to the AudioLink software or the man pages to the audiolink-devel mailing list <<a href="mailto:aud...@li...">aud...@li...</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>This manual page is written and maintained by Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="copyright">COPYRIGHT</a></h1> <p>The AudioLink package is Copyright (C) 2003, Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>>. All the programs and the documentation that come as part of AudioLink are licensed by the GNU General Public License v2 (GPLv2).</p> <p><a href="#__index__"><small>Top</small></a></p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alfilldb - Add/update information of music files in the AudioLink database</span></strong></big> </td></tr> </table> </body> </html> --- NEW FILE: alsearch_doc.html --- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>alsearch - Search the AudioLink database for music</title> <link rev="made" href="mailto:root@localhost" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alsearch - Search the AudioLink database for music</span></strong></big> </td></tr> </table> <p><a name="__index__"></a></p> <!-- INDEX BEGIN --> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#description">DESCRIPTION</a></li> <li><a href="#options">OPTIONS</a></li> <li><a href="#search_options">SEARCH OPTIONS</a></li> <li><a href="#examples">EXAMPLES</a></li> <li><a href="#see_also">SEE ALSO</a></li> <li><a href="#bugs">BUGS</a></li> <li><a href="#author">AUTHOR</a></li> <li><a href="#copyright">COPYRIGHT</a></li> </ul> <!-- INDEX END --> <hr /> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="name">NAME</a></h1> <p>alsearch - Search the AudioLink database for music</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <p><strong>alsearch</strong> [<em>OPTION</em>]... <em>search_option</em>... <em>--td=/some/path/to/create/links/</em></p> <p><strong>alsearch</strong> [<em>OPTION</em>]... <em>search_option</em>... <em>-s</em></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="description">DESCRIPTION</a></h1> <p>You can use this script to search for songs in the AudioLink database. You can specify one or several options for the artist, composer, lyricist, album, etc., as the search criteria.</p> <p>You can specify several <em>search_option</em> options to search for particular music files. See the section on <a href="#search_options">search options</a> for the list of options.</p> <p>The search is not case sensitive. <strong>alsearch</strong> looks for strings as well as sub-strings in the fields being searched. See the <a href="#examples">examples</a> section for more information.</p> <p>Specifying the <strong>--td</strong> (target directory) option is mandatory for creating links to the actual files. This directory will contain the symbolic links to the actual audio files. The directory will be created if it doesn't exist.</p> <p>Creating symbolic links to the actual files is analogous to creating playlists in audio-playing software. Symbolic links are actually just point to the actual files on the hard disk. This way of creating and storing playlists is very useful in several ways, some of which are:</p> <ol> <li><strong><a name="item_compatible_across_various_audio_players">Compatible across various audio players</a></strong><br /> </li> Since the ``playlists'' are actually files represented on your hard disk, you can add whole directories generated by the <strong>alsearch</strong> program in the playlist of your audio software. If you switch to another music player for whatever reason, you still have your playlists. You don't have to bother about compatibility between the playlist formats of the two players. <p></p> <li><strong><a name="item_can_be_seen_and_operated_upon_in_a_file_browser">Can be seen and operated upon in a file browser</a></strong><br /> </li> As the symbolic links are present on a file-system, your playlist collection can be viewed by using normal file operations in the shell or using a GUI-based file browsing program. If the file browsing program is supports file traversals and symlinks, it'll show you the information of the actual song. <p></p></ol> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="options">OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dhelp"><strong>--help</strong></a></strong><br /> </dt> <dd> Brief usage information </dd> <p></p> <dt><strong><a name="item__2d_2dhost_3dxxx"><strong>--host</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Connects to the MySQL server on the target host. Default is localhost. </dd> <p></p> <dt><strong><a name="item__2d_2dpass_3dxxx"><strong>--pass</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Password for the database </dd> <p></p> <dt><strong><a name="item__2ds_2c__2d_2dna"><strong>-s</strong>, <strong>--na</strong></a></strong><br /> </dt> <dd> Just displays the search results, doesn't create links (simulation mode) </dd> <p></p> <dt><strong><a name="item__2d_2dtd_3dxxx"><strong>--td</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Target-directory in which to create links </dd> <p></p> <dt><strong><a name="item__2d_2duser_3dxxx"><strong>--user</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Username for the database </dd> <p></p> <dt><strong><a name="item__2dv_2c__2d_2dverbose"><strong>-v</strong>, --verbose</a></strong><br /> </dt> <dd> Displays some extra information. Useful for spotting errors and sending debug information. </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="search_options">SEARCH OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dalbum_3dxxx"><strong>--album</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``album'' field </dd> <p></p> <dt><strong><a name="item__2d_2dartist_3dxxx"><strong>--artist</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the artist/band/performers fields. You can give this option multiple times, for example: </dd> <dd> <p><code>alsearch --artist=kishore --artist=asha --td=/songs/asha_kishore</code></p> </dd> <p></p> <dt><strong><a name="item__2d_2dcomment_3dxxx"><strong>--comment</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``comment'' field </dd> <p></p> <dt><strong><a name="item__2dc_2c__2d_2dcomposer_3dxxx"><strong>-c</strong>, <strong>--composer</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``composer'' field </dd> <p></p> <dt><strong><a name="item__2d_2dgenre_3dxxx"><strong>--genre</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``genre'' field </dd> <p></p> <dt><strong><a name="item__2dl_2c__2d_2dlyricist_3dxxx"><strong>-l</strong>, <strong>--lyricist</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``lyricist'' field </dd> <p></p> <dt><strong><a name="item__2d_2dtitle_3dxxx"><strong>--title</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``title'' field </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="examples">EXAMPLES</a></h1> <p>The options that take arguments can be specified in two ways:</p> <p><code>alsearch --artist="kishore kumar" --td=/songs/kishore</code></p> <p><code>alsearch --artist "kishore kumar" --td /songs/kishore</code></p> <p>That is, the option and the argument can be separated with a '<em> </em>' (space) or an '<em>=</em>' (equal) sign.</p> <p>In case you want to search for a string that has spaces, enclose the string in `` ''.</p> <p><code>alsearch --artist=kishore --composer=burman --lyricist=bakshi</code></p> <p>Will search for songs sung by *Kishore*, composed by *Burman* and written by *Bakshi*. Any name in the composer field which have ``burman'' in them will be matched. This means, it'll find songs composed by RD Burman, SD Burman, etc. This is true for all search fields.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <em><a href="audiolink_doc.html">audiolink(1)</a></em>, <em><a href="alfilldb_doc.html">alfilldb(1)</a></em><p>The current version of this man page is available on the AudioLink website at <<a href="http://audiolink.sourceforge.net/">http://audiolink.sourceforge.net/</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="bugs">BUGS</a></h1> <p>Report bugs related to the AudioLink software or the man pages to the audiolink-devel mailing list <<a href="mailto:aud...@li...">aud...@li...</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>This manual page is written and maintained by Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="copyright">COPYRIGHT</a></h1> <p>The AudioLink package is Copyright (C) 2003, Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>>. All the programs and the documentation that come as part of AudioLink are licensed by the GNU General Public License v2 (GPLv2).</p> <p><a href="#__index__"><small>Top</small></a></p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alsearch - Search the AudioLink database for music</span></strong></big> </td></tr> </table> </body> </html> --- NEW FILE: audiolink_doc.html --- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>audiolink - Create AudioLink config file, databases and tables</title> <link rev="made" href="mailto:root@localhost" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> audiolink - Create AudioLink config file, databases and tables</span></strong></big> </td></tr> </table> <p><a name="__index__"></a></p> <!-- INDEX BEGIN --> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#description">DESCRIPTION</a></li> <li><a href="#options">OPTIONS</a></li> <li><a href="#more_information">MORE INFORMATION</a></li> <li><a href="#configuration_file">CONFIGURATION FILE</a></li> <li><a href="#see_also">SEE ALSO</a></li> <li><a href="#bugs">BUGS</a></li> <li><a href="#author">AUTHOR</a></li> <li><a href="#copyright">COPYRIGHT</a></li> </ul> <!-- INDEX END --> <hr /> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="name">NAME</a></h1> <p>audiolink - Create AudioLink config file, databases and tables</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <p>audiolink [<em>OPTION</em>]...</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="description">DESCRIPTION</a></h1> <p>AudioLink is a set of programs which help you manage your music collection. It makes searching for music on your local storage media easier and faster. Your searches can include a variety of criteria, like male artists, female artists, band, genre, etc.</p> <p>It supports music files of MP3 and Ogg Vorbis formats.</p> <p><strong>audiolink</strong> assists you in creating a configuration file for oft-used options passed to the AudioLink programs and creating the MySQL database and tables which the AudioLink programs, <em>alfilldb(1)</em> and <em>alsearch(1)</em> use.</p> <p>The options specified on the command prompt override the options specified in the config file.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="options">OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dhelp"><strong>--help</strong></a></strong><br /> </dt> <dd> Brief usage information </dd> <p></p> <dt><strong><a name="item__2d_2dhost_3dxxx"><strong>--host</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Connects to the MySQL server on the target host. Default is localhost. </dd> <p></p> <dt><strong><a name="item__2d_2dpass_3dxxx"><strong>--pass</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Password for the database </dd> <p></p> <dt><strong><a name="item__2d_2duser_3dxxx"><strong>--user</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Username for the database </dd> <p></p> <dt><strong><a name="item__2d_2dverbose"><strong>--verbose</strong></a></strong><br /> </dt> <dd> Display extra information about what's going on </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="more_information">MORE INFORMATION</a></h1> <p>The user and password fields for the database have to be specified. There are three ways of doing this:</p> <ol> <li><strong><a name="item_command_2dline_arguments">Command-line arguments</a></strong><br /> </li> By specifying them via the --user and --pass command-line arguments to the programs: <p><code>alfilldb --user=mysql_username --pass=mysql_password --prompt=basic /songs/</code></p> <p><code>alsearch --user=mysql_username --pass=mysql_password --artist=kishore --td=/songs/kishore</code></p> <p></p> <li><strong><a name="item_environment_variables">Environment variables</a></strong><br /> </li> Setting the DBI_USER and DBI_PASS environment variables: <p>If you are using bash, ksh, zsh or sh do this:</p> <p><code>export DBI_USER=mysql_username</code></p> <p><code>export DBI_PASS=mysql_password</code></p> <p>If you are using csh or tcsh, do this:</p> <p><code>setenv DBI_USER mysql_username</code></p> <p><code>setenv DBI_USER mysql_password</code></p> <p>Consult the man page of the respective shell interpreter that you use for help on environment variables.</p> <p></p> <li><strong><a name="item_config_file">Config file</a></strong><br /> </li> Specifying them in the config file (the most convenient). The config file is stored in each user's home directory in the <em>~/.audiolink/config</em> location. <p></p></ol> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="configuration_file">CONFIGURATION FILE</a></h1> <p>The AudioLink configuration file <em>config</em> resides in the <em>.audiolink/</em> directory in the user's home directory (<em>$HOME/.audiolink/config</em>).</p> <p>The format of the current config file is pretty easy to understand: Just put in <code>a = b</code> on separate lines for all the options you want the AudioLink scripts to use by default. Here, a is the option name, like user, password, host, etc., and b is the value you wish to associate the option with. For example, to set the username for accessing the database to 'root', you would put this in the config file:</p> <p><code>user = root</code></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <em><a href="alfilldb_doc.html">alfilldb(1)</a></em>, <em><a href="alsearch_doc.html">alsearch(1)</a></em><p>The current version of this man page is available on the AudioLink website at <<a href="http://audiolink.sourceforge.net/">http://audiolink.sourceforge.net/</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="bugs">BUGS</a></h1> <p>Report bugs related to the AudioLink software or the man pages to the audiolink-devel mailing list <<a href="mailto:aud...@li...">aud...@li...</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>This manual page is written and maintained by Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="copyright">COPYRIGHT</a></h1> <p>The AudioLink package is Copyright (C) 2003, Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>>. All the programs and the documentation that come as part of AudioLink are licensed by the GNU General Public License v2 (GPLv2).</p> <p><a href="#__index__"><small>Top</small></a></p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> audiolink - Create AudioLink config file, databases and tables</span></strong></big> </td></tr> </table> </body> </html> |
|
From: <ami...@us...> - 2003-12-05 17:24:55
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv22613 Modified Files: VERSION Log Message: version 0.05 Index: VERSION =================================================================== RCS file: /cvsroot/audiolink/audiolink/VERSION,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** VERSION 3 Nov 2003 13:32:52 -0000 1.3 --- VERSION 5 Dec 2003 17:24:52 -0000 1.4 *************** *** 1 **** ! AudioLink version 0.04 20031103 --- 1 ---- ! AudioLink version 0.05 20031205 |
|
From: <ami...@us...> - 2003-12-05 14:28:24
|
Update of /cvsroot/audiolink/audiolink
In directory sc8-pr-cvs1:/tmp/cvs-serv25145
Modified Files:
ChangeLog
Log Message:
ChangeLog update for 0.05
Index: ChangeLog
===================================================================
RCS file: /cvsroot/audiolink/audiolink/ChangeLog,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** ChangeLog 3 Nov 2003 13:31:56 -0000 1.6
--- ChangeLog 5 Dec 2003 14:28:21 -0000 1.7
***************
*** 1,2 ****
--- 1,195 ----
+ 2003-12-05 amitshah <amitshah@magrathea>
+
+ * code/alsearch:
+ 1. config file isn't perl code now; simple "a = b" stuff
+ 2. command-line args override config file options
+
+ * code/alfilldb: ouch! one more ref. to alfilldb_usage.txt
+
+ * code/alfilldb: removed ref. to alfilldb_usage.txt
+
+ * code/alfilldb:
+ 1. config file isn't perl code now; simple "a = b" stuff
+ 2. command-line args override config file options
+
+ * code/audiolink: 1. clean up the printed statements.
+ 2. added a verbose mode
+ 3. config file isn't perl code now; simple "a = b" stuff
+ 4. default to localhost for the host field
+ 5. command-line args override config file options
+
+ * .cvsignore: ignore debian/ and gui/
+
+ * Documentation/alsearch_usage.txt, Documentation/alfilldb_usage.txt:
+ remove the *_usage.txt files; we now have *_doc.html files.
+
+ * INSTALL:
+ You can now use the audiolink script to create the datbase and table.
+
+ * README: better 1st para
+
+ * TODO: 1. We have a config file
+ 2. Debian packaging is done; get rpms done now.
+
+ 2003-12-04 amitshah <amitshah@magrathea>
+
+ * Makefile: install code/audiolink
+ create man page for code/audiolink
+
+ * code/audiolink: 1. documentation
+ 2. create/modify config file based on user input if $user, $pass, $host not present
+ 3. create database
+ 4. create table
+
+ * code/alsearch, code/alfilldb: use pod2usage better
+
+ * code/alsearch: use pod2usage() instead of show_usage()
+
+ * code/alfilldb: use pod2usage() instead of system("pod2usage $0");
+
+ * code/alfilldb: 1. show_usage() now uses pod2usage
+ 2. huge documentation fixes and updates
+
+ * code/alsearch: 1. show_usage() uses pod2usage now
+ 2. huge documentation updates and fixes
+
+ 2003-11-29 amitshah <amitshah@magrathea>
+
+ * code/audiolink: some info on config file and better formatting
+
+ * Documentation/alfilldb_usage.txt: fix invalid option.
+
+ anyways, this file is going to be scrapped now
+
+ * code/alsearch: documentation fixes/enhancements
+
+ * Makefile:
+ optimizations for the clean target, new targets for generating and installing man pages
+
+ * INSTALL:
+ moved info about configuring, etc. to the man pages and README
+
+ * README:
+ moved info about running and documentation from INSTALL to here
+
+ * code/audiolink:
+ New file: Currently, just holds generic AudioLink documentation (bare minimum, ripped from INSTALL and other sources)
+
+ * code/alfilldb: 1. Pod documentation
+ 2. Minor optimizations
+ 3. Check if absolute path name or path name with ~/ given. Else,
+ reject the path/file. This is useful so that the user doesn't enter
+ invalid file names in the database.
+
+ 2003-11-28 amitshah <amitshah@magrathea>
+
+ * code/alsearch: * Pod documentation
+ * Move target dir check to main routine
+
+ 2003-11-17 amitshah <amitshah@magrathea>
+
+ * Makefile:
+ tidy the createdb, insschema comment; rename $DB_LINE TO $DB_OPTS
+
+ 2003-11-16 amitshah <amitshah@magrathea>
+
+ * Documentation/design.txt: design for the audiolink script
+
+ * Makefile: define vars for the DB
+
+ 2003-11-15 amitshah <amitshah@magrathea>
+
+ * INSTALL:
+ ogg::vorbis::header is complusory; better message for non-avl. of packages for stable/testing
+
+ 2003-11-14 amitshah <amitshah@magrathea>
+
+ * TODO: add todo about including musicbrainz searches
+
+ * code/alfilldb:
+ 1. Fix missing function get_ogg_artists; fixed by doing things locally
+ 2. Fix reading Ogg Vorbis comments: didn't work previously :-(
+ 3. Add some exception handling
+
+ 2003-11-12 amitshah <amitshah@magrathea>
+
+ * web/index.html:
+ point the download location to make the latest release highlighted.
+
+ * web/documents.html: mv developers.txt CREDITS
+
+ * Documentation/design.txt, INSTALL, Makefile:
+ s,code/search/alsearch,code/alsearch
+ s,code/search/alsearch,code/alsearch
+
+ 2003-11-10 amitshah <amitshah@magrathea>
+
+ * code/alsearch, code/alfilldb:
+ retain default values in case the config file isn't present for $user, $password, $host for the sql database
+
+ * Makefile: Version: 0.04-cvs
+
+ 2003-11-09 amitshah <amitshah@magrathea>
+
+ * Documentation/design.txt: update copyright; corrections
+
+ * Makefile: update email addr, copyright info
+
+ * code/alfilldb, code/alsearch: config file; comment cleanups
+
+ 2003-11-03 amitshah <amitshah@magrathea>
+
+ * web/index.html: v0.04
+
+ * VERSION: update VERSION
+
+ * ChangeLog: update
+
+ * Changes: the mode description belongs to RELEASE_NOTES
+
+ * Documentation/alsearch_usage.txt:
+ better naming convention for target dir.
+
+ * Makefile: ignore the ann directory while making tarballs
+
+ * .cvsignore: add ann
+
+ * .cvsignore: ignore file
+
+ * Documentation/alfilldb_usage.txt: example using ~/
+
+ * Documentation/alfilldb_usage.txt: support for ~: handled.
+
+ * TODO: support for filenames with ~: handled.
+
+ * code/alfilldb: enable ~/blah expansions for filename
+
+ * Documentation/alfilldb_usage.txt:
+ don't provide pathnames that start with ~/
+
+ * Changes: note on what this doc tells; Changes in 0.04
+
+ * RELEASE_NOTES: info on what this doc tells; release notes for 0.04
+
+ * code/alfilldb: note on how to use the options list (gg<nr>)
+
+ * INSTALL: CPAN names for perl modules
+ packages for Ogg Vorbis and the mentors.debian.net binaries/sources
+ mysql-client is required; mysql-server optional
+
+ * Documentation/design.txt: add some design details for the dbfs
+
+ * code/alfilldb: We're actually dealing with Ogg _Vorbis_.
+
+ * code/alfilldb:
+ * Fix bug for the case where just one value is guessed from the database/filename
+ * Write support for Ogg files
+ * Read info from Ogg files
+ * Show "Error:" if bailing out due to some error
+
+ * code/alsearch: print Error: if exiting on an error
+
+ * code/alsearch: s/$song/$title/g
+
2003-11-03 amitshah <amitshah@magrathea>
|
|
From: <ami...@us...> - 2003-12-05 14:27:41
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv25039 Modified Files: Makefile Log Message: 1. .orig.tar.gz so that creating debs is easier 2. automatically compute md5sums for the .tar.gz and .tar.bz2 3. v0.05 Index: Makefile =================================================================== RCS file: /cvsroot/audiolink/audiolink/Makefile,v retrieving revision 1.22 retrieving revision 1.23 diff -C2 -d -r1.22 -r1.23 *** Makefile 4 Dec 2003 16:21:45 -0000 1.22 --- Makefile 5 Dec 2003 14:27:38 -0000 1.23 *************** *** 28,33 **** # versioning info VERSION = 0 ! SUBLEVEL = 04 ! EXTRAVERSION = -cvs ALVER = $(VERSION).$(SUBLEVEL)$(EXTRAVERSION) --- 28,33 ---- # versioning info VERSION = 0 ! SUBLEVEL = 05 ! EXTRAVERSION = ALVER = $(VERSION).$(SUBLEVEL)$(EXTRAVERSION) *************** *** 66,73 **** $(Q)rm -rf ../audiolink-$(ALVER)/debian $(Q)rm -f ../audiolink-$(ALVER)/.cvsignore ! $(Q)rm -f ../audiolink-$(ALVER)/upd_web.sh $(Q)tar --directory=.. -cjf ../audiolink-$(ALVER).tar.bz2 audiolink-$(ALVER) $(Q)tar --directory=.. -czf ../audiolink-$(ALVER).tar.gz audiolink-$(ALVER) $(Q)rm -rf ../audiolink-$(ALVER) $(Q)echo "Done. Have you run 'make cvs' yet?" --- 66,75 ---- $(Q)rm -rf ../audiolink-$(ALVER)/debian $(Q)rm -f ../audiolink-$(ALVER)/.cvsignore ! $(Q)rm -f ../audiolink-$(ALVER)/web/upd_web.sh $(Q)tar --directory=.. -cjf ../audiolink-$(ALVER).tar.bz2 audiolink-$(ALVER) $(Q)tar --directory=.. -czf ../audiolink-$(ALVER).tar.gz audiolink-$(ALVER) + $(Q)md5sum ../audiolink-$(ALVER).tar.* > ../md5sums + $(Q)cp ../audiolink-$(ALVER).tar.gz ../aldeb/audiolink_$(ALVER).orig.tar.gz $(Q)rm -rf ../audiolink-$(ALVER) $(Q)echo "Done. Have you run 'make cvs' yet?" *************** *** 97,103 **** # Commit latest and tag the CVS with the release info cvs: version ! cvs ci -m "update VERSION" VERSION cvs tag rel_$(VERSION)$(SUBLEVEL) - #------------------------------------------------------------------------------ --- 99,104 ---- # Commit latest and tag the CVS with the release info cvs: version ! cvs ci -m "version $(ALVER)" VERSION cvs tag rel_$(VERSION)$(SUBLEVEL) #------------------------------------------------------------------------------ |
|
From: <ami...@us...> - 2003-12-05 14:24:20
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv24199 Modified Files: Changes Log Message: update for 0.05 Index: Changes =================================================================== RCS file: /cvsroot/audiolink/audiolink/Changes,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** Changes 3 Nov 2003 13:30:11 -0000 1.3 --- Changes 5 Dec 2003 14:24:17 -0000 1.4 *************** *** 6,10 **** --- 6,27 ---- which have been made to the user interfaces. + Changes from AudioLink v0.04 to v0.05: + + * The scripts alsearch and alfilldb have been moved to + code/. search/, filldb/ are not used now. + + * Fix Ogg Vorbis comments handling: they work now. + + * Pod documentation for all the scripts. Man pages, HTML + documentation is now available. + + * New script: audiolink. Handles creation of the config file + and database, tables. + + * We now have a config file. It resides in ~/.audiolink/config + + Changes from AudioLink v0.03 to v0.04: + * Scripts alsearch.pl and alfilldb.pl have moved to alsearch and alfilldb respectively. For the reasons, see ChangeLog. |
|
From: <ami...@us...> - 2003-12-05 14:23:38
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv24063 Modified Files: RELEASE_NOTES Log Message: release notes update for 0.05 Index: RELEASE_NOTES =================================================================== RCS file: /cvsroot/audiolink/audiolink/RELEASE_NOTES,v retrieving revision 1.6 retrieving revision 1.7 diff -C2 -d -r1.6 -r1.7 *** RELEASE_NOTES 3 Nov 2003 09:25:51 -0000 1.6 --- RELEASE_NOTES 5 Dec 2003 14:23:35 -0000 1.7 *************** *** 6,9 **** --- 6,20 ---- describes changes in the user interface. + Release notes for AudioLink v0.05: + ---------------------------------- + * The scripts alfilldb and alsearch have been moved to code/. The + directories code/search and code/filldb are not used now. + + * Config file: resides in ~/.audiolink/config. + + * New script: audiolink that handles creation/modification of config + file and the database, tables in MySQL. + + Release notes for AudioLink v0.04: ---------------------------------- |
|
From: <ami...@us...> - 2003-12-05 12:32:42
|
Update of /cvsroot/audiolink/audiolink/code
In directory sc8-pr-cvs1:/tmp/cvs-serv5956
Modified Files:
alsearch
Log Message:
1. config file isn't perl code now; simple "a = b" stuff
2. command-line args override config file options
Index: alsearch
===================================================================
RCS file: /cvsroot/audiolink/audiolink/code/alsearch,v
retrieving revision 1.24
retrieving revision 1.25
diff -C2 -d -r1.24 -r1.25
*** alsearch 4 Dec 2003 16:13:07 -0000 1.24
--- alsearch 5 Dec 2003 12:32:39 -0000 1.25
***************
*** 141,151 ****
# execution starts here
- $config_file = "$ENV{HOME}/.audiolink/config";
-
- unless ($file_ret = do $config_file) {
- die "Couldn't parse the config file, $config_file: $@" if $@;
- die "Couldn't read the config file, $config_file: $!";
- die "Some problem occured with the config file, $config_file";
- }
# check for command-line arguments
--- 141,144 ----
***************
*** 183,186 ****
--- 176,198 ----
}
+ $config_file = "$ENV{HOME}/.audiolink/config";
+
+ if (-e $config_file) {
+ open(CONFFILE, $config_file);
+
+ # go through the config file
+ while (<CONFFILE>) {
+ if (/^\s*user\s*\=+\s*(\w+)/) {
+ chomp($user = $1) unless $user;
+ } elsif ( /^\s*pass(word)?\s*=\s*(\w+)/) {
+ chomp($password = $2) unless $password;
+ } elsif ( /^\s*host\s*=\s*(\w+)/) {
+ chomp($host = $1) unless $host;
+ }
+ }
+ } else {
+ warn "WARNING: config file not found. Use the audiolink script to create one.\n";
+ }
+
my $i = 0;
***************
*** 218,223 ****
$dbh = DBI->connect($dbi_string,$user,$password)
or die "$0: Error: Could not connect to the database! \
! Make sure that the DBI_PASS and DBI_USER environment variables are set.\n";
!
if ($target_dir_name) {
--- 230,234 ----
$dbh = DBI->connect($dbi_string,$user,$password)
or die "$0: Error: Could not connect to the database! \
! Check the user, password and host fields for the MySQL connection.";
if ($target_dir_name) {
|
|
From: <ami...@us...> - 2003-12-05 12:31:45
|
Update of /cvsroot/audiolink/audiolink/code
In directory sc8-pr-cvs1:/tmp/cvs-serv5743
Modified Files:
alfilldb
Log Message:
ouch! one more ref. to alfilldb_usage.txt
Index: alfilldb
===================================================================
RCS file: /cvsroot/audiolink/audiolink/code/alfilldb,v
retrieving revision 1.32
retrieving revision 1.33
diff -C2 -d -r1.32 -r1.33
*** alfilldb 5 Dec 2003 12:30:31 -0000 1.32
--- alfilldb 5 Dec 2003 12:31:42 -0000 1.33
***************
*** 448,452 ****
} else {
die "\n$0: Error: Invalid argument \'$prompt\' passed to \'prompt\'.
! See Documentation/alfilldb_usage.txt for more information.\n";
}
--- 448,452 ----
} else {
die "\n$0: Error: Invalid argument \'$prompt\' passed to \'prompt\'.
! See the alfilldb(1) man page for more information.\n";
}
|
|
From: <ami...@us...> - 2003-12-05 12:30:34
|
Update of /cvsroot/audiolink/audiolink/code
In directory sc8-pr-cvs1:/tmp/cvs-serv5584
Modified Files:
alfilldb
Log Message:
removed ref. to alfilldb_usage.txt
Index: alfilldb
===================================================================
RCS file: /cvsroot/audiolink/audiolink/code/alfilldb,v
retrieving revision 1.31
retrieving revision 1.32
diff -C2 -d -r1.31 -r1.32
*** alfilldb 5 Dec 2003 12:24:03 -0000 1.31
--- alfilldb 5 Dec 2003 12:30:31 -0000 1.32
***************
*** 488,494 ****
$dbh = DBI->connect($dbi_string,$user,$password)
or die "\n$0: Error: Could not connect to the database!\
! Check the user, password and host fields for the MYSQL connection.
! (the --user, --pass, --host options and the DBI_USER and DBI_PASS env. vars
! See the file Documentation/alfilldb_usage.txt for more information\n";
if (not $files[0]) {
--- 488,492 ----
$dbh = DBI->connect($dbi_string,$user,$password)
or die "\n$0: Error: Could not connect to the database!\
! Check the user, password and host fields for the MySQL connection.";
if (not $files[0]) {
|
|
From: <ami...@us...> - 2003-12-05 12:24:06
|
Update of /cvsroot/audiolink/audiolink/code
In directory sc8-pr-cvs1:/tmp/cvs-serv4484
Modified Files:
alfilldb
Log Message:
1. config file isn't perl code now; simple "a = b" stuff
2. command-line args override config file options
Index: alfilldb
===================================================================
RCS file: /cvsroot/audiolink/audiolink/code/alfilldb,v
retrieving revision 1.30
retrieving revision 1.31
diff -C2 -d -r1.30 -r1.31
*** alfilldb 4 Dec 2003 16:11:59 -0000 1.30
--- alfilldb 5 Dec 2003 12:24:03 -0000 1.31
***************
*** 406,415 ****
# execution starts here
- $config_file = "$ENV{HOME}/.audiolink/config";
-
- unless (do $config_file) {
- warn "WARNING: Couldn't parse the config file, $config_file: $@" if $@;
- warn "WARNING: Couldn't read the config file, $config_file: $!";
- }
# check for command-line arguments
--- 406,409 ----
***************
*** 468,471 ****
--- 462,484 ----
} else { # no option specified, default to add and update
$addmode = $updmode = 1;
+ }
+
+ $config_file = "$ENV{HOME}/.audiolink/config";
+
+ if (-e $config_file) {
+ open(CONFFILE, $config_file);
+
+ # go through the config file
+ while (<CONFFILE>) {
+ if (/^\s*user\s*\=+\s*(\w+)/) {
+ chomp($user = $1) unless $user;
+ } elsif ( /^\s*pass(word)?\s*=\s*(\w+)/) {
+ chomp($password = $2) unless $password;
+ } elsif ( /^\s*host\s*=\s*(\w+)/) {
+ chomp($host = $1) unless $host;
+ }
+ }
+ } else {
+ warn "WARNING: config file not found. Use the audiolink script to create one.\n";
}
|
|
From: <ami...@us...> - 2003-12-05 12:20:52
|
Update of /cvsroot/audiolink/audiolink/code
In directory sc8-pr-cvs1:/tmp/cvs-serv3914
Modified Files:
audiolink
Log Message:
1. clean up the printed statements.
2. added a verbose mode
3. config file isn't perl code now; simple "a = b" stuff
4. default to localhost for the host field
5. command-line args override config file options
Index: audiolink
===================================================================
RCS file: /cvsroot/audiolink/audiolink/code/audiolink,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** audiolink 4 Dec 2003 16:20:17 -0000 1.3
--- audiolink 5 Dec 2003 12:20:49 -0000 1.4
***************
*** 26,43 ****
-
- # Currently, we'll do the database setting up and the config file
- # setting up here. Eventually, move this to alconf and aldbconf.
-
- # First, detect if there's a config file in the home dir.
-
-
use DBI;
use Getopt::Long;
# Options for the database
$user = undef;
$password = undef;
! $host = "localhost"; # use local mysql server by default
--- 26,37 ----
use DBI;
use Getopt::Long;
+ use Pod::Usage;
# Options for the database
$user = undef;
$password = undef;
! $host = undef;
***************
*** 54,78 ****
sub ask_for_configfile_and_input {
! print STDERR "
You haven't specified the " . $_[0] . " field for the database. The
easiest way of doing this is by storing it in the AudioLink
configuration file. Would you like to do that now? [Yes/no] ";
! chomp($input = <STDIN>);
! unless ($input) {
! $input = "yes";
! }
! unless ($input =~ /yes/i) {
! print "\n\tQuitting now. See the audiolink(1) man page for
more information on the mandatory input information needed,
the config file and alternate ways of specifying the
information.\n";
! # This is bad... don't quit from a subroutine!
! close CONFFILE;
! exit -1;
}
--- 48,74 ----
sub ask_for_configfile_and_input {
! if ( $_[0] =~ /user/ or $_[0] =~ /password/) {
! print STDERR "
You haven't specified the " . $_[0] . " field for the database. The
easiest way of doing this is by storing it in the AudioLink
configuration file. Would you like to do that now? [Yes/no] ";
! chomp($input = <STDIN>);
! unless ($input) {
! $input = "yes";
! }
! unless ($input =~ /yes/i) {
! print "\n\tQuitting now. See the audiolink(1) man page for
more information on the mandatory input information needed,
the config file and alternate ways of specifying the
information.\n";
! # This is bad... don't quit from a subroutine!
! close CONFFILE;
! exit -1;
! }
}
***************
*** 82,86 ****
--- 78,87 ----
print STDERR "Please enter the " . $_[0] . " field for the database: ";
+ $_[0] =~ /host/ ? print "[localhost]" : 1 ;
+
chomp($input = <STDIN>);
+ if (not $input and $_[0] =~ /host/) {
+ $input = "localhost";
+ }
}
return $input;
***************
*** 92,95 ****
--- 93,97 ----
'pass=s' => \$password,
'host=s' => \$host,
+ 'verbose' => \$verbose
) or pod2usage();
***************
*** 98,121 ****
}
$config_file = "$ENV{HOME}/.audiolink/config";
! unless (do $config_file) {
! warn "WARNING: Couldn't parse the config file, $config_file: $@" if $@;
! warn "WARNING: Couldn't read the config file, $config_file: $!";
}
! open(CONFFILE, ">>", $config_file);
unless ($user) {
$user = ask_for_configfile_and_input("username");
! print CONFFILE '$user = ' . $user . ";\n";
}
unless ($password) {
$password = ask_for_configfile_and_input("password");
! print CONFFILE '$password = ' . $password . ";\n";
}
unless ($host) {
$host = ask_for_configfile_and_input("host");
! print CONFFILE '$host = ' . $host . ";\n";
}
--- 100,140 ----
}
+ # Currently, we'll do the database setting up and the config file
+ # setting up here.
+
$config_file = "$ENV{HOME}/.audiolink/config";
! # First, detect if there's a config file in the home dir.
! if (-e $config_file) {
! # If the config file already exists, open it in read-write mode;
! # don't clobber contents (+< as opposed to +>)
! open(CONFFILE, '+<', $config_file);
! } else {
! # If it doesn't exist, open it in write mode.
! open (CONFFILE, '>', $config_file);
}
! # go through the config file
! while (<CONFFILE>) {
! if (/^\s*user\s*\=+\s*(\w+)/) {
! chomp($user = $1) unless $user;
! } elsif ( /^\s*pass(word)?\s*=\s*(\w+)/) {
! chomp($password = $2) unless $password;
! } elsif ( /^\s*host\s*=\s*(\w+)/) {
! chomp($host = $1) unless $host;
! }
! }
unless ($user) {
$user = ask_for_configfile_and_input("username");
! print CONFFILE 'user = ' . $user . "\n";
}
unless ($password) {
$password = ask_for_configfile_and_input("password");
! print CONFFILE 'pass = ' . $password . "\n";
}
unless ($host) {
$host = ask_for_configfile_and_input("host");
! print CONFFILE 'host = ' . $host . "\n";
}
***************
*** 127,136 ****
AutoCommit => 1} )
or warn "\n$0: WARNING: Could not connect to the database!\
! !! This probably means that the AudioLink database is not initialized or
! !! the MySQL server you are trying to connect to is not available.
# If
! # !! you have already created the database tables, answer \"no\" below and
# !! start the MySQL server. If you're running it on your local machine,
! # !! executing \'/etc/init.d/mysql restart\' as root would suffice.\n";
$input = "";
--- 146,158 ----
AutoCommit => 1} )
or warn "\n$0: WARNING: Could not connect to the database!\
! !! This probably means that the AudioLink database is not initialized,
! !! the MySQL server you are trying to connect to is not available,
! !! or the username/password for authentication are not valid.
!
! !! If you don't see a success message below, something is wrong.\n";
# If
! # !! you have already created the database tables, answer "no" below and
# !! start the MySQL server. If you're running it on your local machine,
! # !! executing `/etc/init.d/mysql restart` as root would suffice.\n";
$input = "";
***************
*** 151,155 ****
$db_name = "aldb";
! print "\nCreating the AudioLink database...";
$ret = system("mysqladmin -u$user -p$password -h$host create $db_name 2>/tmp/audiolink.db.tmp");
--- 173,177 ----
$db_name = "aldb";
! print "\nCreating the AudioLink database..." if $verbose;
$ret = system("mysqladmin -u$user -p$password -h$host create $db_name 2>/tmp/audiolink.db.tmp");
***************
*** 163,170 ****
while (<DBOP>) {
if ( /database exists/i) {
! print "The database already exists. Moving on to creating the tables...\n";
} else {
! print "Some error occured while creating the database:\n$_\n";
! print "Ask for help on the audiolink-users\@lists.sourceforge.net mailing list.\n";
}
}
--- 185,192 ----
while (<DBOP>) {
if ( /database exists/i) {
! print "The database already exists.\n" if $verbose;
} else {
! die "\nSome error occured while creating the database:\n$_\n"
! . "Ask for help on the audiolink-users\@lists.sourceforge.net mailing list.\n";
}
}
***************
*** 172,176 ****
close DBOP;
! print "\nCreating the AudioLink tables...";
$ret = system ("mysql -u$user -p$password -h$host $db_name < /usr/share/doc/audiolink/mysql.schema 2>/tmp/audiolink.tb.tmp");
--- 194,198 ----
close DBOP;
! print "\nCreating the AudioLink tables..." if $verbose;
$ret = system ("mysql -u$user -p$password -h$host $db_name < /usr/share/doc/audiolink/mysql.schema 2>/tmp/audiolink.tb.tmp");
***************
*** 183,190 ****
while (<DBOP>) {
if ( /already exists/i) {
! print "The table already exists.\n";
} else {
! print "Some error occured while creating the table:\n$_";
! print "Ask for help on the audiolink-users\@lists.sourceforge.net mailing list.\n";
}
}
--- 205,212 ----
while (<DBOP>) {
if ( /already exists/i) {
! print "The table already exists.\n" if $verbose;
} else {
! die "\nSome error occured while creating the table:\n$_"
! . "Ask for help on the audiolink-users\@lists.sourceforge.net mailing list.\n";
}
}
***************
*** 192,196 ****
$dbh->disconnect;
! print "\n\nAudioLink is now setup. You're now ready to run the program. Take a look at the AudioLink documentation\n";
print "available via the three man pages: audiolink(1), alfilldb(1), alsearch(1)\n";
print "\nReport positive or negative feedback on the audiolink-users\@lists.sourceforge.net mailing list.\n";
--- 214,218 ----
$dbh->disconnect;
! print "\nAudioLink is setup and ready to run. Take a look at the AudioLink documentation\n";
print "available via the three man pages: audiolink(1), alfilldb(1), alsearch(1)\n";
print "\nReport positive or negative feedback on the audiolink-users\@lists.sourceforge.net mailing list.\n";
***************
*** 229,232 ****
--- 251,257 ----
L<alsearch(1)> use.
+ The options specified on the command prompt override the options
+ specified in the config file.
+
=head1 OPTIONS
***************
*** 249,252 ****
--- 274,281 ----
Username for the database
+ =item B<--verbose>
+
+ Display extra information about what's going on
+
=back
***************
*** 296,300 ****
Specifying them in the config file (the most convenient). The config
file is stored in each user's home directory in the
! F<~/.audiolink/config> location.
=back
--- 325,329 ----
Specifying them in the config file (the most convenient). The config
file is stored in each user's home directory in the
! S<F<~/.audiolink/config>> location.
=back
***************
*** 302,318 ****
=head1 CONFIGURATION FILE
! The AudioLink configuration file resides in the .audiolink/ directory
! in the user's home directory (F<~/.audiolink/config>). This config
! file is perl code; it is included in the AudioLink scripts at
! run-time. This behavior will be changed in a later version, and a
! simple-to-understand format will be used.
! The format of the current config file is such: The option which you
! want to associate with a value is prepended with a '$' sign, and the
! value with which it is to be associated follows after an '=' sign. End
! the statement with a ';'. For example, if you want to associate the
! value of 'root' to the option 'user', you will use:
! C<$user = root;>
=head1 SEE ALSO
--- 331,346 ----
=head1 CONFIGURATION FILE
! The AudioLink configuration file F<config> resides in the
! F<.audiolink/> directory in the user's home directory
! (F<$HOME/.audiolink/config>).
! The format of the current config file is pretty easy to understand:
! Just put in C<a = b> on separate lines for all the options you want the
! AudioLink scripts to use by default. Here, a is the option name, like
! user, password, host, etc., and b is the value you wish to associate
! the option with. For example, to set the username for accessing the
! database to 'root', you would put this in the config file:
! C<user = root>
=head1 SEE ALSO
|
|
From: <ami...@us...> - 2003-12-05 09:41:02
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv10567 Modified Files: .cvsignore Log Message: ignore debian/ and gui/ Index: .cvsignore =================================================================== RCS file: /cvsroot/audiolink/audiolink/.cvsignore,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** .cvsignore 3 Nov 2003 13:05:11 -0000 1.2 --- .cvsignore 5 Dec 2003 09:40:59 -0000 1.3 *************** *** 1,2 **** --- 1,4 ---- patches + gui + debian ann |
|
From: <ami...@us...> - 2003-12-05 09:37:35
|
Update of /cvsroot/audiolink/audiolink/Documentation In directory sc8-pr-cvs1:/tmp/cvs-serv10163 Removed Files: alfilldb_usage.txt alsearch_usage.txt Log Message: remove the *_usage.txt files; we now have *_doc.html files. --- alfilldb_usage.txt DELETED --- --- alsearch_usage.txt DELETED --- |
|
From: <ami...@us...> - 2003-12-05 09:30:47
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv9192 Modified Files: INSTALL Log Message: You can now use the audiolink script to create the datbase and table. Index: INSTALL =================================================================== RCS file: /cvsroot/audiolink/audiolink/INSTALL,v retrieving revision 1.12 retrieving revision 1.13 diff -C2 -d -r1.12 -r1.13 *** INSTALL 29 Nov 2003 17:11:54 -0000 1.12 --- INSTALL 5 Dec 2003 09:30:44 -0000 1.13 *************** *** 78,82 **** You can directly run the scripts from the code/ directory. You can also run 'make install' to install these scripts system-wide, so that ! all the users on the local machine have access to them. --- 78,85 ---- You can directly run the scripts from the code/ directory. You can also run 'make install' to install these scripts system-wide, so that ! all the users on the local machine have access to them. You will need ! to run 'make install' so that the audiolink script works properly and ! the databases and tables are set up properly the first time you use ! AudioLink. *************** *** 84,103 **** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You'll have to create a database in MySQL before you use ! AudioLink. The following steps are just to be executed the first time ! you use AudioLink. You need not execute them each time you upgrade to ! a newer version of AudioLink. ! If you're using AudioLink v0.02 or greater, you can setup the database ! in two easy steps listed below: ! make createdb ! make insschema ! This will create the database and insert the schema. Make sure you ! have the DBI_USER and DBI_PASS environment variables set. See the ! audiolink(1) manpage or documentation in Documentation/ directory. ! If you want to create the database manually or you are using v0.01, ! run the following from the shell: (Assuming the user for the database is root. Change it to suit your --- 87,115 ---- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You'll have to create a database in MySQL before you use ! AudioLink. The audiolink script assists you in creating the database, ! set up tables and also enter frequently used values in a configuration ! file. ! Run the 'audiolink' script once you've installed AudioLink. This ! script will ask you certain questions related to logging into the ! database. After that, it proceeds to create the database and setup the ! tables. ! If you want to create the database manually, see the following section. ! Now populate the database with the code/alfilldb script. ! More documentation on the usage, etc. can be found in the manpages and ! the Documentation/ directory. ! ! Send feedback to aud...@li... ! ! Have fun :-) ! ! ! Creating the MySQL database and tables manually: ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ! If you want to create the AudioLink database manually, run the ! following from the shell: (Assuming the user for the database is root. Change it to suit your *************** *** 117,127 **** This will create the table for you. - - Now populate the database with the code/alfilldb script. - - More documentation on the usage, etc. can be found in the manpages and - the Documentation/ directory. - - Send feedback to aud...@li... - - Have fun :-) --- 129,130 ---- |
|
From: <ami...@us...> - 2003-12-05 09:22:21
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv8030 Modified Files: README Log Message: better 1st para Index: README =================================================================== RCS file: /cvsroot/audiolink/audiolink/README,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** README 29 Nov 2003 17:10:35 -0000 1.3 --- README 5 Dec 2003 09:22:18 -0000 1.4 *************** *** 16,21 **** be creating a directory with the name of the artist, and creating symbolic links to all the songs of that artist in this new ! directory. In this way, you have all his songs in one place... add all ! of these files in a playlist, and enjoy! :-) --- 16,22 ---- be creating a directory with the name of the artist, and creating symbolic links to all the songs of that artist in this new ! directory. In this way, you have all his songs in one place. This is ! just what AudioLink does... all you do is add all of these files in a ! playlist and enjoy! :-) |
|
From: <ami...@us...> - 2003-12-05 09:19:30
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv7550 Modified Files: TODO Log Message: 1. We have a config file 2. Debian packaging is done; get rpms done now. Index: TODO =================================================================== RCS file: /cvsroot/audiolink/audiolink/TODO,v retrieving revision 1.10 retrieving revision 1.11 diff -C2 -d -r1.10 -r1.11 *** TODO 14 Nov 2003 13:38:42 -0000 1.10 --- TODO 5 Dec 2003 09:19:24 -0000 1.11 *************** *** 15,21 **** * Support for crawling the LAN for NFS, SMB, FTP, etc protocols. ! * As we have something that works, support for building debian ! packages. If some developers can build .rpm's or other packages, ! they will be welcome too. * Plugin for some audio-playing software, which will allow searches, --- 15,19 ---- * Support for crawling the LAN for NFS, SMB, FTP, etc protocols. ! * Packaging in different formats: rpm, etc. (Debian's done) * Plugin for some audio-playing software, which will allow searches, *************** *** 31,35 **** * ID3v2 support ! * config files for default options: ~/.audiolink/config and /etc/audiolink/config * script that updates schema based on version numbers --- 29,33 ---- * ID3v2 support ! * print error messages, informational messages to STDERR * script that updates schema based on version numbers |
|
From: <ami...@us...> - 2003-12-04 16:21:48
|
Update of /cvsroot/audiolink/audiolink In directory sc8-pr-cvs1:/tmp/cvs-serv11510 Modified Files: Makefile Log Message: install code/audiolink create man page for code/audiolink Index: Makefile =================================================================== RCS file: /cvsroot/audiolink/audiolink/Makefile,v retrieving revision 1.21 retrieving revision 1.22 diff -C2 -d -r1.21 -r1.22 *** Makefile 29 Nov 2003 17:13:06 -0000 1.21 --- Makefile 4 Dec 2003 16:21:45 -0000 1.22 *************** *** 81,84 **** --- 81,85 ---- install code/alfilldb $(BIN) install code/alsearch $(BIN) + install code/audiolink $(BIN) # Generate HTML documentation *************** *** 92,95 **** --- 93,97 ---- $(Q)pod2man --section=$(MANEXT) code/alfilldb $(MAN)/alfilldb.$(MANEXT) $(Q)pod2man --section=$(MANEXT) code/alsearch $(MAN)/alsearch.$(MANEXT) + $(Q)pod2man --section=$(MANEXT) code/audiolink $(MAN)/audiolink.$(MANEXT) # Commit latest and tag the CVS with the release info |
|
From: <ami...@us...> - 2003-12-04 16:20:21
|
Update of /cvsroot/audiolink/audiolink/code
In directory sc8-pr-cvs1:/tmp/cvs-serv11258
Modified Files:
audiolink
Log Message:
1. documentation
2. create/modify config file based on user input if $user, $pass, $host not present
3. create database
4. create table
Index: audiolink
===================================================================
RCS file: /cvsroot/audiolink/audiolink/code/audiolink,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** audiolink 29 Nov 2003 17:27:55 -0000 1.2
--- audiolink 4 Dec 2003 16:20:17 -0000 1.3
***************
*** 27,30 ****
--- 27,200 ----
+ # Currently, we'll do the database setting up and the config file
+ # setting up here. Eventually, move this to alconf and aldbconf.
+
+ # First, detect if there's a config file in the home dir.
+
+
+ use DBI;
+ use Getopt::Long;
+
+ # Options for the database
+ $user = undef;
+ $password = undef;
+ $host = "localhost"; # use local mysql server by default
+
+
+ # ask_for_configfile_and_input: This function asks if the user wants
+ # to create a config file for the mandatory data she hasn't provided
+ # us with (user/passwd/host for the database).
+ #
+ # arg 1: String field of what's to be asked for.
+ #
+ # return: -1: User doesn't want to create a config file now.
+ # string: the string typed in by the user. Implies she wants a
+ # config file.
+
+ sub ask_for_configfile_and_input {
+
+ print STDERR "
+ You haven't specified the " . $_[0] . " field for the database. The
+ easiest way of doing this is by storing it in the AudioLink
+ configuration file. Would you like to do that now? [Yes/no] ";
+
+ chomp($input = <STDIN>);
+
+ unless ($input) {
+ $input = "yes";
+ }
+
+ unless ($input =~ /yes/i) {
+
+ print "\n\tQuitting now. See the audiolink(1) man page for
+ more information on the mandatory input information needed,
+ the config file and alternate ways of specifying the
+ information.\n";
+
+ # This is bad... don't quit from a subroutine!
+ close CONFFILE;
+ exit -1;
+ }
+
+ $input = "";
+
+ while (not $input) {
+ print STDERR "Please enter the " . $_[0] . " field for the database: ";
+
+ chomp($input = <STDIN>);
+ }
+ return $input;
+ }
+
+ GetOptions(
+ 'help' => \$help,
+ 'user=s' => \$user,
+ 'pass=s' => \$password,
+ 'host=s' => \$host,
+ ) or pod2usage();
+
+ if ($help) {
+ pod2usage();
+ }
+
+ $config_file = "$ENV{HOME}/.audiolink/config";
+
+ unless (do $config_file) {
+ warn "WARNING: Couldn't parse the config file, $config_file: $@" if $@;
+ warn "WARNING: Couldn't read the config file, $config_file: $!";
+ }
+
+ open(CONFFILE, ">>", $config_file);
+
+ unless ($user) {
+ $user = ask_for_configfile_and_input("username");
+ print CONFFILE '$user = ' . $user . ";\n";
+ }
+ unless ($password) {
+ $password = ask_for_configfile_and_input("password");
+ print CONFFILE '$password = ' . $password . ";\n";
+ }
+ unless ($host) {
+ $host = ask_for_configfile_and_input("host");
+ print CONFFILE '$host = ' . $host . ";\n";
+ }
+
+ # connect to the database.
+ $dbi_string = "DBI:mysql:aldb:$host"; # using MySQL
+
+ $dbh = DBI->connect($dbi_string,$user,$password,
+ { PrintError => 0,
+ AutoCommit => 1} )
+ or warn "\n$0: WARNING: Could not connect to the database!\
+ !! This probably means that the AudioLink database is not initialized or
+ !! the MySQL server you are trying to connect to is not available.
+ # If
+ # !! you have already created the database tables, answer \"no\" below and
+ # !! start the MySQL server. If you're running it on your local machine,
+ # !! executing \'/etc/init.d/mysql restart\' as root would suffice.\n";
+
+ $input = "";
+
+ # while (not $input) {
+ # print "\nShould I initialize the AudioLink database [Yes/no]? ";
+ # chomp($input = <STDIN>);
+
+ # unless ($input) {
+ # $input = "yes";
+ # }
+ # }
+
+ if ($input =~ /no/i) {
+ exit -2;
+ }
+
+ $db_name = "aldb";
+
+ print "\nCreating the AudioLink database...";
+
+ $ret = system("mysqladmin -u$user -p$password -h$host create $db_name 2>/tmp/audiolink.db.tmp");
+
+ # or print "\nSome error occured.
+ # If the error reported that the database already exists, it's okay. You already had the database created.
+ # If it was some other error, consult the mysqladmin man page and/or notify the AudioLink developers.\n
+ # Anyways, continuing to create AudioLink tables.\n";
+
+ open (DBOP, "/tmp/audiolink.db.tmp");
+ while (<DBOP>) {
+ if ( /database exists/i) {
+ print "The database already exists. Moving on to creating the tables...\n";
+ } else {
+ print "Some error occured while creating the database:\n$_\n";
+ print "Ask for help on the audiolink-users\@lists.sourceforge.net mailing list.\n";
+ }
+ }
+
+ close DBOP;
+
+ print "\nCreating the AudioLink tables...";
+
+ $ret = system ("mysql -u$user -p$password -h$host $db_name < /usr/share/doc/audiolink/mysql.schema 2>/tmp/audiolink.tb.tmp");
+ # or print "\nSome error occured.
+ # If the error reported that the table already exists, it's okay. You already had the table created.
+ # If it was some other error, consult the mysql man page and/or notify the AudioLink developers.\n";
+
+ open (DBOP, "/tmp/audiolink.tb.tmp");
+
+ while (<DBOP>) {
+ if ( /already exists/i) {
+ print "The table already exists.\n";
+ } else {
+ print "Some error occured while creating the table:\n$_";
+ print "Ask for help on the audiolink-users\@lists.sourceforge.net mailing list.\n";
+ }
+ }
+
+ $dbh->disconnect;
+
+ print "\n\nAudioLink is now setup. You're now ready to run the program. Take a look at the AudioLink documentation\n";
+ print "available via the three man pages: audiolink(1), alfilldb(1), alsearch(1)\n";
+ print "\nReport positive or negative feedback on the audiolink-users\@lists.sourceforge.net mailing list.\n";
+
+ exit 0;
=pod
***************
*** 32,50 ****
=head1 NAME
audiolink - Music collection manager
=head1 DESCRIPTION
! B<AudioLink> is a set of programs which help you manage your music
! collection.
! The programs that come with B<AudioLink> are alfilldb and alsearch.
! alfilldb(1)
! Creating symbolic links to the actual files is analogous to creating
! playlists in audio-playing software. Symbolic links are actually just
! point to the actual files on the hard disk;
The user and password fields for the database have to be
--- 202,255 ----
=head1 NAME
+ audiolink - Create AudioLink config file, databases and tables
+
+ =begin later
audiolink - Music collection manager
+ --- when everything is integrated
+
+ =end later
+
+ =head1 SYNOPSIS
+
+ audiolink [I<OPTION>]...
+
=head1 DESCRIPTION
! AudioLink is a set of programs which help you manage your music
! collection. It makes searching for music on your local storage media
! easier and faster. Your searches can include a variety of criteria,
! like male artists, female artists, band, genre, etc.
! It supports music files of MP3 and Ogg Vorbis formats.
! B<audiolink> assists you in creating a configuration file for oft-used
! options passed to the AudioLink programs and creating the MySQL
! database and tables which the AudioLink programs, L<alfilldb(1)> and
! L<alsearch(1)> use.
! =head1 OPTIONS
!
! =over
!
! =item B<--help>
!
! Brief usage information
!
! =item B<--host>=I<xxx>
!
! Connects to the MySQL server on the target host. Default is localhost.
!
! =item B<--pass>=I<xxx>
+ Password for the database
+
+ =item B<--user>=I<xxx>
+
+ Username for the database
+
+ =back
+
+ =head1 MORE INFORMATION
The user and password fields for the database have to be
***************
*** 58,68 ****
the programs:
- =over
-
C<alfilldb --user=mysql_username --pass=mysql_password --prompt=basic /songs/>
C<alsearch --user=mysql_username --pass=mysql_password --artist=kishore --td=/songs/kishore>
- =back
=item 2. Environment variables
--- 263,270 ----
***************
*** 71,77 ****
! If you're using bash, ksh, zsh or sh do this:
- =over
C<export DBI_USER=mysql_username>
--- 273,278 ----
! If you are using bash, ksh, zsh or sh do this:
C<export DBI_USER=mysql_username>
***************
*** 79,87 ****
C<export DBI_PASS=mysql_password>
- =back
! If you're using csh or tcsh, do this:
- =over
C<setenv DBI_USER mysql_username>
--- 280,286 ----
C<export DBI_PASS=mysql_password>
! If you are using csh or tcsh, do this:
C<setenv DBI_USER mysql_username>
***************
*** 89,93 ****
C<setenv DBI_USER mysql_password>
- =back
Consult the man page of the respective shell interpreter that you
--- 288,291 ----
***************
*** 101,104 ****
--- 299,352 ----
=back
+
+ =head1 CONFIGURATION FILE
+
+ The AudioLink configuration file resides in the .audiolink/ directory
+ in the user's home directory (F<~/.audiolink/config>). This config
+ file is perl code; it is included in the AudioLink scripts at
+ run-time. This behavior will be changed in a later version, and a
+ simple-to-understand format will be used.
+
+ The format of the current config file is such: The option which you
+ want to associate with a value is prepended with a '$' sign, and the
+ value with which it is to be associated follows after an '=' sign. End
+ the statement with a ';'. For example, if you want to associate the
+ value of 'root' to the option 'user', you will use:
+
+ C<$user = root;>
+
+ =head1 SEE ALSO
+
+ =begin man
+
+ L<alfilldb(1)>, L<alsearch(1)>
+
+ =end man
+
+ =begin html
+
+ <em><a href="alfilldb_doc.html">alfilldb(1)</a></em>,
+ <em><a href="alsearch_doc.html">alsearch(1)</a></em>
+
+ =end html
+
+ The current version of this man page is available on the AudioLink
+ website at E<lt>http://audiolink.sourceforge.net/E<gt>.
+
+ =head1 BUGS
+
+ Report bugs related to the AudioLink software or the man pages to the
+ audiolink-devel mailing list E<lt>aud...@li...<gt>.
+
+ =head1 AUTHOR
+
+ This manual page is written and maintained by Amit Shah E<lt>ami...@gm...<gt>
+
+ =head1 COPYRIGHT
+
+ The AudioLink package is Copyright (C) 2003, Amit Shah
+ E<lt>ami...@gm...<gt>. All the programs and the documentation that come
+ as part of AudioLink are licensed by the GNU General Public License v2
+ (GPLv2).
=cut
|
|
From: <ami...@us...> - 2003-12-04 16:13:10
|
Update of /cvsroot/audiolink/audiolink/code
In directory sc8-pr-cvs1:/tmp/cvs-serv9851
Modified Files:
alsearch
Log Message:
use pod2usage better
Index: alsearch
===================================================================
RCS file: /cvsroot/audiolink/audiolink/code/alsearch,v
retrieving revision 1.23
retrieving revision 1.24
diff -C2 -d -r1.23 -r1.24
*** alsearch 4 Dec 2003 16:09:43 -0000 1.23
--- alsearch 4 Dec 2003 16:13:07 -0000 1.24
***************
*** 152,156 ****
if (not @ARGV) {
pod2usage();
- exit;
}
--- 152,155 ----
***************
*** 178,186 ****
'genre=s' => \$genre,
'comment=s' => \$comment
! ) or pod2usage() and exit;
if ($help) {
pod2usage();
- exit;
}
--- 177,184 ----
'genre=s' => \$genre,
'comment=s' => \$comment
! ) or pod2usage();
if ($help) {
pod2usage();
}
|
