* docs/reference/tmpl/track.sgml

src/itdb.h
src/itdb_itunesdb.c
src/itdb_track.c: Added the following fields to Itdb_Track:

sort_artist
sort_title
sort_album
sort_albumartist
sort_composer
sort_tvshow

These fields can (theoretically) be used to force a certain sort
order on the iPod when displaying by artist, album...

Even though these fields are present in the iTunesDB, they are
discarded when reading the iTunesDB and applications must always
set them before writing the iTunesDB again. This is to avoid
that the fields 'artist' and 'sort_artist' accidentially get out
of sync.

libgpod will automatically create a sort_artist key for you if
artist is of the type 'The Artist' and sort_artist is not
set. The sort key used in that case is 'Artist, The' (followed
by five time 0x01), even though sort_artist itself will not be
touched.

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

1 files changed, 10 insertions, 1 deletions

diff --git a/docs/reference/tmpl/track.sgml b/docs/reference/tmpl/track.sgml
index ffc0028..9f4be02 100644
--- a/docs/reference/tmpl/track.sgml
+++ b/docs/reference/tmpl/track.sgml
@@ -44,7 +44,12 @@ information about an iPod track.
 @tvnetwork: 
 @albumartist: 
 @keywords: 
-@reserved: 
+@sort_artist: 
+@sort_title: 
+@sort_album: 
+@sort_albumartist: 
+@sort_composer: 
+@sort_tvshow: 
 @id: 
 @size: 
 @tracklen: 
@@ -132,6 +137,10 @@ information about an iPod track.
 @reserved_int6: 
 @reserved1: 
 @reserved2: 
+@reserved3: 
+@reserved4: 
+@reserved5: 
+@reserved6: 
 @usertype: 
 @userdata: 
 @userdata_duplicate: