Debian Codegraph @

contrib/HEADER.html.in

raw
1 #if 0
2 Input file for docs in multiple different directories. Process with
3 cpp.
4 #endif
5
6 <h1>What's in this directory?</h1>
7
8 #ifdef STYLElist
9
10 <p>These are list files.</p>
11
12 <h2>How do I use these files?</h2>
13
14 <p>
15 The list files here simply describe what files are contained in
16 each Debian ISO image, in order to help users find which images
17 they might want to download. They are simply text files, compressed
18 to save space and download time.</p>
19
20 #else
21 # ifdef ARCHsource
22
23 <p>These are files containing source code for the Debian
24 operating system.</p>
25
26 # else
27
28 <p>These are files containing the installer and other software
29 for the Debian GNU/KERNEL operating system.
30
31 # ifdef ARCHmulti
32
33 The files in this directory are designed to work on both 32-bit
34 and 64-bit PCs (<code>i386</code> and <code>amd64</code>).
35
36 # else
37
38 The files in this directory are specifically for
39 the <code>ARCH</code> architecture.
40
41 # endif
42
43 </p>
44
45 # endif
46
47 <h2>How do I use these files?</h2>
48
49 # ifdef STYLEjigdo
50
51 <p>The files here are in "jigdo"
52 format. Use <a href="https://www.debian.org/CD/jigdo-cd/">jigdo</a>
53 tools to download the contents of the complete ISO image files
54 from what's here and a normal Debian mirror. You should end up
55 with an exact copy of each ISO image as though you'd downloaded
56 it directly via HTTP or FTP.</p>
57
58 # elif defined(STYLEbt)
59
60 <p>The files here are bittorrent files. Use
61 a <a href="https://www.debian.org/CD/torrent-cd/">bittorrent</a>
62 client program to download the contents of the complete ISO image
63 files in a peer-to-peer manner. You should end up with an exact
64 copy of each ISO image as though you'd downloaded it directly via
65 HTTP or FTP.</p>
66
67 # elif defined(STYLEiso)
68
69 <p>The files here are complete ISO images, ready to use.</p>
70
71 # endif
72
73 <p> Once you have downloaded all the ISO images you want, you will
74 typically need to write them to installation media.</p>
75
76 <h2>What size and type of media will I need?</h2>
77
78 <p>The images described here are sized to be written to
79
80 # ifdef TYPEcd
81 writeable CD media
82 # elif TYPEdvd
83 writeable DVD media
84 # elif TYPEbd
85 writeable Blu-Ray media
86 # elif TYPE16G
87 16GB USB media
88 # elif TYPEdlbd
89 writeable dual-layer Blu-Ray media
90 # endif
91
92 at a minimum, but may be written to larger media if needed.</p>
93
94 # ifdef ISOHYBRID
95
96 <p>For extra convenience, <strong>these images may also be written
97 directly to a USB stick</strong>. So long as your computer will
98 boot directly from that USB stick, it should start the Debian
99 installer that way.
100
101 # if defined(TYPEdvd)
102
103 The first DVD in this set is also deliberately limited in size
104 so it should fit on a standard-sized 4GB USB stick.
105
106 # endif
107 # endif
108 </p>
109
110 # if !defined(ONEonly) && !defined(ARCHsource)
111
112 <h2>There are lots of files here! Do I need all of them?</h2>
113
114 <p>In most cases it is not necessary to download and
115 use <strong>all</strong> of these images to be able to install
116 Debian on your computer. Debian comes with a massive set of
117 software packages, hence why it takes so many disks for a
118 complete set. Most typical users only need a small subset of
119 those software packages.</p>
120
121 # if !defined(TYPEcd)
122
123 <p>Initially, you will only need to download and use
124 the <strong>first</strong> image of a set (labelled as
125 <code>debian-<i>something</i>-1</code> to be able to start the
126 Debian installer and set up Debian on your computer. If there are
127 more images available here
128 (labelled <code>debian-<i>something</i>-2</code>,
129 <code>debian-<i>something</i>-3</code>, etc.), they contain the
130 extra packages that can be installed on a Debian system (as
131 mentioned previously). They will <strong>not</strong> be
132 bootable and are entirely optional. If you have a fast Internet
133 connection, you're most likely better off installing any
134 desired extra packages directly from the Debian mirrors on the
135 Internet instead of by using these extra images.</p>
136
137 # endif
138
139 # endif
140
141 # if defined(TYPEcd) && !defined(ARCHsource) && !defined(STYLElist)
142
143 <h2>What is a netinst image?</h2>
144
145 <p>The <code>netinst</code> CD here is a small CD image that
146 contains just the core Debian installer code and a small core set
147 of text-mode programs (known as "standard" in Debian). To install
148 a desktop or other common software, you'll also need either an
149 Internet connection or some other Debian CD/DVD images.</p>
150
151 # if defined(ARCHi386)
152
153 <h2>What is an edu netinst image?</h2>
154
155 <p>The <code>edu netinst</code> CD here is a special version of
156 the netinst CD image that is targeted specifically at 32-bit
157 Intel machines. It provides a menu to install the Debian Edu Pure
158 Blend. See the <a href="https://wiki.debian.org/DebianEdu/">
159 Debian Wiki</a> for more information.</p>
160
161 # endif
162
163 # if defined(ARCHamd64)
164
165 <h2>What is an edu netinst image?</h2>
166
167 <p>The <code>edu netinst</code> CD here is a special version of
168 the netinst CD image that is targeted specifically at 64-bit
169 Intel machines. It provides a menu to install the Debian Edu Pure
170 Blend. See the <a href="https://wiki.debian.org/DebianEdu/">
171 Debian Wiki</a> for more information.</p>
172
173 # endif
174
175 # if defined(ARCHi386)
176
177 <h2>What is a mac netinst image?</h2>
178
179 <p>The <code>mac netinst</code> CD here is a special version of
180 the netinst CD image that is targeted specifically at older
181 32-bit Intel Macintosh machines. It will likely work on most
182 other i386 machines too, but it does not contain UEFI boot
183 files that some people
184 need. See <a href="https://wiki.debian.org/MacMiniIntel#Macmini_1.2C1">
185 the Debian Wiki</a> for more information.</p>
186
187 # endif
188
189 # if defined(ARCHamd64)
190
191 <h2>What is a mac netinst image?</h2>
192
193 <p>The <code>mac netinst</code> CD here is a special version of
194 the netinst CD image that is targeted specifically at older
195 64-bit Intel Macintosh machines. It will likely work on most
196 other amd64 machines too, but it does not contain UEFI boot
197 files that some people
198 need. See <a href="https://wiki.debian.org/MacMiniIntel#Macmini_2.2C1">
199 the Debian Wiki</a> for more information.</p>
200
201 # endif
202
203 # endif
204
205 # if defined(TYPEbd) && !defined(ARCHsource) && !defined(STYLElist)
206
207 # if defined(ARCHi386)
208
209 <h2>What is an edu BD image?</h2>
210
211 <p>The <code>edu</code> BD here is a special version of
212 the BD image that is targeted specifically at 32-bit Intel machines.
213 It provides a menu to install the Debian Edu Pure Blend without the
214 need of an Internet connection. See the
215 <a href="https://wiki.debian.org/DebianEdu/">Debian Wiki</a> for
216 more information.</p>
217
218 # endif
219
220 # if defined(ARCHamd64)
221
222 <h2>What is an edu BD image?</h2>
223
224 <p>The <code>edu</code> BD here is a special version of
225 the BD image that is targeted specifically at 64-bit Intel machines.
226 It provides a menu to install the Debian Edu Pure Blend without the
227 need of an Internet connection. See the
228 <a href="https://wiki.debian.org/DebianEdu/">Debian Wiki</a> for
229 more information.</p>
230
231 # endif
232
233 # endif
234
235 # ifdef UPDATES
236
237 <p>The <code>update</code> files here are extra convenience files
238 for people updating from previous versions of Debian. If you are
239 installing fresh, you may safely ignore
240 them. <a href="https://www.debian.org/CD/faq/#update-cd">More
241 details...</a></p>
242
243 # endif
244
245 <h2>How can I verify my download is correct and exactly what has
246 been created by Debian?</h2>
247
248 <p>There are files here (SHA512SUMS, etc.) which contain checksums
249 of the images. These checksum files are also signed - see the
250 matching .sign files. Once you've downloaded an image, you can
251 check:</p>
252
253 <ul>
254 <li>that its checksum matches that expected from the checksum file; and
255 <li>that the checksum file has not been tampered with.
256 </ul>
257
258 <p>For more information about how to do these steps, read
259 the <a href="https://www.debian.org/CD/verify">verification guide</a>.
260
261 #endif
262
263 #if !defined(ONEonly) && (defined(STYLEbt) || defined(STYLEiso))
264
265 <h2>Only the first few images are available! Where are the rest?</h2>
266
267 <p>We don't store/serve the full set of ISO images for all
268 architectures, to reduce the amount of space taken up on the
269 mirrors. You can
270 <a href="https://www.debian.org/CD/faq/#why-jigdo">use the jigdo
271 tool</a> to recreate the missing ISO images instead.</p>
272
273 #endif
274
275 <h2>Non-free Firmware</h2>
276
277 <p>This Debian image build only includes Free Software where
278 possible. However, many systems include hardware which depends on
279 non-free firmware to function properly so this build also includes
280 those firmware files for those cases. See the Debian
281 Wiki <a href="https://wiki.debian.org/Firmware">non-free
282 firmware</a> page for more information.
283
284 <h2>Other questions?</h2>
285
286 <p>See the Debian CD <a href="https://www.debian.org/CD/faq/">FAQ</a>
287 for lots more information about Debian CDs and installation.</p>
288
289 <p>The images here were put together by
290 the <a href="https://wiki.debian.org/Teams/DebianCd">Debian CD team</a>
291 , using debian-cd and other software.</p>