diff --git a/Makefile b/Makefile index ea0426fb52c0..d42a1f2718b7 100644 --- a/Makefile +++ b/Makefile @@ -30,6 +30,17 @@ distclean: docclean pkg-clean @echo "Cleaning all build products" @for dir in $(APPLICATION_DIRS); do "$(MAKE)" -C$$dir distclean; done +print-versions: + @./dist/tools/ci/print_toolchain_versions.sh + +include makefiles/boards.inc.mk +include makefiles/app_dirs.inc.mk + +include makefiles/tools/riotgen.inc.mk +-include makefiles/tests.inc.mk + +include makefiles/color.inc.mk + welcome: @echo "Welcome to RIOT - The friendly OS for IoT!" @echo "" @@ -47,12 +58,7 @@ welcome: @echo " print-versions" @echo " clean distclean pkg-clean" @echo " doc doc-{man,latex}" - -print-versions: - @./dist/tools/ci/print_toolchain_versions.sh - -include makefiles/boards.inc.mk -include makefiles/app_dirs.inc.mk - -include makefiles/tools/riotgen.inc.mk --include makefiles/tests.inc.mk + @echo "" + @echo "==> tl;dr Try running:" + @echo " cd examples/default" + @echo " make BOARD=" diff --git a/doc/doxygen/src/getting-started.md b/doc/doxygen/src/getting-started.md index 081aa8bcd8e4..1b6579117eed 100644 --- a/doc/doxygen/src/getting-started.md +++ b/doc/doxygen/src/getting-started.md @@ -202,7 +202,8 @@ Building and executing an example {#building-and-executing-an-example} --------------------------------- RIOT provides a number of examples in the `examples/` directory. Every example has a README that documents its usage and its purpose. You can build them by -typing +opening a shell, navigating to an example (e.g. `examples/default`), and +running: ~~~~~~~~ {.sh} make BOARD=samr21-xpro @@ -214,9 +215,7 @@ or make all BOARD=samr21-xpro ~~~~~~~~ -into your shell. - -To flash the application to a board just type +To flash the application to a board just run: ~~~~~~~~ {.sh} make flash BOARD=samr21-xpro