More WIP on documentation

This commit is contained in:
Steve McIntyre 2006-04-03 00:20:54 +00:00
parent 7dc5813457
commit b5e4ddc950
3 changed files with 91 additions and 1 deletions

40
docs/getting.html Normal file
View File

@ -0,0 +1,40 @@
<html>
<head>
<title>getting debian-cd</title>
</head>
<body
<h1>getting debian-cd</h1>
<h2>Development versions - using svn</h2>
<p>debian-cd is actively maintained by a team of people, a mixture of
the initial developers and assorted users including the
debian-installer team. The main repository is stored in a subversion
repository on Debian's alioth server, where it can be checked out
anonymously as</p>
<p><code>svn://svn.debian.org/svn/debian-cd/trunk</code></p>
<h2>Debian packages</h2>
<p>debian-cd is also packaged and distributed as normal as a debian
package. Be aware that the version of debian-cd needed can depend on
the target version of Debian for your CDs, for example building etch
CDs will need either a checkout from subversion or the very latest
packaged version. Debian testing versions are a moving target!</p>
<h2>Support</h2>
<p>debian-cd development and support happens on the debian-cd mailing
list; see <a
href="http://lists.debian.org/debian-cd/">http://lists.debian.org/debian-cd/</a>
for archives and details of how to subscribe.</p>
<p>
<hr>
(c) Steve McIntyre &lt;steve@einval.com&gt;, April 2006. GPL v2<br>
<a href="index.html">Prev - Overview</a><br>
<a href="requirements.html">Next - Requirements</a>
</body>
</html>

View File

@ -72,5 +72,8 @@ jigdo files
<p>This is a <strong>rough</strong> guide only - see later for more
details on each of the steps!</p>
<hr>
(c) Steve McIntyre &lt;steve@einval.com&gt;, April 2006. GPL v2<br>
<a href="getting.html">Next - Getting debian-cd</a>
</body>
</html>
</html>

47
docs/requirements.html Normal file
View File

@ -0,0 +1,47 @@
<html>
<head>
<title>debian-cd requirements</title>
</head>
<body
<h1>debian-cd requirements</h1>
<p>debian-cd has a few dependencies, some obvious and some less
so. The packaged version in Debian depends on the key items that
<strong>must</strong> be installed, and recommends lots of others.</p>
<p>This recommendation works, as many of the deps are
optional. Exactly which sets of packages will be needed is determined
by the architectures you wish to build CDs for. On some architectures,
making bootable CDs needs extra support from other packages (e.g. palo
for hppa CDs).</p>
<p>The other important dependency for debian-cd cannot be represented
so easily - it needs a copy of parts of the Debian archive to be able
to build CDs. This includes the <code>doc</code>, <code>indices</code>
and <code>tools</code> directories from the root of the archive. Be
aware the commonly-used <code>debmirror</code> package does
<strong>not</strong> currently grab those directories when
mirroring. Most debian-cd users tend to use <code>rsync</code> to
mirror the archive.</p>
<p>For best performance, the mirror should be on a local disk and the
user running debian-cd should have permissions to be able to create
hard links on the same filesystem. It should be possible to run
without this, using symbolic links instead of hard links, but the code
to do this is not as well tested and can be expected to be much
slower.</p>
<p>For producing <a href="jigdo.html">jigdo</a> files, older versions
of debian-cd (up to and including the sarge release) used
<code>jigdo-file</code> to parse ISO images and output the
jigdos. Newer versions of debian-cd (v2.2.24 and newer) instead use a
patched version of <code>mkisofs</code> which can natively create
jigdo files. This needs mkisofs version 4:2.01+01a03-4 or newer in
Debian.</p>
<hr>
(c) Steve McIntyre &lt;steve@einval.com&gt;, April 2006. GPL v2<br>
<a href="getting.html">Prev - Getting debian-cd</a><br>
<a href="setup.html">Next - Setup</a>
</body>
</html>