public inbox for openembedded-core@lists.openembedded.org
 help / color / mirror / Atom feed
* [PATCH 0/6] Investigate hotdoc and add a recipe to build it
@ 2026-01-29  3:53 Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 1/6] python3-appdirs: Add new recipe Liu Yiding
                   ` (5 more replies)
  0 siblings, 6 replies; 21+ messages in thread
From: Liu Yiding @ 2026-01-29  3:53 UTC (permalink / raw)
  To: openembedded-core

Add new recipe hotdoc and its runtime dependence.

Liu Yiding (6):

  [OE-core][PATCH v3] hotdoc : Add new recipe

  [OE-core][PATCH] orc: Enable hotdoc to produce doc
    Make a recipe to use hotdoc

  Add following 4 recipes for runtime dependence of hotdoc.
  [OE-core][PATCH] python3-appdirs: Add new recipe
    Move it from meta-openembedded to openembedded-core as it is required by hotdoc 0.17.4.
  [OE-core][PATCH] python3-schema: Add new recipe
  [OE-core][PATCH] python3-toposort: Add new recipe
  [OE-core][PATCH v2] python3-wheezy-template: Add new recipe

 meta/conf/distro/include/maintainers.inc      |  1 +
 ...ment_scanner-fix-function-prototypes.patch | 32 +++++++++
 ...y-backports-dependency-on-sufficient.patch | 72 +++++++++++++++++++
 .../hotdoc/0003-CMake-4-compatibility.patch   | 44 ++++++++++++
 ...ke-path-to-relative-in-FlexExtension.patch | 34 +++++++++
 meta/recipes-devtools/hotdoc/hotdoc_0.17.4.bb | 27 +++++++
 .../orc/orc/0001-Fix-hotdoc-run-error.patch   | 37 ++++++++++
 meta/recipes-devtools/orc/orc_0.4.42.bb       |  5 +-
 .../python/python3-appdirs_1.4.4.bb           | 11 +++
 .../python/python3-schema_0.7.8.bb            | 10 +++
 .../python/python3-toposort_1.10.bb           | 10 +++
 .../python/python3-wheezy-template_3.2.4.bb   | 13 ++++
 12 files changed, 295 insertions(+), 1 deletion(-)
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0001-c_comment_scanner-fix-function-prototypes.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0002-avoid-third-party-backports-dependency-on-sufficient.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0003-CMake-4-compatibility.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0004-Make-path-to-relative-in-FlexExtension.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc_0.17.4.bb
 create mode 100644 meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
 create mode 100644 meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
 create mode 100644 meta/recipes-devtools/python/python3-schema_0.7.8.bb
 create mode 100644 meta/recipes-devtools/python/python3-toposort_1.10.bb
 create mode 100644 meta/recipes-devtools/python/python3-wheezy-template_3.2.4.bb

-- 
2.43.0



^ permalink raw reply	[flat|nested] 21+ messages in thread

* [OE-core][PATCH 1/6] python3-appdirs: Add new recipe
  2026-01-29  3:53 [PATCH 0/6] Investigate hotdoc and add a recipe to build it Liu Yiding
@ 2026-01-29  3:53 ` Liu Yiding
  2026-01-30  8:28   ` Mathieu Dubois-Briand
  2026-01-29  3:53 ` [OE-core][PATCH 2/6] python3-schema: " Liu Yiding
                   ` (4 subsequent siblings)
  5 siblings, 1 reply; 21+ messages in thread
From: Liu Yiding @ 2026-01-29  3:53 UTC (permalink / raw)
  To: openembedded-core

Move it from meta-openembedded to openembedded-core as it is required by hotdoc 0.17.4.

Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
---
 meta/recipes-devtools/python/python3-appdirs_1.4.4.bb | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 meta/recipes-devtools/python/python3-appdirs_1.4.4.bb

diff --git a/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb b/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
new file mode 100644
index 0000000000..bee0b7d815
--- /dev/null
+++ b/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
@@ -0,0 +1,11 @@
+SUMMARY = "A small Python module for determining appropriate + platform-specific dirs, e.g. a user data dir."
+LICENSE = "MIT"
+LIC_FILES_CHKSUM = "file://LICENSE.txt;md5=31625363c45eb0c67c630a2f73e438e4"
+
+SRC_URI[sha256sum] = "7d5d0167b2b1ba821647616af46a749d1c653740dd0d2415100fe26e27afdf41"
+
+inherit pypi setuptools3 ptest-python-pytest
+
+PTEST_PYTEST_DIR = "test"
+
+BBCLASSEXTEND = "native nativesdk"
-- 
2.43.0



^ permalink raw reply related	[flat|nested] 21+ messages in thread

* [OE-core][PATCH 2/6] python3-schema: Add new recipe
  2026-01-29  3:53 [PATCH 0/6] Investigate hotdoc and add a recipe to build it Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 1/6] python3-appdirs: Add new recipe Liu Yiding
@ 2026-01-29  3:53 ` Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 3/6] python3-toposort: " Liu Yiding
                   ` (3 subsequent siblings)
  5 siblings, 0 replies; 21+ messages in thread
From: Liu Yiding @ 2026-01-29  3:53 UTC (permalink / raw)
  To: openembedded-core

Add this new recipe for runtime dependence of hotdoc.

Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
---
 meta/recipes-devtools/python/python3-schema_0.7.8.bb | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 meta/recipes-devtools/python/python3-schema_0.7.8.bb

diff --git a/meta/recipes-devtools/python/python3-schema_0.7.8.bb b/meta/recipes-devtools/python/python3-schema_0.7.8.bb
new file mode 100644
index 0000000000..b27b890374
--- /dev/null
+++ b/meta/recipes-devtools/python/python3-schema_0.7.8.bb
@@ -0,0 +1,10 @@
+SUMMARY = "A library for validating Python data structures"
+HOMEPAGE = "https://github.com/keleshev/schema"
+LICENSE = "MIT"
+LIC_FILES_CHKSUM = "file://LICENSE-MIT;md5=7e70914c99a6ec706baa9fad5e0502df"
+
+SRC_URI[sha256sum] = "e86cc08edd6fe6e2522648f4e47e3a31920a76e82cce8937535422e310862ab5"
+
+inherit pypi python_setuptools_build_meta
+
+BBCLASSEXTEND = "native"
-- 
2.43.0



^ permalink raw reply related	[flat|nested] 21+ messages in thread

* [OE-core][PATCH 3/6] python3-toposort: Add new recipe
  2026-01-29  3:53 [PATCH 0/6] Investigate hotdoc and add a recipe to build it Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 1/6] python3-appdirs: Add new recipe Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 2/6] python3-schema: " Liu Yiding
@ 2026-01-29  3:53 ` Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 4/6 v2] python3-wheezy-template: " Liu Yiding
                   ` (2 subsequent siblings)
  5 siblings, 0 replies; 21+ messages in thread
From: Liu Yiding @ 2026-01-29  3:53 UTC (permalink / raw)
  To: openembedded-core

Add this new recipe for runtime dependence of hotdoc.

Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
---
 meta/recipes-devtools/python/python3-toposort_1.10.bb | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 meta/recipes-devtools/python/python3-toposort_1.10.bb

diff --git a/meta/recipes-devtools/python/python3-toposort_1.10.bb b/meta/recipes-devtools/python/python3-toposort_1.10.bb
new file mode 100644
index 0000000000..ce903dcec3
--- /dev/null
+++ b/meta/recipes-devtools/python/python3-toposort_1.10.bb
@@ -0,0 +1,10 @@
+SUMMARY = "Implements a topological sort algorithm"
+HOMEPAGE = "https://gitlab.com/ericvsmith/toposort"
+LICENSE = "Apache-2.0"
+LIC_FILES_CHKSUM = "file://LICENSE.txt;md5=3b83ef96387f14655fc854ddc3c6bd57"
+
+SRC_URI[sha256sum] = "bfbb479c53d0a696ea7402601f4e693c97b0367837c8898bc6471adfca37a6bd"
+
+inherit pypi python_setuptools_build_meta
+
+BBCLASSEXTEND = "native"
-- 
2.43.0



^ permalink raw reply related	[flat|nested] 21+ messages in thread

* [OE-core][PATCH 4/6 v2] python3-wheezy-template: Add new recipe
  2026-01-29  3:53 [PATCH 0/6] Investigate hotdoc and add a recipe to build it Liu Yiding
                   ` (2 preceding siblings ...)
  2026-01-29  3:53 ` [OE-core][PATCH 3/6] python3-toposort: " Liu Yiding
@ 2026-01-29  3:53 ` Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 5/6 v3] hotdoc: " Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc Liu Yiding
  5 siblings, 0 replies; 21+ messages in thread
From: Liu Yiding @ 2026-01-29  3:53 UTC (permalink / raw)
  To: openembedded-core

Add this new recipe for runtime dependence of hotdoc.

Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
---
 .../python/python3-wheezy-template_3.2.4.bb         | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 meta/recipes-devtools/python/python3-wheezy-template_3.2.4.bb

diff --git a/meta/recipes-devtools/python/python3-wheezy-template_3.2.4.bb b/meta/recipes-devtools/python/python3-wheezy-template_3.2.4.bb
new file mode 100644
index 0000000000..9386b0ca2f
--- /dev/null
+++ b/meta/recipes-devtools/python/python3-wheezy-template_3.2.4.bb
@@ -0,0 +1,13 @@
+SUMMARY = "a lightweight template library"
+HOMEPAGE = "https://github.com/akornatskyy/wheezy.template"
+LICENSE = "MIT"
+LIC_FILES_CHKSUM = "file://LICENSE;md5=fa10554c46b94944529c6a886cf85631"
+
+PYPI_PACKAGE = "wheezy_template"
+UPSTREAM_CHECK_PYPI_PACKAGE = "${PYPI_PACKAGE}"
+
+SRC_URI[sha256sum] = "465b9ac52e1c38bc9fc30127ae90bd232ce8df07fc2ac53383cb784f238b144f"
+
+inherit pypi python_setuptools_build_meta
+
+BBCLASSEXTEND = "native"
-- 
2.43.0



