Documentation: update API docs

Add new functions to the proper places in the documentation, remove
old/unused functions, and clean up various minor issues.

7 files changed, 297 insertions, 37 deletions

diff --git a/docs/reference/libgpod-docs.xml b/docs/reference/libgpod-docs.xml
index c6c46b6..4c999fe 100644
--- a/docs/reference/libgpod-docs.xml
+++ b/docs/reference/libgpod-docs.xml
@@ -26,7 +26,7 @@
       </author>
     </authorgroup>
     <copyright>
-      <year>2006</year>
+      <year>2006-2008</year>
       <holder>Christophe Fergeau</holder>
     </copyright>
 
@@ -88,6 +88,7 @@
       <xi:include href="xml/playlists.xml"/>
       <xi:include href="xml/smart-playlists.xml"/>
       <xi:include href="xml/artwork.xml"/>
+      <xi:include href="xml/chapterdata.xml"/>
       <xi:include href="xml/device.xml"/>
     </chapter>
   </part>
diff --git a/docs/reference/libgpod-sections.txt b/docs/reference/libgpod-sections.txt
index 7b7e217..a930fe7 100644
--- a/docs/reference/libgpod-sections.txt
+++ b/docs/reference/libgpod-sections.txt
@@ -79,6 +79,8 @@ itdb_track_by_id
 itdb_track_id_tree_create
 itdb_track_id_tree_destroy
 itdb_track_id_tree_by_id
+itdb_track_get_thumbnail
+itdb_track_has_thumbnails
 itdb_track_set_thumbnails
 itdb_track_set_thumbnails_from_data
 itdb_track_set_thumbnails_from_pixbuf
@@ -150,6 +152,22 @@ itdb_spl_update_live
 </SECTION>
 
 <SECTION>
+<FILE>chapterdata</FILE>
+<TITLE>Chapter Data</TITLE>
+Itdb_Chapter
+Itdb_Chapterdata
+itdb_chapter_new
+itdb_chapter_duplicate
+itdb_chapter_free
+itdb_chapterdata_new
+itdb_chapterdata_add_chapter
+itdb_chapterdata_duplicate
+itdb_chapterdata_remove_chapter
+itdb_chapterdata_remove_chapters
+itdb_chapterdata_free
+</SECTION>
+
+<SECTION>
 <FILE>device</FILE>
 <TITLE>Device</TITLE>
 Itdb_Device
@@ -163,6 +181,7 @@ itdb_device_write_sysinfo
 itdb_device_get_ipod_info
 itdb_device_supports_artwork
 itdb_device_supports_photo
+itdb_device_supports_video
 itdb_info_get_ipod_info_table
 itdb_info_get_ipod_generation_string
 itdb_info_get_ipod_model_name_string
@@ -181,11 +200,15 @@ Itdb_Thumb
 itdb_artwork_new
 itdb_artwork_duplicate
 itdb_artwork_free
+itdb_artwork_get_pixbuf
+itdb_artwork_set_thumbnail
 itdb_artwork_set_thumbnail_from_data
 itdb_artwork_set_thumbnail_from_pixbuf
 itdb_artwork_remove_thumbnails
 itdb_thumb_duplicate
 itdb_thumb_free
+itdb_thumb_to_pixbuf_at_size
+itdb_thumb_to_pixbufs
 </SECTION>
 
 <SECTION>
@@ -210,24 +233,18 @@ itdb_photodb_write
 <SECTION>
 <FILE>Internal</FILE>
 <SUBSECTION Private>
+DEBUG_ARTWORK
 G_GNUC_INTERNAL
-g_stat
-g_mkdir
-g_rename
-g_printf
-G_IS_DIR_SEPARATOR
 dump_mhif
 dump_mhia
-dump_mhod_type_1
-dump_mhod_type_3
 dump_mhni
 dump_mhod
+dump_mhod_string
 dump_mhii
 dump_mhl
 dump_mhsd
 dump_mhfd
 dump_mhba
-ITUNESDB_MAX_SIZE
 MHeader
 MhlHeader
 MhbdHeader
@@ -238,6 +255,7 @@ MhypHeader
 MhipHeader
 MhitHeader
 ArtworkDB_MhodHeader
+ArtworkDB_MhodHeaderString
 MhfdHeader
 MhliHeader
 MhiiHeader
@@ -248,28 +266,15 @@ MhlfHeader
 MhifHeader
 MhiaHeader
 MhitHeader471
-ArtworkDB_MhodHeaderArtworkType3
 MhodHeaderString
-MhodHeaderArtworkType1
 MhodHeaderSmartPlaylistData
 MhodHeaderSmartPlaylistRuleString
 MhodHeaderSmartPlaylistRuleNonString
 MhodHeaderSmartPlaylistRule
 iTunesDB_MhsdHeader
 MhodHeader
