Menu
▾
▴
[gtpd-cvs] [gtkpod/gtk-3.0] Update to documentation
|
From: phantomjinx <pha...@us...> - 2011-05-22 19:21:27
|
commit 2efbd07cc6ffb89e1792694539b9dbb94ace3328
Author: phantomjinx <p.g...@ph...>
Date: Sat May 21 18:54:49 2011 +0100
Update to documentation
* Update to documentation.
* Thanks to mfv (mvescovi at gmail.com) for the patch.
* This is the same patch as reverted in the previous
commit but the patch was attributed incorrectly. The
commit corrects this attribution.
doc/gtkpod.xml | 18 +++++++++---------
doc/hooking-up-the-ipod.html | 4 ++--
doc/the-sysinfo-file.html | 13 ++++++-------
3 files changed, 17 insertions(+), 18 deletions(-)
---
diff --git a/doc/gtkpod.xml b/doc/gtkpod.xml
index 1ce604c..e28a444 100644
--- a/doc/gtkpod.xml
+++ b/doc/gtkpod.xml
@@ -32,7 +32,7 @@
<sect2>
<title>Introduction</title>
<para>The iPod has largely been an USB device yet there are older models of iPods that used IEEE1394/ / firewire for their connection interface. Historically, it took something of an effort for linux to recognise the iPod model correctly. However, this situation has greatly improved in recent times where it is now possible to simply plug the iPod into a USB port and have your distro recognise it straight off.</para>
- <para>gtkpod first and foremost relies on the successful mounting of a recognised iPod. Thus, if the iPod cannot be mounted then gtkpod is NOT going to do it for you! Thus, before firing up gtkpod make sure you can see the filesystem of your iPod at its desginated mount point, eg. /mnt/ipod.</para>
+ <para>gtkpod first and foremost relies on the successful mounting of a recognised iPod. Thus, if the iPod cannot be mounted then gtkpod is NOT going to do it for you! Thus, before firing up gtkpod make sure you can see the filesystem of your iPod at its desginated mount point, eg. /media/ipod.</para>
</sect2>
<sect2>
<title>Using udev</title><para>For linux distros installed with hal and udev, plugging an ipod in and mounting it becomes a trivial exercise. A device node will normally be created under /dev, eg. /dev/sdc.</para><para>Using udev rules it is possible to "play" and refine this device node to reflect personal requirements. For example, including these udev rules will allow 2 ipods to be loaded at the same time without interfering with one another:</para><programlisting>
@@ -51,7 +51,7 @@ NAME="4gbnano", MODE="0664", OPTIONS="last_rule"]]>
<para>
The result of this is that the ipod will be located on a device node and this can be mounted manually using the command (performed as root):
</para>
- <programlisting>mount /dev/sdc2 /mnt/ipod</programlisting>
+ <programlisting>mount /dev/sdc2 /media/ipod</programlisting>
<para>This assumes an iPod is loaded onto the device /dev/sdc and that it is a 2 partition model. It seems that post-2006, iPods have become 1-partition items.</para>
<para>However, it should be noted that moden window managers such as gnome and kde take on the responsibility of managing connected devices. Thus, the result of connecting an iPod will be an icon on the desktop which will either be mounted automatically or can be mounted by the user with a click of the mouse on a popup menu.</para>
</sect2>
@@ -476,7 +476,7 @@ usb-storage: Status code -75; transferred 0/13 ]]>
<para>touch_ip -- denotes the IP address that is assigned to your iPod Touch
(e.g. 192.168.0.27).
</para>
- <para>touch_mnt -- denotes the mount point to your iPod Touch (i.e. the
+ <para>touch_media -- denotes the mount point to your iPod Touch (i.e. the
directory the iPod is mounted on).
</para>
<para>To make effective use of the following you have to jailbreak your iPod Touch first (in order to access it via SSH). This document won't go into detail on this topic. One possibility to do this using a computer that runs Microsoft Windows (XP) can be found at:
@@ -528,16 +528,16 @@ usb-storage: Status code -75; transferred 0/13 ]]>
<title id='making-libgpod-aware-of-the-firewire-guid-title'>Making libgpod Aware of the Firewire GUID</title>
<para>Mount your iPod Touch via:
</para>
- <programlisting>sudo sshfs root@touch_ip:Media touch_mnt/ -o allow_other
+ <programlisting>sudo sshfs root@touch_ip:Media touch_media/ -o allow_other
</programlisting>
<para>Go to the directory 'iTunes_Control' and create (if it does not already exist) a directory named 'Device':
</para>
- <programlisting><![CDATA[~/touch_mnt/iTunesControl$ mkdir Device; cd Device
-~/touch_mnt/iTunesControl/Device$ echo "FirewireGuid: 0xfd98145617c113dc" > SysInfo ]]>
+ <programlisting><![CDATA[~/touch_media/iTunesControl$ mkdir Device; cd Device
+~/touch_media/iTunesControl/Device$ echo "FirewireGuid: 0xfd98145617c113dc" > SysInfo ]]>
</programlisting>
<para>Test if libgpod is able to retrieve the FWGUID by changing into the 'tests' subdirectory of libgpod's source directory and runnning:
</para>
- <programlisting>./test-firewire-id touch_mnt/
+ <programlisting>./test-firewire-id touch_media/
</programlisting>
</sect3>
<sect3 id='gtkpod-revisited'>
@@ -559,11 +559,11 @@ usb-storage: Status code -75; transferred 0/13 ]]>
<title id='the-classic-and-nano-three-g-title'>The Classic and Nano3g</title>
<para>There are two ways to set up the iPod to make libgpod able to find its firewire id.
</para>
- <para>The 1st one is mostly automated. First, make sure you have libsgutils installed before running configure/autogen.sh. If you built libgpod without it, install it and run configure/make/make install. You should now have an ipod-read-sysinfo-extended tool available. Run it with the iPod device path (eg /dev/sda) and the iPod mount point (eg /mnt/ipod) as arguments. This may require root privileges. ipod-read-sysinfo-extended will read an XMLfile from the iPod and write it as /mnt/ipod/iPod_Control/Device/SysInfoExtended. See http://ipodlinux.org/Device_Information for more details about the method used.
+ <para>The 1st one is mostly automated. First, make sure you have libsgutils installed before running configure/autogen.sh. If you built libgpod without it, install it and run configure/make/make install. You should now have an ipod-read-sysinfo-extended tool available. Run it with the iPod device path (eg /dev/sda) and the iPod mount point (eg /media/ipod) as arguments. This may require root privileges. ipod-read-sysinfo-extended will read an XMLfile from the iPod and write it as /media/ipod/iPod_Control/Device/SysInfoExtended. See http://ipodlinux.org/Device_Information for more details about the method used.
</para>
<para>Having that file is enough for libgpod to figure out the iPod firewire id.
</para>
- <para>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. 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:
+ <para>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. 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 /media/ipod/iPod_Control/Device/SysInfo (if your iPod is mounted at /media/ipod). Add to that file the line below:
</para>
<programlisting>FirewireGuid: 0xffffffffffffffff
</programlisting>
diff --git a/doc/hooking-up-the-ipod.html b/doc/hooking-up-the-ipod.html
index 75ce7d5..e46ae3a 100644
--- a/doc/hooking-up-the-ipod.html
+++ b/doc/hooking-up-the-ipod.html
@@ -488,7 +488,7 @@ dd.answer div.label { float: left; }
<div class="division sect2">
<div class="header"><h2 class="sect2 title"><span class="title"><span class="label">1.1.1.â</span>Introduction</span></h2></div>
<p class="para block block-first">The iPod has largely been an USB device yet there are older models of iPods that used IEEE1394/ / firewire for their connection interface. Historically, it took something of an effort for linux to recognise the iPod model correctly. However, this situation has greatly improved in recent times where it is now possible to simply plug the iPod into a USB port and have your distro recognise it straight off.</p>
-<p class="para block">gtkpod first and foremost relies on the successful mounting of a recognised iPod. Thus, if the iPod cannot be mounted then gtkpod is NOT going to do it for you! Thus, before firing up gtkpod make sure you can see the filesystem of your iPod at its desginated mount point, eg. /mnt/ipod.</p>
+<p class="para block">gtkpod first and foremost relies on the successful mounting of a recognised iPod. Thus, if the iPod cannot be mounted then gtkpod is NOT going to do it for you! Thus, before firing up gtkpod make sure you can see the filesystem of your iPod at its desginated mount point, eg. /media/ipod.</p>
</div>
<div class="division sect2">
<div class="header"><h2 class="sect2 title"><span class="title"><span class="label">1.1.2.â</span>Using udev</span></h2></div>
@@ -509,7 +509,7 @@ NAME="4gbnano", MODE="0664", OPTIONS="last_rule"
<p class="para block block-first">
The result of this is that the ipod will be located on a device node and this can be mounted manually using the command (performed as root):
</p>
-<div class=" block programlisting block-indent"><pre class="programlisting">mount /dev/sdc2 /mnt/ipod</pre></div>
+<div class=" block programlisting block-indent"><pre class="programlisting">mount /dev/sdc2 /media/ipod</pre></div>
<p class="para block">This assumes an iPod is loaded onto the device /dev/sdc and that it is a 2 partition model. It seems that post-2006, iPods have become 1-partition items.</p>
<p class="para block">However, it should be noted that moden window managers such as gnome and kde take on the responsibility of managing connected devices. Thus, the result of connecting an iPod will be an icon on the desktop which will either be mounted automatically or can be mounted by the user with a click of the mouse on a popup menu.</p>
</div>
diff --git a/doc/the-sysinfo-file.html b/doc/the-sysinfo-file.html
index ce32b86..79d8f4e 100644
--- a/doc/the-sysinfo-file.html
+++ b/doc/the-sysinfo-file.html
@@ -506,7 +506,7 @@ dd.answer div.label { float: left; }
<p class="para block block-first">touch_ip -- denotes the IP address that is assigned to your iPod Touch
(e.g. 192.168.0.27).
</p>
-<p class="para block">touch_mnt -- denotes the mount point to your iPod Touch (i.e. the
+<p class="para block">touch_media -- denotes the mount point to your iPod Touch (i.e. the
directory the iPod is mounted on).
</p>
<p class="para block">To make effective use of the following you have to jailbreak your iPod Touch first (in order to access it via SSH). This document won't go into detail on this topic. One possibility to do this using a computer that runs Microsoft Windows (XP) can be found at:
@@ -558,16 +558,15 @@ dd.answer div.label { float: left; }
<a name="making-libgpod-aware-of-the-firewire-guid"></a><div class="header"><h3 class="sect3 title"><span class="title"><a name="making-libgpod-aware-of-the-firewire-guid-title"></a><span class="label">1.4.1.4.â</span>Making libgpod Aware of the Firewire GUID</span></h3></div>
<p class="para block block-first">Mount your iPod Touch via:
</p>
-<div class=" block programlisting block-indent"><pre class="programlisting">sudo sshfs root@touch_ip:Media touch_mnt/ -o allow_other
+<div class=" block programlisting block-indent"><pre class="programlisting">sudo sshfs root@touch_ip:Media touch_media/ -o allow_other
</pre></div>
<p class="para block">Go to the directory 'iTunes_Control' and create (if it does not already exist) a directory named 'Device':
</p>
-<div class=" block programlisting block-indent"><pre class="programlisting">~/touch_mnt/iTunesControl$ mkdir Device; cd Device
-~/touch_mnt/iTunesControl/Device$ echo "FirewireGuid: 0xfd98145617c113dc" > SysInfo
+<div class=" block programlisting block-indent"><pre class="programlisting">~/touch_media/iTunesControl$ mkdir Device; cd Device ~/touch_media/iTunesControl/Device$ echo "FirewireGuid: 0xfd98145617c113dc" > SysInfo
</pre></div>
<p class="para block">Test if libgpod is able to retrieve the FWGUID by changing into the 'tests' subdirectory of libgpod's source directory and runnning:
</p>
-<div class=" block programlisting block-indent"><pre class="programlisting">./test-firewire-id touch_mnt/
+<div class=" block programlisting block-indent"><pre class="programlisting">./test-firewire-id touch_media/
</pre></div>
</div>
<div class="division sect3">
@@ -588,11 +587,11 @@ dd.answer div.label { float: left; }
<a name="the-classic-and-nano-three-g"></a><div class="header"><h2 class="sect2 title"><span class="title"><a name="the-classic-and-nano-three-g-title"></a><span class="label">1.4.2.â</span>The Classic and Nano3g</span></h2></div>
<p class="para block block-first">There are two ways to set up the iPod to make libgpod able to find its firewire id.
</p>
-<p class="para block">The 1st one is mostly automated. First, make sure you have libsgutils installed before running configure/autogen.sh. If you built libgpod without it, install it and run configure/make/make install. You should now have an ipod-read-sysinfo-extended tool available. Run it with the iPod device path (eg /dev/sda) and the iPod mount point (eg /mnt/ipod) as arguments. This may require root privileges. ipod-read-sysinfo-extended will read an XMLfile from the iPod and write it as /mnt/ipod/iPod_Control/Device/SysInfoExtended. See http://ipodlinux.org/Device_Information for more details about the method used.
+<p class="para block">The 1st one is mostly automated. First, make sure you have libsgutils installed before running configure/autogen.sh. If you built libgpod without it, install it and run configure/make/make install. You should now have an ipod-read-sysinfo-extended tool available. Run it with the iPod device path (eg /dev/sda) and the iPod mount point (eg /media/ipod) as arguments. This may require root privileges. ipod-read-sysinfo-extended will read an XMLfile from the iPod and write it as /media/ipod/iPod_Control/Device/SysInfoExtended. See http://ipodlinux.org/Device_Information for more details about the method used.
</p>
<p class="para block">Having that file is enough for libgpod to figure out the iPod firewire id.
</p>
-<p class="para block">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. 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:
+<p class="para block">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. 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 /media/ipod/iPod_Control/Device/SysInfo (if your iPod is mounted at /media/ipod). Add to that file the line below:
</p>
<div class=" block programlisting block-indent"><pre class="programlisting">FirewireGuid: 0xffffffffffffffff
</pre></div>
|