[PATCH] meta: add missing descriptions and homepage in bsp

[PATCH] meta: add missing descriptions and homepage in bsp

[Maxime Roussin-Bélanger]

Signed-off-by: Maxime Roussin-Bélanger <maxime.roussinbelanger@gmail.com>
---
 meta/recipes-bsp/acpid/acpid.inc              | 5 +++++
 meta/recipes-bsp/formfactor/formfactor_0.0.bb | 3 +++
 meta/recipes-bsp/grub/grub-bootconf_1.00.bb   | 5 +++++
 meta/recipes-bsp/u-boot/u-boot-common.inc     | 4 ++++
 meta/recipes-bsp/usbinit/usbinit.bb           | 4 ++++
 5 files changed, 21 insertions(+)

diff --git a/meta/recipes-bsp/acpid/acpid.inc b/meta/recipes-bsp/acpid/acpid.inc
index 766ed4f89e..ee9f2c0ece 100644
--- a/meta/recipes-bsp/acpid/acpid.inc
+++ b/meta/recipes-bsp/acpid/acpid.inc
@@ -1,4 +1,9 @@
 SUMMARY = "A daemon for delivering ACPI events"
+DESCRIPTION = "In recent linux kernels, the /proc/acpi/event interface has \
+been deprecated. The same information (and more) is available via netlink \
+(a way for the kernel to communicate with userspace that is usually used \
+for networking) and the input layer (mouse, keyboard, power button, etc...). \
+This version of acpid supports netlink and the input layer."
 HOMEPAGE = "http://sourceforge.net/projects/acpid2"
 BUGTRACKER = "http://sourceforge.net/p/acpid2/tickets/?source=navbar"
 SECTION = "base"
diff --git a/meta/recipes-bsp/formfactor/formfactor_0.0.bb b/meta/recipes-bsp/formfactor/formfactor_0.0.bb
index 53cf1cf774..919fb1fbba 100644
--- a/meta/recipes-bsp/formfactor/formfactor_0.0.bb
+++ b/meta/recipes-bsp/formfactor/formfactor_0.0.bb
@@ -1,4 +1,7 @@
 SUMMARY = "Device formfactor information"
+DESCRIPTION = "A formfactor configuration file provides information about the /
+target hardware for which the image is being built and information that the /
+build system cannot obtain from other sources such as the kernel."
 SECTION = "base"
 LICENSE = "MIT"
 LIC_FILES_CHKSUM = "file://${COREBASE}/meta/COPYING.MIT;md5=3da9cfbcb788c80a0384361b4de20420"
diff --git a/meta/recipes-bsp/grub/grub-bootconf_1.00.bb b/meta/recipes-bsp/grub/grub-bootconf_1.00.bb
index 750f8c808a..57e0eddb67 100644
--- a/meta/recipes-bsp/grub/grub-bootconf_1.00.bb
+++ b/meta/recipes-bsp/grub/grub-bootconf_1.00.bb
@@ -1,6 +1,11 @@
 LICENSE = "MIT"
 LIC_FILES_CHKSUM = "file://${COREBASE}/meta/COPYING.MIT;md5=3da9cfbcb788c80a0384361b4de20420"
 SUMMARY = "Basic grub.cfg for use in EFI systems"
+DESCRIPTION = "The grub.cfg file contains Bash-like code and a list of installed \
+kernels in an array ordered by sequence of installation. For example, if you \
+have four installed kernels, the most recent kernel will be at index 0, the \
+previous kernel will be at index 1, and the oldest kernel will be index 3."
+HOMEPAGE = "https://www.gnu.org/software/grub/manual/grub/grub.html#Configuration"
 
 RPROVIDES_${PN} += "virtual/grub-bootconf"
 
diff --git a/meta/recipes-bsp/u-boot/u-boot-common.inc b/meta/recipes-bsp/u-boot/u-boot-common.inc
index ad043dbcde..a056eae8ce 100644
--- a/meta/recipes-bsp/u-boot/u-boot-common.inc
+++ b/meta/recipes-bsp/u-boot/u-boot-common.inc
@@ -1,4 +1,8 @@
 HOMEPAGE = "http://www.denx.de/wiki/U-Boot/WebHome"
+DESCRIPTION = "U-Boot, a boot loader for Embedded boards based on PowerPC, \
+ARM, MIPS and several other processors, which can be installed in a boot \
+ROM and used to initialize and test the hardware or to download and run \
+application code."
 SECTION = "bootloaders"
 DEPENDS += "flex-native bison-native"
 
diff --git a/meta/recipes-bsp/usbinit/usbinit.bb b/meta/recipes-bsp/usbinit/usbinit.bb
index aba44b4068..c93f5faee5 100644
--- a/meta/recipes-bsp/usbinit/usbinit.bb
+++ b/meta/recipes-bsp/usbinit/usbinit.bb
@@ -1,4 +1,8 @@
 SUMMARY = "Initscript for enabling USB gadget Ethernet"
