linux/poky.git/documentation/ref-manual/ref-manual-customization.xsl, branch yocto-2.3.1

documentation: Updated customization layers to point to XSL mirrors

2015-07-28T17:02:30+00:00

The customization layers were pointing to Sourceforge site for the XSl files needed to build the manuals. Throuhgout time, this site has failed me enough to warrent trying to get these XSL files from some other source. Rather than ship the XSL files with the YP release, we decided to create some mirrors and point the customization files there. (From yocto-docs rev: 4fd1703870694dff1f593b421f90aad0803d9e65) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

documentation: Reverted back to the 1.76.1 XSL stylesheet

2015-02-17T15:16:56+00:00

Using the 1.76.1 version in all the customization layers so the manual revision tables will build with boxes. (From yocto-docs rev: 85a31ef53a59d17bed23ebf57a14db507eb21338) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

documentation: Changed back to the "current" XSL style sheet.

2015-02-17T15:16:47+00:00

I need to get back to how it was working and then fix the table box issue from there. Using the 1.76.1 stylesheets makes the build too long for the manuals and sometimes the XSL sheets do not load. (From yocto-docs rev: 7bc502fa069fdc4aebf5705513bb82127716859f) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

documentation: Updated all XSL style sheet imports to use 1.76.1 version

2015-01-06T14:26:59+00:00

This fixes the issue where the lines for the manual revision table are not appearing. For some reason they do not appear when building the docs using Ubuntu 14.10 and the "current" XSL transformation files. So, I backed up to the 1.76.1 version, which is the nearest version where the issue does not surface. (From yocto-docs rev: 82b15986b97b9ed082b652b562eaaf843572fdff) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

ref-manual, template: Permalinks for QA errors and warnings

2014-10-10T15:44:34+00:00

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 tag that precedes each tag pair. The 'xxx' string of the id is the leaf portion of the permalink. This creates the following tag construct:


            some-warning-or-error-message

The permalink is generated with the help of the new qa-code-permalinks.xsl file, which triggers on the 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 (From yocto-docs rev: aec27a9f8337575d31bfe0066563da99259046e0) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

ref-manual: Added support for variable permalinks in the glossary.

2014-07-03T12:57:09+00:00

Fixes [YOCTO #5772] Updated the customization layer to include the file that generates permalinks for the variable definitions. (From yocto-docs rev: adfb6f06fcba2045e56353bcff0df1df9106544c) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

ref-manual-customization.xsl: Changes to custom layer to support permalinks.

2014-06-18T09:30:46+00:00

Fixes [YOCTO #5772] Added some code to suck in the XSL templates that support permalinks. (From yocto-docs rev: 713a17465df48de2ece3845bbd7a8bf972e353b0) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

ref-manual: Added new chapter on QA error and warning messages.

2014-05-30T15:32:14+00:00

This new chapter is a reference on the default configuration QA check messages you can get from errors and warnings. (From yocto-docs rev: 04d766b4e1235ae46df38c4b296cb2729b6a439f) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie

documentation: Move poky-ref-manual global parameters to customization file

2013-02-14T17:14:58+00:00

Standard stylesheet parameters were moved to the docbook customization file tying them to the docbook stylesheet used. Removing these parameters simplifies the Makefile. Signed-off-by: Richard Purdie

documentation: Rename of poky-ref-manual folder to ref-manual.

2013-01-07T14:43:25+00:00

Changing the folder that holds the YP Reference Manual to be "ref-manual". This will help with confustion over the manual's intended purpose. (From yocto-docs rev: 1106442964b5080cb0b6b3bd3af32e9407c0f7c1) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie