]> hackdaworld.org Git - hdw-linux/hdw-linux.git/commitdiff
updated BUILD file
authorhackbard <hackbard>
Sat, 24 Jul 2004 03:12:07 +0000 (03:12 +0000)
committerhackbard <hackbard>
Sat, 24 Jul 2004 03:12:07 +0000 (03:12 +0000)
doc/BUILD
doc/CHANGELOG

index ab68eee63b2f60e19b159e59e16298fa51b13736..3dcb36d5fbc1a7b1dbc44e646ecdf1587da477f1 100644 (file)
--- a/doc/BUILD
+++ b/doc/BUILD
@@ -1,21 +1,24 @@
 # hdw - linux BUILD file
 
-welcome to hdw-linux-0.3-dev
+welcome to hdw-linux!
 
-this is a short introduction on how to build hdw-linux. it is supposed to work
-at least for me. though this is dev and may hurt your baby, be warned. i mean
-it!
+this is a short introduction on how to build hdw-linux. the latest stable
+release is supposed to build properly, well at least it works for me.
+please note that the scripts may fuckup your system, especially if you dont
+have any idea what this is all about after reading the files in ./doc.
+be warned, i mean it!
 
 requirements:
 -------------
 
-- working linux system, including gcc and other essential development tools.
-  ( latest versions of automake, autoconf, m4 recommended )
+- working linux system, including gcc and other essential development tools
+  (latest versions of automake, autoconf, m4 recommended)
 - wget, cvs
 - internet connection, or local server using -mirror option
-- devfs supporting kernel.
-- an empty partition (1.5 gb) for building, and 650 mb for sources.
-  (the default target is smaller (900mb & ~200mb)
+- kernel with devfs support for versions <= 0.2
+- a not used partition (900mb-3gb) for building. 250-900mb for sources
+  depending on the selected target
+- x86 hardware for default users, any hardware for development ;)
 
 what to do: (for the impatient)
 -------------------------------
@@ -23,47 +26,50 @@ what to do: (for the impatient)
        build your distribution:
        ------------------------
 
-- get the hdw-linux source from http://hackdaworld.dyndns.org/hdw-linux
+- get the latest stable release of hdw-linux (much better: use cvs)
+  from http://hackdaworld.dyndns.org/hdw-linux
 
        example:
-       mkdir -p /mnt/hdw && cd /mnt/hdw
-       wget http://hackdaworld.dyndns.org/hdw-linux/hdw-linux-0.3-dev-*.tar.bz2
-       tar xvfI hdw-linux-0.3-dev-*.tar.bz2
-       
-- create a filesystem on the empty partition and mount it wherever you want to.
+       mkdir -p /usr/src && cd /usr/src
+       cvs -d:pserver:anonymous@cvs.hackdaworld.dyndns.org:/hdw-linux \
+       co hdw-linux
+       cd hdw-linux
+
+- create a filesystem on the empty partition and mount it wherever you want to
        
        example:
        mke2fs /dev/ide/host0/bus0/target0/lun0/part6
-       mkdir /mnt/hdw/hdw-build
-       mount /dev/ide/host0/bus0/target0/lun0/part6 /mnt/hdw/hdw-build
+       mkdir -p /mnt/hdw-build
+       mount /dev/ide/host0/bus0/target0/lun0/part6 /mnt/hdw-build
 
-- edit ./Config and insert the above mountpoint to hdw_build_dir and
-  chose a target.
+- edit ./Config: insert the above mountpoint to hdw_build_dir and select your
+  prefered target
        
        example:
-       cd hdw-linux*
+
        vi Config
 
        - modify the following line to read:
-       export hdw_build_dir="/mnt/hdw/hdw-build"
+       export hdw_build_dir="/mnt/hdw-build"
        
        - choose your target:
        export hdw_target="mobile"
        
-- if you want to add targets/packages made by the hdw hackers & users community
-  run: (this is optional - in fact it is maybe causing harm to your build)
+- if you want to add targets/packages made by the hdw hackers & user community,
+  run ./scripts/Update-Tree
+  (this is optional - in fact it is maybe causing harm to your build!)
 
        example:
        ./scripts/Update-Tree
 
   (maybe you want to chose another target now in ./Config -- see 'ls ./targets')
 
-- run ./scripts/Puzzle to create the target depending PKGS files.
+- run ./scripts/Puzzle to create the target depending PKGS files
 
        example:
        ./scripts/Puzzle
 
-- run ./scripts/Download to fetch the sources needed to build that target.
+- run ./scripts/Download to fetch the sources needed to build that target,
   alternatively run ./scripts/Download -mirror <mirrorsite>
 
        example:
@@ -71,24 +77,14 @@ what to do: (for the impatient)
        - after that, if you didnt get all the sources:
        ./scripts/Download -mirror http://we-have-no-mrror-by-now/hdw/
 
-- make Build-Distro executable (only needed in some dev snapshots afaik)
-       
-       example:
-       chmod 700 scripts/Build-Distro
-
 - you may now start building: 
        
-       example ./scripts/Build-Distro > build.log. 2>&1; 
-       tail -f ./build.log
-
-
-       optional: create binaries:
-       --------------------------
+       example:
+        ./scripts/Build-Distro
 
-       you have the possibility  to create binary tar.bz2 packages. in that way
-       you can easily install the created system even on other computers. it is
-       also possible to install them on a running system, package installations
-       via net, etc...
+- do not relax, do not get some drinks ... the build will fail and you have to
+  hack the source! in case everything works fine, you may want to have binary
+  packages of your builds. if not, skip the next part.
 
 - create binaries:
 
@@ -98,23 +94,12 @@ what to do: (for the impatient)
        ./scripts/Create-Binary all
        
        - create single packages
-       ./scripts/Create-Binary -package gcc (-tar-name gcc2)
-
-  (where arguments in the brackets are optional, default is package name)
-
-       after that you can install the packages. you can even use a minimal 
-       rescue disk from another distribution (it should have tar and bzip 
-       on it) and install your hdw-linux distribution. in the future dev
-       snapshots of hdw, a hdw rescue-disk pseudo package will be available.
-
-- install packages from another non hdw system:
-       
-       example:
-       . ./misc/hdw-tools/hdw-get install /mnt/hdw-target gcc
+       ./scripts/Create-Binary -package gcc
 
+- your build is completed now, congrats!
 
 for further information on how to install hdw-linux refer to the INSTALL file
-in doc/ directory.
+in ./doc directory.
 
 
 troubleshooting:
@@ -125,4 +110,4 @@ troubleshooting:
 - visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)
 
 
-regards hackbard
+regards, hackbard.
index 20d9cdc47af7795aa75d51293e4deae45fed451a..14319159cbb4aec7b9d35acb92fcf5d96d7d80d6 100644 (file)
@@ -1,5 +1,6 @@
 *) 2004-07-24
 
+- updated BUILD file
 - fixed scummvm and lprng package
 - added thunderbird freetype patches (still not working) - removed from targets
 - added alternative mutt console mail client