[0/3] Add HOMEPAGE variable to several recipes.

Weisser, Pascal (3):
  ssh-pregen-hostkeys: Add HOMEPAGE variable
  weston-init: Add HOMEPAGE variable
  keymaps: Add HOMEPAGE variable

 meta/recipes-bsp/keymaps/keymaps_1.0.bb                          | 1 +
 .../ssh-pregen-hostkeys/ssh-pregen-hostkeys_1.0.bb               | 1 +
 meta/recipes-graphics/wayland/weston-init.bb                     | 1 +
 3 files changed, 3 insertions(+)

Hi Pascal,

On 12/9/25 2:22 PM, Weisser, Pascal.ext via lists.openembedded.org wrote:
> 

You have not explained what this helps with? The URL that would be 
specified after this is applied isn't that useful, so what does it do 
for you that this needs to be applied? Essentially shortened to: "why?"

Cheers,
Quentin

On 11 Dec 2025, at 10:29, Quentin Schulz via lists.openembedded.org <quentin.schulz=cherry.de@lists.openembedded.org> wrote:
> 
> Hi Pascal,
> 
> On 12/9/25 2:22 PM, Weisser, Pascal.ext via lists.openembedded.org wrote:
> 
> You have not explained what this helps with? The URL that would be specified after this is applied isn't that useful, so what does it do for you that this needs to be applied? Essentially shortened to: "why?”

Agreed. The homepage link is for further information about what the recipe provides, such as documentation. Pointing to the yoctoproject top-level page doesn’t give any more information  (and arguably, it should be openembedded.org).

Ross

There are several reasons for this change:

First, according to the recipe style guide, HOMEPAGE is a required variable and should be contained in all recipes:

https://docs.yoctoproject.org/dev/contributor-guide/recipe-style-guide.html#required-variables

Second, the recipe linter oelint-adv also wants HOMEPAGE to be set.

Third, the HOMEPAGE is included in the SBOM if it is set. It would be great, if every component would contain the HOMEPAGE to be consistent.

I checked what other recipes are doing when they just provide local files. The recipes mini-x-session or python3-dtschema-wrapper also set HOMEPAGE to "https://yoctoproject.org", so I thought that would be the accepted way to have a HOMEPAGE for recipes that only provide local files.

Best regards
Pascal

On Thu, 11 Dec 2025 at 15:29, Weisser, Pascal.ext via
lists.openembedded.org
<Pascal.Weisser.ext=karlstorz.com@lists.openembedded.org> wrote:
>
> There are several reasons for this change:
>
> First, according to the recipe style guide, HOMEPAGE is a required variable and should be contained in all recipes:
>
> https://docs.yoctoproject.org/dev/contributor-guide/recipe-style-guide.html#required-variables
>
> Second, the recipe linter oelint-adv also wants HOMEPAGE to be set.

Sadly the docs are somewhat inconsistent there. The section says
'required', but on the other hand 'should' is usually interpreted as a
recommendation, but not a strict requirement.

The actual enforced requirements are in the recipe_qa task, and from
what I just checked, only SUMMARY must be always present, while
HOMEPAGE is required only when SRC_URI is fetching from external
sources on the network.

oelint-adv is a 3rd party linter, and things it suggests when using
its default configuration should not be taken as guidelines for
oe-core contributions.

> Third, the HOMEPAGE is included in the SBOM if it is set. It would be great, if every component would contain the HOMEPAGE to be consistent.

The issue is that following this principle mechanically clutters
recipes, packages, and various other derived items (such as sboms)
with entries that aren't actually useful or helpful to humans. So I'd
rather not do it.

> I checked what other recipes are doing when they just provide local files. The recipes mini-x-session or python3-dtschema-wrapper also set HOMEPAGE to "https://yoctoproject.org", so I thought that would be the accepted way to have a HOMEPAGE for recipes that only provide local files.
>

This patchset has now merged (no one made objections in the patch
review, and RP took it), so if any interested parties feel strongly
about further tweaks, they should make them on top of master.

Alex

> -----Original Message-----
> From: openembedded-core@lists.openembedded.org <openembedded-core@lists.openembedded.org> On Behalf Of Alexander Kanavin via lists.openembedded.org
> Sent: den 11 december 2025 16:20
> To: Pascal.Weisser.ext@karlstorz.com; Quentin Schulz <quentin.schulz@cherry.de>; Ross Burton <ross.burton@arm.com>
> Cc: openembedded-core@lists.openembedded.org
> Subject: Re: [OE-core] [PATCH 0/3] Add HOMEPAGE variable to several recipes.
> 
> On Thu, 11 Dec 2025 at 15:29, Weisser, Pascal.ext via lists.openembedded.org
> <Pascal.Weisser.ext=karlstorz.com@lists.openembedded.org> wrote:
> >
> > There are several reasons for this change:
> >
> > First, according to the recipe style guide, HOMEPAGE is a required
> > variable and should be contained in all recipes:
> >
> > https://docs.yoctoproject.org/dev/contributor-guide/recipe-style-guide.html#required-variables
> >
> > Second, the recipe linter oelint-adv also wants HOMEPAGE to be set.
> 
> Sadly the docs are somewhat inconsistent there. The section says
> 'required', but on the other hand 'should' is usually interpreted as a
> recommendation, but not a strict requirement.
> 
> The actual enforced requirements are in the recipe_qa task, and from
> what I just checked, only SUMMARY must be always present, while
> HOMEPAGE is required only when SRC_URI is fetching from external
> sources on the network.
> 
> oelint-adv is a 3rd party linter, and things it suggests when using
> its default configuration should not be taken as guidelines for
> oe-core contributions.
> 
> > Third, the HOMEPAGE is included in the SBOM if it is set. It would be
> > great, if every component would contain the HOMEPAGE to be consistent.
> 
> The issue is that following this principle mechanically clutters
> recipes, packages, and various other derived items (such as sboms)
> with entries that aren't actually useful or helpful to humans. So I'd
> rather not do it.

Given that it seems like everyone and their mother are trying to 
come up with new fields of information and making them mandatory 
in the SBOMs (try country of origin for each component, which I 
have no idea how they expect anyone to be able to comply with), 
I have a feeling that we will have to get used to this and a lot 
more clutter to be able to comply with all whims of different 
legislatures. :(

> 
> > I checked what other recipes are doing when they just provide local
> > files. The recipes mini-x-session or python3-dtschema-wrapper also set
> > HOMEPAGE to "https://yoctoproject.org", so I thought that would be the
> > accepted way to have a HOMEPAGE for recipes that only provide local files.
> >
> 
> This patchset has now merged (no one made objections in the patch
> review, and RP took it), so if any interested parties feel strongly
> about further tweaks, they should make them on top of master.
> 
> Alex

//Peter