Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page has been replaced with References and will be archived shortly.

Cross references can be created via the Structure View in Lawmaker or using the Tag x-refs feature.  In both cases, Lawmaker will create a reference to the target provision so that if it changes, e.g. through renumbering, promotion, demotion or deletion, the system can detect the change and either update the reference to show the change or flag that the reference has become invalid.

...

Info

Tag x-ref relies on sophisticated pattern recognition but there may be some references that it doesn’t recognise. It may also tag something as a reference when it isn’t.  We’re constantly refining this feature so please provide feedback to Lawmaker Support if you come across any issues.

External cross-references (i.e. references to other enactments) are ignored by Tag x-refs when recognised as such.

Tag-x-ref will skip over quoted structures because there is not enough context in a quoted structure to reliably identify the target of any cross-references within it. It also skips the introducing text before the quoted structure on the assumption that any references there will be external references.

How to create a cross-reference using the Structure

...

View

The other way to create cross-references is to use the Structure View. (This is the only way to create cross-references within a quoted structure.)

To create a cross-reference using the Structure View:

  1. Right-click on the provision in the Structure view you want to refer to (you may want to turn on full-depth mode to see all provisions - see Using the structure view).

  2. From the context menu that appears, select the reference you want to copy from the Select x-ref to copy sub-menu. The menu will show all the different options for referring to the provision so you can select whether or not you want the provision name (e.g. “section”) to be included and whether any ancestor provisions should be included in the reference.

  3. This will place the selected cross-reference in the clipboard.

  4. To insert the reference, place your cursor in the Editor where you would like the cross reference to be inserted and press Ctrl+v to paste in the reference.

Info

In SI/SSIs, Lawmaker will determine whether a provision should be referred to in the reference as a “sub-paragraph” or “paragraph” depending on the provision’s context.

...

If nothing has been selected before you trigger the update then you’ll be given the option of updating references in the current provision (i.e. the current section, article, regulation etc.) or the whole document. Otherwise, Lawmaker will update all references in your selection.

...

.

Both valid and invalid references will be updated. If Lawmaker can no longer find the target of valid reference in the current document then it will change the reference’s status to invalid. Equally, if Lawmaker finds the target of an invalid reference then it will change the reference’s status to valid.

Tagging and updating cross-references when editing a portion of the document

If you have a portion of a document open in the Editor (see Opening and editing a portion of document) and you use the Tag x-ref or Update x-refs feature, Lawmaker will detect when references in the portion do not point to other provisions within the portion and give you option to search the whole document rather than just the portion.

This will take longer than just searching the portion but will mean that references to other parts of the document are tagged and updated correctly instead of being marked as invalid references.

Showing j-refs as part of cross-references

You can make the Editor and any PDF generated show the j-ref of target provisions within cross-references. See Managing J-refs for more about this.

Inserting and updating cross-references between documents within Lawmaker

...

The reference will show up as valid when you first paste it in. However, when you update the cross-references in text, any reference to another document will show up as Invalid (grey highlighted text) and the reference won’t be updated. If at a future point the target provision is copied into the same document (or, in the case of an amendment, it is applied to the Bill), then the reference should return to being valid when you update the cross-references again.

Cross-reference statuses and how they are displayed

A cross-reference can have one of four statuses. The styling of the reference in the Editor changes to indicate its status. Invalid references are also highlighted in the Document Checks panel.

Status

Styling

Notes

Valid

Orange text

The target provision has been identified and the citation should update correctly when you update x-refs.

Invalid

Grey highlighted text

The target provision cannot be found in the document. (It may, however, exist in another document.)

Can’t resolve

Black text with orange highlight

Lawmaker can find the target provision but is unable to update the reference text automatically. This is usually because the target provision has changed in some way, e.g. it has be promoted or demoted.

To fix this, it is generally best to remove the existing reference and either re-tag the reference if it remains correct or insert a new reference using the Structure View.

Ignore

Purple text with dotted grey underline

The reference text of this cross-reference will not be updated as part of an Update x-refs operation.