1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00

pkg/doc.txt: improve rendering of source location documentation

This commit is contained in:
Alexandre Abadie 2020-06-29 11:57:22 +02:00
parent ef4835a092
commit 5a9399e4c2
No known key found for this signature in database
GPG Key ID: 1C919A403CAE1405

View File

@ -14,14 +14,23 @@
* INCLUDE += $(RIOTPKG)/<pkg_name>/...
* ~~~~~~~~
*
* When the package can be build out-of-source, the source code of external
* packages is fetched in a global location in
* `$(RIOTBASE)/build/pkg/$(PKG_NAME)`.
* When the package can be built out-of-source, the source code of external
* packages is fetched in a global location in:
*
* ~~~~~~~~ {.mk}
* $(RIOTBASE)/build/pkg/$(PKG_NAME)
* ~~~~~~~~
*
* When out-of-source build is not possible (for example because the package
* build system doesn't allow it), the source code is fetch in the build
* directory of the application under `$(BINDIR)/pkg/$(PKG_NAME)`
* and is the same as the build directory (this is the case for micropython
* and openthread packages).
* build system doesn't allow it), the source code is fetched in the build
* directory of the application under:
*
* ~~~~~~~~ {.mk}
* $(BINDIR)/pkg/$(PKG_NAME)
* ~~~~~~~~
*
* In this case, the source and the build directory are the same (currently,
* this applies to the micropython and openthread packages).
*
* Porting an external library
* ===========================