Hypertext is the linking of online information so the user can navigate from selectable text to related information. A hypertext link is the association between two topics. The origin of the link is the source topic; the destination is the target topic.

In the following example, the DIR command is the source topic; it describes the directory command. Within the DIR topic is a reference to the MKDIR command - the target topic.

       Source Topic                      Target Topic
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿      ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³DIR - Display files in ... ³ ÚÄÄ ³ MKDIR - Make a new ... ³
³                           ³ ³    ³                        ³
³                           ³ ³    ³                        ³
³                           ³ ³    ³                        ³
³ Related command: MKDIR ÄÄÄÅÄÙ    ³  Related command: DIR  ³
³                           ³      ³                        ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ      ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

You use :link. to establish a hypertext link between a topic in the source-topic window and a topic in the target-topic window. :link. enables you to create selectable, highlighted text in the source-topic window. When users select this text, they are linked to the window containing the target topic, and the linked window appears.

Consider the following example:

:link reftype=hd res=123.MKDIR:elink.

• reftype=hd indicates the hypertext phrase MKDIR is being linked to a heading in the target-topic window.

  Notice MKDIR is delimited by the period of the :link. tag and the colon of the :elink. tag.

• res=123 is the identifier of the target-topic window.

  The heading tag of the target-topic window must contain this identifier. The following is an example:

      :h2 res=123.MKDIR
  

For more information about hypertext links, see Display Another Window of the Same Library.