From cb8873379bd03d84352a6d28e985ab975b555dbb Mon Sep 17 00:00:00 2001 From: Nathaniel Graff Date: Wed, 13 Feb 2019 10:22:14 -0800 Subject: Document INCLUDE_METAL_SOURCES for standalone target Signed-off-by: Nathaniel Graff --- Makefile | 3 ++- README.md | 7 ++++++- doc/sphinx/userguide/standalone.rst | 7 ++++++- 3 files changed, 14 insertions(+), 3 deletions(-) diff --git a/Makefile b/Makefile index 19347b8..20a4a5d 100644 --- a/Makefile +++ b/Makefile @@ -98,7 +98,8 @@ help: @echo " Launch OpenOCD and attach GDB to the running program." @echo "" @echo " standalone BSP=metal STANDALONE_DEST=/path/to/desired/location" - @echo " [PROGRAM=$(PROGRAM) TARGET=$(TARGET)]:" + @echo " [INCLUDE_METAL_SOURCES=1] [PROGRAM=$(PROGRAM)]" + @echo " [TARGET=$(TARGET)]:" @echo " Export a program for a single target into a standalone" @echo " project directory at STANDALONE_DEST." @echo "" diff --git a/README.md b/README.md index 4ba9ee8..2484c5f 100644 --- a/README.md +++ b/README.md @@ -248,8 +248,13 @@ Legacy Freedom E SDK. `STANDALONE_DEST` is a required argument to provide the desired project location. +You can include the argument `INCLUDE_METAL_SOURCES=1` if you would like to +include the sources for the Freedom Metal library in the generated standalone +project. If this argument is not included, then the Freedom Metal library will +be included in the generated project as a pre-built archive. + ``` -make BSP=metal [PROGRAM=hello] [TARGET=sifive-hifive1] STANDALONE_DEST=/path/to/desired/location standalone +make BSP=metal [PROGRAM=hello] [TARGET=sifive-hifive1] [INCLUDE_METAL_SOURCES=1] STANDALONE_DEST=/path/to/desired/location standalone ``` Run `make help` for more commands. diff --git a/doc/sphinx/userguide/standalone.rst b/doc/sphinx/userguide/standalone.rst index 58f7f51..61214d2 100644 --- a/doc/sphinx/userguide/standalone.rst +++ b/doc/sphinx/userguide/standalone.rst @@ -8,7 +8,12 @@ Legacy Freedom E SDK. ``STANDALONE_DEST`` is a required argument to provide the desired project location. +You can include the argument ``INCLUDE_METAL_SOURCES=1`` if you would like to +include the sources for the Freedom Metal library in the generated standalone +project. If this argument is not included, then the Freedom Metal library will +be included in the generated project as a pre-built archive. + .. code-block:: bash - make BSP=mee [PROGRAM=hello] [TARGET=sifive-hifive1] STANDALONE_DEST=/path/to/desired/location standalone + make BSP=mee [PROGRAM=hello] [TARGET=sifive-hifive1] [INCLUDE_METAL_SOURCES=1] STANDALONE_DEST=/path/to/desired/location standalone -- cgit v1.2.1-18-gbd029