From b5e4ddc950b466e7779e364a746b8de6f9fa79a8 Mon Sep 17 00:00:00 2001 From: Steve McIntyre <93sam@debian.org> Date: Mon, 3 Apr 2006 00:20:54 +0000 Subject: [PATCH] More WIP on documentation --- docs/getting.html | 40 +++++++++++++++++++++++++++++++++++ docs/index.html | 5 ++++- docs/requirements.html | 47 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 91 insertions(+), 1 deletion(-) create mode 100644 docs/getting.html create mode 100644 docs/requirements.html diff --git a/docs/getting.html b/docs/getting.html new file mode 100644 index 00000000..f2822203 --- /dev/null +++ b/docs/getting.html @@ -0,0 +1,40 @@ + + +getting debian-cd + +getting debian-cd + +

Development versions - using svn

+ +

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

+ +

svn://svn.debian.org/svn/debian-cd/trunk

+ +

Debian packages

+ +

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!

+ +

Support

+ +

debian-cd development and support happens on the debian-cd mailing +list; see http://lists.debian.org/debian-cd/ +for archives and details of how to subscribe.

+ +

+ +

+(c) Steve McIntyre <steve@einval.com>, April 2006. GPL v2
+Prev - Overview
+Next - Requirements + + diff --git a/docs/index.html b/docs/index.html index 5fc491fb..067fcf34 100644 --- a/docs/index.html +++ b/docs/index.html @@ -72,5 +72,8 @@ jigdo files

This is a rough guide only - see later for more details on each of the steps!

+
+(c) Steve McIntyre <steve@einval.com>, April 2006. GPL v2
+Next - Getting debian-cd - \ No newline at end of file + diff --git a/docs/requirements.html b/docs/requirements.html new file mode 100644 index 00000000..b9260029 --- /dev/null +++ b/docs/requirements.html @@ -0,0 +1,47 @@ + + +debian-cd requirements + +debian-cd requirements + +

debian-cd has a few dependencies, some obvious and some less +so. The packaged version in Debian depends on the key items that +must be installed, and recommends lots of others.

+ +

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).

+ +

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 doc, indices +and tools directories from the root of the archive. Be +aware the commonly-used debmirror package does +not currently grab those directories when +mirroring. Most debian-cd users tend to use rsync to +mirror the archive.

+ +

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.

+ +

For producing jigdo files, older versions +of debian-cd (up to and including the sarge release) used +jigdo-file to parse ISO images and output the +jigdos. Newer versions of debian-cd (v2.2.24 and newer) instead use a +patched version of mkisofs which can natively create +jigdo files. This needs mkisofs version 4:2.01+01a03-4 or newer in +Debian.

+ +
+(c) Steve McIntyre <steve@einval.com>, April 2006. GPL v2
+Prev - Getting debian-cd
+Next - Setup + +