Change 12823
Add a new 'htmlhelp' doc build target that
generates the HTML, index, TOC files that
can be compiled into a CHM file on a Windows
machine using HTML Help Workshop.
The build target can be used wherever the
doc infrastructure runs, but the final CHM
compilation currently needs to be performed
on a Windows box. This means full CHM
production automation is currently unavailable.
Further investigation into non-Microsoft CHM
compilers will be required for full automation.
Note that any guide that requires CHM production
will need to add its own 'htmlhelp' asset tree.
The P4VS guide will (shortly) become a decent
reference, if required.
For any XSLT tinkerers, note that only a few of
the 'htmlhelp' DocBook parameters are currently
passed through to the transformation phase.
If you need to pass any additional parameters
through, add them to build.xml as appropriate.
generates the HTML, index, TOC files that
can be compiled into a CHM file on a Windows
machine using HTML Help Workshop.
The build target can be used wherever the
doc infrastructure runs, but the final CHM
compilation currently needs to be performed
on a Windows box. This means full CHM
production automation is currently unavailable.
Further investigation into non-Microsoft CHM
compilers will be required for full automation.
Note that any guide that requires CHM production
will need to add its own 'htmlhelp' asset tree.
The P4VS guide will (shortly) become a decent
reference, if required.
For any XSLT tinkerers, note that only a few of
the 'htmlhelp' DocBook parameters are currently
passed through to the transformation phase.
If you need to pass any additional parameters
through, add them to build.xml as appropriate.