Index: gnupod.texi
===================================================================
RCS file: /sources/gnupod/gnupod/doc/gnupod.texi,v
retrieving revision 1.38
diff -u -u -r1.38 gnupod.texi
--- gnupod.texi 26 Sep 2007 14:11:40 -0000 1.38
+++ gnupod.texi 24 Dec 2007 16:28:07 -0000
@@ -112,7 +112,7 @@
The @address@hidden script checks if the desired Perl modules are installed.
-On Debian GNU/Linux you'll simply have to run this commands to install the required Perl modules:
+On Debian GNU/Linux you'll simply have to run these commands to install the required Perl modules:
@example
apt-get install libfile-ncopy-perl
apt-get install libmp3-info-perl
@@ -133,7 +133,7 @@
http://cpan.org/misc/cpan-faq.html#How_install_Perl_modules
-(Maybe you'd like to use the CPAN-Shell.. google knows how to use it ;-) )
+(Maybe you'd like to use the CPAN-Shell.. Google knows how to use it ;-) )
@node Using FireWire with GNU/Linux
@@ -155,34 +155,34 @@
@end itemize
Feel free to build OHCI-1394 into the kernel ('y'), but make sure to compile
-SBP-2 support as module. It won't work (good) if you say 'y' there!
+SBP-2 support as module. It won't work well if you say 'y' there!
If you don't own an OHCI-1394 FireWire card you may need to use the LYNX driver instead.
-But OHCI-1394 is the most common used, please also have a look at http://www.linux1394.org
+But OHCI-1394 is the most common, please also have a look at http://www.linux1394.org
-After you rebootet with the new Kernel, you should now be able to mount the iPod.
-First load the OHCI-1394 module if you did say 'm' to OHCI-1394 support.
+After you reboot with the new Kernel, you should now be able to mount the iPod.
+First load the OHCI-1394 module if you said 'm' to OHCI-1394 support.
@example
modprobe ohci1394
@end example
-Now plugin the iPod and wait until you can see the 'hook-symbol' and load the sbp2 module using
+Now plug in the iPod and wait until you can see the 'hook-symbol' and load the sbp2 module using
@example
modprobe sbp2
@end example
-Please keep in mind that FireWire support is still experimental and you may see Kernel Oopses and other nasty things.
+Please keep in mind that FireWire support is still experimental and you may see Kernel ``oopses'' and other nasty things.
If your system hangs after loading sbp2 or mounting the iPod you may try to load sbp2 like this:
@example
modprobe sbp2 sbp2_max_speed=0 sbp2_serialize_io=1 sbp2_force_inquiry_hack=1
@end example
-This will slow down the transfer rate but should act much more stable.
-Note: Firewire works very good with Linux 2.6. If you have Problems
-with Linux 2.4, you may wan't to upgrade to 2.6 !
+This will slow down the transfer rate but should be much more stable.
+Note: Firewire works very well with Linux 2.6. If you have problems
+with Linux 2.4, you may want to upgrade to 2.6!
-After loading sbp2, use @address@hidden to get some information, the output
-should look like this (If you are running linux 2.4.20 or older)
+After loading sbp2, use @address@hidden to get some information. The output
+should look like this (if you are running linux 2.4.20 or older):
@example
SBP-2 module load options:
@@ -203,8 +203,8 @@
In this case, @address@hidden/dev/sda}} would be your iPod.
Linux 2.4.21 (and newer) doesn't show such verbose output and your iPod
-will not be detectet while loading sbp2. Simply run @address@hidden
-It should find your iPod (See /proc/scsi/scsi).
+will not be detected while loading sbp2. Simply run @address@hidden which
+should find your iPod (See /proc/scsi/scsi).
(You can download 'rescan-scsi-bus.sh' at http://www.garloff.de/kurt/linux/rescan-scsi-bus.sh)
You can now mount the iPod:
@@ -217,11 +217,11 @@
/dev/sda2 /mnt/ipod vfat defaults,user,noauto,umask=000
@end example
-Note: Avoid adding the 'sync' mount-option for flash based iPods (Shuffle, Nano) because
+Note: avoid adding the 'sync' mount-option for flash based iPods (Shuffle, Nano) because
flash drives have a limited number of write cycles.
-Note2: As you can see, we assume an FAT32/VFAT formatted iPod (@address@hidden
-vfat}}), if you own a HFS+ formatted iPod (aka. Mac-iPod) please have a look at the
+Note2: as you can see, we assume an FAT32/VFAT formatted iPod (@address@hidden
+vfat}}); if you own an HFS+ formatted iPod (aka. Mac-iPod) please have a look at the
next section 'Convert your Mac iPod' before using @address@hidden
@@ -232,10 +232,10 @@
HFS+ Formatted (aka 'Mac-iPod') you will have to reformat the iPod.
Note: Linux 2.6.4 includes HFS+ Read/WRITE Support(!)
-It's still experimental and may do nasty things. (But it works well for me..)
+It's still experimental and may do nasty things. (But it works well for me...)
If you build your kernel with HFS+ support, you don't have to convert your iPod :)
-Please note that you will need a fdisk for DOS-Style partitions, you will also need a kernel that supports
+Please note that you will need an fdisk for DOS-Style partitions, you will also need a kernel that supports
Mac- (to read the firmware) and Dos-style (to access the device after converting it) partitions.
If you are using GNU/Linux on x86, your fdisk should be fine, but if you are running GNU/Linux on
(for example) PowerPC you may have to get a suitable fdisk from the util-linux package which can
@@ -252,7 +252,7 @@
@end example
-We assume your iPod at @address@hidden/dev/sda}}. (No, don't mount the iPod, simply plugin the iPod and make sure it
+We assume that your iPod is at @address@hidden/dev/sda}}. (No, don't mount the iPod, simply plugin the iPod and make sure it
got detected with @address@hidden
Here we go:
@@ -262,7 +262,7 @@
dd if=/dev/sda2 of=backup_firmware
@end example
-This should result in a ~32Mb big file, now we have to kill the old partition map and force the kernel
+This should result in a ~32MB file, now we have to kill the old partition map and force the kernel
to re-read the new (empty) map
@example
dd if=/dev/zero of=/dev/sda bs=1M count=10
@@ -317,14 +317,14 @@
Syncing disks.
@end example
-Note: The first partition doesn't have to be 32M, it just needs enought space to hold the firmware
+Note: The first partition doesn't have to be 32M, it just needs enough space to hold the firmware
image (6M would be okay for firmware 130.bin).
Now we can rewrite the Firmwarebackup we created above.
@example
dd if=backup_firmware of=/dev/sda1
@end example
-You may ask why we now write the Firmware to sda1 while we read it from sda2, the answear is simple:
+You may ask why we now write the Firmware to sda1 while we read it from sda2, the answer is simple:
Before running fdisk, the iPod was a Mac-iPod with a different Partition layout, but now the iPod is a Windows-iPod, belive me: sda1
is correct.
@@ -354,22 +354,22 @@
@section Firmware update
** Don't update the Firmware just for fun, only do it if you need a
-new Firmware or/and the documentation told you to do this **
+new Firmware and/or the documentation told you to do this **
-Note: This steps do not work on late 2007 iPods (such as Classic, Touch and 3th gen. Nano).
+Note: These steps do not work on late 2007 iPods (such as Classic, Touch and 3th gen. Nano).
-Setup Firewire (or USB) as described in 'Using FireWire with GNU/Linux', load the modules and make sure sbp2 detected your iPod.
-Mount the iPod and run @address@hidden to bring the device into a 'clean' state. Unmount the iPod after mktunes.pl finished
+Setup Firewire (or USB) as described in 'Using FireWire with GNU/Linux', load the modules and make sure that sbp2 detected your iPod.
+Mount the iPod and run @address@hidden to bring the device into a 'clean' state. Unmount the iPod after mktunes.pl finishes
but do *not* unplug the iPod. Ready? Ok, we assume your iPod is @address@hidden/dev/sda}}:
-First you need to get a new Firmware.
+First you need to get a new Firmware image.
Checkout the latest firmware list:
@example
wget -O list.gz http://ax.phobos.apple.com.edgesuite.net//WebObjects/MZStore.woa/wa/com.apple.jingle.appserver.client.MZITunesClientCheck/version
gunzip list.gz
@end example
-Open the list in a text editor and find the correct Fimrware-URL for iPod model:
+Open the list in a text editor and find the correct Fimrware-URL for your iPod model:
@example
http://appldnld.apple.com.edgesuite.net/content.info.apple.com/iPod/SBML/osx/bundles/061-3877.20070914.n9gGb/iPod_24.1.0.1.ipsw iPod Classic (2007)
http://appldnld.apple.com.edgesuite.net/content.info.apple.com/iPod/SBML/osx/bundles/061-2790.20061206.iPr9t/iPod_25.1.2.1.ipsw iPod Video late 5th Gen (30 or 80 gb)
@@ -395,7 +395,7 @@
http://appldnld.apple.com.edgesuite.net/content.info.apple.com/iPod/SBML/osx/bundles/061-2789.20061206.9IIut/iPod_20.1.2.1.ipsw iPod 5th Gen.
@end example
-Download the correct firmware image of your iPod (http://docs.info.apple.com/article.html?artnum=61688 should help you identify our iPod model) and extract it:
+Download the correct firmware image for your iPod (http://docs.info.apple.com/article.html?artnum=61688 should help you identify our iPod model) and extract it:
@example
# Example for ipod photo: iPod_11.1.2.1.ipsw : 11 = Model (Photo) 1.2.1 = Firmware version
wget http://appldnld.apple.com.edgesuite.net/content.info.apple.com/iPod/SBML/osx/bundles/061-2694.20060912.ipDcD/iPod_11.1.2.1.ipsw
@@ -451,7 +451,7 @@
@node Preparation
@section Preparation
-Mount the iPod (i assume you mount it at /mnt/ipod) as described in 'Using FireWire with GNUpod'
+Mount the iPod (I assume you mount it at /mnt/ipod) as described in 'Using FireWire with GNUpod'
If the iPod is freshly formatted or you never used GNUpod before with this iPod, run
@example
@@ -466,7 +466,7 @@
gnupod_INIT.pl -m /mnt/ipod --france
@end example
-if you would like to enable the 'EU-Volume-Limit' (=decrase max. volume).
+if you would like to enable the 'EU-Volume-Limit' (=decrease max. volume).
This only works for iPods running Firmware 1.x
Your iPod is now ready for GNUpod!
@@ -474,7 +474,7 @@
@node Configuration
@section Configuration
-(Note: You don't need to bother about the Configfile. GNUpod works fine
+(Note: You don't need to bother with the Configfile. GNUpod works fine
without it, but it could make your life easier)
GNUpod >= 0.95 can read a simple Configfile.
@@ -520,7 +520,7 @@
gnupod_addsong.pl tries to 'auto-detect' the encoding of the ID3 Tag.
Sometimes this works (in most cases ;) ) sometimes it doesn't. If it doesn't work for you,
-feel free do send me an example-file: pab@@blinkenligts.ch
+feel free to send me an example-file: pab@@blinkenligts.ch
DO NOT umount the iPod yet! First read the section 'Unplug the iPod'!
@@ -529,7 +529,7 @@
@node Search files
@section Search files
-GNUpod includes a tool called @address@hidden which helps you searching for files.
+GNUpod includes a tool called @address@hidden that helps you search for files.
Maybe you would like to search for the artist called 'Schlummiguch'. In this case, run
@example
@@ -558,7 +558,7 @@
gnupod_search.pl --artist="Alfred Neumann" --rename="artist=John Doe" --rename="rating=100"
@end example
-This example searches all files from 'Alfred Neumann', changes the artist into 'Johne Doe' and
+This example searches all files from 'Alfred Neumann', changes the artist into 'John Doe' and
sets the rating to 5 Stars (5*20=100)
Don't forget to run mktunes.pl!
@@ -569,7 +569,7 @@
@node Creating playlists
@section Creating playlists
-Open the file @address@hidden/.gnupod/GNUtunesDB}} in a editor (It's a XML File).
+Open the file @address@hidden/.gnupod/GNUtunesDB}} in a editor (It's an XML File).
To create a playlist named 'sweet' which holds the songs with the ID 1 and 2, create something like this:
@example
@@ -631,12 +631,12 @@
@end example
-'Example SPL1' matches all songs from 'Jon Doe' with playcount==0 (= All songs from Jon Doe never played until yet)
+'Example SPL1' matches all songs from 'Jon Doe' with playcount==0 (= All songs from Jon Doe that heven't been played yet)
'Example SPL2' matches all songs with a Bitrate > 331.
(See also README.smartplaylists)
For more examples have a look at @address@hidden/gnutunesdb.example}} included in the GNUpod tarball.
-Also checkout http://blinkenlights.ch/gnupod/mkspl.html for a 'JavaScript SPL-Creator'
+Also check out http://blinkenlights.ch/gnupod/mkspl.html for a 'JavaScript SPL-Creator'
You can also use the --playlist option of gnupod_addsong.pl. This will create and add the listed songs to the
named playlist.
@@ -766,7 +766,7 @@
If you want to use an iPod with GNUpod and used something other than GNUpod (maybe iTunes)
to perform the last update (adding songs, editing playists.. doing something..), you'll have to
- use @address@hidden to update the (outdatet) GNUtunesDB.
+ use @address@hidden to update the (outdated) GNUtunesDB.
Mount the iPod and run
@example
@@ -775,8 +775,8 @@
The iPod is now ready again for GNUpod.
-You have to do this because GNUpod stores it's information in the GNUtunesDB, other programs are accessing the
-iTunesDB directly. After you did something with eg. iTunes, the GNUtunesDB would be 'outdatet' and you would
+You have to do this because GNUpod stores its information in the GNUtunesDB, but other programs access the
+iTunesDB directly. After you did something with eg. iTunes, the GNUtunesDB would be 'outdated' and you would
lose any changes you made with iTunes. Running @address@hidden will write a new GNUtunesDB which
reflects the content of the current iTunesDB.
@@ -832,8 +832,8 @@
@node GNUtunesDB
@section GNUtunesDB
-We talked alot about the 'GNUtunesDB' and the 'iTunesDB' files, but
-why do we need this two files and what's the difference ?
+We talked a lot about the 'GNUtunesDB' and the 'iTunesDB' files, but
+why do we need these two files and what's the difference ?
Well, you can find the iTunesDB on your iPod at @address@hidden/iTunes/iTunesDB}} .
This file is read by the iPod when you 'boot' the device.
@@ -853,7 +853,7 @@
Only mktunes.pl and tunes2pod.pl have to worry about the iTunesDB format: all other tools
(gnupod_addsong.pl for example) only have to deal with the XML file called GNUtunesDB.
-It's important to keep the iTunesDB and GNUtunesDB 'in sync', so everytime you changed the
+It's important to keep the iTunesDB and GNUtunesDB 'in sync', so everytime you change the
GNUtunesDB (by hand or using gnupod_something.pl) you'll have to run @address@hidden
If 'you' changed the iTunesDB (using gtkPod/iTunes/Ehpod), run @address@hidden *before*
@@ -864,7 +864,7 @@
@section Get rid of '-m'
You don't have to use the '-m' switch if you set IPOD_MOUNTPOINT.
-(Example for the BASH)
+(Example for the BASH shell)
@example
export IPOD_MOUNTPOINT="/mnt/ipod"
@end example