Document the recent upgrade of the printf and scanf families of functions.
[dragonfly.git] / nrelease / README
1 $DragonFly: src/nrelease/Attic/README,v 1.2 2006/07/16 23:06:56 dillon Exp $
2
3 The DragonFly framework for building ISO image (nrelease)
4 =========================================================
5
6 Important user-tunable variables
7 --------------------------------
8
9 ISODIR                  default prefix of ISOFILE and ISOROOT
10 ISOFILE                 name of the ISO image to generate
11 ISOROOT                 location where to fresh world is installed to
12 KERNCONF                kernel configuration to use
13
14 PKGSRC_PACKAGES         default list of packages to be added to the ISO
15 PKGSRC_PKG_ADD          location of pkgsrc-style pkg_add used during build
16 PKGSRC_PKG_PATH         location of binary packages to be added to the ISO
17 PKGSRC_BOOTSTRAP_FILE   location of the bootstrap kit
18                         (this must be local, PKGSRC_PKG_PATH can be remote)
19 PKGSRC_DB               db location used by the bootstrap kit
20 PKGSRC_PREFIX           localbase used by the bootstrap kit
21 PKGSRC_RSYNC_SRC        where to fetch packages from during make fetch
22
23 WITH_INSTALLER          if defined, the BSD installer is added to the target
24
25 The default values match the packages from packages.stura.uni-rostock.de.
26
27
28 Important targets
29 -----------------
30
31 fetch                   fetches the bootstrap kit and binary packages using rsync
32 release                 builds world and kernel, installs them, adds packages and
33                         prepares the ISO image
34 quickrel                same as release, but use quickworld and quickkernel
35 realquickrel            same as release, but skips buildworld and buildkernel
36
37
38 First time usage
39 ----------------
40
41 The nrelease framework expects to find a working pkg_add from pkgsrc.
42 You can use the bootstrap kit, which matches the default configuration,
43 or install it yourself.  If you use a location other than /usr/pkg, you
44 have to specify PKGSRC_PKG_ADD in make.conf.
45
46 If you want to have any packages install in the ISO (the default), run
47 ``make fetch'' first, to get them and the bootstrap kit used in the ISO.
48 By default, the current directory is used, the location can and should
49 be overriden by PKGSRC_PKG_PATH in make.conf.
50
51 RELEASE ENGINEERING
52 --------------------------------
53
54 The steps required for engineering a release are documented in (CVS)
55 doc/notes/release.txt.  How to branch the CVS tree, etc.  They were put
56 in an out of the way place so normal developers would not accidently try
57 to run the commands in question.
58