# HG changeset patch
# User Eugene Zagidullin <e.asphyx@gmail.com>
# Date 1196197168 -10800
# Node ID d342cfceb294382c3c9c56f035b15e13707dee53
# Parent  0f3cd542f23ad0620586ff18bb3e29f2df3823e5
added some comments to plugin.h about update_song_tuple()

diff -r 0f3cd542f23a -r d342cfceb294 src/audacious/plugin.h
--- a/src/audacious/plugin.h	Tue Nov 27 23:39:25 2007 +0300
+++ b/src/audacious/plugin.h	Tue Nov 27 23:59:28 2007 +0300
@@ -1087,6 +1087,17 @@
 
     /* Added in Audacious 1.5.0 */
     gboolean (*update_song_tuple)(Tuple *tuple, VFSFile *fd);
+    /* 
+     * Plugin can provide this function for file metadata (aka tag) writing functionality
+     * in case when no reason to provide its own custom file info dialog. Thus in most cases.
+     *
+     * Some notes:
+     *
+     * 1. In current Audacious version, if plugin provides file_info_box(), the latter will be used in any case.
+     * 2. Each field in tuple means operation on one and only one tag's filed:
+     *     2.1. Set this field to appropriate value, if non-empty string or positive number provided.
+     *     2.2. Set this field to blank (or just delete, at plugins`s discretion), if empty string or negative number provided.
+     */
 };
 
 struct _GeneralPlugin {