[yocto] standard for doc URL links?

[Robert P. J. Day]

  noticed the following in kernel-dev manual, if you want to link to
the glossary entry for a variable while using it in an expression,
there's:

<ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink> := "${THISDIR}/${PN}"

  however, that really should be eventually rendered as:

FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}"

but in that case, since you're appending "_prepend" to the variable
name, do you still link? or link with just the proper variable name
part? or what?

  i don't see any example of trying to combine those two features.
would you do something like:

<ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'>FILESEXTRAPATHS</ulink>_prepend := "${THISDIR}/${PN}"

is this even used?

rday

-- 

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

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