README for those who want to hack on yacs/debian-cd
---------------------------------------------------

Organisation :
--------------

The main source is in the Debian CVS. If you want to hack on debian-cd
and if you want to send me patches, please work on the latest version
available in the CVS.

http://cvs.debian.org/debian-cd/

$ export CVSROOT=anonymous@cvs.debian.org:/cvs/debian-boot
$ cvs co debian-cd

If you want to discuss anything related to the debian-cd development, you
can contact me directly or, better, you can mail the
debian-cd@lists.debian.org mailing list where all people interested in the
debian-cd development are subscribed.

Technical details :
-------------------

The Makefile which is the main directory will be used to launch
each step of the install process. Try to comment each target of
the makefile so that other can know why it's here. If you need
specific programs (perl or shell scripts), please put them
in the tools directory.

The tasks directory will contain files listing packages (the
order in which package are listed is important, each package
added will be added to the current CD until it's full).

The data dir will contains useful data (not directly task 
related) like the master file from boot-floppies and so on.

Each tool is self-documented, if you want to know what it
does read the sources (they are scripts).

Debugging YACS :
----------------

If you want to read more about what YACS is doing you can set
the VERBOSE environment variable to 1, 2 or 3 depending on the
level of noise that you want.

Some scripts generates their own log files in the temp dir. You 
can take a look at them if you want to check for warnings 
and so on.
Log files :
- $TDIR/$CODENAME-$ARCH/log.list2cds
- $TDIR/$CODENAME-SRC/log.cds2src

TODO list :
-----------
+ put the doc directory only on the first binary CD
+ be able to use an alternate location for the boot disks
  (in order to use i18ned boot disks and to more easily
   test debian-cd with CVS version of the boot-floppies)
+ a way to force the inclusion of packages (even broken)
+ possibility to add project/* to the last CD
+ check the source files on the mirror (with Sources.gz)
  when doing make mirrorcheck

Bugs / Problems :
-----------------
* make list will not add contrib packages if you do not
  select NONFREE too. That's because contrib is broken
  without non-free. And the building process only allow
  functionnal packages to be added.