syslinux-3.08-2 sources from FC4
[bootcd.git] / syslinux / distrib.doc
1 For creators of Linux distributions:
2
3 SYSLINUX is a notoriously hard program to debug, since it runs outside
4 of any operating system, and has a tendency to expose BIOS and
5 hardware bugs on various systems.  Therefore, I would appreciate if
6 you would resist the temptation of recompiling the SYSLINUX bootloader
7 itself (ldlinux.asm) if at all possible.  If you do that, I will have
8 to refer any bug reports I receive back to the respective distributor.
9
10 However, I have no such concerns about recompiling the installer
11 programs, and in fact, with both libc 5 and libc 6 in common use in
12 the Linux world today I understand if you wish to relink the
13 Linux-based installer against your system version of libc.  Therefore
14 a special makefile targets "make installer" has been included with the
15 SYSLINUX distribution, starting with version 1.42.
16
17 To rebuild the installer programs *only*, starting from a freshly
18 untarred distribution copy of SYSLINUX, do:
19
20         make clean
21         make installer
22
23 If you want to remove all intermediate files, including the ones
24 obtained from assembling ldlinux.asm and which are included in the
25 distribution, do "make spotless".
26
27 I appreciate your assistance in this matter.
28
29         H. Peter Anvin
30