-MhodHeaderArtworkType3
-playcount
 NO_PLAYCOUNT
 WCONTENTS_STEPSIZE
-RED_BITS
-RED_SHIFT
-RED_MASK
-GREEN_BITS
-GREEN_SHIFT
-GREEN_MASK
-BLUE_BITS
-BLUE_SHIFT
-BLUE_MASK
 DBParseContext
 db_parse_context_get_m_header
 iPodSong
@@ -278,9 +283,62 @@ DB_TO_CPU_GET_DB
 ItdbFileError
 ITDB_FILE_ERROR
 itdb_file_error_quark
-itdb_get_artwork_info_from_type
+ITDB_DEVICE_ERROR
+ItdbDeviceError
+itdb_device_error_quark
 DbType
 Itdb_DB
+ItdbThumbDataType
+
+GChecksum
+GChecksumType
+g_checksum_copy
+g_checksum_free
+g_checksum_get_digest
+g_checksum_get_string
+g_checksum_new
+g_checksum_type_get_length
+g_checksum_update
+g_compute_checksum_for_data
+g_compute_checksum_for_string
+
+SysInfoIpodProperties
+itdb_sysinfo_extended_parse
+itdb_sysinfo_properties_free
+
+ALPHA_BITS_555
+ALPHA_BITS_888
+ALPHA_MASK_555
+ALPHA_MASK_888
+ALPHA_SHIFT_555
+ALPHA_SHIFT_888
+BLUE_BITS_555
+BLUE_BITS_565
+BLUE_BITS_888
+BLUE_MASK_555
+BLUE_MASK_565
+BLUE_MASK_888
+BLUE_SHIFT_555
+BLUE_SHIFT_565
+BLUE_SHIFT_888
+GREEN_BITS_555
+GREEN_BITS_565
+GREEN_BITS_888
+GREEN_MASK_555
+GREEN_MASK_565
+GREEN_MASK_888
+GREEN_SHIFT_555
+GREEN_SHIFT_565
+GREEN_SHIFT_888
+RED_BITS_555
+RED_BITS_565
+RED_BITS_888
+RED_MASK_555
+RED_MASK_565
+RED_MASK_888
+RED_SHIFT_555
+RED_SHIFT_565
+RED_SHIFT_888
 
 ITDB_SPLACTION_LAST_HOURS_VALUE
 ITDB_SPLACTION_LAST_MINUTES_VALUE
@@ -296,5 +354,15 @@ ITDB_SPLACTION_LAST_QUARTER
 ITDB_SPLACTION_LAST_SOLAR_YEAR
 ITDB_SPLACTION_LAST_SIDEREAL_YEAR
 
+SHA_BLOCKSIZE
+SHA_BYTE
+SHA_BYTE_ORDER
+SHA_DIGESTSIZE
+SHA_INFO
+SHA_LONG
+SHA_VERSION
+sha_final
+sha_init
+sha_update
+itdb_compute_hash
 </SECTION>
-
diff --git a/docs/reference/tmpl/artwork.sgml b/docs/reference/tmpl/artwork.sgml
index a93704b..70cdc4a 100644
--- a/docs/reference/tmpl/artwork.sgml
+++ b/docs/reference/tmpl/artwork.sgml
@@ -75,6 +75,30 @@ album/track artwork.  For working with photos, see the
 @artwork: 
 
 
+<!-- ##### FUNCTION itdb_artwork_get_pixbuf ##### -->
+<para>
+
+</para>
+
+@device: 
+@artwork: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_artwork_set_thumbnail ##### -->
+<para>
+
+</para>
+
+@artwork: 
+@filename: 
+@rotation: 
+@error: 
+@Returns: 
+
+
 <!-- ##### FUNCTION itdb_artwork_set_thumbnail_from_data ##### -->
 <para>
 
@@ -125,3 +149,25 @@ album/track artwork.  For working with photos, see the
 @thumb: 
 
 
