Start the cleanup of PicoBSD build scripts and general build

structure.
These changes have been discussed with Greg Lehey and posted on
freebsd-small (most things in the PicoBSD tree were already broken
so things can only improve!)

Approved-By: jordan

1 files changed, 34 insertions, 108 deletions

diff --git a/release/picobsd/README.luigi b/release/picobsd/README.luigi
index 5a3a333..4261a1a 100644
--- a/release/picobsd/README.luigi
+++ b/release/picobsd/README.luigi
@@ -1,16 +1,23 @@
 In this file i try to document the overall architecture of PicoBSD
 source tree.
 
-    build/
-	directory containing main build scripts and makefiles.
+    ./		Per-image directory-tree and generic trees.
+	
+    build/	Main build scripts and Makefiles.
 	build:	main build script
 	stage1:	invoked by build
 	clean:	to clean up previous compilations
 	Makefile.conf
 		makefile to edit config file and build kernel
+	Makefile.mfs
+		makefile to create the memory filesystem
+	Makefile.crunch
+		makefile to handle the crunched directory
+	mfs.mtree
+		mtree cmd -- structure of the mfs tree
 
     floppy.tree/
-	default files to fill the floppy and mfs trees.
+	Default files to fill the floppy and mfs trees.
 	Can be overridden by listing files to be removed in
 	${TYPE}/floppy.tree.exclude, and putting files to be replaced
 	in ${TYPE}/floppy.tree/
@@ -18,9 +25,6 @@ source tree.
     doc/
 	documentation (unchanged from original)
 
-    forth/
-	load files for the boot loader (unchanged from original)
-
     help/
 	help files in various languages. The suffix is the two letter
 	country code for the language. Currently only .en and .pl
@@ -30,122 +34,44 @@ source tree.
 	various small programs used instead of the corresponding
 	full-blown utilities.
 
-    tools/
-	couple of tools used during the build process.
-
-    dial, isp, net, router, custom ...
-	directories containing the source and config files for the
-	various image types.
-
+    $TYPE/	source and config files for the various image types.
 
 Structure of each image type is as follows:
 
     Makefile.mfs
-	makefile used to build/populate the MFS
+	Makefile used to build/populate the MFS. Only needs two
+	lines typically:
+
+	MY_DEVS=std ....
+	.include "../build/Makefile.mfs"
 
     PICOBSD
-	kernel config file
+	kernel config file. One line is required
+
+	    #PicoBSD  mfs_size init_name mfs_inodes floppy_inodes
+	e.g.
+	    #PicoBSD  2400	init	4096	32768
 
     crunch1/
-	directory with crunched config etc (unchanged from original)
+	Directory with crunched config etc. Main files:
+	crunch.conf	main config file for crunchgen
+	crunch.inc	(optional) file included in crunchgen
+			Makefiles, used e.g. to set make variables
+			such as RELEASE_CRUNCH or similar.
 
     floppy.tree/
-	local files to be put into the floppy/mfs trees.
+	local files to be put into the floppy/mfs trees instead
+	of the ones in ../build/floppy.tree
 
     floppy.tree.exclude
-	list of files in the default floppy.tree/ not to be copied
-	for this configuration (used by tar --exclude-from
-	floppy.tree.exclude)
+	list of files to be omitted in the copy from ../build/floppy.tree
+
+    floppy.tree.${SITE}/
+	site-specific files which update the ones taken from one
+	of the two places above. Typically they are passwd, hosts,
+	rc.conf, rc.firewall things to go in /etc
 
     lang/
 	language-dependant files (trimmed from the original one)
 
-    mfs.mtree
-	mtree structure used to populate the mfs image
-	MFS image, or on the floppy image in various phases.1G
-
-----
-
-Below a partly incomplete list of files used by the various
-picobsd types.
-
-Files for various systems
-
-=  base file
-x  missing
-X  missing, not needed with oinit
-D  different
-d  minor difference, merge candidate
-L  copied from LANG directory
-G  generated in stage3
-
-DIAL ISP  NET  ROUT  MY1  MY2  	File in floppy.tree
-------------------------------------------------------
- =    =    =    =               boot.config
- x    =    =    =               disktab
- x    =    x    x               etc/firewall
- =    =    =    =               etc/fstab
- =    =    =    =               etc/gettytab
- =    =    =    =               etc/group
- =    =    =    =               etc/host.conf
- L    L    L    L             L etc/hosts
- x    =    =    x               etc/inetd.conf
- =    =    =    =               etc/login.conf
- d    =    =    x               etc/master.passwd
- d    =    =    D               etc/mfs.rc
- L    L    L    L             L etc/motd
- D    =    =    =               etc/ppp/ppp.conf
- =    x    x    x               etc/ppp/ppp.conf.template
- =    =    =    =               etc/ppp/ppp.deny
- d    =    =    =               etc/ppp/ppp.linkup
- =    =    =    =               etc/ppp/ppp.secret.sample
- =    =    =    =               etc/profile
- =    =    =    =               etc/protocols
- D    =    d    D               etc/rc
- D    =    =    X               etc/rc.conf
- x    =    =    D               etc/rc.firewall
- =    =    =    D               etc/rc.network
- x    =    =    D               etc/rc.serial
- x    =    =    =               etc/remote
- L    =    =    X             L etc/resolv.conf
- =    =    =    =               etc/services
- x    =    =    =               etc/shells
- x    =    =    x               etc/snmpd.conf
- =    x    x    x             G etc/spwd.db
- =    x    x    x               etc/ssh_config
- =    =    =    =               etc/termcap
- D    =    =    =               etc/ttys
- =    =    =    =               kernel.config
- =    =    =    =             G kernel.gz
-
-DIAL ISP  NET  ROUT  MY1  MY2  	File in lang
-                                README.en
-				README.pl
-				boot.help.en
-				boot.help.pl
-				hosts.en
-				hosts.pl
-				mfs.rc.en	to floppy.tree
-				mfs.rc.pl
-				motd.en
-				motd.pl
-				rc.conf.en	to floppy.tree
-				rc.conf.pl	via
-				rc.en		to floppy.tree
-				rc.network.en	to floppy.tree
-				rc.network.pl	via
-				rc.pl		via
-				reboot.en
-				reboot.pl
-				resolv.conf.en	to floppy.tree
-				resolv.conf.pl	via
-				update.en
-				update.pl
-
-
-DIAL ISP  NET  ROUT  MY1  MY2  	File in mfs.tree
-
- D    =    d    d               Makefile
- =    x    x    x               login.conf
- D    =    D    D               mfs.tree