<feed xmlns='http://www.w3.org/2005/Atom'>
<title>linux/poky.git/documentation/template/qa-code-permalinks.xsl, branch uninative-2.1</title>
<subtitle>Mirror of git.yoctoproject.org/poky</subtitle>
<id>https://git.enea.com/cgit/linux/poky.git/atom?h=uninative-2.1</id>
<link rel='self' href='https://git.enea.com/cgit/linux/poky.git/atom?h=uninative-2.1'/>
<link rel='alternate' type='text/html' href='https://git.enea.com/cgit/linux/poky.git/'/>
<updated>2014-10-10T15:44:34+00:00</updated>
<entry>
<title>ref-manual, template: Permalinks for QA errors and warnings</title>
<updated>2014-10-10T15:44:34+00:00</updated>
<author>
<name>Scott Rifenbark</name>
<email>scott.m.rifenbark@intel.com</email>
</author>
<published>2014-10-06T19:46:00+00:00</published>
<link rel='alternate' type='text/html' href='https://git.enea.com/cgit/linux/poky.git/commit/?id=3e991ee6851d9396e99aab37b8706426ff5185f1'/>
<id>urn:sha1:3e991ee6851d9396e99aab37b8706426ff5185f1</id>
<content type='text'>
Updated the ref-qa-checks.xml chapter so that each QA warning
or error message would generate a permalink that is suitable
for searching from the poky codebase.  To implement this, I
had to embed an id marker in the &lt;para&gt; tag that precedes each
&lt;code&gt;&lt;/code&gt; tag pair.  The 'xxx' string of the id is the leaf
portion of the permalink.

This creates the following tag construct:

    &lt;para id='xxx'&gt;
        &lt;code&gt;
            some-warning-or-error-message
        &lt;/code&gt;
    &lt;/para&gt;

The permalink is generated with the help of the new
qa-code-permalinks.xsl file, which triggers on the
&lt;para&gt;&lt;code&gt;&lt;/code&gt;&lt;/para&gt; construct.  This new file resides
in documentation/template.

Right now, this construct
is unique to the ref-manual's chapter on the QA error and warnings
chapter only.  However, if for some reason that construct is
used in any other part of the ref-manual, a generically numbered
permalink would also be generated.

The ref-manual-customization.xsl file was also altered to include
the new documentation/template/qa-code-permalinks.xsl file.

Reported-by: Paul Eggleton &lt;paul.eggleton@linux.intel.com&gt;
(From yocto-docs rev: aec27a9f8337575d31bfe0066563da99259046e0)

Signed-off-by: Scott Rifenbark &lt;scott.m.rifenbark@intel.com&gt;
Signed-off-by: Richard Purdie &lt;richard.purdie@linuxfoundation.org&gt;
</content>
</entry>
</feed>
