README

   1 # Copyright 1999-2005 Gentoo Foundation
   2 # Distributed under the terms of the GNU General Public License v2
   3 # $Header: /var/cvsroot/gentoo/src/catalyst/README,v 1.14 2005/12/19 21:19:11 wolf31o2 Exp $
   4
   5 Licensing
   6 ========================
   7
   8 Catalyst is copyrighted by the Gentoo Foundation, and released
   9 under the terms of the GNU General Public License v.2.0 or later. For more
  10 information, please consult COPYING.
  11
  12 Disclaimer
  13 ========================
  14
  15 Gentoo Linux extends no warranty or guarantee for catalyst. Use at
  16 your own risk.
  17
  18 Requirements
  19 =======================
  20
  21 - Python 2.4 or greater (may still work with 2.3)
  22 - A portage snapshot (or portage tree to make your own)
  23 - A Gentoo seed stage tarball
  24 - md5sum/sha1sum for simple digesting (MD5/SHA1)
  25 - Archive-Zip for CRC32 checking
  26 - shash for advanced digesting (SHA224 RIPEMD128 RIPEMD320 SHA384 RIPEMD256 SHA256 SHA512 RIPEMD160
  27
  28 What is Catalyst?
  29 ========================
  30
  31 Catalyst is the Gentoo Linux project's release building tool. With catalyst,
  32 you are able to completely customize your Gentoo install by customizing
  33 the very tools you install your system with.
  34
  35 Catalyst is capable of:
  36
  37 - Building installation stages for every architecture supported by Gentoo.
  38 - Building bootable LiveCDs for every architecture supported by Gentoo.
  39 - Building GRP (Gentoo Reference Platform) sets for every architecture supported by Gentoo.
  40 - Setting up a Tinderbox target for test building.
  41 - Building netboot images.
  42
  43 Configuring catalyst
  44 ========================
  45
  46 After emerging catalyst, the first thing (and probably only thing)
  47 that you will have to do is edit /etc/catalyst/catalyst.conf to your liking.
  48
  49 Example catalyst.conf:
  50
  51 distdir="/usr/portage/distfiles"
  52 options="pkgcache kerncache"
  53 sharedir="/usr/lib/catalyst"
  54
  55 There are many more options that can be set, but those defaults are good
  56 for out of the box operation. For more documentation on what you can do
  57 with catalyst, please check the man page or the online documentation at
  58 <http://www.gentoo.org/proj/en/releng/catalyst>.