What's New in This Guide

This update of IRIS InSight Professional Publisher User's Guide documents the 4.2 tools for bookbuilding. These tools include support for the new SGIDOCBK DTD.

New Features Documented

Bookbuild tools can be installed on systems running IRIX 6.2 and IRIX 6.5.X and include updated scripts, a new Makefile template, and a new set of error messages.

The online appearance of several character tags have changed in the SGIDOCBK DTD. The SGIDOC DTD is still supported in 4.2 tools, however.


Note: The functionality of the two DTDs is essentially the same; the online appearance is different. Before converting all your bookbuilding to the new SGIDOCBK DTD, you'll want to perform a sample bookbuild and view it in IRIS InSight to ensure its online appearance matches your company's style guide. If you need to build books for the SJIS Japanese locale or any Chinese or Korean languages and locales, you must use the SGIDOCBK DTD.


Major Documentation Changes

The following changes were made to this book:

Chapter 2, “Preparing Your Workstation”, contains the following changes:

  • Updated list of software subsystems and configuration requirements

  • Installation instructions and distribution locations for software

Chapter 3, “Using the IPTemplates to Author Documents”, is new.

Chapter 4, “Using FrameMaker Files and Template Features”, (formerly Chapter 5) contains expanded instructions on how to create:

  • Links within a book

  • Index entries

and new instructions on how to create:

  • Reference (man) page links

  • Inline media links

  • Links to URLs and applications

Chapter 5, “Working With Figures”, (formerly Chapter 6 and Appendix B), contains the following updated lists:

  • Supported figure formats

  • Screen capture tools and their software subsystems

Chapter 6, “Building Online Books”, (formerly Chapter 3), contains updated information about the Makefile and make commands for the new 4.2 build tools.

Chapter 7, “Finding and Fixing Online Build Errors”, (formerly Chapter 4), contains an updated list of errors and their meanings.

Chapter 8, “ Creating Online Help”, (formerly Chapter 7), contains instructions on viewing and testing help using the updated SGIHelp graphical user interlace.

Appendix A, “IRIS Insight Bookbuilding Architecture”, (formerly Appendix C) is an updated overview of the bookbuilding process.