Shaun McCance
shaunm@gnome.org 2008-2009
Mark up a sequence of interface controls to navigate.

# GUI Sequences

    mal_inline_guiseq = element guiseq {
      attribute style { xsd:NMTOKENS } ?,
      attribute * - (mal:* | local:*) { text } *,

      mixed { mal_inline_gui + }
    }

Use the `guiseq` element to mark up a sequence of graphical interface elements. This is typically used to present a sequence of menu items.

# Notas

The `guiseq` element can contain a mixture of text and `gui` elements.

The `guiseq` element can occur in any general inline context, including inside most inline elements, some basic block elements, and certain informational elements.

The `style` attribute takes a space-separated list of style hints. Processing tools should adjust their behavior according to those style hints they understand.

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

# Ejemplos

Use `guiseq` to mark up a sequence of menu items:

Select <guiseq><gui>File</gui><gui>New</gui></guiseq> to open a new document.

Select File New to open a new document.

# Processing Expectations

Each of the child `key` elements and text nodes, except whitespace-only text nodes, is displayed as described below, adding a separator between them. The exact separator may vary according to the language and style preferences, but it will typically be some sort of right-pointing arrow or triangle, or left-pointing for right-to-left languages.

Child `gui` elements are shown as normal. Text nodes have their whitespace normalized to strip leading and trailing spaces. Text nodes may be rendered using a font variation.

# Comparison to Other Formats

The `guiseq` element is similar to the `menuchoice` element in DocBook. Since Mallard does not provide different elements for different types of interface elements, the contents of `guiseq` are all `gui` elements or text. Currently, Mallard does not provide a way to encode shortcut keys like the `shortcut` element in DocBook. It is recommended that shortcuts, when necessary, be written into prose separately.