# hdw - linux BUILD file

welcome to hdw-linux-0.3-dev

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!

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
- devfs supporting kernel.
- an empty partition (1.5 gb) for building, and 650 mb for sources.
  (the default target is smaller (900mb & ~200mb)

what to do: (for the impatient)
-------------------------------

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

- get the hdw-linux source 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.
	
	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

- edit ./Config and insert the above mountpoint to hdw_build_dir and
  chose a target.
	
	example:
	cd hdw-linux*
	vi Config

	- modify the following line to read:
	export hdw_build_dir="/mnt/hdw/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)

	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/

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

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

- create binaries:

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


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