+<!-- ##### FUNCTION itdb_thumb_to_pixbuf_at_size ##### -->
+<para>
+
+</para>
+
+@device: 
+@thumb: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_thumb_to_pixbufs ##### -->
+<para>
+
+</para>
+
+@device: 
+@thumb: 
+@Returns: 
+
+
diff --git a/docs/reference/tmpl/chapterdata.sgml b/docs/reference/tmpl/chapterdata.sgml
new file mode 100644
index 0000000..f76f63b
--- /dev/null
+++ b/docs/reference/tmpl/chapterdata.sgml
@@ -0,0 +1,123 @@
+<!-- ##### SECTION Title ##### -->
+Chapter Data
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT Itdb_Chapter ##### -->
+<para>
+
+</para>
+
+@startpos: 
+@chaptertitle: 
+@reserved_int1: 
+@reserved_int2: 
+@reserved1: 
+@reserved2: 
+
+<!-- ##### STRUCT Itdb_Chapterdata ##### -->
+<para>
+
+</para>
+
+@chapters: 
+@unk024: 
+@unk028: 
+@unk032: 
+@reserved_int1: 
+@reserved_int2: 
+@reserved1: 
+@reserved2: 
+
+<!-- ##### FUNCTION itdb_chapter_new ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_chapter_duplicate ##### -->
+<para>
+
+</para>
+
+@chapter: 
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_chapter_free ##### -->
+<para>
+
+</para>
+
+@chapter: 
+
+
+<!-- ##### FUNCTION itdb_chapterdata_new ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_chapterdata_add_chapter ##### -->
+<para>
+
+</para>
+
+@chapterdata: 
+@startpos: 
+@chaptertitle: 
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_chapterdata_duplicate ##### -->
+<para>
+
+</para>
+
+@chapterdata: 
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_chapterdata_remove_chapter ##### -->
+<para>
+
+</para>
+
+@chapterdata: 
+@chapter: 
+
+
+<!-- ##### FUNCTION itdb_chapterdata_remove_chapters ##### -->
+<para>
+
+</para>
+
+@chapterdata: 
+
+
+<!-- ##### FUNCTION itdb_chapterdata_free ##### -->
+<para>
+
+</para>
+
+@chapterdata: 
+
+
diff --git a/docs/reference/tmpl/device.sgml b/docs/reference/tmpl/device.sgml
index c4b69e6..124db61 100644
--- a/docs/reference/tmpl/device.sgml
+++ b/docs/reference/tmpl/device.sgml
@@ -121,6 +121,15 @@ These functions are for reading and setting information about the iPod.
 @Returns: 
 
 
+<!-- ##### FUNCTION itdb_device_supports_video ##### -->
+<para>
+
+</para>
+
+@device: 
+@Returns: 
+
+
 <!-- ##### FUNCTION itdb_info_get_ipod_info_table ##### -->
 <para>
 
diff --git a/docs/reference/tmpl/libgpod-unused.sgml b/docs/reference/tmpl/libgpod-unused.sgml
index ccbb77d..8df8383 100644
--- a/docs/reference/tmpl/libgpod-unused.sgml
+++ b/docs/reference/tmpl/libgpod-unused.sgml
@@ -129,23 +129,16 @@ iTunesDB
 @ITDB_FILE_ERROR_RENAME: 
 @ITDB_FILE_ERROR_ITDB_CORRUPT: 
 
-<!-- ##### ENUM ItdbThumbType ##### -->
+<!-- ##### ENUM ItdbThumbDataType ##### -->
 <para>
 
 </para>
 
-@ITDB_THUMB_COVER_SMALL: 
-@ITDB_THUMB_COVER_LARGE: 
-@ITDB_THUMB_PHOTO_SMALL: 
-@ITDB_THUMB_PHOTO_LARGE: 
-@ITDB_THUMB_PHOTO_FULL_SCREEN: 
-@ITDB_THUMB_PHOTO_TV_SCREEN: 
-@ITDB_THUMB_COVER_XLARGE: 
-@ITDB_THUMB_COVER_MEDIUM: 
-@ITDB_THUMB_COVER_SMEDIUM: 
-@ITDB_THUMB_COVER_XSMALL: 
-@ITDB_THUMB_CHAPTER_SMALL: 
-@ITDB_THUMB_CHAPTER_LARGE: 
+@ITDB_THUMB_TYPE_INVALID: 
+@ITDB_THUMB_TYPE_FILE: 
+@ITDB_THUMB_TYPE_MEMORY: 
+@ITDB_THUMB_TYPE_PIXBUF: 
+@ITDB_THUMB_TYPE_IPOD: 
 
 <!-- ##### ENUM Itdb_Generation ##### -->
 <para>
diff --git a/docs/reference/tmpl/track.sgml b/docs/reference/tmpl/track.sgml
index 3a3c14f..a6ff7fb 100644
--- a/docs/reference/tmpl/track.sgml
+++ b/docs/reference/tmpl/track.sgml
@@ -252,6 +252,26 @@ information about an iPod track.
 @Returns: 
 
 
+<!-- ##### FUNCTION itdb_track_get_thumbnail ##### -->
+<para>
+
+</para>
+
+@track: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION itdb_track_has_thumbnails ##### -->
+<para>
+
+</para>
+
+@track: 
+@Returns: 
+
+
 <!-- ##### FUNCTION itdb_track_set_thumbnails ##### -->
 <para>