summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Olbrich <m.olbrich@pengutronix.de>2023-06-23 11:41:36 +0200
committerMichael Olbrich <m.olbrich@pengutronix.de>2023-06-23 11:42:02 +0200
commit85ab3d3ace36066ae6eb877c4c8ea613b630b5fd (patch)
tree67405768bfd752b703cd46fb13aeeac0093216d8
parent315b6603cac1eb2cb31534feaa29486b4f865194 (diff)
downloadptxdist-85ab3d3ace36066ae6eb877c4c8ea613b630b5fd.tar.gz
ptxdist-85ab3d3ace36066ae6eb877c4c8ea613b630b5fd.tar.xz
doc: clarify that there is no SELAS.BSP-Pengutronix-Example BSP
Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>
-rwxr-xr-xbin/ptxdist4
-rw-r--r--doc/environment.rst15
2 files changed, 18 insertions, 1 deletions
diff --git a/bin/ptxdist b/bin/ptxdist
index 745ef9170..511af3be9 100755
--- a/bin/ptxdist
+++ b/bin/ptxdist
@@ -1018,12 +1018,14 @@ drop() {
create_docs() {
local builder srcdir outdir dir entry
+ local -a args
builder="${1}"
outdir=${PTXDIST_WORKSPACE}/Documentation
if [ "${PTXDIST_TOPDIR}" -ef "${PTXDIST_WORKSPACE}" ]; then
srcdir="${PTXDIST_TEMPDIR}/docs"
+ args=( "-t" "ptxdistonly" )
else
srcdir="${STATEDIR}/docs"
rm -rf "${srcdir}" &&
@@ -1039,7 +1041,7 @@ create_docs() {
done
done &&
check_virtualenv &&
- sphinx-build -b "${builder}" -d "${outdir}/.doctrees" "${srcdir}" \
+ sphinx-build -b "${builder}" -d "${outdir}/.doctrees" "${args[@]}" "${srcdir}" \
"${outdir}/${builder}" &&
if [ "${builder}" = "latex" ]; then
sed -i s/pdflatex/xelatex/ ${outdir}/${builder}/Makefile
diff --git a/doc/environment.rst b/doc/environment.rst
index 21156033f..f35d0b43e 100644
--- a/doc/environment.rst
+++ b/doc/environment.rst
@@ -14,6 +14,21 @@ http://www.ptxdist.org. This website provides
all required packages and documentation (at least for software
components which are available to the public).
+.. only:: ptxdistonly
+
+ .. note::
+ The PTXdist documenation can be built for a specific BSP. That makes it
+ possible to add BSP specific chapters to the documentation, the BSP is
+ referenced by its name and the PTXdist and toolchain versions are
+ correctly specified for this BSP.
+
+ This instance of the documentation is built without a BSP. So
+ *|ptxdistBSPName|* is used as a placeholder for the BSP name. There is no
+ *|ptxdistBSPName|* BSP!
+
+ To start experimenting with PTXdist, `DistroKit <https://git.pengutronix.de/cgit/DistroKit/>`_
+ can be used.
+
In order to build |ptxdistBSPName|, the following source archives have to be available
on the development host: