documenatation tweaks

Signed-off-by: Andreas Müller <schnitzeltony@gmail.com>

README

@@ -57,7 +57,10 @@ appends:
   for the layer is ignored (see conf/layer.conf).
 
 classes:
-  Our classes to tailor build.
+  * instant-remote-debug.bbclass: Create a sysroot for remote debugging -
+    OE-Core's suggested workflow is cumbersome for ad-hoc remote debugging.
+  * user-with-full-skel.bbclass: Helper to populate /etc/skel in user's
+    home at image creation time.
 
 conf:
   layer.conf / and distro configurations
@@ -70,16 +73,19 @@ recipes-defaultconfig:
     /etc/skel.
 
 recipes-image:
-   All images for console / kde / lxqt / xfce ar found. allgui-images build
-   images for all graphical environments.
+  All images for console / kde / lxqt / xfce ar found. allgui-images build
+  images for all graphical environments.
 
-recipes-uitls:
-   Some tools (these are the only left from angstrom). Honestly: Have never
-   used them but kept them if users come from angstrom and might miss
-   them.
+recipes-utlis:
+  * udev-rules-udisks-hide-bootpart: Hide boot partition from udisks
+  * Some tools (these are the only left from angstrom). Honestly: Have never
+    used them but kept them if users come from angstrom and might miss
+    them.
 
 scripts:
-   A script collection to write images or kernel only to sdcards
+  A script collection
+  * to write images or kernel only to sdcards
+  * for changing recipe checksums automatically after version bump
 
 
 -------------------------------------------------------------------------------

classes/instant-remote-debug.bbclass

@@ -6,7 +6,7 @@
 # dropping helpful information. In these situations one wants to debug NOW
 # without further waiting or quirky activities.
 #
-# To achieve a debug sysroot is build with low cost:
+# To achieve, a debug sysroot is build with low cost:
 #
 # * All files are hard-linked to recipe's ${WORKDIR}/package
 # * Additional build time for task do_copysourcestosysroot for most recipes is < 1s

classes/user-with-full-skel.bbclass

@@ -1,6 +1,6 @@
-# Problem with copying /etc/skel to home forder by useradd only is that
-# user-recipe must RDEPEND on all recipes installing files to /etc/skel.
-# Otherwise content found in home folder is unpredictable.
+# Problem with copying /etc/skel to home forder by useradd at image creation
+# time is that user-recipe must RDEPEND on all recipes installing files to 
+# /etc/skel. Otherwise content found in home folder is unpredictable.
 #
 # To get around, this class was created. It is dual role and can be inherited
 # by:

recipes-utils/udev-udisks/udev-rules-udisks-hide-bootpart_1.0.bb

@@ -4,11 +4,13 @@ LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda
 
 PACKAGE_ARCH = "${MACHINE_ARCH}"
 
-# BOOTPARTSPEC is an array of comma separated entries Each entry can have
+# BOOTPARTSPEC is a space-separated array of entries. Each entry can have the
+# following comma-separated fields:
 # 1. A label e.g 'boot' or machine name
 # 2. A partition type e.g. 'vfat'
 #
 # Feel free to add more...
+
 BOOTPARTSPEC = "boot,vfat BOOT,vfat"
 BOOTPARTSPEC_rpi = "raspberrypi,vfat"
 

scripts/update-recipe-checksums.sh

@@ -4,12 +4,12 @@
 # (c) Copyright 2018 Andreas Müller <schnitzeltony@gmail.com>
 # Licensed under terms of GPLv2
 #
-# This script updates checksums in recipes after version bump. It run in same
-# environment as bitbake by:
+# This script updates checksums in recipes after version bump. It is supposed
+# to run run in same environment as bitbake:
 #
 # update-recipe-checksums.sh <recipe>
 #
-# where recipe can be a single recipe, a packagegroup an image or...
+# where <recipe> can be a single recipe, a packagegroup an image or...
 
 # Includes
 . `dirname $0`/include/common-helpers.inc