Scroll to navigation

wml::std::label(3) EN Tools wml::std::label(3)

NAME

wml::std::label - Labels and References

SYNOPSIS

 #use wml::std::label auxfile=NAME
 <label name "Label Section">
 <ref name>

DESCRIPTION

This module implements a mechanism of labels and references. Labels are defined via variables, which are expanded with the "<ref>" tag. A common problem is when labels are referenced before they are defined. For this reason, labels are stored in an auxiliary file. When the module is loaded, this file is read and labels are defined. Then input is processed and at end of input, labels are compared with their previous value. If some labels changed, then all labels are written to the auxiliary file and a message is printed to warn that labels are wrong.

AUTHOR

 Denis Barbier
 barbier@engelschall.com

REQUIRES

 Internal: P2, P3, P4
 External: --
2020-11-29 EN Tools