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