summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSolomon Peachy <pizza@shaftnet.org>2020-03-29 10:06:12 -0400
committerSolomon Peachy <pizza@shaftnet.org>2020-03-29 16:08:37 +0200
commitf86f7883f53d1dcd7d441a7cd9e4fce4c1318b1f (patch)
treee4c13d2dfacd03c3eeec2eddbaf21b0c423dd99f
parent2ce000272d1c91ddbb175e7153131a9b861166c9 (diff)
downloadrockbox-f86f7883f53d1dcd7d441a7cd9e4fce4c1318b1f.tar.gz
rockbox-f86f7883f53d1dcd7d441a7cd9e4fce4c1318b1f.zip
manual: Fix broken ipod manual generation
Split apart ipod6g installation instructions from the rest. For unknown reasons the \opt and \nopt tests were causing the \code blocks to go wonky Change-Id: I99b96cd17bd817e18b3487a92b66e966e39397d6
-rw-r--r--manual/getting_started/installation.tex6
-rw-r--r--manual/getting_started/ipod6g_install.tex66
-rw-r--r--manual/getting_started/ipod_install.tex73
3 files changed, 71 insertions, 74 deletions
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex
index 9812c13606..831dab1fe2 100644
--- a/manual/getting_started/installation.tex
+++ b/manual/getting_started/installation.tex
@@ -512,7 +512,11 @@ structure that Rockbox needs.\\}
512 \subsubsection{Installing the bootloader} 512 \subsubsection{Installing the bootloader}
513 \opt{iriverh100,iriverh300}{\input{getting_started/iriver_install.tex}} 513 \opt{iriverh100,iriverh300}{\input{getting_started/iriver_install.tex}}
514 \opt{mpiohd200,mpiohd300}{\input{getting_started/mpio_install.tex}} 514 \opt{mpiohd200,mpiohd300}{\input{getting_started/mpio_install.tex}}
515 \opt{ipod}{\input{getting_started/ipod_install.tex}} 515 \opt{ipod}{
516 \nopt{ipod6g} {
517 \input{getting_started/ipod_install.tex}}
518 \opt{ipod6g} {
519 \input{getting_started/ipod6g_install.tex}} }
516 \opt{iaudio}{\input{getting_started/iaudio_install.tex}} 520 \opt{iaudio}{\input{getting_started/iaudio_install.tex}}
517 \opt{iriverh10,iriverh10_5gb}{\input{getting_started/h10_install.tex}} 521 \opt{iriverh10,iriverh10_5gb}{\input{getting_started/h10_install.tex}}
518 \opt{gigabeatf}{\input{getting_started/gigabeat_install.tex}} 522 \opt{gigabeatf}{\input{getting_started/gigabeat_install.tex}}
diff --git a/manual/getting_started/ipod6g_install.tex b/manual/getting_started/ipod6g_install.tex
new file mode 100644
index 0000000000..d1c77dad01
--- /dev/null
+++ b/manual/getting_started/ipod6g_install.tex
@@ -0,0 +1,66 @@
1
2\subsubsection{Bootloader installation from Windows}
3
4Manual installation under Windows is not supported. Please use \caps{Rockbox
5Utility} for bootloader and Rockbox installation.
6
7\subsubsection{Bootloader installation from Mac OS X}
8
9\warn{Please make sure that your iPod is formatted using FAT32
10 (a.k.a. WinPod) before attempting to install the bootloader!
11 Installation will not work on HFS/HFS+ iPods (a.k.a. MacPods).}
12
13\begin{enumerate}
14
15\item Download the bootloader in .ipod format from
16\url{https://files.freemyipod.org/~user890104/bootloader-ipodclassic-v1_0/bootloader-ipod6g.ipod}
17
18\item Download mks5lboot for your operating system from
19\url{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html\#download_stable}
20
21\item You need to have package libusb installed using Homebrew (brew install
22libusb) or MacPorts (port install libusb) in order to run mks5lboot.
23
24\item Start mks5lboot from a terminal with the following command-line:
25mks5lboot --dfuscan -l It should scan for DFU devices every second.
26
27\item It is important to stop iTunes (dock icon -> Quit) and iTunesHelper
28(using Activity monitor, find the process and select Quit or Force
29quit if it keeps restarting) BEFORE continuing to the next
30step. Otherwise iTunes will put your iPod in wrong mode, and you will
31not be able to proceed with the installation.
32
33\item Put your iPod in DFU mode.
34
35\item When the device is detected, press CTRL+C to terminate the scan
36process, and proceed to the next step.
37
38\item Start mks5lboot from a terminal with the following command-line:
39mks5lboot --bl-inst path/to/bootloader-ipod6g.ipod, providing the
40correct path to bootloader-ipod6g.ipod that you downloaded earlier.
41
42\item When the installation is complete, you should have Rockbox up and
43running!
44
45\end{enumerate}
46
47\subsubsection{Bootloader installation from Linux}
48
49\begin{enumerate}
50
51\item Connect your iPod in normal mode (iTunes/file transfer).
52\item Download \wikilink{RockboxUtility} for your operating system.
53\item When \caps{Rockbox Utility} opens, select the checkbox named Show disabled targets, and point the installer to your iPod's mount point.
54\item On the installation screen make sure that Rockbox is selected and Bootloader is not selected. You can install themes or the game files if you want.
55\item Start the Rockbox installation.
56\item Download the \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic-v1_0/bootloader-ipod6g.ipod}{bootloader in .ipod format}.
57\item Download \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#download_stable}{mks5lboot} for your operating system. Alternatively, you can \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#build_mks5lboot}{build it} from the source code.
58\item You need to have package libusb-1.0.0 installed in order to run mks5lboot.
59\item To make sure the installer is marked as executable, start the following command in the terminal: chmod +x mks5lboot.
60\item Start mks5lboot from a terminal with the following command-line: ./mks5lboot --dfuscan -l. It should scan for DFU devices every second.
61\item Put your iPod in \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#dfu}{DFU mode}.
62\item When the device is detected, press CTRL+C to terminate the scan process, and proceed to the next step.
63\item Start mks5lboot from a terminal with the following command-line: ./mks5lboot --bl-inst path/to/bootloader-ipod6g.ipod, providing the correct path to bootloader-ipod6g.ipod that you downloaded earlier.
64\item When the installation is complete, you should have Rockbox up and running!
65
66\end{enumerate}
diff --git a/manual/getting_started/ipod_install.tex b/manual/getting_started/ipod_install.tex
index bbb5d1421c..3ee4e9d78b 100644
--- a/manual/getting_started/ipod_install.tex
+++ b/manual/getting_started/ipod_install.tex
@@ -1,7 +1,3 @@
1% $Id$ %
2
3\nopt{ipod6g}{
4
5\subsubsection{Bootloader installation from Windows} 1\subsubsection{Bootloader installation from Windows}
6 2
7\begin{enumerate} 3\begin{enumerate}
@@ -87,73 +83,4 @@ bootloader. Press i followed by ENTER, and ipodpatcher will now install the
87bootloader. After a short time you should see the message ``[INFO] Bootloader 83bootloader. After a short time you should see the message ``[INFO] Bootloader
88installed successfully.'' Press ENTER again to exit ipodpatcher. 84installed successfully.'' Press ENTER again to exit ipodpatcher.
89 85
90\end{enumerate}}
91
92\opt{ipod6g}{
93
94\subsubsection{Bootloader installation from Windows}
95
96Manual installation under Windows is not supported. Please use \caps{Rockbox
97Utility} for bootloader and Rockbox installation.
98
99\subsubsection{Bootloader installation from Mac OS X}
100
101\warn{Please make sure that your iPod is formatted using FAT32
102 (a.k.a. WinPod) before attempting to install the bootloader!
103 Installation will not work on HFS/HFS+ iPods (a.k.a. MacPods).}
104
105\begin{enumerate}
106
107\item Download the bootloader in .ipod format from
108\url{https://files.freemyipod.org/~user890104/bootloader-ipodclassic-v1_0/bootloader-ipod6g.ipod}
109
110\item Download mks5lboot for your operating system from
111\url{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html\#download_stable}
112
113\item You need to have package libusb installed using Homebrew (brew install
114libusb) or MacPorts (port install libusb) in order to run mks5lboot.
115
116\item Start mks5lboot from a terminal with the following command-line:
117mks5lboot --dfuscan -l It should scan for DFU devices every second.
118
119\item It is important to stop iTunes (dock icon -> Quit) and iTunesHelper
120(using Activity monitor, find the process and select Quit or Force
121quit if it keeps restarting) BEFORE continuing to the next
122step. Otherwise iTunes will put your iPod in wrong mode, and you will
123not be able to proceed with the installation.
124
125\item Put your iPod in DFU mode.
126
127\item When the device is detected, press CTRL+C to terminate the scan
128process, and proceed to the next step.
129
130\item Start mks5lboot from a terminal with the following command-line:
131mks5lboot --bl-inst path/to/bootloader-ipod6g.ipod, providing the
132correct path to bootloader-ipod6g.ipod that you downloaded earlier.
133
134\item When the installation is complete, you should have Rockbox up and
135running!
136
137\end{enumerate}
138
139\subsubsection{Bootloader installation from Linux}
140
141\begin{enumerate}
142
143\item Connect your iPod in normal mode (iTunes/file transfer).
144\item Download \wikilink{RockboxUtility} for your operating system.
145\item When \caps{Rockbox Utility} opens, select the checkbox named Show disabled targets, and point the installer to your iPod's mount point.
146\item On the installation screen make sure that Rockbox is selected and Bootloader is not selected. You can install themes or the game files if you want.
147\item Start the Rockbox installation.
148\item Download the \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic-v1_0/bootloader-ipod6g.ipod}{bootloader in .ipod format}.
149\item Download \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#download_stable}{mks5lboot} for your operating system. Alternatively, you can \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#build_mks5lboot}{build it} from the source code.
150\item You need to have package libusb-1.0.0 installed in order to run mks5lboot.
151\item To make sure the installer is marked as executable, start the following command in the terminal: chmod +x mks5lboot.
152\item Start mks5lboot from a terminal with the following command-line: ./mks5lboot --dfuscan -l. It should scan for DFU devices every second.
153\item Put your iPod in \href{https://files.freemyipod.org/~user890104/bootloader-ipodclassic.html#dfu}{DFU mode}.
154\item When the device is detected, press CTRL+C to terminate the scan process, and proceed to the next step.
155\item Start mks5lboot from a terminal with the following command-line: ./mks5lboot --bl-inst path/to/bootloader-ipod6g.ipod, providing the correct path to bootloader-ipod6g.ipod that you downloaded earlier.
156\item When the installation is complete, you should have Rockbox up and running!
157
158\end{enumerate} 86\end{enumerate}
159}