commit 8be67335269179cdd140aef15511db01e263f4e3
Author: p4u <hakais@gmail.com>
Date:   Wed Jan 11 12:20:17 2012 +0100

    Added new optin DEV to select developer mode. Default one is user mode (using readonly git repo). Improved help document and added new function: make help

diff --git a/Makefile b/Makefile
index d2e990a..74637fb 100644
--- a/Makefile
+++ b/Makefile
@@ -19,7 +19,8 @@
 OWRT_SVN = svn://svn.openwrt.org/openwrt/trunk
 OWRT_SVN_REV = 29704
 OWRT_PKG_SVN = svn://svn.openwrt.org/openwrt/packages
-QMP_GIT = ssh://gitosis@qmp.cat:221/qmp.git
+QMP_GIT_RW = ssh://gitosis@qmp.cat:221/qmp.git
+QMP_GIT_RO = git://qmp.cat/qmp.git
 QMP_GIT_BRANCH = master
 B6M_GIT = git://qmp.cat/b6m.git
 B6M_GIT_BRANCH = openwrt
@@ -40,6 +41,7 @@ TIMESTAMP = $(shell date +%d%m%y_%H%M)
 CONFIG = $(BUILD_DIR)/$(T)/.config
 KCONFIG = $(BUILD_DIR)/$(T)/target/linux/$(ARCH)/config-* 
 
+$(eval $(if $(DEV),QMP_GIT=$(QMP_GIT_RW),QMP_GIT=$(QMP_GIT_RO)))
 
 .PHONY: checkout update clean config menuconfig kernel_menuconfig list_targets build clean_qmp
 
@@ -119,6 +121,7 @@ define target_error
 endef
 
 .checkout_qmp:
+	@[ "$(DEV)" == "1" ] && echo "Using developer enviroment" || true
 	git clone $(QMP_GIT) $(BUILD_DIR)/qmp
 	cd $(BUILD_DIR)/qmp; git checkout $(QMP_GIT_BRANCH); cd ..
 	@touch $@
@@ -172,6 +175,9 @@ config:
 	select HW in alix rs rspro x86 fonera nsm5 nsm2; do break; done; echo $HW > .config.tmp;
 	mv .config.tmp .config 
 
+help:
+	cat README | more || true
+
 build: checkout
 	$(if $(T),$(call build_src))
 	$(call post_build)
diff --git a/README b/README
index b611c69..2ed719d 100644
--- a/README
+++ b/README
@@ -1,12 +1,16 @@
-[qmpfw]
+=================================================================================
+				qMpfw SDK
+=================================================================================
 
-Qmpfw is a tool for developers to create a development enviroment for qMp.
+qMpfw is a tool for developers to create a development enviroment for qMp.
 Basically it consists in one Makefile, so it is called using "make" command.
 
 Read Only URL: http://qmp.cat/git/qmpfw.git
 Developer URL: ssh://gitosis@qmp.cat:221/qmpfw.git
 
-*Directory structure
+=================================================================================
+			Directory structure
+=================================================================================
 
 There are several directories and files. This is the functionallity for each of them:
 
@@ -24,10 +28,14 @@ There are several directories and files. This is the functionallity for each of
 
     images: output directory for compiled images, each of them has a different timestamp, so you can have as many as you want
 
-*Command options
+
+=================================================================================
+				Command options
+=================================================================================
 
 To compile a qMp image from scratch, you need to specify the target (next example with target=rspro):
-This command will run all necessary commands to compile the image. After the compilation you can see the OpenWRT code in directory: build/[target]
+This command will run all necessary commands to compile the image. After the compilation you can see the 
+OpenWRT code in directory: build/[target]
 
     make T=rspro build
 
@@ -35,53 +43,73 @@ Also you can specify the number of parallel processes for compilation and the ve
 
     make V=99 J=2 T=rspro build
 
+For work in developer mode (uses QMP readwrite repository instead readonly one)
+
+    make T=rspro DEV=1 build
+
+---------------------------------------------------------------------------------
 To see list of avaiable targets run:
 
     make list_targets
 
+---------------------------------------------------------------------------------
 This will update all targets
 
     make update
-    (this will update only qmp source)
 
+Note that this will update only qmp and b6m source (not openwrt)
+
+---------------------------------------------------------------------------------
 This will update only rspro target
 
     make T=rspro update
 
+---------------------------------------------------------------------------------
 This will update all sources (qmp, openwrt feeds and eighennet)
 
     make update_all
 
+---------------------------------------------------------------------------------
+To syncronize config files from configs/ dir to existing target
+
+    make T=rspro sync_config
+
+---------------------------------------------------------------------------------
 To run menuconfig (from openwrt):
 
     make T=rspro menuconfig
 
 After that, the new config file will be applied to destination target and also it will by copied inside build/configs directory
-To run kernel menuconfig (from openwrt):
+
+---------------------------------------------------------------------------------
+To run kernel menuconfig (from openwrt), in this case config file will be not copied because it is not directly compatible with configs/target/kernel_config:
 
     make T=rspro kernel_menuconfig
 
+---------------------------------------------------------------------------------
 To run the initial checkout:
 
     make T=rspro checkout
 
+---------------------------------------------------------------------------------
 To clean specific target:
 
     make T=rspro clean
 
+---------------------------------------------------------------------------------
 To clean all targets:
 
     make clean
 
+---------------------------------------------------------------------------------
 To clean just qmp packages from a target
 
     make T=rspro clean_qmp
 
+---------------------------------------------------------------------------------
 To configure some general parameters from qMp you can run:
 
     make config
 
 TODO: This feature is missing
 
-
-
