summaryrefslogtreecommitdiffstats
path: root/src/itdb_playlist.c
diff options
context:
space:
mode:
Diffstat (limited to 'src/itdb_playlist.c')
-rw-r--r--src/itdb_playlist.c78
1 files changed, 20 insertions, 58 deletions
diff --git a/src/itdb_playlist.c b/src/itdb_playlist.c
index 2fbc691..9acd695 100644
--- a/src/itdb_playlist.c
+++ b/src/itdb_playlist.c
@@ -1,7 +1,7 @@
/*
| Copyright (C) 2002-2005 Jorg Schuler <jcsjcs at users sourceforge net>
| Part of the gtkpod project.
-|
+|
| URL: http://www.gtkpod.org/
| URL: http://gtkpod.sourceforge.net/
|
@@ -135,14 +135,13 @@ ItdbSPLFieldType itdb_splr_get_field_type (const Itdb_SPLRule *splr)
return(ITDB_SPLFT_UNKNOWN);
}
-
/**
* itdb_splr_get_action_type:
* @splr: an #Itdb_SPLRule
- *
+ *
* Gets the type of the action associated with @splr.
*
- * Return value: type (range, date, string...) of the action field
+ * Return value: type (range, date, string...) of the action field
**/
ItdbSPLActionType itdb_splr_get_action_type (const Itdb_SPLRule *splr)
{
@@ -319,7 +318,6 @@ ItdbSPLActionType itdb_splr_get_action_type (const Itdb_SPLRule *splr)
*
*/
-
/**
* itdb_splr_eval:
* @splr: an #Itdb_SPLRule
@@ -678,7 +676,6 @@ static GList *randomize_glist (GList *list)
return list;
}
-
/**
* itdb_playlist_randomize:
* @pl: an #Itdb_Playlist to randomize
@@ -692,7 +689,6 @@ void itdb_playlist_randomize (Itdb_Playlist *pl)
pl->members = randomize_glist (pl->members);
}
-
/**
* itdb_spl_update:
* @spl: an #Itdb_Playlist
@@ -908,7 +904,6 @@ void itdb_spl_update (Itdb_Playlist *spl)
}
}
-
/**
* itdb_spl_update_all:
* @itdb: an #Itdb_iTunesDB
@@ -930,8 +925,7 @@ static void spl_update2 (Itdb_Playlist *playlist, gpointer data)
itdb_spl_update (playlist);
}
-
-/**
+/**
* itdb_spl_update_live:
* @itdb: an #Itdb_iTunesDB
*
@@ -949,7 +943,6 @@ void itdb_spl_update_live (Itdb_iTunesDB *itdb)
/* end of code based on Samuel Wood's work */
/* ------------------------------------------------------------------- */
-
/**
* itdb_splr_validate:
* @splr: an #Itdb_SPLRule
@@ -1007,12 +1000,11 @@ void itdb_splr_validate (Itdb_SPLRule *splr)
}
-
/**
* itdb_splr_free:
* @splr: an #Itdb_SPLRule
*
- * Frees the memory used by @splr
+ * Frees the memory used by @splr
**/
void itdb_splr_free (Itdb_SPLRule *splr)
{
@@ -1059,13 +1051,12 @@ void itdb_splr_add (Itdb_Playlist *pl, Itdb_SPLRule *splr, gint pos)
splr, pos);
}
-
/**
* itdb_splr_new:
- *
- * Creates a new default smart rule
*
- * Return value: a new #Itdb_SPLRule that must be freed with itdb_splr_free() when
+ * Creates a new default smart rule
+ *
+ * Return value: a new #Itdb_SPLRule that must be freed with itdb_splr_free() when
* no longer needed
**/
Itdb_SPLRule *itdb_splr_new (void)
@@ -1084,7 +1075,6 @@ Itdb_SPLRule *itdb_splr_new (void)
return splr;
}
-
/**
* itdb_splr_add_new:
* @pl: an #Itdb_Playlist
@@ -1122,7 +1112,6 @@ static Itdb_SPLRule *splr_duplicate (Itdb_SPLRule *splr)
return dup;
}
-
/**
* itdb_playlist_duplicate:
* @pl: an #Itdb_Playlist
@@ -1175,7 +1164,6 @@ Itdb_Playlist *itdb_playlist_duplicate (Itdb_Playlist *pl)
return pl_dup;
}
-
/**
* itdb_spl_copy_rules:
* @dest: destination #Itdb_Playlist
@@ -1212,8 +1200,6 @@ void itdb_spl_copy_rules (Itdb_Playlist *dest, Itdb_Playlist *src)
}
}
-
-
/**
* itdb_playlist_new:
* @title: playlist title
@@ -1253,12 +1239,11 @@ Itdb_Playlist *itdb_playlist_new (const gchar *title, gboolean spl)
return pl;
}
-
/**
* itdb_playlist_free:
* @pl: an #Itdb_Playlist
*
- * Frees the memory used by playlist @pl.
+ * Frees the memory used by playlist @pl.
**/
void itdb_playlist_free (Itdb_Playlist *pl)
{
@@ -1273,8 +1258,6 @@ void itdb_playlist_free (Itdb_Playlist *pl)
g_free (pl);
}
-
-
/**
* itdb_playlist_add:
* @itdb: an #Itdb_iTunesDB
@@ -1322,14 +1305,12 @@ void itdb_playlist_add (Itdb_iTunesDB *itdb, Itdb_Playlist *pl, gint32 pos)
itdb->playlists = g_list_insert (itdb->playlists, pl, pos);
}
-
-
/**
* itdb_playlist_move:
* @pl: an #Itdb_Playlist
* @pos: new position
*
- * Moves playlist @pl to position @pos
+ * Moves playlist @pl to position @pos
**/
void itdb_playlist_move (Itdb_Playlist *pl, guint32 pos)
{
@@ -1343,13 +1324,12 @@ void itdb_playlist_move (Itdb_Playlist *pl, guint32 pos)
itdb->playlists = g_list_insert (itdb->playlists, pl, pos);
}
-
/**
* itdb_playlist_remove:
* @pl: an #Itdb_Playlist
- *
- * Removes @pl from the #Itdb_iTunesDB it's associated with
- * and frees memory
+ *
+ * Removes @pl from the #Itdb_iTunesDB it's associated with
+ * and frees memory
**/
void itdb_playlist_remove (Itdb_Playlist *pl)
{
@@ -1363,7 +1343,6 @@ void itdb_playlist_remove (Itdb_Playlist *pl)
itdb_playlist_free (pl);
}
-
/**
* itdb_playlist_unlink:
* @pl: an #Itdb_Playlist
@@ -1383,7 +1362,6 @@ void itdb_playlist_unlink (Itdb_Playlist *pl)
pl->itdb = NULL;
}
-
/**
* itdb_playlist_exists:
* @itdb: an #Itdb_iTunesDB
@@ -1402,7 +1380,6 @@ gboolean itdb_playlist_exists (Itdb_iTunesDB *itdb, Itdb_Playlist *pl)
else return FALSE;
}
-
/**
* itdb_playlist_add_track:
* @pl: an #Itdb_Playlist
@@ -1424,8 +1401,6 @@ void itdb_playlist_add_track (Itdb_Playlist *pl,
pl->members = g_list_insert (pl->members, track, pos);
}
-
-
/**
* itdb_playlist_remove_track:
* @pl: an #Itdb_Playlist
@@ -1448,13 +1423,12 @@ void itdb_playlist_remove_track (Itdb_Playlist *pl, Itdb_Track *track)
pl->members = g_list_remove (pl->members, track);
}
-
/**
* itdb_playlist_by_id:
* @itdb: an #Itdb_iTunesDB
* @id: ID of the playlist to look for
*
- * Looks up a playlist whose ID is @id
+ * Looks up a playlist whose ID is @id
*
* Return value: the #Itdb_Playlist with ID @id or NULL if there is no such
* playlist.
@@ -1473,7 +1447,6 @@ Itdb_Playlist *itdb_playlist_by_id (Itdb_iTunesDB *itdb, guint64 id)
return NULL;
}
-
/**
* itdb_playlist_by_nr:
* @itdb: an #Itdb_iTunesDB
@@ -1492,7 +1465,6 @@ Itdb_Playlist *itdb_playlist_by_nr (Itdb_iTunesDB *itdb, guint32 num)
return pl;
}
-
/**
* itdb_playlist_by_name:
* @itdb: an #Itdb_iTunesDB
@@ -1519,14 +1491,13 @@ Itdb_Playlist *itdb_playlist_by_name (Itdb_iTunesDB *itdb, gchar *name)
return NULL;
}
-
/**
* itdb_playlist_is_mpl:
* @pl: an #Itdb_Playlist
*
- * Checks if @pl is the master playlist
+ * Checks if @pl is the master playlist
*
- * Return value: TRUE if @pl is the master playlist, FALSE otherwise
+ * Return value: TRUE if @pl is the master playlist, FALSE otherwise
**/
gboolean itdb_playlist_is_mpl (Itdb_Playlist *pl)
{
@@ -1535,14 +1506,13 @@ gboolean itdb_playlist_is_mpl (Itdb_Playlist *pl)
return ((pl->type & 0xff) == ITDB_PL_TYPE_MPL);
}
-
/**
* itdb_playlist_is_podcasts:
* @pl: an #Itdb_Playlist
*
* Checks if @pl is the podcasts playlist
*
- * Return value: TRUE if @pl is the podcasts playlist, FALSE otherwise
+ * Return value: TRUE if @pl is the podcasts playlist, FALSE otherwise
**/
gboolean itdb_playlist_is_podcasts (Itdb_Playlist *pl)
{
@@ -1551,7 +1521,6 @@ gboolean itdb_playlist_is_podcasts (Itdb_Playlist *pl)
return (pl->podcastflag == ITDB_PL_FLAG_PODCASTS);
}
-
/**
* itdb_playlist_set_mpl:
* @pl: an #Itdb_Playlist
@@ -1565,12 +1534,11 @@ void itdb_playlist_set_mpl (Itdb_Playlist *pl)
pl->type = ITDB_PL_TYPE_MPL;
}
-
/**
* itdb_playlist_set_podcasts:
* @pl: an #Itdb_Playlist
*
- * Set @pl to be a podcasts playlist
+ * Set @pl to be a podcasts playlist
**/
void itdb_playlist_set_podcasts (Itdb_Playlist *pl)
{
@@ -1579,14 +1547,13 @@ void itdb_playlist_set_podcasts (Itdb_Playlist *pl)
pl->podcastflag = ITDB_PL_FLAG_PODCASTS;
}
-
/**
* itdb_playlist_mpl:
* @itdb: an #Itdb_iTunesDB
- *
+ *
* Gets the master playlist of @itdb
*
- * Return value: the master playlist of @itdb
+ * Return value: the master playlist of @itdb
**/
Itdb_Playlist *itdb_playlist_mpl (Itdb_iTunesDB *itdb)
{
@@ -1629,8 +1596,6 @@ Itdb_Playlist *itdb_playlist_podcasts (Itdb_iTunesDB *itdb)
return NULL;
}
-
-
/**
* itdb_playlist_contains_track:
* @pl: an #Itdb_Playlist
@@ -1653,7 +1618,6 @@ gboolean itdb_playlist_contains_track (Itdb_Playlist *pl, Itdb_Track *tr)
else return FALSE;
}
-
/**
* itdb_playlist_contain_track_number:
* @tr: an #Itdb_Track
@@ -1684,8 +1648,6 @@ guint32 itdb_playlist_contain_track_number (Itdb_Track *tr)
return num;
}
-
-
/**
* itdb_playlist_tracks_number:
* @pl: an #Itdb_Playlist
generated by cgit (git 2.34.1) at 2025-07-03 15:02:00 +0000