# hdw - linux BUILD file

welcome to hdw-linux!

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)
- wget, cvs
- internet connection, or local server using -mirror option
- kernel with devfs support for versions <= 0.2
- at least kernel version 2.6 with hotplug 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)
-------------------------------

	build your distribution:
	------------------------

- get the latest stable release of hdw-linux (much better: use cvs)
  from http://hackdaworld.dyndns.org/hdw-linux

	example:
	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 -p /mnt/hdw-build
	mount /dev/ide/host0/bus0/target0/lun0/part6 /mnt/hdw-build

- edit ./Config: insert the above mountpoint to hdw_build_dir and select your
  prefered target
	
	example:

	vi Config

	- modify the following line to read:
	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 & 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

	example:
	./scripts/Puzzle

- run ./scripts/Download to fetch the sources needed to build that target,
  alternatively run ./scripts/Download -mirror <mirrorsite>

	example:
	./scripts/Download
	- after that, if you didnt get all the sources:
	./scripts/Download -mirror http://we-have-no-mrror-by-now/hdw/

- you may now start building: 
	
	example:
	 ./scripts/Build-Distro

- 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:

	example:
	
	- create binary packages of all packages from the target
	./scripts/Create-Binary all
	
	- create single packages
	./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.


troubleshooting:
----------------

- visit: irc.hackdaworld.dyndns.org, #hackdaworld
- visit: http://www.hackdaworld.dyndns.org/contents/mailing-list/
- visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)


regards, hackbard.