Shaun McCance
shaunm@gnome.org 2008-2009
Mark up the name of a file or directory.

# Filenames

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

      mal_inline
    }

Use the `file` element to mark up the name of a file or directory. You may also use it to mark up collections or portions of filenames, such as search paths and file extensions.

# Notas

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

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

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

# Processing Expectations

Filenames should be displayed in a fixed-width or wide font. Fixed-width fonts tend to have more distinction between visually similar characters. This is particularly important in filenames, since letters often appear without the context of a known word that helps make them discernable in normal prose.

# Comparison to Other Formats

The `file` element is similar to the `filename` element in DocBook.