[yocto] i still think FILESEXTRAPATHS needs to be explained more completely

[Robert P. J. Day]

  i've whined about this before, but i think the proper use of
FILESEXTRAPATHS needs to be explained more completely than what's
currently in the variable glossary here:

http://www.yoctoproject.org/docs/1.4/ref-manual/ref-manual.html#var-FILESEXTRAPATHS

  i mentioned that, when i first figured out how it worked, i wrote it
up here (needs a bit of updating, yes, i know):

http://www.crashcourse.ca/wiki/index.php/FILESEXTRAPATHS_and_bbappend_files

but the important point is, of course, that FILESEXTRAPATHS extends
FILESPATH with a *number* of search dirs. unless that's made really
clear, new developers are going to get confused if they look at
existing recipes for guidance on how to use it.

rday

p.s.  i also notice that the standard value of FILESPATH has some
redundancy. using an example related to beagleboard and psplash, you
can see that the .../psplash/" subdirectory is listed twice -- same
happens with the other subdirectories.

... snip ...
/home/rpjday/oe/dist/layers/oe-core/meta/recipes-core/psplash/psplash/arm
/home/rpjday/oe/dist/layers/oe-core/meta/recipes-core/psplash/psplash/armv7a
/home/rpjday/oe/dist/layers/oe-core/meta/recipes-core/psplash/psplash/beagleboard
/home/rpjday/oe/dist/layers/oe-core/meta/recipes-core/psplash/psplash/
/home/rpjday/oe/dist/layers/oe-core/meta/recipes-core/psplash/psplash/
... snip ...

  doesn't hurt, of course, but unnecessary.

-- 

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

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