* NEWS: update for 0.6.0 release

* README.SysInfo: explain how to get the firewire id from an iPod Touch


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

3 files changed, 72 insertions, 4 deletions

diff --git a/ChangeLog b/ChangeLog
index e6bd160..0af01f6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-11-10  Christophe Fergeau <teuf@gnome.org>
+
+	* NEWS: update for 0.6.0 release
+	* README.SysInfo: explain how to get the firewire id from an iPod Touch
+
 2007-11-10  Jorg Schuler <jcsjcs at users.sourceforge.net>
 
 	* src/db-artwork-parser.c (parse_mhba): fix double g_free on mhba
@@ -14,7 +19,7 @@
 	* src/db-parse-context.c (db_parse_context_get_m_header_internal):
 	  fixed memory leak.
 
-2007-11-08  Christophe Fergeau  <christophe@anevia.com>
+2007-11-08  Christophe Fergeau <teuf@gnome.org>
 
 	* src/itdb_device.c: (itdb_device_requires_checksum): the iPod Touch
 	needs a firewire id as well
diff --git a/NEWS b/NEWS
index e69de29..130afc5 100644
--- a/NEWS
+++ b/NEWS
@@ -0,0 +1,56 @@
+Overview of changes in libgpod 0.6.0
+====================================
+
+* support for iPod Classics and Video Nanos
+
+The database from these models is protected by a checksum. When this checksum 
+doesn't match the content of the iPod database, the iPod won't show any 
+track (ie it will look empty). Support for writing this checksum has been 
+implemented in this release thanks to the awesome work of a few people in
+#gtkpod. However, to calculate this checksum, a so called "firewire ID" is 
+needed which is different from iPod to iPod. Since reading it from the iPod
+requires special permissions, the firewire ID must be written in a regular 
+file on the iPod so that libgpod can find it and use it to generate the
+checksum. 
+
+libgpod installs a HAL callout to do that automatically when 
+everything is installed in an appropriate place. It can also be done manually,
+see README.SysInfo for more information.
+
+Cover art should be working except for non square covers, preliminary photo 
+support but this hasn't been widely tested yet.
+
+
+* support for iPhone and iPod Touch
+
+This requires manual user intervention: the devices must be jailbroken and 
+mounted through sshfs. The iPod Touch also needs a firewire ID which must be
+manually set, see README.SysInfo
+
+Cover art is implemented but not tested at all, ditto for photo support on 
+the iPod Touch
+
+
+* additional tools to get the firewire id from new iPods including a HAL
+  callout which will make the process totally automatic when it's properly 
+  installed. These tools need libsgutils to be installed.
+
+* endianness fixes in the artwork writing code
+* now depends on glib 2.8 or newer
+
+Huge thanks to wtbw and Simon Schulz without whom that release wouldn't have 
+been possible. Thanks as well to the people on #gtkpod for the testing they 
+provided.
+
+Other contributors to the release:
+- Jesse Bouwman
+- Alex Eftimie
+- Christophe Fergeau
+- Filippo Giunchedi
+- Javier Kohen
+- Tobias Kreisel
+- Eric Lassauge
+- Nicholas Piper
+- Jorg Schuler
+- Simon Schulz
+- Todd Zullinger
diff --git a/README.SysInfo b/README.SysInfo
index 34b79f2..1a598e5 100644
--- a/README.SysInfo
+++ b/README.SysInfo
@@ -20,9 +20,10 @@ Having that file is enough for libgpod to figure out the iPod firewire id.
 The 2nd method requires more manual intervention. First, you need to get your
 firewire id manually. To do that, run "sudo lsusb -v | grep -i Serial" (without
 the "") with your iPod plugged in, this should print a 16 character long string
-like 00A1234567891231. Once you have that number, create/edit 
-/mnt/ipod/iPod_Control/Device/SysInfo (if your iPod is mounted at /mnt/ipod).
-Add to that file the line below:
+like 00A1234567891231. For an iPod Touch, this number will be much longer than
+16 characters, the firewire ID is constituted by the first 16 characters.
+Once you have that number, create/edit /mnt/ipod/iPod_Control/Device/SysInfo 
+(if your iPod is mounted at /mnt/ipod). Add to that file the line below:
 FirewireGuid: 0xffffffffffffffff
 (replace ffffffffffffffff with the string you obtained at the previous step
 and don't forget the trailing 0x before the string)
@@ -32,3 +33,9 @@ file when you do that. So if after doing that libgpod still seems to write
 invalid content to the iPod, double-check the content of that SysInfo file to
 make sure the FirewireGuid line you added isn't gone. If that happens, readd it
 to the end of the file, and make sure libgpod rewrite the iPod content.
+
+
+
+Once that is done, if you compiled libgpod from source, you can test that 
+libgpod can find the firewire ID on your iPod by running 
+libgpod/tests/test-firewire-id /ipod/mount/point