<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<refentry id="literal.environment">
  <refmeta>
    <refentrytitle>literal.environment</refentrytitle>
  </refmeta>
  <refnamediv>
    <refname><parameter>literal.environment</parameter></refname>
    <refpurpose>Latex environment used to format verbatim blocks</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <programlisting>
      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="syn/literal.environment.xml"/></programlisting>
  </refsynopsisdiv>
  <refsection>
    <title>Description</title>
    <para>It specifies the Latex environment to use to render a verbatim
    block.</para>
    <para>Since <command>dblatex</command> uses the listings package 
    capabilities to
    handle the DocBook attributes, the specified environment must have the same
    capabilities if written from scratch, but it is recommended to just extend
    the listings environment with you own listings extension. See <xref
    linkend="sec-literal-env"/> for more details.</para>
    <para>The specified environment name must starts with
    <literal>"lst"</literal>. Otherwise <command>dblatex</command> raises an
    error and exits.</para>
  </refsection>
  <refsection>
    <title>See Also</title>
    <para><parameter>literal.extensions</parameter>.</para>
  </refsection>
</refentry>
