Shaun McCance
shaunm@gnome.org 2008-2009
Mark up text the user should input into a computer program.

# User Input

    mal_inline_input = element input {
      mal_attr_link ?,
      attribute style { xsd:NMTOKENS } ?,
      attribute * - (mal:* | local:*) { text } *,

      mal_inline
    }

Use the `input` element to mark up text that is input by the user. This may be text entered into a command-line environment or into a text field in a graphical application.

# Notas

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

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

The `input` element can link to other pages or documents. See for more information.

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 `input` element can have attributes from external namespaces. See for more information on external-namespace attributes.

The `input` element, together with the `output` element, may be used to mark up the contents of a `screen` element, allowing processing tools to treat them differently.

# Ejemplos

Use `input` to mark up a user response to a prompt:

Type <input>Y</input> at the prompt to proceed.

Type Y at the prompt to proceed.

Use `input` and `output` inside a `screen` element:

<screen> <output style="prompt">$ </output><input>ls mal_inline_output.xml</input> <output>mal_inline_output.xml</output> </screen>

    $ls mal_inline_output.xml
    mal_inline_output.xml

# Processing Expectations

User input is displayed in a fixed-width or wide font. Fixed-width fonts tend to have more distinction between visually similar characters. A border or background color may be used to make the beginning and end of the intput clear.

# Comparison to Other Formats

The `input` element is similar to the `userinput` element in DocBook.