Package: simple-cdd Version: 0.3.13 Severity: minor Tags: patch Hi,
the attached patch updates the Quick Start section in the README file. (from http://wiki.debian.org/Simple-CDD/Howto. My editor trimmed all trailing spaces, sorry) Regards Stefan
diff -uNrp simple-cdd-0.3.13.original/README simple-cdd-0.3.13/README --- simple-cdd-0.3.13.original/README 2009-10-30 07:56:58.000000000 +0100 +++ simple-cdd-0.3.13/README 2010-07-28 16:43:56.337659225 +0200 @@ -1,4 +1,4 @@ -here's a quick guide to using simple-cdd... +here's a quick guide to using simple-cdd... if you have further questions, ask on the simple-cdd-devel mailing list: http://lists.alioth.debian.org/mailman/listinfo/simple-cdd-devel, or in the @@ -7,67 +7,59 @@ debian-custom channel on irc.debian.org. Quick Start (from http://wiki.debian.org/Simple-CDD/Howto) -if you want to try Simple-CDD, on an etch system: +To try Simple-CDD, on a Debian system: - mkdir ~/my-simple-cdd +Install simple-cdd (as root): - cd ~/my-simple-cdd + # apt-get install simple-cdd -add to your sources.list: +Create a working directory (as a user): - echo deb http://http.us.debian.org/debian sid main >> /etc/apt/sources.list + $ mkdir ~/my-simple-cdd + $ cd ~/my-simple-cdd - apt-get update +Build a basic CD: - apt-get -t stable install simple-cdd + $ build-simple-cdd - apt-get update +This will create a partial package mirror in the directory tmp/mirror, and if +all goes well, an .iso CD image in the "images" directory when it is finished. +By default, target CDD release version is the same as the host version. You can +specify the optional argument --dist to change the targets version. For example, +it can be etch, lenny, sid, etc. +If this step doesn't work, you need to figure out why before trying more +complicated things. -comment out the lines in /etc/apt/sources.list, or configure apt pinning so it -doesn't pull in unstable packages. +Create a profile named NAME: -build a basic CD, and include simple-cdd-profiles .udeb from sid: + $ mkdir profiles + $ for p in list-of-packages-you-want-installed ; do echo $p >> profiles/NAME.packages ; done - build-simple-cdd --profiles-udeb-dist sid - -this will create a partial package mirror in the dir "tmp/mirror", and if all -goes well, an .iso CD image in the "images" dir when it is finished. if this -step doesn't work, you need to figure out why before trying more complicated -things. - -create a profile named NAME: - - mkdir profiles - - for p in list of packages you want installed ; do echo $p >> profiles/NAME.packages ; done - -note that you should not include package dependencies, but only the packages +Note that you should not include package dependencies, but only the packages you actually want. -build the CD with selected profile NAME, and include simple-cdd-profiles .udeb -from sid: +Build the CD with selected profile NAME: - build-simple-cdd --profiles NAME --profiles-udeb-dist sid + $ build-simple-cdd --profiles NAME -this should create an .iso CD image in the "images" dir when it is finished -with your custom profile. +This should create an .iso CD image in the "images" directory when it is +finished with your custom profile. -use qemu to test: +Use qemu to test: - apt-get install qemu + # apt-get install qemu + $ build-simple-cdd --qemu --profiles NAME - build-simple-cdd --qemu --profiles NAME +Optional features: -optional features: +If you want debconf preseeding, put a debconf-set-selections compatible file +into profiles/NAME.preseed. -if you want debconf preseeding, put a debconf-set-selections compatible file -into profiles/NAME.preseed +If you want a custom post-install script, place it in profiles/NAME.postinst. -if you want a custom post-install script, place it in profiles/NAME.postinst +For more options: -for more options: - - build-simple-cdd --help + $ build-simple-cdd --help The Less Quick Start @@ -89,7 +81,7 @@ to make a custom profile, think of a nam edit or create files in the "profiles" directory, beginning with the profile name, and ending in .preseed, .packages, .downloads, etc. for example: -profiles/x-basic.preseed +profiles/x-basic.preseed profiles/x-basic.packages profiles/x-basic.downloads @@ -98,26 +90,26 @@ profiles/x-basic.downloads short, one-line description of the what the profile does *.packages - + packages installed when the profile is selected. do not include packages such as linux-image or grub, as debian-installer will handle these specially. *.downloads - + additional packages included on a CD providing the profile, but not installed by simple-cdd (though debian-installer may install them) *.preseed - + debconf questions loaded if the profile is selected *.postinst - + profile-specific post-install script. runs in the "finish-install" phase of debian-installer. *.conf - + profile-specific configuration settings. sourced during CD build. @@ -127,7 +119,7 @@ to build a CD image with the x-basic pro when installing from the CD, a menu should pop up asking you which profiles you want to install. select all the profiles you want, and the debconf preseed -files will populate the debconf database, and the packages will be installed. +files will populate the debconf database, and the packages will be installed. Default Profile @@ -163,7 +155,7 @@ Automatically Selecting Profiles to automatically select profiles, in profiles/default.preseed, uncomment the line: - simple-cdd simple-cdd/profiles multiselect + simple-cdd simple-cdd/profiles multiselect and add all profiles you want, separated by commas, i.e.:
signature.asc
Description: OpenPGP digital signature
