[yocto] brief observations on poky ref manual

[Robert P. J. Day]

  some potential fixes for poky reference manual, i'll graciously
allow scott rifenbark to do all the work.  :-)

  working in appendix F (variable glossary):

* INITSCRIPT_PACKAGES: it seems that it's not only if there are
multiple packages that you'll need to append the package names to
subsequent INITSCRIPT_* variables, it's also if there's just a single
package but it's not equal to ${PN}, as in:

meta/recipes-connectivity/openssh/openssh_6.0p1.bb:INITSCRIPT_PACKAGES = "${PN}-sshd"
meta/recipes-connectivity/openssh/openssh_6.0p1.bb:INITSCRIPT_NAME_${PN}-sshd = "sshd"
meta/recipes-connectivity/openssh/openssh_6.0p1.bb:INITSCRIPT_PARAMS_${PN}-sshd = "defaults 9"

  in the above, there's only one initscript package related to
openssh, but since its name differs from ${PN}, you need to be
explicit, yes?  the current glossary entry doesn't make that clear.


* just below that, INITSCRIPT_PARAMS is listed as "mandatory".  not
really -- its assigned a default value of "defaults" in
meta/classes/update-rc.d.bbclass, so if that's fine for your recipe,
there's no need to assign anything.  (in fact, there's a small number
of recipes that unnecessarily set that value.)

  and in appendix G.2.1, AUTHOR is listed as a required variable --
i'm pretty sure that's not true as numerous recipes have no listed
author.  on the other hand, there's no mention of other recipe-level
variables, such as SUMMARY.

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================