* docs/reference/tmpl/device.sgml

docs/reference/tmpl/itunesdb-time.sgml
docs/reference/tmpl/libgpod-unused.sgml
docs/reference/tmpl/track.sgml
src/db-artwork-parser.c
src/db-artwork-writer.c
src/db-itunes-parser.h
src/itdb.h
src/itdb_device.c
src/itdb_device.h
src/itdb_itunesdb.c
src/itdb_private.h
tests/Makefile.am:

Christophe's patch for automatic correction of timestamps
depending on which timezone the iPod is set to.

ATTENTION DEVELOPERS: as a consequence all exported timestamps
are no longer guint32 mac-type timestamps but standard time_t
timestamps. This also includes the 64 bit timestamps in smart
playlists. The following functions are therefore no longer
needed and are deprecated:

itdb_time_mac_to_host(), itdb_time_host_to_mac(): simply return
the argument without changing it. Argument and return value are
now both of type 'time_t'.

itunesdb_time_get_mac_time(): returns the seconds passed since
Epoch in seconds and is equivalent to time(NULL).

These functions may be removed in a future version of
libgpod. Programs linking to libgpod may need to be changed
slightly if they made any assumptions on the type of timestamps
used. This should be obvious through compile-time warnings.

tests/test-ls.c: print a list of recently played tracks.

git-svn-id: https://gtkpod.svn.sf.net/svnroot/gtkpod/libgpod/trunk@1417 f01d2545-417e-4e96-918e-98f8d0dbbcb6

4 files changed, 23 insertions, 21 deletions

diff --git a/docs/reference/tmpl/device.sgml b/docs/reference/tmpl/device.sgml
index 6ca9191..4323e53 100644
--- a/docs/reference/tmpl/device.sgml
+++ b/docs/reference/tmpl/device.sgml
@@ -27,6 +27,7 @@ These functions are for reading and setting information about the iPod.
 @byte_order: 
 @sysinfo: 
 @sysinfo_changed: 
+@timezone_shift: 
 
 <!-- ##### FUNCTION itdb_device_new ##### -->
 <para>
@@ -101,24 +102,6 @@ These functions are for reading and setting information about the iPod.
 @Returns: 
 
 
-<!-- ##### FUNCTION itdb_device_supports_artwork ##### -->
-<para>
-
-</para>
-
-@device: 
-@Returns: 
-
-
-<!-- ##### FUNCTION itdb_device_supports_photo ##### -->
-<para>
-
-</para>
-
-@device: 
-@Returns: 
-
-
 <!-- ##### FUNCTION itdb_info_get_ipod_info_table ##### -->
 <para>
 
diff --git a/docs/reference/tmpl/itunesdb-time.sgml b/docs/reference/tmpl/itunesdb-time.sgml
index 3f75abb..aeee4fb 100644
--- a/docs/reference/tmpl/itunesdb-time.sgml
+++ b/docs/reference/tmpl/itunesdb-time.sgml
@@ -6,7 +6,10 @@ Helper functions to convert between Epoch time and Mac (iPod) time
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-The functions provide conversion between Epoch time and Mac (iPod) time
+The functions provide conversion between Epoch time and Mac (iPod) time. These 
+functions are now obsolete and should no longer be used, libgpod automatically
+converts to/from Epoch time and iPod time when writing/reading the iPod 
+databases
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -30,7 +33,7 @@ The functions provide conversion between Epoch time and Mac (iPod) time
 
 </para>
 
-@mactime: 
+@time: 
 @Returns: 
 
 
diff --git a/docs/reference/tmpl/libgpod-unused.sgml b/docs/reference/tmpl/libgpod-unused.sgml
index aaf7c7f..ebb16c4 100644
--- a/docs/reference/tmpl/libgpod-unused.sgml
+++ b/docs/reference/tmpl/libgpod-unused.sgml
@@ -153,6 +153,22 @@ iTunesDB
 </para>
 
 
+<!-- ##### FUNCTION itdb_device_supports_artwork ##### -->
+<para>
+
+</para>
+
+@device: 
+@Returns: 
+
+<!-- ##### FUNCTION itdb_device_supports_photo ##### -->
+<para>
+
+</para>
+
+@device: 
+@Returns: 
+
 <!-- ##### FUNCTION itdb_file_error_quark ##### -->
 <para>
 
diff --git a/docs/reference/tmpl/track.sgml b/docs/reference/tmpl/track.sgml
index 658d51e..95c2550 100644
--- a/docs/reference/tmpl/track.sgml
+++ b/docs/reference/tmpl/track.sgml
@@ -59,8 +59,8 @@ information about an iPod track.
 @volume: 
 @soundcheck: 
 @time_added: 
-@time_played: 
 @time_modified: 
+@time_played: 
 @bookmark_time: 
 @rating: 
 @playcount: