<chapt id="listexamp">
  <heading>Listas e exemplos</heading>

  <sect id="lists">
    <heading>Listas</heading>
    
    <p>
      Há três tipos de listas:
      <list compact="compact">
	<item>
	  <p>
	    <tt>&lt;list&gt;</tt> - lista ordinária (bola)
	  </p>
	</item>
	<item>
	  <p>
	    <tt>&lt;enumlist&gt;</tt> - lista numerada
	  </p>
	</item>
	<item>
	  <p>
	    <tt>&lt;taglist&gt;</tt> - lista com tags
	  </p>
	</item>
      </list>
    </p>

    <p>
      Cada entrada em uma lista ordinária ou numerada é um item
      introduzido por <tt>&lt;item&gt;</tt>.  Cada entrada em uma
      lista é uma ou mais tags <tt>&lt;tag&gt;</tt>s seguida de um
      <tt>&lt;item&gt;</tt>.
    </p>

    <p>
      Não é necessário marcar o final de <tt>&lt;tag&gt;</tt> ou
      elementos <tt>&lt;item&gt;</tt>.
    </p>

    <p>
      Todos os três tipos de lista vem em dois tipos, dependendo se
      você especificar o atributo <tt>compact</tt> (eg,
      <tt>&lt;taglist compact&gt;</tt>) ou não (eg,
      <tt>&lt;enumlist&gt;</tt>).  A <tt>&lt;tag&gt;</tt> pode conter
      apenas texto marcado inline.
    </p>

    <p>
      As versões compactas são usadas dentro de parágrafos.  O
      formatador não colocará "buracos" em torno da lista ou entre os
      itens.<footnote><p>Existe um problema com isto em HTML.  O
      formatador HTML não tenta, usando listas HTML com atributo
      <tt>compact</tt> que gerou, mas nem todos os navegadores o
      entendem corretamente.</p></footnote>  As entradas em cada lista
      compacta devem ser um parágrafo simples (não é necessário para
      marcar o início de um parágrafo).  Quaisquer listas dentro de
      uma lista compacta devem ser marcadas como compactas (embora os
      formatadores de fato deduzem que elas devem ser compactas).
    </p>

    <p>
      As versões não compactas são entendidas como parágrafos.  Cada
      entrada em tal lista pode conter mais que um parágrafo (denovo,
      o início do primeiro parágrafo não precisa ser marcado).  A lista
      é separada do texto ao redor, e as entradas umas das outras por
      linhas em branco como é esperado que ocorra em quebra de
      parágrafo.
    </p>

  </sect>


  <sect id="examples">
    <heading>Exemplos</heading>

    <p>
      Exemplos - fragmentos de código multi linhas, scripts, e fragmentos 
      similares de texto de computador são incluídos com
      <tt>&lt;example&gt;</tt> e finalizados com
      <tt>&lt;/example&gt;</tt>.
    </p>

    <p>
      O exemplo será formatado exatamente como ele é digitado, com
      espaços e novas linhas reproduzidas.  Ele será mostrado em uma
      fonte fixa, normalmente a usada pelo estilo de caracteres
      <tt>&lt;tt&gt;</tt>, até mesmo se o formatador usa uma fonte
      proporcional.  Qualquer identação necessária será incluída
      pelo formatador; o exemplo deve ser incluído
      iniciando na coluna da esquerda.
    </p>

    <p>
      Exemplos podem conter texto com caracteres marcados mas não referências cruzadas ou elementos de estilo de caracteres
      <tt>&lt;em&gt;</tt>, <tt>&lt;strong&gt;</tt>,
      <tt>&lt;package&gt;</tt>, <tt>&lt;prgn&gt;</tt>,
      <tt>&lt;file&gt;</tt>, and <tt>&lt;tt&gt;</tt>. Veja <ref
      id="inline">.
    </p>

    <p>
      Um exemplo não produz uma quebra de parágrafo; exemplos são
      considerados partes do parágrafo. Se um exemplo será um parágrafo
      então seu próprio parágrafo inicia tags que devem ser
      adicionadas como apropriadas.
    </p>

    <p>
      Qualquer caracter de marcação SGML no exemplo deve ser referenciado pelo nome na forma usual de referência a entidade - veja
      <ref id="markup">.  <tt>&lt;example&gt;</tt> não funciona como o
      ambiente TeX <tt>verbatim</tt>.
    </p>

  </sect>

</chapt>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:("../debiandoc-sgml.pt_BR.sgml" "book" "chapt")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
