From: "Robert P. J. Day" <rpjday@crashcourse.ca>
To: YP docs mailing list <docs@lists.yoctoproject.org>
Subject: [PATCH] ref-manual: organize all recipes-* directories under subdirectory
Date: Mon, 22 Jun 2026 16:29:02 -0400 (EDT) [thread overview]
Message-ID: <543708dc-e1aa-0798-653b-d8c073dbec50@crashcourse.ca> (raw)
It's cumbersome to list all meta/recipes-* directories under the same
level as other meta/ directories, so place them under a recipes-*
higher-level directory.
Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
---
diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst
index ff84b250b..fae0368b9 100644
--- a/documentation/ref-manual/structure.rst
+++ b/documentation/ref-manual/structure.rst
@@ -881,10 +881,17 @@ build process. It is enabled via the ``addpylib`` directive in
``meta/conf/local.conf``. For more information, see
:ref:`bitbake-user-manual/bitbake-user-manual-metadata:extending python library code`.
+.. _structure-meta-recipes:
+
+``meta/recipes-*/``
+---------------------
+
+All of the "recipes-*" subdirectories define recipes broken into related sub-categories.
+
.. _structure-meta-recipes-bsp:
``meta/recipes-bsp/``
----------------------
+~~~~~~~~~~~~~~~~~~~~~
This directory contains anything linking to specific hardware or
hardware configuration information such as "u-boot" and "grub".
@@ -892,7 +899,7 @@ hardware configuration information such as "u-boot" and "grub".
.. _structure-meta-recipes-connectivity:
``meta/recipes-connectivity/``
-------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains libraries and applications related to
communication with other devices.
@@ -900,7 +907,7 @@ communication with other devices.
.. _structure-meta-recipes-core:
``meta/recipes-core/``
-----------------------
+~~~~~~~~~~~~~~~~~~~~~~
This directory contains what is needed to build a basic working Linux
image including commonly used dependencies.
@@ -908,7 +915,7 @@ image including commonly used dependencies.
.. _structure-meta-recipes-devtools:
``meta/recipes-devtools/``
---------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains tools that are primarily used by the build
system. The tools, however, can also be used on targets.
@@ -916,7 +923,7 @@ system. The tools, however, can also be used on targets.
.. _structure-meta-recipes-extended:
``meta/recipes-extended/``
---------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains non-essential applications that add features
compared to the alternatives in core. You might need this directory for
@@ -925,7 +932,7 @@ full tool functionality.
.. _structure-meta-recipes-gnome:
``meta/recipes-gnome/``
------------------------
+~~~~~~~~~~~~~~~~~~~~~~~
This directory contains all things related to the GTK+ application
framework.
@@ -933,7 +940,7 @@ framework.
.. _structure-meta-recipes-graphics:
``meta/recipes-graphics/``
---------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains X and other graphically related system
libraries.
@@ -941,7 +948,7 @@ libraries.
.. _structure-meta-recipes-kernel:
``meta/recipes-kernel/``
-------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains the kernel and generic applications and
libraries that have strong kernel dependencies.
@@ -949,7 +956,7 @@ libraries that have strong kernel dependencies.
.. _structure-meta-recipes-multimedia:
``meta/recipes-multimedia/``
-----------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains codecs and support utilities for audio, images
and video.
@@ -957,7 +964,7 @@ and video.
.. _structure-meta-recipes-rt:
``meta/recipes-rt/``
---------------------
+~~~~~~~~~~~~~~~~~~~~
This directory contains package and image recipes for using and testing
the ``PREEMPT_RT`` kernel.
@@ -965,7 +972,7 @@ the ``PREEMPT_RT`` kernel.
.. _structure-meta-recipes-sato:
``meta/recipes-sato/``
-----------------------
+~~~~~~~~~~~~~~~~~~~~~~
This directory contains the Sato demo/reference UI/UX and its associated
applications and configuration data.
@@ -973,7 +980,7 @@ applications and configuration data.
.. _structure-meta-recipes-support:
``meta/recipes-support/``
--------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains recipes used by other recipes, but that are not
directly included in images (i.e. dependencies of other recipes).
next reply other threads:[~2026-06-22 20:29 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-06-22 20:29 Robert P. J. Day [this message]
2026-06-25 8:01 ` [docs] [PATCH] ref-manual: organize all recipes-* directories under subdirectory Antonin Godard
2026-06-25 8:02 ` Robert P. J. Day
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=543708dc-e1aa-0798-653b-d8c073dbec50@crashcourse.ca \
--to=rpjday@crashcourse.ca \
--cc=docs@lists.yoctoproject.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox