7  Inline Tags

7 Inline Tags

Inline tags are typically used within block tags, for example to highlight a word within a paragraph.

Forces a newline. The <br> tag is both a block- and an inline tag and is described in the Block Tags section.

Highlights things like variables and file names in a text flow. Can contain plain text only. Newlines and tabs are ignored as opposed to the code tag. All character entities are expanded. Example:

<p>Returns <c>true</c> if <c>Term</c> is an integer.</p>

results in:

Returns true if Term is an integer.

Highlights words which are important within a text flow. Example:

<p>The application <em>must</em> be up and running.</p>

results in:

The application must be up and running.

Contains plain text or a <c> tag.

Used as an anchor for hypertext references. The id attribute defines the name of the marker. Example:

<marker id="marker_example"/>

The <see*> tags are used to refer to the marker.

The <marker> tag is both a block- and an inline tag.

A cross reference (hypertext link) to a marker in the same file, a marker in another file, or (the top of) another file, given by the marker attribute. The syntax used within the marker attribute is application:file#anchor for the general case. application and file can be omitted if the link target is the current application or file.

There are several different see tags that are to be used depending on what it is that they point to.


Points to an MFA using the syntax application:module#function/arity. These links must point to functions documented in a <funcs> section. Examples:

<seemfa marker="stdlib:string#length/1">string:length/1</seemfa>
<seemfa marker="string#length/1">string:length/1</seemfa>
<seemfa marker="#length/1">string:length/1</seemfa>
results in: string:length/1.

Points to an Erlang module or a custom marker within a module. Example:

<seeerl marker="stdlib:string">string(3)</seeerl>,
<seeerl marker="stdlib:string#oldapi">Old API in string</seeerl>
results in: string(3),Old API in string.

Points to a type using the syntax application:module#type. These links must point to types documented in a <datatypes> section. Example:

<seetype marker="stdlib:string#grapheme_cluster">string::grapheme_cluster()</seetype>
results in: string::grapheme_cluster().

Points to the application documentation. index can be used as the target file. Example:

<seeapp marker="stdlib:STDLIB_app">STDLIB app</seeapp>,
<seeapp marker="stdlib:index">STDLIB index</seeapp>
results in: STDLIB, STDLIB.

Points to the documentation of any command line utility. Example:

<seecom marker="erts:epmd">epmd</seecom>
results in: epmd.

Points to the documentation of any C reference. Example:

<seecref marker="erts:erl_nif">erl_nif</seecref>
results in: erl_nif.

Points to the documentation of a file format. Example:

<seefile marker="kernel:config">config(3)</seefile>
results in: config(3).

Points to the User"s Guide of any application. index can be used as the target file. Example:

<seeguide marker="kernel:index">Kernel User's Guide Index</seeguide>,
<seeguide marker="kernel:logger_chapter">Logging in the Kernel User's Guide</seeguide>
results in: Kernel User's Guide Index, Logging in the Kernel User's Guide.

A reference to a file outside the documentation, a web address or similar, given by the href attribute. Must contain plain text. Example:

<url href="http://www.erlang.org">erlang.org</url>

results in: erlang.org