[Gtkpod-devel] cleanups

[Sam C. <sa...@su...>]

Hi guys..

I just finished my MSc and so I now have more time to play
with my iPod.

I would like to make some superficial but widespread changes to
gtkpod to make it simpler to navigate.  I'll number them so
we can discuss them separately.

1: I'd like to add $id$ to every source file in the header.=20

2: I'd like to make the global naming cleaner and more modular.
I've started with playlists.  My new playlists.h looks like this:

void      pl_create_mpl         ();
Playlist* pl_add_new            (gchar *plname, gint position);
void      pl_free               (Playlist *playlist);
Playlist* pl_add_playlist       (Playlist *plitem, gint ylist *playlist, gi=
nt pos);
void      pl_remove             (Playlist *playlist);
void      pl_remove_all         ();

Note the indentation, naming conventions and shorter function
names.  I have these changes made locally and can commit them if
nobody objects.

3: I'd like to convert function comments to a common format.
For example the javadoc style:

/**
 * bar is a function
 * @param foo is a foo arg
 * @returns some value
 */

4: I'd like to start using "track" rather than "song" whereever
possible.  I think this makes for sense.

Thats all I can think of for now..=20

sam
--=20
Sam clegg
:: sa...@su... :: http://superduper.net/ :: PGP : D91EE369=20
$superduper: .signature,v 1.13 2003/06/17 10:29:24 sam Exp $