+DESCRIPTION = "This module allows ethernet emulation over USB, allowing for /
+all sorts of nifty things like SSH and NFS in one go plus charging over the /
+same wire, at higher speeds than most Wifi connections."
+HOMEPAGE = "http://linux-sunxi.org/USB_Gadget/Ethernet"
 
 LICENSE = "GPLv2"
 LIC_FILES_CHKSUM = "file://${WORKDIR}/COPYING.GPL;md5=751419260aa954499f7abaabaa882bbe"
-- 
2.20.1

Re: [PATCH] meta: add missing descriptions and homepage in bsp

[Ross Burton]

On 30/08/2019 02:08, Maxime Roussin-Bélanger wrote:
> +DESCRIPTION = "In recent linux kernels, the /proc/acpi/event interface has \
> +been deprecated. The same information (and more) is available via netlink \
> +(a way for the kernel to communicate with userspace that is usually used \
> +for networking) and the input layer (mouse, keyboard, power button, etc...). \
> +This version of acpid supports netlink and the input layer."

This is not a meaningful description of acpid.

> +DESCRIPTION = "The grub.cfg file contains Bash-like code and a list of installed \
> +kernels in an array ordered by sequence of installation. For example, if you \
> +have four installed kernels, the most recent kernel will be at index 0, the \
> +previous kernel will be at index 1, and the oldest kernel will be index 3."

This reads more as documentation than description.

Ross

Re: [PATCH] meta: add missing descriptions and homepage in bsp

[Randy MacLeod]

On 9/3/19 11:00 AM, Ross Burton wrote:
> On 30/08/2019 02:08, Maxime Roussin-Bélanger wrote:
>> +DESCRIPTION = "In recent linux kernels, the /proc/acpi/event 
>> interface has \
>> +been deprecated. The same information (and more) is available via 
>> netlink \
>> +(a way for the kernel to communicate with userspace that is usually 
>> used \
>> +for networking) and the input layer (mouse, keyboard, power button, 
>> etc...). \
>> +This version of acpid supports netlink and the input layer."
>
> This is not a meaningful description of acpid.

Hi Maxime,

Thanks for staring on this work.


People often just copy info from another distro as a starting or even 
ending point.

 From my ubu-19.04 system is below (1).


You can also look the package info for several distros using:

   https://pkgs.org/download/acpid

I think the Debian-based distro and SUSE distros tend to have good short 
and long

summaries but I've only looked briefly at the acpid one.


Please take a look, let us know if you have any questions and send a v2 
if not.

Thanks,

../Randy


[1]

$ apt show acpid
Package: acpid
Version: 1:2.0.31-1ubuntu2
Priority: optional
Section: admin
Origin: Ubuntu
Maintainer: Ubuntu Developers <ubuntu-devel-discuss@lists.ubuntu.com>
Original-Maintainer: Debian Acpi Team 
<pkg-acpi-devel@lists.alioth.debian.org>
Bugs: https://bugs.launchpad.net/ubuntu/+filebug
Installed-Size: 145 kB
Depends: libc6 (>= 2.27), lsb-base (>= 3.2-14), kmod
Homepage: http://sourceforge.net/projects/acpid2/
Task: ubuntu-desktop-minimal, ubuntu-desktop, kubuntu-desktop, 
xubuntu-core, xubuntu-desktop, lubuntu-desktop, 
ubuntustudio-desktop-core, ubuntustudio-desktop, ubuntukylin-desktop, 
ubuntu-mate-core, ubuntu-mate-desktop, ubuntu-budgie-desktop
Supported: 9m
Download-Size: 37.3 kB
APT-Manual-Installed: no
APT-Sources: http://ca.archive.ubuntu.com/ubuntu disco/main amd64 Packages
Description: Advanced Configuration and Power Interface event daemon
  Modern computers support the Advanced Configuration and Power 
Interface (ACPI)
  to allow intelligent power management on your system and to query 
battery and
  configuration status.
  .
  ACPID is a completely flexible, totally extensible daemon for delivering
  ACPI events. It listens on netlink interface (or on the deprecated file
  /proc/acpi/event), and when an event occurs, executes programs to 
handle the
  event. The programs it executes are configured through a set of 
configuration
  files, which can be dropped into place by packages or by the admin.


>
>> +DESCRIPTION = "The grub.cfg file contains Bash-like code and a list 
>> of installed \
>> +kernels in an array ordered by sequence of installation. For 
>> example, if you \
>> +have four installed kernels, the most recent kernel will be at index 
>> 0, the \
>> +previous kernel will be at index 1, and the oldest kernel will be 
>> index 3."
>
> This reads more as documentation than description.
>
> Ross


-- 
# Randy MacLeod
# Wind River Linux