| 1 |
README for those who want to hack on debian-cd
|
| 2 |
----------------------------------------------
|
| 3 |
|
| 4 |
Organisation :
|
| 5 |
--------------
|
| 6 |
|
| 7 |
The main source is in the Debian svn. If you want to hack on debian-cd
|
| 8 |
and if you want to send me patches, please work on the latest version
|
| 9 |
available in svn.
|
| 10 |
|
| 11 |
auth: svn+ssh://svn.debian.org/svn/debian-cd/trunk
|
| 12 |
anon: svn://svn.debian.org/debian-cd/trunk
|
| 13 |
web: http://svn.debian.org/wsvn/debian-cd
|
| 14 |
|
| 15 |
If you want to discuss anything related to the debian-cd development,
|
| 16 |
mail the debian-cd@lists.debian.org mailing list where all people
|
| 17 |
interested in the debian-cd development are subscribed.
|
| 18 |
|
| 19 |
Technical details :
|
| 20 |
-------------------
|
| 21 |
|
| 22 |
The Makefile which is the main directory will be used to launch
|
| 23 |
each step of the install process. Try to comment each target of
|
| 24 |
the makefile so that other can know why it's here. If you need
|
| 25 |
specific programs (perl or shell scripts), please put them
|
| 26 |
in the tools directory.
|
| 27 |
|
| 28 |
The tasks directory will contain files listing packages (the
|
| 29 |
order in which package are listed is important, each package
|
| 30 |
added will be added to the current CD until it's full).
|
| 31 |
|
| 32 |
The data dir will contains useful data (not directly task
|
| 33 |
related) like the master file from boot-floppies and so on.
|
| 34 |
|
| 35 |
Each tool is self-documented, if you want to know what it
|
| 36 |
does read the sources (they are scripts).
|
| 37 |
|
| 38 |
Debugging debian-cd :
|
| 39 |
---------------------
|
| 40 |
|
| 41 |
If you want to read more about what YACS is doing you can set
|
| 42 |
the VERBOSE environment variable to 1, 2 or 3 depending on the
|
| 43 |
level of noise that you want.
|
| 44 |
|
| 45 |
Some scripts generates their own log files in the temp dir. You
|
| 46 |
can take a look at them if you want to check for warnings
|
| 47 |
and so on.
|
| 48 |
Log files :
|
| 49 |
- $TDIR/$CODENAME/log.list2cds
|
| 50 |
- $TDIR/$CODENAME/make_disc_trees.log
|
| 51 |
|
| 52 |
TODO list :
|
| 53 |
-----------
|
| 54 |
+ put the doc directory only on the first binary CD
|
| 55 |
+ a way to force the inclusion of packages (even broken)
|
| 56 |
+ possibility to add project/* to the last CD
|
| 57 |
|
| 58 |
Bugs / Problems :
|
| 59 |
-----------------
|
| 60 |
* make list will not add contrib packages if you do not
|
| 61 |
select NONFREE too. That's because contrib is broken
|
| 62 |
without non-free. And the building process only allow
|
| 63 |
functional packages to be added.
|
| 64 |
|
| 65 |
Technical choices :
|
| 66 |
-------------------
|
| 67 |
|
| 68 |
For the multiboot on the first CD of an i386 CD set, we had two options
|
| 69 |
isolinux and el-torito native multiboot. We selected isolinux
|
| 70 |
because it works well and it lets you display information to the user.
|
| 71 |
The el-torito multiboot just displays a menu with each item
|
| 72 |
being the same "2.88Mb boot image". Both multiboot mechanism may
|
| 73 |
not work on older hardware with very old BIOSes however the el-torito
|
| 74 |
one works a bit better because it's usually able to boot the first choice
|
| 75 |
without displaying the menu then.
|
Parent Directory
| 
Revision Log