^ permalink raw reply related	[flat|nested] 21+ messages in thread

* [OE-core][PATCH 5/6 v3] hotdoc: Add new recipe
  2026-01-29  3:53 [PATCH 0/6] Investigate hotdoc and add a recipe to build it Liu Yiding
                   ` (3 preceding siblings ...)
  2026-01-29  3:53 ` [OE-core][PATCH 4/6 v2] python3-wheezy-template: " Liu Yiding
@ 2026-01-29  3:53 ` Liu Yiding
  2026-01-29  3:53 ` [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc Liu Yiding
  5 siblings, 0 replies; 21+ messages in thread
From: Liu Yiding @ 2026-01-29  3:53 UTC (permalink / raw)
  To: openembedded-core

1. Backport following patch to solve build and runtime issue
  0001-c_comment_scanner-fix-function-prototypes.patch
  0002-avoid-third-party-backports-dependency-on-sufficient.patch
  0003-CMake-4-compatibility.patch

2. Add do_configure:prepend() to solve buildpaths QA check
  do_package_qa: QA Issue: File /usr/lib/python3.14/site-packages/hotdoc/parsers/cmark.cpython-314-x86_64-linux-gnu.so in package hotdoc contains reference to TMPDIR [buildpaths]

3. Add 0004-Make-path-to-relative-in-FlexExtension.patch to solve buildpaths QA check
  do_package_qa: QA Issue: File /usr/src/debug/hotdoc/0.17.4/hotdoc/parsers/c_comment_scanner/scanner.c in package hotdoc-src contains reference to TMPDIR [buildpaths]

Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
---
 meta/conf/distro/include/maintainers.inc      |  1 +
 ...ment_scanner-fix-function-prototypes.patch | 32 +++++++++
 ...y-backports-dependency-on-sufficient.patch | 72 +++++++++++++++++++
 .../hotdoc/0003-CMake-4-compatibility.patch   | 44 ++++++++++++
 ...ke-path-to-relative-in-FlexExtension.patch | 34 +++++++++
 meta/recipes-devtools/hotdoc/hotdoc_0.17.4.bb | 27 +++++++
 6 files changed, 210 insertions(+)
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0001-c_comment_scanner-fix-function-prototypes.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0002-avoid-third-party-backports-dependency-on-sufficient.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0003-CMake-4-compatibility.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc/0004-Make-path-to-relative-in-FlexExtension.patch
 create mode 100644 meta/recipes-devtools/hotdoc/hotdoc_0.17.4.bb

diff --git a/meta/conf/distro/include/maintainers.inc b/meta/conf/distro/include/maintainers.inc
index e830648945..af081dc3dc 100644
--- a/meta/conf/distro/include/maintainers.inc
+++ b/meta/conf/distro/include/maintainers.inc
@@ -268,6 +268,7 @@ RECIPE_MAINTAINER:pn-harfbuzz = "Unassigned <unassigned@yoctoproject.org>"
 RECIPE_MAINTAINER:pn-hdparm = "Denys Dmytriyenko <denis@denix.org>"
 RECIPE_MAINTAINER:pn-help2man = "Hongxu Jia <hongxu.jia@windriver.com>"
 RECIPE_MAINTAINER:pn-hicolor-icon-theme = "Unassigned <unassigned@yoctoproject.org>"
+RECIPE_MAINTAINER:pn-hotdoc = "Liu Yiding <liuyd.fnst@fujitsu.com>"
 RECIPE_MAINTAINER:pn-hwdata = "Hiago De Franco <hfranco@baylibre.com>"
 RECIPE_MAINTAINER:pn-hwlatdetect = "Unassigned <unassigned@yoctoproject.org>"
 RECIPE_MAINTAINER:pn-i2c-tools = "Unassigned <unassigned@yoctoproject.org>"
diff --git a/meta/recipes-devtools/hotdoc/hotdoc/0001-c_comment_scanner-fix-function-prototypes.patch b/meta/recipes-devtools/hotdoc/hotdoc/0001-c_comment_scanner-fix-function-prototypes.patch
new file mode 100644
index 0000000000..c26dde93b3
--- /dev/null
+++ b/meta/recipes-devtools/hotdoc/hotdoc/0001-c_comment_scanner-fix-function-prototypes.patch
@@ -0,0 +1,32 @@
+Subject: [PATCH 1/2] c_comment_scanner: fix function prototypes
+
+scanner.l: Fix compile error as the following:
+
+python3-hotdoc/0.17.4/sources/hotdoc-0.17.4/hotdoc/parsers/c_comment_scanner/scanner.l:126:1: error: conflicting types for 'parse_comment'; have 'int(PyObject *)' {aka 'int(struct _object *)'}
+|   126 | parse_comment (PyObject *comments)
+
+Upstream-Status: Backport [https://github.com/hotdoc/hotdoc/commit/adf8518431fafb78c9b47862a0a9a58824b6a421]
+
+Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
+---
+ hotdoc/parsers/c_comment_scanner/scanner.l | 4 ++--
+ 1 file changed, 2 insertions(+), 2 deletions(-)
+
+diff --git a/hotdoc/parsers/c_comment_scanner/scanner.l b/hotdoc/parsers/c_comment_scanner/scanner.l
+index 0408601..7bccd64 100644
+--- a/hotdoc/parsers/c_comment_scanner/scanner.l
++++ b/hotdoc/parsers/c_comment_scanner/scanner.l
+@@ -34,8 +34,8 @@
+ extern int yylex (PyObject *comments);
+ #define YY_DECL int yylex (PyObject *comments)
+ static int yywrap (void);
+-static int parse_comment ();
+-static int parse_define ();
++static int parse_comment (PyObject *);
++static int parse_define (PyObject *);
+ %}
+ 
+ %option nounput
+-- 
+2.43.0
+
diff --git a/meta/recipes-devtools/hotdoc/hotdoc/0002-avoid-third-party-backports-dependency-on-sufficient.patch b/meta/recipes-devtools/hotdoc/hotdoc/0002-avoid-third-party-backports-dependency-on-sufficient.patch
new file mode 100644
index 0000000000..560d1257f0
--- /dev/null
+++ b/meta/recipes-devtools/hotdoc/hotdoc/0002-avoid-third-party-backports-dependency-on-sufficient.patch
@@ -0,0 +1,72 @@
+Subject: [PATCH 2/2] avoid third-party backports dependency on sufficiently
+ new python
+
+`backports.entry_points_selectable` backports functionality from python
+3.10 to older versions of python.
+
+Backport this patch to solve runtime backports import problem as following:
+  File "/usr/lib/python3.14/site-packages/hotdoc/utils/utils.py", line 38, in <module>
+  from backports.entry_points_selectable import entry_points
+ModuleNotFoundError: No module named 'backports'
+
+Upstream-Status: Backport [https://github.com/hotdoc/hotdoc/commit/51043c3ef889e36c8232280581598b875073ded7]
+
+Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
+---
+ hotdoc/extensions/gi/utils.py | 6 +++++-
+ hotdoc/utils/utils.py         | 6 +++++-
+ setup.py                      | 2 +-
+ 3 files changed, 11 insertions(+), 3 deletions(-)
+
+diff --git a/hotdoc/extensions/gi/utils.py b/hotdoc/extensions/gi/utils.py
+index 159c2b6..91902cb 100644
+--- a/hotdoc/extensions/gi/utils.py
++++ b/hotdoc/extensions/gi/utils.py
+@@ -1,9 +1,13 @@
+ import os
+ from collections import namedtuple
+ import pathlib
++import sys
+ import traceback
+ 
+-from backports.entry_points_selectable import entry_points
++if sys.version_info >= (3, 10):
++    from importlib.metadata import entry_points
++else:
++    from backports.entry_points_selectable import entry_points
+ 
+ from hotdoc.core.links import Link
+ from hotdoc.utils.loggable import info, debug
+diff --git a/hotdoc/utils/utils.py b/hotdoc/utils/utils.py
+index 518d308..aef657a 100644
+--- a/hotdoc/utils/utils.py
++++ b/hotdoc/utils/utils.py
+@@ -35,7 +35,11 @@ import importlib.util
+ from urllib.request import urlretrieve
+ from pathlib import Path
+ 
+-from backports.entry_points_selectable import entry_points
++if sys.version_info >= (3, 10):
++    from importlib.metadata import entry_points
++else:
++    from backports.entry_points_selectable import entry_points
++
+ try:
+     import importlib.metadata as meta
+ except ImportError:
+diff --git a/setup.py b/setup.py
+index 5d7f131..9ee504d 100644
+--- a/setup.py
++++ b/setup.py
+@@ -300,7 +300,7 @@ INSTALL_REQUIRES = [
+     'wheezy.template',
+     'toposort>=1.4',
+     'importlib_metadata; python_version<"3.10"',
+-    'backports.entry_points_selectable',
++    'backports.entry_points_selectable; python_version<"3.10"',
+ ]
+ 
+ # dbus-deviation requires sphinx, which requires python 3.5
+-- 
+2.43.0
+
diff --git a/meta/recipes-devtools/hotdoc/hotdoc/0003-CMake-4-compatibility.patch b/meta/recipes-devtools/hotdoc/hotdoc/0003-CMake-4-compatibility.patch
new file mode 100644
index 0000000000..cb243176ae
--- /dev/null
+++ b/meta/recipes-devtools/hotdoc/hotdoc/0003-CMake-4-compatibility.patch
@@ -0,0 +1,44 @@
+Subject: [PATCH] CMake 4 compatibility
+
+All CMake versions older than 3.10 are deprecated.
+
+Upstream-Status: Backport [https://github.com/MathieuDuponchelle/cmark/commit/bd78193dbff98c3860e77629b5c7bfee6169d1da]
+
+Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
+---
+ cmark/CMakeLists.txt            | 11 ++---------
+ cmark/extensions/CMakeLists.txt |  2 +-
+ 2 files changed, 3 insertions(+), 10 deletions(-)
+
+diff --git a/cmark/CMakeLists.txt b/cmark/CMakeLists.txt
+index ff97419..45fdf6c 100755
+--- a/cmark/CMakeLists.txt
++++ b/cmark/CMakeLists.txt
+@@ -1,12 +1,5 @@
+-cmake_minimum_required(VERSION 2.8.9)
+-
+-# prevent ugly developer warnings because version is set directly, not through project()
+-# it should be redone properly by using VERSION in project() if on CMake 3.x
+-if(CMAKE_MAJOR_VERSION GREATER 2)
+-    cmake_policy(SET CMP0048 OLD)
+-endif()
+-
+-project(cmark)
++cmake_minimum_required(VERSION 3.10)
++project(cmark VERSION 0.28.3)
+ 
+ include("FindAsan.cmake")
+ 
+diff --git a/cmark/extensions/CMakeLists.txt b/cmark/extensions/CMakeLists.txt
+index e62d155..b6a1556 100644
+--- a/cmark/extensions/CMakeLists.txt
++++ b/cmark/extensions/CMakeLists.txt
+@@ -1,4 +1,4 @@
+-cmake_minimum_required(VERSION 2.8)
++cmake_minimum_required(VERSION 3.10)
+ set(LIBRARY "cmarkextensions")
+ set(LIBRARY_SOURCES
+     core-extensions.c
+-- 
+2.43.0
+
diff --git a/meta/recipes-devtools/hotdoc/hotdoc/0004-Make-path-to-relative-in-FlexExtension.patch b/meta/recipes-devtools/hotdoc/hotdoc/0004-Make-path-to-relative-in-FlexExtension.patch
new file mode 100644
index 0000000000..ae8c2ef3e7
--- /dev/null
+++ b/meta/recipes-devtools/hotdoc/hotdoc/0004-Make-path-to-relative-in-FlexExtension.patch
@@ -0,0 +1,34 @@
+Subject: [PATCH] Make path to relative in FlexExtension
+
+To fix following do_package QA Issue:
+
+do_package_qa:QA Issue: File /usr/src/debug/hotdoc/0.17.4/hotdoc/parsers/c_comment_scanner/scanner.c in package hotdoc-src contains reference to TMPDIR [buildpaths]
+
+Upstream-Status: Inappropriate [oe-specific]
+
+Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
+---
+ setup.py | 4 ++--
+ 1 file changed, 2 insertions(+), 2 deletions(-)
+
+diff --git a/setup.py b/setup.py
+index 9ee504d..fc03c57 100644
+--- a/setup.py
++++ b/setup.py
+@@ -357,11 +357,11 @@ build_c_extension = os.environ.get('HOTDOC_BUILD_C_EXTENSION', 'auto')
+ class FlexExtension (Extension):
+     def __init__(self, flex_sources, *args, **kwargs):
+         Extension.__init__(self, *args, **kwargs)
+-        self.__flex_sources = [src(s) for s in flex_sources]
++        self.__flex_sources = list(flex_sources)
+ 
+     def __build_flex(self):
+         src_dir = os.path.dirname(self.__flex_sources[0])
+-        built_scanner_path = src(os.path.join(src_dir, 'scanner.c'))
++        built_scanner_path = os.path.join(src_dir, 'scanner.c')
+ 
+         self.sources.append(built_scanner_path)
+         if newer_group(self.__flex_sources, built_scanner_path):
+-- 
+2.43.0
+
diff --git a/meta/recipes-devtools/hotdoc/hotdoc_0.17.4.bb b/meta/recipes-devtools/hotdoc/hotdoc_0.17.4.bb
new file mode 100644
index 0000000000..6236f03df8
--- /dev/null
+++ b/meta/recipes-devtools/hotdoc/hotdoc_0.17.4.bb
@@ -0,0 +1,27 @@
+SUMMARY = "Hotdoc is a documentation framework"
+DESCRIPTION = "Hotdoc is a documentation micro-framework. It provides an interface for extensions to plug upon, along with some base objects (formatters, ...)"
+HOMEPAGE = "https://github.com/hotdoc/hotdoc"
+
+LICENSE = "LGPL-2.1-or-later"
+LIC_FILES_CHKSUM = "file://COPYING;md5=90263a49bc1d9a204656fec4d5616c66"
+
+SRC_URI[sha256sum] = "c4d5dff647f03aa87a1d2d06035d2819edd099b91635e3b2ee390829357ae9fc"
+
+SRC_URI = "file://0001-c_comment_scanner-fix-function-prototypes.patch \
+           file://0002-avoid-third-party-backports-dependency-on-sufficient.patch \
+           file://0003-CMake-4-compatibility.patch \
+           file://0004-Make-path-to-relative-in-FlexExtension.patch \
+          "
+
+DEPENDS += "libxml2 glib-2.0 json-glib"
+
+inherit pypi python_setuptools_build_meta pkgconfig
+
+#Fix LIBDIR path to fix buildpaths QA check of hotdoc/parsers/cmark.cpython-314-x86_64-linux-gnu.so
+do_configure:prepend() {
+    sed -i -e "s#'\"%s\"' % CMARK_BUILD_DIR#'\"${PYTHON_SITEPACKAGES_DIR}/${PN}\"'#" ${S}/setup.py
+}
+
+RDEPENDS:${PN} += "python3-appdirs python3-lxml python3-pyyaml python3-schema python3-toposort python3-wheezy-template"
+
+BBCLASSEXTEND = "native"
-- 
2.43.0



^ permalink raw reply related	[flat|nested] 21+ messages in thread

* [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-01-29  3:53 [PATCH 0/6] Investigate hotdoc and add a recipe to build it Liu Yiding
                   ` (4 preceding siblings ...)
  2026-01-29  3:53 ` [OE-core][PATCH 5/6 v3] hotdoc: " Liu Yiding
@ 2026-01-29  3:53 ` Liu Yiding
  2026-01-29  4:01   ` Patchtest results for " patchtest
                     ` (2 more replies)
  5 siblings, 3 replies; 21+ messages in thread
From: Liu Yiding @ 2026-01-29  3:53 UTC (permalink / raw)
  To: openembedded-core

Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
---
 .../orc/orc/0001-Fix-hotdoc-run-error.patch   | 37 +++++++++++++++++++
 meta/recipes-devtools/orc/orc_0.4.42.bb       |  5 ++-
 2 files changed, 41 insertions(+), 1 deletion(-)
 create mode 100644 meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch

diff --git a/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
new file mode 100644
index 0000000000..277ce038f8
--- /dev/null
+++ b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
@@ -0,0 +1,36 @@
+Subject: [PATCH] Fix hotdoc run error.
+
+Fix the following error.
+| Running custom install script 'tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/meson.real --internal hotdoc --install orc-doc/html --docdir /usr/share/doc/orc/html --name orc --builddir tmp/work/x86-64-v3-poky-linux/orc/0.4.42/build/doc tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/hotdoc run --conf-file orc-doc.json'
+| --- stdout ---
+|
+| --- stderr ---
+| ERROR: [doc-tree]: (index-extension-not-found): tmp/work/x86-64-v3-poky-linux/orc/0.4.42/sources/orc-0.4.42/doc/sitemap.txt:8:10: No extension named c for index page
+| 00006:                tutorial.md
+| 00007:                opcodes.md
+| 00008:        c-index
+|               ^
+| 00009:
+|
+
+Remove c-index as it is not in the doc directory.
+
+Upstream-Status: Pending
+
+Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
+---
+ doc/sitemap.txt | 1 -
+ 1 file changed, 1 deletion(-)
+
+diff --git a/doc/sitemap.txt b/doc/sitemap.txt
+index 568b367..40a7f99 100644
+--- a/doc/sitemap.txt
++++ b/doc/sitemap.txt
+@@ -5,4 +5,3 @@ index.md
+ 		concepts.md
+ 		tutorial.md
+ 		opcodes.md
+-	c-index
+-- 
+2.43.0
+
diff --git a/meta/recipes-devtools/orc/orc_0.4.42.bb b/meta/recipes-devtools/orc/orc_0.4.42.bb
index f56b9058c2..b73c8df04d 100644
--- a/meta/recipes-devtools/orc/orc_0.4.42.bb
+++ b/meta/recipes-devtools/orc/orc_0.4.42.bb
@@ -4,11 +4,14 @@ DESCRIPTION = "Optimised Inner Loop Runtime Compiler is a Library and set of too
 LICENSE = "BSD-2-Clause & BSD-3-Clause"
 LIC_FILES_CHKSUM = "file://COPYING;md5=1400bd9d09e8af56b9ec982b3d85797e"
 
-SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz"
+SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz \
+           file://0001-Fix-hotdoc-run-error.patch \
+          "
 SRC_URI[sha256sum] = "7ec912ab59af3cc97874c456a56a8ae1eec520c385ec447e8a102b2bd122c90c"
 
 inherit meson pkgconfig
 
+DEPENDS = "hotdoc-native"
 # distinguish from apache:orc
 CVE_PRODUCT = "gstreamer:orc"
 
-- 
2.43.0



^ permalink raw reply related	[flat|nested] 21+ messages in thread

* Patchtest results for [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-01-29  3:53 ` [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc Liu Yiding
@ 2026-01-29  4:01   ` patchtest
  2026-01-29 11:26   ` Alexander Kanavin
  2026-02-05 14:06   ` Ross Burton
  2 siblings, 0 replies; 21+ messages in thread
From: patchtest @ 2026-01-29  4:01 UTC (permalink / raw)
  To: Liu Yiding; +Cc: openembedded-core

[-- Attachment #1: Type: text/plain, Size: 2095 bytes --]

Thank you for your submission. Patchtest identified one
or more issues with the patch. Please see the log below for
more information:

---
Testing patch /home/patchtest/share/mboxes/6-6-orc-Enable-hotdoc-to-produce-doc.patch

FAIL: test commit message presence: Please include a commit message on your patch explaining the change (test_mbox.TestMbox.test_commit_message_presence)

PASS: test CVE tag format (test_patch.TestPatch.test_cve_tag_format)
PASS: test Signed-off-by presence (test_mbox.TestMbox.test_signed_off_by_presence)
PASS: test Signed-off-by presence (test_patch.TestPatch.test_signed_off_by_presence)
PASS: test Upstream-Status presence (test_patch.TestPatch.test_upstream_status_presence_format)
PASS: test author valid (test_mbox.TestMbox.test_author_valid)
PASS: test commit message user tags (test_mbox.TestMbox.test_commit_message_user_tags)
PASS: test mbox format (test_mbox.TestMbox.test_mbox_format)
PASS: test non-AUH upgrade (test_mbox.TestMbox.test_non_auh_upgrade)
PASS: test shortlog format (test_mbox.TestMbox.test_shortlog_format)
PASS: test shortlog length (test_mbox.TestMbox.test_shortlog_length)
PASS: test target mailing list (test_mbox.TestMbox.test_target_mailing_list)

SKIP: pretest pylint: No python related patches, skipping test (test_python_pylint.PyLint.pretest_pylint)
SKIP: test bugzilla entry format: No bug ID found (test_mbox.TestMbox.test_bugzilla_entry_format)
SKIP: test pylint: No python related patches, skipping test (test_python_pylint.PyLint.test_pylint)
SKIP: test series merge on head: Merge test is disabled for now (test_mbox.TestMbox.test_series_merge_on_head)

---

Please address the issues identified and
submit a new revision of the patch, or alternatively, reply to this
email with an explanation of why the patch should be accepted. If you
believe these results are due to an error in patchtest, please submit a
bug at https://bugzilla.yoctoproject.org/ (use the 'Patchtest' category
under 'Yocto Project Subprojects'). For more information on specific
failures, see: https://wiki.yoctoproject.org/wiki/Patchtest. Thank
you!

^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-01-29  3:53 ` [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc Liu Yiding
  2026-01-29  4:01   ` Patchtest results for " patchtest
@ 2026-01-29 11:26   ` Alexander Kanavin
  2026-01-30  2:19     ` 回复: " Yiding Liu (Fujitsu)
  2026-02-05 14:06   ` Ross Burton
  2 siblings, 1 reply; 21+ messages in thread
From: Alexander Kanavin @ 2026-01-29 11:26 UTC (permalink / raw)
  To: liuyd.fnst; +Cc: openembedded-core

Thanks for looking into this. Are there other recipes in oe-core that
have hotdoc support? You can perhaps unpack everything (without
building it), and then grep in WORKDIR for hotdoc.

If there's just orc, we could probably add hotdoc to meta-openembedded first.

The pending patch needs to be submitted upstream.

Alex

On Thu, 29 Jan 2026 at 04:54, Yiding Liu (Fujitsu) via
lists.openembedded.org <liuyd.fnst=fujitsu.com@lists.openembedded.org>
wrote:
>
> Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> ---
>  .../orc/orc/0001-Fix-hotdoc-run-error.patch   | 37 +++++++++++++++++++
>  meta/recipes-devtools/orc/orc_0.4.42.bb       |  5 ++-
>  2 files changed, 41 insertions(+), 1 deletion(-)
>  create mode 100644 meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
>
> diff --git a/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> new file mode 100644
> index 0000000000..277ce038f8
> --- /dev/null
> +++ b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> @@ -0,0 +1,36 @@
> +Subject: [PATCH] Fix hotdoc run error.
> +
> +Fix the following error.
> +| Running custom install script 'tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/meson.real --internal hotdoc --install orc-doc/html --docdir /usr/share/doc/orc/html --name orc --builddir tmp/work/x86-64-v3-poky-linux/orc/0.4.42/build/doc tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/hotdoc run --conf-file orc-doc.json'
> +| --- stdout ---
> +|
> +| --- stderr ---
> +| ERROR: [doc-tree]: (index-extension-not-found): tmp/work/x86-64-v3-poky-linux/orc/0.4.42/sources/orc-0.4.42/doc/sitemap.txt:8:10: No extension named c for index page
> +| 00006:                tutorial.md
> +| 00007:                opcodes.md
> +| 00008:        c-index
> +|               ^
> +| 00009:
> +|
> +
> +Remove c-index as it is not in the doc directory.
> +
> +Upstream-Status: Pending
> +
> +Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> +---
> + doc/sitemap.txt | 1 -
> + 1 file changed, 1 deletion(-)
> +
> +diff --git a/doc/sitemap.txt b/doc/sitemap.txt
> +index 568b367..40a7f99 100644
> +--- a/doc/sitemap.txt
> ++++ b/doc/sitemap.txt
> +@@ -5,4 +5,3 @@ index.md
> +               concepts.md
> +               tutorial.md
> +               opcodes.md
> +-      c-index
> +--
> +2.43.0
> +
> diff --git a/meta/recipes-devtools/orc/orc_0.4.42.bb b/meta/recipes-devtools/orc/orc_0.4.42.bb
> index f56b9058c2..b73c8df04d 100644
> --- a/meta/recipes-devtools/orc/orc_0.4.42.bb
> +++ b/meta/recipes-devtools/orc/orc_0.4.42.bb
> @@ -4,11 +4,14 @@ DESCRIPTION = "Optimised Inner Loop Runtime Compiler is a Library and set of too
>  LICENSE = "BSD-2-Clause & BSD-3-Clause"
>  LIC_FILES_CHKSUM = "file://COPYING;md5=1400bd9d09e8af56b9ec982b3d85797e"
>
> -SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz"
> +SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz \
> +           file://0001-Fix-hotdoc-run-error.patch \
> +          "
>  SRC_URI[sha256sum] = "7ec912ab59af3cc97874c456a56a8ae1eec520c385ec447e8a102b2bd122c90c"
>
>  inherit meson pkgconfig
>
> +DEPENDS = "hotdoc-native"
>  # distinguish from apache:orc
>  CVE_PRODUCT = "gstreamer:orc"
>
> --
> 2.43.0
>
>
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#230118): https://lists.openembedded.org/g/openembedded-core/message/230118
> Mute This Topic: https://lists.openembedded.org/mt/117521454/1686489
> Group Owner: openembedded-core+owner@lists.openembedded.org
> Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [alex.kanavin@gmail.com]
> -=-=-=-=-=-=-=-=-=-=-=-
>


^ permalink raw reply	[flat|nested] 21+ messages in thread

* 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-01-29 11:26   ` Alexander Kanavin
@ 2026-01-30  2:19     ` Yiding Liu (Fujitsu)
  2026-02-05  2:59       ` Yiding Liu (Fujitsu)
  0 siblings, 1 reply; 21+ messages in thread
From: Yiding Liu (Fujitsu) @ 2026-01-30  2:19 UTC (permalink / raw)
  To: Alexander Kanavin; +Cc: openembedded-core@lists.openembedded.org

[-- Attachment #1: Type: text/plain, Size: 4343 bytes --]

Hi Alex

     I search the changelog in git log, and found that besides orc, gstreamer1.0-vaapi,  gstreamer1.0-plugins-base and gstreamer1.0 used hotdoc in new version.

Liu
________________________________
发件人: Alexander Kanavin <alex.kanavin@gmail.com>
发送时间: 2026年1月29日 19:26
收件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
主题: Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc

Thanks for looking into this. Are there other recipes in oe-core that
have hotdoc support? You can perhaps unpack everything (without
building it), and then grep in WORKDIR for hotdoc.

If there's just orc, we could probably add hotdoc to meta-openembedded first.

The pending patch needs to be submitted upstream.

Alex

On Thu, 29 Jan 2026 at 04:54, Yiding Liu (Fujitsu) via
lists.openembedded.org <liuyd.fnst=fujitsu.com@lists.openembedded.org>
wrote:
>
> Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> ---
>  .../orc/orc/0001-Fix-hotdoc-run-error.patch   | 37 +++++++++++++++++++
>  meta/recipes-devtools/orc/orc_0.4.42.bb       |  5 ++-
>  2 files changed, 41 insertions(+), 1 deletion(-)
>  create mode 100644 meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
>
> diff --git a/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> new file mode 100644
> index 0000000000..277ce038f8
> --- /dev/null
> +++ b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> @@ -0,0 +1,36 @@
> +Subject: [PATCH] Fix hotdoc run error.
> +
> +Fix the following error.
> +| Running custom install script 'tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/meson.real --internal hotdoc --install orc-doc/html --docdir /usr/share/doc/orc/html --name orc --builddir tmp/work/x86-64-v3-poky-linux/orc/0.4.42/build/doc tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/hotdoc run --conf-file orc-doc.json'
> +| --- stdout ---
> +|
> +| --- stderr ---
> +| ERROR: [doc-tree]: (index-extension-not-found): tmp/work/x86-64-v3-poky-linux/orc/0.4.42/sources/orc-0.4.42/doc/sitemap.txt:8:10: No extension named c for index page
> +| 00006:                tutorial.md
> +| 00007:                opcodes.md
> +| 00008:        c-index
> +|               ^
> +| 00009:
> +|
> +
> +Remove c-index as it is not in the doc directory.
> +
> +Upstream-Status: Pending
> +
> +Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> +---
> + doc/sitemap.txt | 1 -
> + 1 file changed, 1 deletion(-)
> +
> +diff --git a/doc/sitemap.txt b/doc/sitemap.txt
> +index 568b367..40a7f99 100644
> +--- a/doc/sitemap.txt
> ++++ b/doc/sitemap.txt
> +@@ -5,4 +5,3 @@ index.md
> +               concepts.md
> +               tutorial.md
> +               opcodes.md
> +-      c-index
> +--
> +2.43.0
> +
> diff --git a/meta/recipes-devtools/orc/orc_0.4.42.bb b/meta/recipes-devtools/orc/orc_0.4.42.bb
> index f56b9058c2..b73c8df04d 100644
> --- a/meta/recipes-devtools/orc/orc_0.4.42.bb
> +++ b/meta/recipes-devtools/orc/orc_0.4.42.bb
> @@ -4,11 +4,14 @@ DESCRIPTION = "Optimised Inner Loop Runtime Compiler is a Library and set of too
>  LICENSE = "BSD-2-Clause & BSD-3-Clause"
>  LIC_FILES_CHKSUM = "file://COPYING;md5=1400bd9d09e8af56b9ec982b3d85797e"
>
> -SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz"
> +SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz \
> +           file://0001-Fix-hotdoc-run-error.patch \
> +          "
>  SRC_URI[sha256sum] = "7ec912ab59af3cc97874c456a56a8ae1eec520c385ec447e8a102b2bd122c90c"
>
>  inherit meson pkgconfig
>
> +DEPENDS = "hotdoc-native"
>  # distinguish from apache:orc
>  CVE_PRODUCT = "gstreamer:orc"
>
> --
> 2.43.0
>
>
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#230118): https://lists.openembedded.org/g/openembedded-core/message/230118
> Mute This Topic: https://lists.openembedded.org/mt/117521454/1686489
> Group Owner: openembedded-core+owner@lists.openembedded.org
> Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [alex.kanavin@gmail.com]
> -=-=-=-=-=-=-=-=-=-=-=-
>

[-- Attachment #2: Type: text/html, Size: 7083 bytes --]

^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 1/6] python3-appdirs: Add new recipe
  2026-01-29  3:53 ` [OE-core][PATCH 1/6] python3-appdirs: Add new recipe Liu Yiding
@ 2026-01-30  8:28   ` Mathieu Dubois-Briand
  2026-01-30 21:36     ` Mathieu Dubois-Briand
  0 siblings, 1 reply; 21+ messages in thread
From: Mathieu Dubois-Briand @ 2026-01-30  8:28 UTC (permalink / raw)
  To: liuyd.fnst, openembedded-core

On Thu Jan 29, 2026 at 4:53 AM CET, Yiding Liu (Fujitsu) via lists.openembedded.org wrote:
> Move it from meta-openembedded to openembedded-core as it is required by hotdoc 0.17.4.
>
> Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> ---

Hi Liu,

Thanks for your patch.

>  meta/recipes-devtools/python/python3-appdirs_1.4.4.bb | 11 +++++++++++
>  1 file changed, 11 insertions(+)
>  create mode 100644 meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
>
> diff --git a/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb b/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
> new file mode 100644
> index 0000000000..bee0b7d815
> --- /dev/null
> +++ b/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
> @@ -0,0 +1,11 @@
> +SUMMARY = "A small Python module for determining appropriate + platform-specific dirs, e.g. a user data dir."
> +LICENSE = "MIT"
> +LIC_FILES_CHKSUM = "file://LICENSE.txt;md5=31625363c45eb0c67c630a2f73e438e4"

You will also need to add an HOMEPAGE line in there.

Thanks,
Mathieu

-- 
Mathieu Dubois-Briand, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com



^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 1/6] python3-appdirs: Add new recipe
  2026-01-30  8:28   ` Mathieu Dubois-Briand
@ 2026-01-30 21:36     ` Mathieu Dubois-Briand
  0 siblings, 0 replies; 21+ messages in thread
From: Mathieu Dubois-Briand @ 2026-01-30 21:36 UTC (permalink / raw)
  To: liuyd.fnst, openembedded-core

On Fri Jan 30, 2026 at 9:28 AM CET, Mathieu Dubois-Briand wrote:
> On Thu Jan 29, 2026 at 4:53 AM CET, Yiding Liu (Fujitsu) via lists.openembedded.org wrote:
>> Move it from meta-openembedded to openembedded-core as it is required by hotdoc 0.17.4.
>>
>> Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
>> ---
>
> Hi Liu,
>
> Thanks for your patch.
>
>>  meta/recipes-devtools/python/python3-appdirs_1.4.4.bb | 11 +++++++++++
>>  1 file changed, 11 insertions(+)
>>  create mode 100644 meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
>>
>> diff --git a/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb b/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
>> new file mode 100644
>> index 0000000000..bee0b7d815
>> --- /dev/null
>> +++ b/meta/recipes-devtools/python/python3-appdirs_1.4.4.bb
>> @@ -0,0 +1,11 @@
>> +SUMMARY = "A small Python module for determining appropriate + platform-specific dirs, e.g. a user data dir."
>> +LICENSE = "MIT"
>> +LIC_FILES_CHKSUM = "file://LICENSE.txt;md5=31625363c45eb0c67c630a2f73e438e4"
>
> You will also need to add an HOMEPAGE line in there.
>
> Thanks,
> Mathieu

Hi Liu,

I missed that at first, but you will also need to add an entry into
meta/conf/distro/include/maintainers.inc for all added recipes. 

Thanks,
Mathieu

-- 
Mathieu Dubois-Briand, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com



^ permalink raw reply	[flat|nested] 21+ messages in thread

* 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-01-30  2:19     ` 回复: " Yiding Liu (Fujitsu)
@ 2026-02-05  2:59       ` Yiding Liu (Fujitsu)
  2026-02-05  9:50         ` Alexander Kanavin
  0 siblings, 1 reply; 21+ messages in thread
From: Yiding Liu (Fujitsu) @ 2026-02-05  2:59 UTC (permalink / raw)
  To: Alexander Kanavin; +Cc: openembedded-core@lists.openembedded.org

[-- Attachment #1: Type: text/plain, Size: 4681 bytes --]

Ping
________________________________
发件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
发送时间: 2026年1月30日 10:19
收件人: Alexander Kanavin <alex.kanavin@gmail.com>
抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
主题: 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc

Hi Alex

     I search the changelog in git log, and found that besides orc, gstreamer1.0-vaapi,  gstreamer1.0-plugins-base and gstreamer1.0 used hotdoc in new version.

Liu
________________________________
发件人: Alexander Kanavin <alex.kanavin@gmail.com>
发送时间: 2026年1月29日 19:26
收件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
主题: Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc

Thanks for looking into this. Are there other recipes in oe-core that
have hotdoc support? You can perhaps unpack everything (without
building it), and then grep in WORKDIR for hotdoc.

If there's just orc, we could probably add hotdoc to meta-openembedded first.

The pending patch needs to be submitted upstream.

Alex

On Thu, 29 Jan 2026 at 04:54, Yiding Liu (Fujitsu) via
lists.openembedded.org <liuyd.fnst=fujitsu.com@lists.openembedded.org>
wrote:
>
> Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> ---
>  .../orc/orc/0001-Fix-hotdoc-run-error.patch   | 37 +++++++++++++++++++
>  meta/recipes-devtools/orc/orc_0.4.42.bb       |  5 ++-
>  2 files changed, 41 insertions(+), 1 deletion(-)
>  create mode 100644 meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
>
> diff --git a/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> new file mode 100644
> index 0000000000..277ce038f8
> --- /dev/null
> +++ b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> @@ -0,0 +1,36 @@
> +Subject: [PATCH] Fix hotdoc run error.
> +
> +Fix the following error.
> +| Running custom install script 'tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/meson.real --internal hotdoc --install orc-doc/html --docdir /usr/share/doc/orc/html --name orc --builddir tmp/work/x86-64-v3-poky-linux/orc/0.4.42/build/doc tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/hotdoc run --conf-file orc-doc.json'
> +| --- stdout ---
> +|
> +| --- stderr ---
> +| ERROR: [doc-tree]: (index-extension-not-found): tmp/work/x86-64-v3-poky-linux/orc/0.4.42/sources/orc-0.4.42/doc/sitemap.txt:8:10: No extension named c for index page
> +| 00006:                tutorial.md
> +| 00007:                opcodes.md
> +| 00008:        c-index
> +|               ^
> +| 00009:
> +|
> +
> +Remove c-index as it is not in the doc directory.
> +
> +Upstream-Status: Pending
> +
> +Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> +---
> + doc/sitemap.txt | 1 -
> + 1 file changed, 1 deletion(-)
> +
> +diff --git a/doc/sitemap.txt b/doc/sitemap.txt
> +index 568b367..40a7f99 100644
> +--- a/doc/sitemap.txt
> ++++ b/doc/sitemap.txt
> +@@ -5,4 +5,3 @@ index.md
> +               concepts.md
> +               tutorial.md
> +               opcodes.md
> +-      c-index
> +--
> +2.43.0
> +
> diff --git a/meta/recipes-devtools/orc/orc_0.4.42.bb b/meta/recipes-devtools/orc/orc_0.4.42.bb
> index f56b9058c2..b73c8df04d 100644
> --- a/meta/recipes-devtools/orc/orc_0.4.42.bb
> +++ b/meta/recipes-devtools/orc/orc_0.4.42.bb
> @@ -4,11 +4,14 @@ DESCRIPTION = "Optimised Inner Loop Runtime Compiler is a Library and set of too
>  LICENSE = "BSD-2-Clause & BSD-3-Clause"
>  LIC_FILES_CHKSUM = "file://COPYING;md5=1400bd9d09e8af56b9ec982b3d85797e"
>
> -SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz"
> +SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz \
> +           file://0001-Fix-hotdoc-run-error.patch \
> +          "
>  SRC_URI[sha256sum] = "7ec912ab59af3cc97874c456a56a8ae1eec520c385ec447e8a102b2bd122c90c"
>
>  inherit meson pkgconfig
>
> +DEPENDS = "hotdoc-native"
>  # distinguish from apache:orc
>  CVE_PRODUCT = "gstreamer:orc"
>
> --
> 2.43.0
>
>
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#230118): https://lists.openembedded.org/g/openembedded-core/message/230118
> Mute This Topic: https://lists.openembedded.org/mt/117521454/1686489
> Group Owner: openembedded-core+owner@lists.openembedded.org
> Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [alex.kanavin@gmail.com]
> -=-=-=-=-=-=-=-=-=-=-=-
>

[-- Attachment #2: Type: text/html, Size: 7983 bytes --]

^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-02-05  2:59       ` Yiding Liu (Fujitsu)
@ 2026-02-05  9:50         ` Alexander Kanavin
  2026-02-10  2:41           ` 回复: " Yiding Liu (Fujitsu)
  0 siblings, 1 reply; 21+ messages in thread
From: Alexander Kanavin @ 2026-02-05  9:50 UTC (permalink / raw)
  To: Yiding Liu (Fujitsu); +Cc: openembedded-core@lists.openembedded.org

Hello,

sorry for not saying this explicitly, as you've found other recipes
with hotdoc support, can you look into enabling it there as well?

Alex

On Thu, 5 Feb 2026 at 03:59, Yiding Liu (Fujitsu)
<liuyd.fnst@fujitsu.com> wrote:
>
> Ping
> ________________________________
> 发件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
> 发送时间: 2026年1月30日 10:19
> 收件人: Alexander Kanavin <alex.kanavin@gmail.com>
> 抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
> 主题: 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
>
> Hi Alex
>
>      I search the changelog in git log, and found that besides orc, gstreamer1.0-vaapi,  gstreamer1.0-plugins-base and gstreamer1.0 used hotdoc in new version.
>
> Liu
> ________________________________
> 发件人: Alexander Kanavin <alex.kanavin@gmail.com>
> 发送时间: 2026年1月29日 19:26
> 收件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
> 抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
> 主题: Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
>
> Thanks for looking into this. Are there other recipes in oe-core that
> have hotdoc support? You can perhaps unpack everything (without
> building it), and then grep in WORKDIR for hotdoc.
>
> If there's just orc, we could probably add hotdoc to meta-openembedded first.
>
> The pending patch needs to be submitted upstream.
>
> Alex
>
> On Thu, 29 Jan 2026 at 04:54, Yiding Liu (Fujitsu) via
> lists.openembedded.org <liuyd.fnst=fujitsu.com@lists.openembedded.org>
> wrote:
> >
> > Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> > ---
> >  .../orc/orc/0001-Fix-hotdoc-run-error.patch   | 37 +++++++++++++++++++
> >  meta/recipes-devtools/orc/orc_0.4.42.bb       |  5 ++-
> >  2 files changed, 41 insertions(+), 1 deletion(-)
> >  create mode 100644 meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> >
> > diff --git a/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> > new file mode 100644
> > index 0000000000..277ce038f8
> > --- /dev/null
> > +++ b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> > @@ -0,0 +1,36 @@
> > +Subject: [PATCH] Fix hotdoc run error.
> > +
> > +Fix the following error.
> > +| Running custom install script 'tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/meson.real --internal hotdoc --install orc-doc/html --docdir /usr/share/doc/orc/html --name orc --builddir tmp/work/x86-64-v3-poky-linux/orc/0.4.42/build/doc tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/hotdoc run --conf-file orc-doc.json'
> > +| --- stdout ---
> > +|
> > +| --- stderr ---
> > +| ERROR: [doc-tree]: (index-extension-not-found): tmp/work/x86-64-v3-poky-linux/orc/0.4.42/sources/orc-0.4.42/doc/sitemap.txt:8:10: No extension named c for index page
> > +| 00006:                tutorial.md
> > +| 00007:                opcodes.md
> > +| 00008:        c-index
> > +|               ^
> > +| 00009:
> > +|
> > +
> > +Remove c-index as it is not in the doc directory.
> > +
> > +Upstream-Status: Pending
> > +
> > +Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> > +---
> > + doc/sitemap.txt | 1 -
> > + 1 file changed, 1 deletion(-)
> > +
> > +diff --git a/doc/sitemap.txt b/doc/sitemap.txt
> > +index 568b367..40a7f99 100644
> > +--- a/doc/sitemap.txt
> > ++++ b/doc/sitemap.txt
> > +@@ -5,4 +5,3 @@ index.md
> > +               concepts.md
> > +               tutorial.md
> > +               opcodes.md
> > +-      c-index
> > +--
> > +2.43.0
> > +
> > diff --git a/meta/recipes-devtools/orc/orc_0.4.42.bb b/meta/recipes-devtools/orc/orc_0.4.42.bb
> > index f56b9058c2..b73c8df04d 100644
> > --- a/meta/recipes-devtools/orc/orc_0.4.42.bb
> > +++ b/meta/recipes-devtools/orc/orc_0.4.42.bb
> > @@ -4,11 +4,14 @@ DESCRIPTION = "Optimised Inner Loop Runtime Compiler is a Library and set of too
> >  LICENSE = "BSD-2-Clause & BSD-3-Clause"
> >  LIC_FILES_CHKSUM = "file://COPYING;md5=1400bd9d09e8af56b9ec982b3d85797e"
> >
> > -SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz"
> > +SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz \
> > +           file://0001-Fix-hotdoc-run-error.patch \
> > +          "
> >  SRC_URI[sha256sum] = "7ec912ab59af3cc97874c456a56a8ae1eec520c385ec447e8a102b2bd122c90c"
> >
> >  inherit meson pkgconfig
> >
> > +DEPENDS = "hotdoc-native"
> >  # distinguish from apache:orc
> >  CVE_PRODUCT = "gstreamer:orc"
> >
> > --
> > 2.43.0
> >
> >
> > -=-=-=-=-=-=-=-=-=-=-=-
> > Links: You receive all messages sent to this group.
> > View/Reply Online (#230118): https://lists.openembedded.org/g/openembedded-core/message/230118
> > Mute This Topic: https://lists.openembedded.org/mt/117521454/1686489
> > Group Owner: openembedded-core+owner@lists.openembedded.org
> > Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [alex.kanavin@gmail.com]
> > -=-=-=-=-=-=-=-=-=-=-=-
> >


^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-01-29  3:53 ` [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc Liu Yiding
  2026-01-29  4:01   ` Patchtest results for " patchtest
  2026-01-29 11:26   ` Alexander Kanavin
@ 2026-02-05 14:06   ` Ross Burton
  2 siblings, 0 replies; 21+ messages in thread
From: Ross Burton @ 2026-02-05 14:06 UTC (permalink / raw)
  To: liuyd.fnst@fujitsu.com; +Cc: openembedded-core@lists.openembedded.org

On 29 Jan 2026, at 03:53, Yiding Liu (Fujitsu) via lists.openembedded.org <liuyd.fnst=fujitsu.com@lists.openembedded.org> wrote:
> +DEPENDS = "hotdoc-native"

We have an api-documentation DISTRO_FEATURE, please respect that.

Ross



^ permalink raw reply	[flat|nested] 21+ messages in thread

* 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-02-05  9:50         ` Alexander Kanavin
@ 2026-02-10  2:41           ` Yiding Liu (Fujitsu)
  2026-02-10  9:41             ` Alexander Kanavin
  0 siblings, 1 reply; 21+ messages in thread
From: Yiding Liu (Fujitsu) @ 2026-02-10  2:41 UTC (permalink / raw)
  To: Alexander Kanavin; +Cc: openembedded-core@lists.openembedded.org

[-- Attachment #1: Type: text/plain, Size: 6095 bytes --]

Hi Alex
       I try to enable doc in gstreamer1.0-vaapi,  gstreamer1.0-plugins-base and gstreamer1.0 but found a problem

       There is a definition in docs/meson.build which prevent building doc in  cross building.

if meson.is_cross_build()
    if get_option('doc').enabled()
        error('Documentation enabled but building the doc while cross building is not supported yet.')
    endif

    message('Documentation not built as building it while cross building is not supported yet.')
    subdir_done()
endif

         So what should I do next? Maybe I should send thest patchsets to meta-oe?
Liu
________________________________
发件人: Alexander Kanavin <alex.kanavin@gmail.com>
发送时间: 2026年2月5日 17:50
收件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
主题: Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc

Hello,

sorry for not saying this explicitly, as you've found other recipes
with hotdoc support, can you look into enabling it there as well?

Alex

On Thu, 5 Feb 2026 at 03:59, Yiding Liu (Fujitsu)
<liuyd.fnst@fujitsu.com> wrote:
>
> Ping
> ________________________________
> 发件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
> 发送时间: 2026年1月30日 10:19
> 收件人: Alexander Kanavin <alex.kanavin@gmail.com>
> 抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
> 主题: 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
>
> Hi Alex
>
>      I search the changelog in git log, and found that besides orc, gstreamer1.0-vaapi,  gstreamer1.0-plugins-base and gstreamer1.0 used hotdoc in new version.
>
> Liu
> ________________________________
> 发件人: Alexander Kanavin <alex.kanavin@gmail.com>
> 发送时间: 2026年1月29日 19:26
> 收件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
> 抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
> 主题: Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
>
> Thanks for looking into this. Are there other recipes in oe-core that
> have hotdoc support? You can perhaps unpack everything (without
> building it), and then grep in WORKDIR for hotdoc.
>
> If there's just orc, we could probably add hotdoc to meta-openembedded first.
>
> The pending patch needs to be submitted upstream.
>
> Alex
>
> On Thu, 29 Jan 2026 at 04:54, Yiding Liu (Fujitsu) via
> lists.openembedded.org <liuyd.fnst=fujitsu.com@lists.openembedded.org>
> wrote:
> >
> > Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> > ---
> >  .../orc/orc/0001-Fix-hotdoc-run-error.patch   | 37 +++++++++++++++++++
> >  meta/recipes-devtools/orc/orc_0.4.42.bb       |  5 ++-
> >  2 files changed, 41 insertions(+), 1 deletion(-)
> >  create mode 100644 meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> >
> > diff --git a/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> > new file mode 100644
> > index 0000000000..277ce038f8
> > --- /dev/null
> > +++ b/meta/recipes-devtools/orc/orc/0001-Fix-hotdoc-run-error.patch
> > @@ -0,0 +1,36 @@
> > +Subject: [PATCH] Fix hotdoc run error.
> > +
> > +Fix the following error.
> > +| Running custom install script 'tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/meson.real --internal hotdoc --install orc-doc/html --docdir /usr/share/doc/orc/html --name orc --builddir tmp/work/x86-64-v3-poky-linux/orc/0.4.42/build/doc tmp/work/x86-64-v3-poky-linux/orc/0.4.42/recipe-sysroot-native/usr/bin/hotdoc run --conf-file orc-doc.json'
> > +| --- stdout ---
> > +|
> > +| --- stderr ---
> > +| ERROR: [doc-tree]: (index-extension-not-found): tmp/work/x86-64-v3-poky-linux/orc/0.4.42/sources/orc-0.4.42/doc/sitemap.txt:8:10: No extension named c for index page
> > +| 00006:                tutorial.md
> > +| 00007:                opcodes.md
> > +| 00008:        c-index
> > +|               ^
> > +| 00009:
> > +|
> > +
> > +Remove c-index as it is not in the doc directory.
> > +
> > +Upstream-Status: Pending
> > +
> > +Signed-off-by: Liu Yiding <liuyd.fnst@fujitsu.com>
> > +---
> > + doc/sitemap.txt | 1 -
> > + 1 file changed, 1 deletion(-)
> > +
> > +diff --git a/doc/sitemap.txt b/doc/sitemap.txt
> > +index 568b367..40a7f99 100644
> > +--- a/doc/sitemap.txt
> > ++++ b/doc/sitemap.txt
> > +@@ -5,4 +5,3 @@ index.md
> > +               concepts.md
> > +               tutorial.md
> > +               opcodes.md
> > +-      c-index
> > +--
> > +2.43.0
> > +
> > diff --git a/meta/recipes-devtools/orc/orc_0.4.42.bb b/meta/recipes-devtools/orc/orc_0.4.42.bb
> > index f56b9058c2..b73c8df04d 100644
> > --- a/meta/recipes-devtools/orc/orc_0.4.42.bb
> > +++ b/meta/recipes-devtools/orc/orc_0.4.42.bb
> > @@ -4,11 +4,14 @@ DESCRIPTION = "Optimised Inner Loop Runtime Compiler is a Library and set of too
> >  LICENSE = "BSD-2-Clause & BSD-3-Clause"
> >  LIC_FILES_CHKSUM = "file://COPYING;md5=1400bd9d09e8af56b9ec982b3d85797e"
> >
> > -SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz"
> > +SRC_URI = "http://gstreamer.freedesktop.org/src/orc/orc-${PV}.tar.xz \
> > +           file://0001-Fix-hotdoc-run-error.patch \
> > +          "
> >  SRC_URI[sha256sum] = "7ec912ab59af3cc97874c456a56a8ae1eec520c385ec447e8a102b2bd122c90c"
> >
> >  inherit meson pkgconfig
> >
> > +DEPENDS = "hotdoc-native"
> >  # distinguish from apache:orc
> >  CVE_PRODUCT = "gstreamer:orc"
> >
> > --
> > 2.43.0
> >
> >
> > -=-=-=-=-=-=-=-=-=-=-=-
> > Links: You receive all messages sent to this group.
> > View/Reply Online (#230118): https://lists.openembedded.org/g/openembedded-core/message/230118
> > Mute This Topic: https://lists.openembedded.org/mt/117521454/1686489
> > Group Owner: openembedded-core+owner@lists.openembedded.org
> > Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [alex.kanavin@gmail.com]
> > -=-=-=-=-=-=-=-=-=-=-=-
> >

[-- Attachment #2: Type: text/html, Size: 12296 bytes --]

^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-02-10  2:41           ` 回复: " Yiding Liu (Fujitsu)
@ 2026-02-10  9:41             ` Alexander Kanavin
  2026-02-11  2:35               ` 回复: " Yiding Liu (Fujitsu)
  0 siblings, 1 reply; 21+ messages in thread
From: Alexander Kanavin @ 2026-02-10  9:41 UTC (permalink / raw)
  To: Yiding Liu (Fujitsu); +Cc: openembedded-core@lists.openembedded.org

On Tue, 10 Feb 2026 at 03:42, Yiding Liu (Fujitsu)
<liuyd.fnst@fujitsu.com> wrote:
>        I try to enable doc in gstreamer1.0-vaapi,  gstreamer1.0-plugins-base and gstreamer1.0 but found a problem
>
>        There is a definition in docs/meson.build which prevent building doc in  cross building.
>
> if meson.is_cross_build()
>     if get_option('doc').enabled()
>         error('Documentation enabled but building the doc while cross building is not supported yet.')
>     endif
>
>     message('Documentation not built as building it while cross building is not supported yet.')
>     subdir_done()
> endif
>
>          So what should I do next? Maybe I should send thest patchsets to meta-oe?

If you have time to look into gstreamer issues, then you could add a
local patch to gstreamer recipes to remove the above code block, then
set 'doc' to enabled and see what happens (upstream-status doesn't
matter at this point yet). Presumably gstreamer upstream has that
because 'doc' needs running target binaries, but in yocto we have ways
to do it (via qemu). So please try and report, then we'll decide what
to do next.

If you do not have time to do this (which is totally fine), then yes,
hotdoc should be sent to meta-oe in my opinion, because enabling it to
support docs in a single, minor recipe in oe-core does not make sense.

Alex


^ permalink raw reply	[flat|nested] 21+ messages in thread

* 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-02-10  9:41             ` Alexander Kanavin
@ 2026-02-11  2:35               ` Yiding Liu (Fujitsu)
  2026-02-11 11:47                 ` Alexander Kanavin
  0 siblings, 1 reply; 21+ messages in thread
From: Yiding Liu (Fujitsu) @ 2026-02-11  2:35 UTC (permalink / raw)
  To: Alexander Kanavin; +Cc: openembedded-core@lists.openembedded.org

[-- Attachment #1: Type: text/plain, Size: 2747 bytes --]

Hi Alex

   In order to make hotdoc work for orc and gstreamer1.0, I need to enable Extensions of hotdoc to work.
   So I need to add additional RDEPENDS including: python3-dbus-deviation python3-networkx python3-cchardet python3-pkgconfig clang llvm

  After addind additional RDEPENDS, the RDEPENDS is as following:
  RDEPENDS:${PN} += "clang llvm python3-appdirs python3-cchardet python3-dbus-deviation python3-lxml python3-networkx python3-pkgconfig python3-pyyaml python3-schema python3-toposort python3-wheezy-template"

  Among these RDEPENDS, some OSS do not exist in the OE‑core, I need to add them newly. Others already exist in meta‑oe, I need to move them from meta‑oe to OE‑core as following .
 Is it okay? If so, I will send the v4 patchsets.

  New Added:
      python3-dbus-deviation
      python3-schema
      python3-toposort
      python3-wheezy-template

  Move from meta-oe:
     python3-appdirs
     python3-networkx
     python3-cchardet
     python3-pkgconfig

Liu

________________________________
发件人: Alexander Kanavin <alex.kanavin@gmail.com>
发送时间: 2026年2月10日 17:41
收件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
主题: Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc

On Tue, 10 Feb 2026 at 03:42, Yiding Liu (Fujitsu)
<liuyd.fnst@fujitsu.com> wrote:
>        I try to enable doc in gstreamer1.0-vaapi,  gstreamer1.0-plugins-base and gstreamer1.0 but found a problem
>
>        There is a definition in docs/meson.build which prevent building doc in  cross building.
>
> if meson.is_cross_build()
>     if get_option('doc').enabled()
>         error('Documentation enabled but building the doc while cross building is not supported yet.')
>     endif
>
>     message('Documentation not built as building it while cross building is not supported yet.')
>     subdir_done()
> endif
>
>          So what should I do next? Maybe I should send thest patchsets to meta-oe?

If you have time to look into gstreamer issues, then you could add a
local patch to gstreamer recipes to remove the above code block, then
set 'doc' to enabled and see what happens (upstream-status doesn't
matter at this point yet). Presumably gstreamer upstream has that
because 'doc' needs running target binaries, but in yocto we have ways
to do it (via qemu). So please try and report, then we'll decide what
to do next.

If you do not have time to do this (which is totally fine), then yes,
hotdoc should be sent to meta-oe in my opinion, because enabling it to
support docs in a single, minor recipe in oe-core does not make sense.

Alex

[-- Attachment #2: Type: text/html, Size: 8501 bytes --]

^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-02-11  2:35               ` 回复: " Yiding Liu (Fujitsu)
@ 2026-02-11 11:47                 ` Alexander Kanavin
  2026-02-12  2:16                   ` 回复: " Yiding Liu (Fujitsu)
  0 siblings, 1 reply; 21+ messages in thread
From: Alexander Kanavin @ 2026-02-11 11:47 UTC (permalink / raw)
  To: Yiding Liu (Fujitsu); +Cc: openembedded-core@lists.openembedded.org

On Wed, 11 Feb 2026 at 03:35, Yiding Liu (Fujitsu)
<liuyd.fnst@fujitsu.com> wrote:
>    In order to make hotdoc work for orc and gstreamer1.0, I need to enable Extensions of hotdoc to work.
>    So I need to add additional RDEPENDS including: python3-dbus-deviation python3-networkx python3-cchardet python3-pkgconfig clang llvm
>
>   After addind additional RDEPENDS, the RDEPENDS is as following:
>   RDEPENDS:${PN} += "clang llvm python3-appdirs python3-cchardet python3-dbus-deviation python3-lxml python3-networkx python3-pkgconfig python3-pyyaml python3-schema python3-toposort python3-wheezy-template"
>
>   Among these RDEPENDS, some OSS do not exist in the OE‑core, I need to add them newly. Others already exist in meta‑oe, I need to move them from meta‑oe to OE‑core as following .
>  Is it okay? If so, I will send the v4 patchsets.

That's okay, yes. Thanks for persevering with this. Please do explain
the need for llvm and clang particularly in the commit messages, those
are heavy dependencies and we should try to avoid them where possible.

I am starting to lean towards just adding all of the needed recipes to
meta-oe to be honest (and not enabling docs in orc/gstreamer by
default), the amount of new recipes we need to support in oe-core does
not seem to justify the outcome (building documentation for gstreamer,
a minor enhancement in my opinion). The patch review will make the
decision based on the final patchset.

Alex


^ permalink raw reply	[flat|nested] 21+ messages in thread

* 回复: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-02-11 11:47                 ` Alexander Kanavin
@ 2026-02-12  2:16                   ` Yiding Liu (Fujitsu)
  2026-02-12 11:42                     ` Alexander Kanavin
  0 siblings, 1 reply; 21+ messages in thread
From: Yiding Liu (Fujitsu) @ 2026-02-12  2:16 UTC (permalink / raw)
  To: Alexander Kanavin; +Cc: openembedded-core@lists.openembedded.org

[-- Attachment #1: Type: text/plain, Size: 2856 bytes --]

Hi Alex

>  Please do explain the need for llvm and clang particularly in the commit messages,

  1.
Yes, I will explain it.

hotdoc has some Extensions and orc need the c-Extension
https://gitlab.freedesktop.org/gstreamer/orc/-/blob/main/doc/sitemap.txt?ref_type=heads

The c-Extension will need llvm and clang in runtime as introduced in doc of hotdoc.
https://hotdoc.github.io/c-extension.html#c-extension
"The extension uses Clang to build and walk an AST from the source code"

By the way, the use of llvm and clang can refer to this source code.
https://github.com/hotdoc/hotdoc/blob/master/hotdoc/extensions/c/c_extension.py


> I am starting to lean towards just adding all of the needed recipes to
meta-oe to be honest


  1.
Yes, I am also prefer to add new recipes to meta-oe as meta-oe already have half of the RDEPENDS.

Then I will send following patchset
a. Send hotdoc and its depend recipes to meta-oe.
b. Send orc/gstreamer docs enable patches to oe-core.

Is that ok?

Liu


________________________________
发件人: Alexander Kanavin <alex.kanavin@gmail.com>
发送时间: 2026年2月11日 19:47
收件人: Liu, Yiding/刘 乙丁 <liuyd.fnst@fujitsu.com>
抄送: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org>
主题: Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc

On Wed, 11 Feb 2026 at 03:35, Yiding Liu (Fujitsu)
<liuyd.fnst@fujitsu.com> wrote:
>    In order to make hotdoc work for orc and gstreamer1.0, I need to enable Extensions of hotdoc to work.
>    So I need to add additional RDEPENDS including: python3-dbus-deviation python3-networkx python3-cchardet python3-pkgconfig clang llvm
>
>   After addind additional RDEPENDS, the RDEPENDS is as following:
>   RDEPENDS:${PN} += "clang llvm python3-appdirs python3-cchardet python3-dbus-deviation python3-lxml python3-networkx python3-pkgconfig python3-pyyaml python3-schema python3-toposort python3-wheezy-template"
>
>   Among these RDEPENDS, some OSS do not exist in the OE‑core, I need to add them newly. Others already exist in meta‑oe, I need to move them from meta‑oe to OE‑core as following .
>  Is it okay? If so, I will send the v4 patchsets.

That's okay, yes. Thanks for persevering with this. Please do explain
the need for llvm and clang particularly in the commit messages, those
are heavy dependencies and we should try to avoid them where possible.

I am starting to lean towards just adding all of the needed recipes to
meta-oe to be honest (and not enabling docs in orc/gstreamer by
default), the amount of new recipes we need to support in oe-core does
not seem to justify the outcome (building documentation for gstreamer,
a minor enhancement in my opinion). The patch review will make the
decision based on the final patchset.

Alex

[-- Attachment #2: Type: text/html, Size: 9667 bytes --]

^ permalink raw reply	[flat|nested] 21+ messages in thread

* Re: [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc
  2026-02-12  2:16                   ` 回复: " Yiding Liu (Fujitsu)
@ 2026-02-12 11:42                     ` Alexander Kanavin
  0 siblings, 0 replies; 21+ messages in thread
From: Alexander Kanavin @ 2026-02-12 11:42 UTC (permalink / raw)
  To: Yiding Liu (Fujitsu); +Cc: openembedded-core@lists.openembedded.org

On Thu, 12 Feb 2026 at 03:16, Yiding Liu (Fujitsu)
<liuyd.fnst@fujitsu.com> wrote:
> > I am starting to lean towards just adding all of the needed recipes to
> meta-oe to be honest
>
> Yes, I am also prefer to add new recipes to meta-oe as meta-oe already have half of the RDEPENDS.
>
> Then I will send following patchset
> a. Send hotdoc and its depend recipes to meta-oe.
> b. Send orc/gstreamer docs enable patches to oe-core.
>
> Is that ok?

Yes please. The oe-core patches should make all the changes that are
needed to enable docs (e.g. add PACKAGECONFIG[doc], adjust
dependencies, etc.), but not actually enable them by default, as
default oe-core must work without meta-oe :)

Alex


^ permalink raw reply	[flat|nested] 21+ messages in thread

end of thread, other threads:[~2026-02-12 11:43 UTC | newest]

Thread overview: 21+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-01-29  3:53 [PATCH 0/6] Investigate hotdoc and add a recipe to build it Liu Yiding
2026-01-29  3:53 ` [OE-core][PATCH 1/6] python3-appdirs: Add new recipe Liu Yiding
2026-01-30  8:28   ` Mathieu Dubois-Briand
2026-01-30 21:36     ` Mathieu Dubois-Briand
2026-01-29  3:53 ` [OE-core][PATCH 2/6] python3-schema: " Liu Yiding
2026-01-29  3:53 ` [OE-core][PATCH 3/6] python3-toposort: " Liu Yiding
2026-01-29  3:53 ` [OE-core][PATCH 4/6 v2] python3-wheezy-template: " Liu Yiding
2026-01-29  3:53 ` [OE-core][PATCH 5/6 v3] hotdoc: " Liu Yiding
2026-01-29  3:53 ` [OE-core][PATCH 6/6] orc: Enable hotdoc to produce doc Liu Yiding
2026-01-29  4:01   ` Patchtest results for " patchtest
2026-01-29 11:26   ` Alexander Kanavin
2026-01-30  2:19     ` 回复: " Yiding Liu (Fujitsu)
2026-02-05  2:59       ` Yiding Liu (Fujitsu)
2026-02-05  9:50         ` Alexander Kanavin
2026-02-10  2:41           ` 回复: " Yiding Liu (Fujitsu)
2026-02-10  9:41             ` Alexander Kanavin
2026-02-11  2:35               ` 回复: " Yiding Liu (Fujitsu)
2026-02-11 11:47                 ` Alexander Kanavin
2026-02-12  2:16                   ` 回复: " Yiding Liu (Fujitsu)
2026-02-12 11:42                     ` Alexander Kanavin
2026-02-05 14:06   ` Ross Burton

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox