I'd like to request that future reviews and package updates include "SUMMARY"
information in the recipe files.

For people who are not aware of the issue, a policy was created in Yocto 0.9
that we want each package to contain both a summary and description.  The
summary should be short and fewer then 80 characters if possible.  While the
description may be arbitrarily long and should explain the functionality of the
package.

By default, the SUMMARY is set to equal the DESCRIPTION if it was not previously
set.

So if the DESCRIPTION is short, a SUMMARY may not be required, such as:

DESCRIPTION = "A multi-purpose linux bootloader"


However, in a package with a more complicated description, such as chrpath:

DESCRIPTION = "chrpath allows you to change the rpath (where the application \
looks for libraries) in an application. It does not (yet) allow you to add an \
rpath if there isn't one already."

A short summary should be added to the recipe:

SUMMARY = "Tool to edit rpath in ELF binaries"

---

I'm currently going through Poky updating many of the recipes by updating
descriptions as necessary and adding SUMMARY fields.  In the future, or as
packages are updated, we should ensure that both the SUMMARY and DESCRIPTION are
present and up-to-date.

--Mark
_______________________________________________
yocto mailing list
yocto@yoctoproject.org
https://lists.yoctoproject.org/listinfo/yocto

Reply via email to