update from sunny@opencurve.org

1 files changed, 53 insertions, 42 deletions

diff --git a/docs/HACKING b/docs/HACKING
index 4e3d51661..3d22a785f 100644
--- a/docs/HACKING
+++ b/docs/HACKING
@@ -10,23 +10,20 @@ Beware, don't try this on a production machine with important data.
 --------------------------------------------------------------------------
 Sources installation:
 
-  First grab the gi.tar.bz2 archive and untar it in your home directory,
-for example from DrakX-*.src.rpm on your Mandrake Linux distribution.
+First grab the gi.tar.bz2 archive and untar it in your home directory, for 
+example from DrakX-*.src.rpm on your Mandrake Linux distribution.
 
-cd to gi
-for i in `du -a | grep CVS/Root | cut -f 2`
-do
-  sed -e 's/prigaux/anoncvs/' $i > $i.tmp
-  mv $i.tmp $i
-done
+Fix a few things:
+% find gi -name "*/CVS/root/*" | xargs perl -pi -e 's/prigaux/anoncvs/'
 
 Then, log yourself into the cvs:
 % export CVS_RSH=ssh
 % export CVSROOT=:ext:anoncvs@cvs.mandrakesoft.com:/cooker
 % cvs checkout gi
-	(passwd: 'cvs')
+        (the passwd is: 'cvs')
+
 And update the gi package:
-cvs update -P -d
+% cvs update -P -d
 
 
 --------------------------------------------------------------------------
@@ -34,49 +31,61 @@ 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'll need roughly 1.5
-Gbytes for a full install.
+Create a /export directory and give write permissions to the user/group that 
+will be compiling DrakX.  It is also suggested that you copy a recent 
+Mandrake Linux CD in there. (You don't have to put have all the RPMS...) ; 
+you'll need roughly 1.5 Gbytes for a full install. (It is possible to not 
+have a copy of Mandrake Linux there, if all you desire is to compile gi)
+
 
-[gc@obiwan ~/cvs/gi] su -c "mkdir /export"
+(2) support directories
 
+You will need to create an /RPMS directory.  This directory needs to be 
+populated with the following RPMS:
+locales-ja locales-ko locales-zh
 
-(2) devel packages
+gi needs to be informed about which kernel(s) is/are to be used.  A 
+directory with the following structure and files is needed for each kernel 
+you want to use:  (2.6.0 is the example kernel)
 
-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, libbzip2*, libncurses*.
+gi/kernel/all.kernels/2.6.0
+                           /boot
+                                System.map-2.6.0
+                                vmlinuz-2.6.0
+                           /lib/modules/2.6.0
+                                (the module directory for the current 
+kernel)
 
-you may need a few others I forgot to mention. if the compilation
-fails, try to understand the message and install any necessary
-remaining package.
+Note:  the modules must not be in compressed form (*.gz *.bz2 etc)
 
 
-(3) sudo
+(3) required rpm packages
 
-never build or run DrakX as root; install package sudo, and set up
-relevant permissions; the following should be enough: (in your
-/etc/sudoers)
+You need quite a number of rpm packages to build gi properly. Roughly:
+emacs gcc make glibc-devel glibc-static-devel perl-devel XFree86 
+XFree86-FBDev XFree86-VGA16 XFree86-devel libglib-devel libgtk+-devel 
+perl-GTK ldetect ldetect-devel ldetect-lst ldetect-lst-devel libslang-devel 
+libnewt-devel e2fsprogs libext2fs2-devel dosfstools rpm-devel rpmtools 
+libbzip2_1 libbzip2_1-devel libncurses5 libncurses5-devel setserial telnet 
+parted raidtools pciutils mt-st gpart reiserfsprogs jfsprogs xfsprogs 
+extipl pcmcia-cs gettext perl-Gtk2 perl-Glib ash imlib fb2png ntfsprogs 
+lm_sensors galaxy-gnome perl-PerlIO-gzip brltty lvm2 mkcd
 
-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,NOPASSWD:/bin/mknod
+You may need a few others I forgot to mention. if the compilation fails, try 
+to understand the message and install any necessary remaining package.
 
 
-(4) boot kernel
+(4)
 
-you need one or more kernels and (all?) their modules. it's
-located in the subdirectory "all.kernels" of the "gi/kernel"
-directory; if you ever grab (or build) another boot kernel,
-replace or add an entry in "all.kernels" as:
+NEVER build or run Drakx as root.  Install sudo and setup the following 
+permissions in /etc/sudoers:
 
-[gc@obiwan ~/cvs/gi/kernel/all.kernels] mkdir 2.4.1-BOOTcustom
-[gc@obiwan ~/cvs/gi/kernel/all.kernels] cd 2.4.1-BOOTcustom
-[gc@obiwan ~/cvs/gi/kernel/all.kernels/2.4.1-BOOTcustom] tar jxvf ~/mycustomkernel.tar.bz2
-[gc@obiwan ~/cvs/gi/kernel/all.kernels/2.4.1-BOOTcustom] ls
-boot/  lib/
+user 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,NOPASSWD:/bin/mknod
 
+(5)
 
-(5) pray
+pray
 
 [gc@obiwan ~/cvs/gi] make
 
@@ -88,11 +97,11 @@ The comments written with #- are automatically stripped out at install.
 ---------------------------------------------------------------------------
 testing all:
 
-  go to the perl-install directory and execute ./install2 --test
+  go to the perl-install directory and execute ./install2 --test
 
-  NEVER execute DrakX as root! You might need to allow all users
-  to read the block devices of your hard-disks, though (chmod a+w
-  /dev/hda* for example).
+  NEVER execute DrakX as root! You might need to allow all users
+  to read the block devices of your hard-disks, though (chmod a+w
+  /dev/hda* for example).
 
 
 
@@ -118,3 +127,5 @@ Here is how I (dams) made it work on my computer.
 
 
 address all bugreports to dave@null.com
+
+info has been added by sunny@opencurve.org
\ No newline at end of file