Alcatel-Lucent nmake Product Builder

Structured Build Logs

Alcatel-Lucent nmake release 11 and above can output build logs in an XML structured format. This facilitates automated build log processing and analysis. Applications include build log visualization and build performance analysis. The standard XML format allows use of widely available tools and libraries to speed implementation of such applications. This page collects all the documentation and references for using the structured build log features.

Documentation

• buildlog2html Command - A quick start guide to generating a visual html build log.
• nmake Structured Build Logs (PDF) - An overview description of the feature including a description of the format and examples of processing scripts.

Requirements

The buildlog2html command requires Java runtime 1.5 or above. It will also use Graphviz dot and neato commands, if available, to generate diagrams showing build log structure. Graphviz versions 2.16 or above are known to work.

Manual Pages

• nmake 14 buildlog2html
• nmake 14 xmakelog
• nmake 13 buildlog2html
• nmake 13 xmakelog
• nmake 12 buildlog2html
• nmake 12 xmakelog
• nmake 11 buildlog2html
• nmake 11 xmakelog

References

• Tool Repository - includes scripts for processing structured build logs.
• Capture of Triggered Target Explain Data from nmake 12 release notes.
• Refined structured build logs from nmake 11 release notes.
• Experimental structured build logs from nmake 10 release notes.

Newsletter Articles

• Build Log Transformations (Issue 31 - March 2009)
• Structured Build Logs (Issue 30 - November 2008)
• Structured Build Logs (Issue 29 - August 2008)

Examples

• Project XYZ example html logs generated by the nmake 12 buildlog2html command. The link points to a summary table of several builds. Select a link in the build outcome column to browse the log for that build. The failures are intentionally shown to illustrate color highlighting of build failures.