Cross Reference Window

Cross Reference Window

Overview

The Cross-Reference Window displays an index of all the graphics that link to and from the graphic as well as symbols included in the graphic. This tool also shows symbols individually and any graphics that include the symbol. The Cross-Reference Window for a particular graphic provides information similar to the Audit Window except across the whole DBDOC system.

To display the Cross Reference Window while on a graphic:

  • Click the Display Cross References button Tool cross reference.jpg
  • Under the Go menu select Display Cross References
  • Type X on your keyboard

You can also display the same cross-reference information in the index pane by clicking on any XREF.IDX link in the Table of Contents, in the index pane. This display of the cross-references is less convenient than the separate window, because the cross-reference index is only visible so long as you don't show anything else in the index pane.

Building symbol cross-references into your project

When building your project, in the BuildPlus Project Options, choose the Advanced Options on the Processing Options page and make sure the Exclude Symbols and Submodels chapters from build is unchecked to get full symbol cross-references built into your project.

Using the Cross-Reference Window

The Cross Reference information can be displayed both as a separate window, and as an index in the main browser, in both cases showing the different Graphics Cross References categories. The position and size of the cross-reference window will be retained between runs. The window will remain open while you navigate to different documents until you choose to close it or if you open a different project file.

You can always return to the original graphic referenced in the cross-reference window if you have moved onto different documents by clicking on the “(click here to return)” link at the top of the tree.


Tool cross reference window.png

The Cross-Reference Window makes it easy to accomplish a number of useful tasks.

Basic Use of the Cross-Reference Feature

If you click on the Tool cross reference.jpg button while viewing a graphic, you will see a display something like this:


Tool cross reference page.png


This graphic includes a number of symbols, which can be scrolled through using L and SHIFT+L. Index entry 7 refers to BW_DY_BFP_1.M1, which you might recognize as being present in the graphic a couple of times. If you click on the link to this symbol, you would see something like this:


Tool cross reference page 2.png


Here you see the symbol just by itself. If you want to know if other graphics use this symbol, or if this symbol calls other symbols, just push the Tool cross reference.jpg button.


Tool cross reference page 3.png


Here we see that only the original graphic we were looking at calls for this symbol. But this symbol also includes another symbol: BW_DY_ROLLER_1.M1. To find out whether this is the green circle, or the more complicated rotor, just click on the link.


Tool cross reference page 4.png


The rotor symbol is in fact used five times in the more complicated symbol, scaled appropriately.

Locating graphics not being built but still being linked to

  • Step through your graphics chapters
  • Bring up the cross-references for each graphic
  • Black entries (no hotspot) in the cross-reference index indicate that DBDOC was unable to build the graphics called for; either the build was incomplete or some of the graphics are trying to link to graphics that no longer exist

Information-noshadow.png Note: You can also locate these graphics and symbols by looking at the Index of Undefined Tags, and Index of Unconfigured Graphics lists located in the Miscellaneous Indices chapter in the Table of Contents.

See Also