id	summary	reporter	owner	description	type	status	priority	milestone	component	version	resolution	keywords	cc
208	Improve build-dir docs	ghost	somebody	"The current docs read:
{{{
--build-dir
Changes build directories for all project roots being built. When this option is specified, all Jamroot files should declare project name. The build directory for the project root will be computed by concatanating the value of the --build-dir option, the project name specified in Jamroot, and the build dir specified in Jamroot (or bin, if none is specified). 
The option is primarily useful when building from read-only media, when you can't modify Jamroot.
}}}

This is probably too hard to read for a new user. We need to provide a simpler overview before giving exact behaviour details."	defect	new	major	M14 - Docs	component1