~ruther/qmk_firmware

5a02cc00a43cbeb9cc6ad94811acfb861d8f3929 — shela 5 years ago 886eb98
Fix docker script and document (#7786)

Fixed error when keyboard parameter is omitted in interactive mode.
2 files changed, 5 insertions(+), 2 deletions(-)

M docs/getting_started_build_tools.md
M util/docker_build.sh
M docs/getting_started_build_tools.md => docs/getting_started_build_tools.md +2 -2
@@ 120,12 120,12 @@ If this is a bit complex for you, Docker might be the turnkey solution you need.
util/docker_build.sh keyboard:keymap
# For example: util/docker_build.sh ergodox_ez:steno
```
This will compile the desired keyboard/keymap and leave the resulting `.hex` or `.bin` file in the QMK directory for you to flash. If `:keymap` is omitted, the `default` keymap is used. Note that the parameter format is the same as when building with `make`.
This will compile the desired keyboard/keymap and leave the resulting `.hex` or `.bin` file in the QMK directory for you to flash. If `:keymap` is omitted, all keymaps are used. Note that the parameter format is the same as when building with `make`.

You can also start the script without any parameters, in which case it will ask you to input the build parameters one by one, which you may find easier to use:
```bash
util/docker_build.sh
# Reads parameters as input (leave blank for defaults)
# Reads parameters as input (leave blank for all keyboards/keymaps)
```

There is also support for building _and_ flashing the keyboard straight from Docker by specifying the `target` as well:

M util/docker_build.sh => util/docker_build.sh +3 -0
@@ 37,6 37,9 @@ else
		exit 1
	fi
fi
if [ -z "$keyboard" ]; then
	keyboard=all
fi
if [ -n "$target" ]; then
	if [ "$(uname)" = "Linux" ] || docker-machine active >/dev/null 2>&1; then
		usb_args="--privileged -v /dev:/dev"