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