From fb104622e264944b4b01f492b70c0eb9557a19a2 Mon Sep 17 00:00:00 2001 From: Guillaume Cottenceau Date: Thu, 25 Jan 2001 16:30:09 +0000 Subject: update docs --- docs/HACKING | 88 ++++++++++++++++++++++++++++++++++++++++-------------- docs/README | 2 +- docs/TODO | 4 +-- docs/mdk-vs-redhat | 17 +++++++++++ 4 files changed, 85 insertions(+), 26 deletions(-) (limited to 'docs') diff --git a/docs/HACKING b/docs/HACKING index af150fa8b..8f3092e32 100644 --- a/docs/HACKING +++ b/docs/HACKING @@ -1,16 +1,19 @@ +-=-=-- DrakX is a very big project, and it needs special setups to work. The purpose of this file is to explain how you can setup your box to make it -compile and run safely. +compile and run. +-=-=-- + +Beware, don't try this on a production machine with important data. -[ Caution!!! This file isn't finished yet, so it isn't 100% safe to use it on - a production machine ] -------------------------------------------------------------------------- Sources installation: - First grab the gi.tar.bz2 archive and untar it in your home directory. + First grab the gi.tar.bz2 archive and untar it in your home directory, +for example from DrakX-*.src.rpm on your Linux-Mandrake distribution. + cd to gi -If you're not Pixel, run this: for i in `du -a | grep CVS/Root | cut -f 2` do sed -e 's/prigaux/anoncvs/' $i > $i.tmp @@ -18,25 +21,70 @@ do done Then, log yourself into the cvs: -cvs login -(The Password is 'cvs') +% export CVSROOT=:pserver:anoncvs@mandrakesoft.com:/home/cvs/cooker +% cvs login +% Passwd: cvs +% cvs checkout gi + And update the gi package: cvs update -P + -------------------------------------------------------------------------- Preparing the compilation process: +(1) target directory + create a /export directory and copy a recent Mandrake-Linux CD in there. -(You don't have to put have all the RPMS...) +(You don't have to put have all the RPMS...) ; you'll need roughly 1.5 +Gbytes for a full install. + +[gc@obiwan ~/cvs/gi] su -c "mkdir /export" + + +(2) devel packages + +you need quite a few devel packages to run the stuff; roughly: gcc, make, +glibc-devel, perl-devel, XFree86-devel, libglib-devel, libgtk+-devel, +perl-GTK, ldetect*, libslang-devel, libnewt-devel, e2fsprogs, dosfstools, +rpm-devel, popt-devel, rpmtools. + + +(3) sudo + +never build or run DrakX as root; install package sudo, and set up +relevant permissions; the following should be enough: (in your +/etc/sudoers) -return to the gi directory, and type: -ln -s /usr/bin/perl . -make +gc ALL=(root) NOPASSWD:/usr/bin/patch,NOPASSWD:/bin/rpm,NOPASSWD:/bin/mount,NOPASSWD:/bin/cp,NOPASSWD:/bin/umount,NOPASSWD:/usr/bin/install,NOPASSWD:/bin/rm,NOPASSWD:/bin/mv,NOPASSWD:/bin/tar,NOPASSWD:/bin/cpio,NOPASSWD:/bin/chown,NOPASSWD:/bin/mkdir,NOPASSWD:/usr/bin/strip + + +(4) boot kernel + +you need a boot kernel and some kind of modules for each boot floppy. it's +located in subdirectory "kernel" in DrakX-*.src.rpm ; if you ever grab (or +build) another boot kernel, re-do following step (c). + + (a) build the packager software for stage1 (read README file to know what's stage1) + [gc@obiwan ~/cvs/gi] cd mdk-stage1/mar + [gc@obiwan ~/cvs/gi/mdk-stage1/mar] make + + (b) build the perl stuff for stage2 + [gc@obiwan ~/cvs/gi] cd perl-install + [gc@obiwan ~/cvs/gi/perl-install] make + + (c) build kernel/modules stuff for stage1 and stage2 + [gc@obiwan ~/cvs/gi] ./update_kernel + + +(5) pray + +[gc@obiwan ~/cvs/gi] make --------------------------------------------------------------------------- -The comments are written with #- -You should use #+ instead of #- if the code is i18n'ed +The comments written with #- are automatically stripped out at install. + --------------------------------------------------------------------------- testing all: @@ -48,15 +96,10 @@ testing all: NEVER compile and/or execute DrakX as root! --- - DindinX - Last change: Mon Feb 21 12:47:06 CET 2000 - -(dam's): -Here is how I made it work on my computer. ------------------------------------------- +Here is how I (dams) made it work on my computer. +------------------------------------------------- - get the sources - install the librairies needed included newt-devel gtk+-devel popt-devel popt gtk-engines @@ -73,7 +116,6 @@ Here is how I made it work on my computer. - cd path/to/gi/perl-install - ./install2 in root (dangerous) or chmod a+r /dev/hd* and ./install2 in user --- - dam's - Last change : Thu Jul 20 14:15:30 CET 2000 + +address all bugreports to dave@null.com diff --git a/docs/README b/docs/README index 1a2534c4c..e92420e6f 100644 --- a/docs/README +++ b/docs/README @@ -156,7 +156,7 @@ If the media you use to install is a pcmcia device, use the pcmcia boot disk. The DrakX install is much bigger than the newt one. So the ramdisk which was used is getting big, and costs a lot in memory (eg: the mdkinst_stage2 is 14MB - 23/09/99) -(update! now size is 22MB - 24/01/01) +(update! now size is 21MB - 24/01/01) | | newt | DrakX |-------+---------+---------------------------------------------------------- diff --git a/docs/TODO b/docs/TODO index 70eff4439..cb9399f82 100644 --- a/docs/TODO +++ b/docs/TODO @@ -11,7 +11,7 @@ warning on diskdrake startup, made them as warning ?). add rpmdrake in menu (7.1 or later) clean SCSI CDROM autoboot. -stage1 & cdrom: add ability in expert to choose the scsi cdrom drive to use +(done,gc,8.0) stage1 & cdrom: add ability in expert to choose the scsi cdrom drive to use (7.1)better help for partitioning in newbie @@ -29,7 +29,7 @@ PPPoE install and configuration (SuSE includes it, DHCP-like) ask "do you have SCSI?" before asking "probe PCI or not" (?) paride in stage1 -stage1 & network: add ability to choose the network interface to use +(done,gc,8.0) stage1 & network: add ability to choose the network interface to use (?) msec custom diff --git a/docs/mdk-vs-redhat b/docs/mdk-vs-redhat index 88e59a2e8..c83d6e2cc 100644 --- a/docs/mdk-vs-redhat +++ b/docs/mdk-vs-redhat @@ -20,6 +20,23 @@ + default config + i18n (bootloader keyboard) ++ More user-friendliness in general: + + you can choose between multiple net devices when more than one are + detected + + you are presented with the media descriptions (disks, cdrom's) + when you must choose between multiple media, and not only "sda", + "hdc", .. + + when installing from a disk partition, you are presented with an + extract of the directory contents when you fail to give the + correct location, which is very helpful to correct the input + instead of simply rebooting to remember where on earth you + mirrored the distribution on your disks ++ Automatic mode (Redhat's equivalent is called "kickstart") is not + performed according to a file on the floppy but from kernel parameters, + which have many pros, among them: (1) we don't need the vfat filesystem + for that purpose, and (2) with advanced bootloaders such as grub and + lilo you can edit parameters on the fly at boot time. + - no LABEL= in fstab (for auto renumbering of devices) - kerberos - LDAP -- cgit v1.2.1