D.1.57 Element ref

D.1.57.1 Description

Allows you to link to another routine in the same programcode document.

This is possibly slightly confusing, since in the Starlink General DTD (for SUNs, SSN, and the like), you cannot use the ref element to do this, but must use the coderef element instead. In the programcode DTD, there is no coderef element.

What you cannot do at all, at present, is refer to a routine in a different programcode document.

D.1.57.2 Parents

attribution, cite, code, dt, em, entry, foreign, kbd, line, p, purpose, px, quote, span, strong, verbatim

D.1.57.3 Content

( #pcdata | em | strong | quote | code | kbd | cite | m | angle | foreign | funcname) *

ref
 |_(#PCDATA |
 |__em |
 |__strong |
 |__quote |
 |__code |
 |__kbd |
 |__cite |
 |__m |
 |__angle |
 |__foreign |
 |__funcname)*

D.1.57.4 Attribute ref/valueref

• Default: #fixed
• Type: CDATA
• Allowed values: #CONTENT ref-title

D.1.57.5 Attribute ref/rflocsrc

• Default: #fixed
• Type: CDATA
• Allowed values: ref-title id

D.1.57.6 Attribute ref/hynames

• Default: #fixed
• Type: CDATA
• Allowed values: linkend id

D.1.57.7 Attribute ref/loctype

• Default: #fixed
• Type: CDATA
• Allowed values: ref-title queryloc DSSSL

D.1.57.8 Attribute ref/text

• Default: #implied
• Type: cdata

D.1.57.9 Attribute ref/hytime

• Default: #fixed
• Type: CDATA
• Allowed values: clink

D.1.57.10 Attribute ref/id

• Default: #required
• Type: idref

D.1.57.11 Attribute ref/ref-title

• Default: #fixed
• Type: CDATA
• Allowed values: (case (gi) (("table" "figure") (select-elements (children (current-node)) (list "caption"))) (else (select-elements (descendants (current-node)) (list "subhead" "title"))))