[LUDOC-104] version specific features should be identified programmatically.

• Status: Closed
• Project: Lustre Documentation
• Type: Improvement
• Priority: Minor
• Reporter: Richard Henwood (Inactive)
• Assignee: Richard Henwood (Inactive)
• Resolution: Fixed

Description

The Lustre Manual is currently rendered through the vanilla style transforms for Docbook 5. This produces documents that are generic in design.

More powerful document design tools are only available using custom styling.

The current tool chain should be modified to include custom transforms and style sheets that enable access to advanced design features.

Comments

[Richard Henwood (Inactive)]

Draft for review.

http://review.whamcloud.com/4611

[Richard Henwood (Inactive)]

Not anything to see yet, I haven't hooked the custom transform into the make file.

You need to checkout the change and run the command shown locally. Provided you're on a fedora 17 machine, it should work.

[Richard Henwood (Inactive)]

Since patch set 13 on:
http://review.whamcloud.com/#change,4611

You can see the lustre version specific conditional annotations in the html, xhtml, pdf and epub builds.

[Richard Henwood (Inactive)]

landed.

[Richard Henwood (Inactive)]

Only l23 (lustre 2.3 and beyond) and l24 (lustre 2.4 an beyond) are currently configured. l21, l22, l25 should also be added.

[Richard Henwood (Inactive)]

another patch closes up this issue for at least another release:

http://review.whamcloud.com/#change,5753

[Richard Henwood (Inactive)]

The revision section of the manual needs updating to reflect on the continuous release and explain the use of version specific style elements.

http://review.whamcloud.com/#/c/6947