Shaun McCance
shaunm@gnome.org 2008-2009
Provide a short description of a page or section.

# Page Descriptions

    mal_info_desc = element desc {
      attribute * - (mal:* | local:*) { text } *,

      mal_inline
    }

The `desc` element can be used to provide a short description for a page or section. While this description is generally not shown on the page itself, it is used in automatic links to the page or section. It may also be used for various other purposes by different tools.

# Notas

The `desc` element can contain a mixture of text and any general inline elements.

The `desc` element can occur in any `info` element.

The `desc` element can have attributes from external namespaces. See for more information on external-namespace attributes.

The `desc` element can also be used in a block context. See for more information.

# Processing Expectations

The `desc` is not necessarily displayed on the page in which it appears. It is, however, used for automatic links, which usually display a link block showing the title and description of the linked-to page or section. When it is displayed, its contents are treated as inline content.