Uma itemizedlist é usada para enumerar items cuja ordem não é muito importante:

<itemizedlist spacing="compact">
  <listitem><para>Laranjas são suculentas</para></listitem>
  <listitem><para>Maçãs supostamente são saudáveis</para></listitem>
  <listitem><para>A maioria das pessoas acham o limão muito
    ácido</para></listitem>
</itemizedlist>

Os items na lista são geralmente marcados com um marcador nos documentos de saída:

Use uma lista ordenada (tag <orderedlist>) quando se deseja forçar a ordem entradas:

<orderedlist spacing="compact" numeration="loweralpha">
  <listitem><para>Sumérios 3300 AC - 1900 AC</para></listitem>
  <listitem><para>Império Assírio 1350 AC - 612 AC</para></listitem>
  <listitem><para>Império Pérsio 6º século AC - 330 AC</para>
  </listitem>
</orderedlist>

Por padrão, numerais arábicos (1, 2, 3, ...) serão colocados antes dos items, mas você pode mudar isso com o atributo numeration. Saída:

Um procedimento (tag <procedure>) é freqüentemente renderizado como uma lista ordenada (tag <orderedlist>), mas com uma semântica diferente: um procedimento denota uma seqüência de passos a serem executados numa dada ordem:

<procedure>
  <step><para>Arrombe a fechadura</para></step>
  <step><para>Roube a casa</para></step>
  <step><para>Seja preso</para></step>
</procedure>

Aqui está a saída:

Dentro de um passo você pode incluir um elemento subpasso (tag <substep>), o qual pode conter mais passos.

Uma lista variável (tag <variablelist>) é feita de entradas de lista variável (tag <varlistentry>), cada uma das quais possuem um termo (tag <term>) seguido de um item de lista (tag <listitem>):

<variablelist>
  <varlistentry>
    <term>Tag</term>
    <listitem>
      <para>Uma peça de texto entre um '<' e um '>'</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>Element</term>
    <listitem>
      <para>Uma tag inicial, uma tag final correspondendo e tudo
        entre elas</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>Coteúdo de um elemento</term>
    <listitem>
      <para>Tudo dentro das tags correspondentes</para>
    </listitem>
  </varlistentry>
</variablelist>

A lista que você está vendo agora, enumerando os diferentes tipos de listas, é uma lista variável com os nomes dos elementos (itemizedlist, orderedlist, etc.) como termos. A próxima seção, sobre links, também consiste de uma sentença introdutória seguida de uma lista variável.

link é o elemento genérico que aponta para qualquer local no conjunto de documentos. O atributo linkend sempre deve estar presente; seu valor deve ser o id de um alvo de link (o elemento para o qual se irá saltar).

Clique <link linkend="docwritehowto-introduction-pt_br">aqui</link>
para saltar para a introdução.

No documento renderizado, a palavra "aqui" ficará quente, o que significa um link clicável apontando para a introdução.

Use um ulink para linkar para um recurso na Internet. O atributo url é obrigatório:

Clique <ulink url="http://docbook.org/tdg/en/">neste link</ulink> para
ler o O Guia Definitivo para DocBook.

As palavras “neste link” aparecerão como um hiperlink para http://docbook.org/tdg/en/, assim:

Você pode fazer um link para email com um ulink, porém é mais fácil usando o elemento email. Este irá mostrar o endereço de email como texto clicável na saída. Esta linha de XML:

Envie mensagem para
<email>[email protected]</email> para 
assinar.

resulta na seguinte saída: "Envie mensagem para <[email protected]> para se assinar."

Se você deseja que o texto clicável seja diferente do próprio endereço de email, use um ulink com uma URL mailto:.

Um anchor (âncora) é um elemento vazio marcando um local exato dentro de um documento. Ele não é mostrado no texto que seus leitores lêem, mas podem ser usados como alvos para links. Isto é útil se você deseja linkar para um local qualquer no meio de um grande parágrafo.

<para id="lost-at-sea">
  Blah blah blah...
  e algo mais....
  e então algo...
  Agora aqui está um lugar interessante no parágrafo que eu quero ser
  capaz de linkar:
  <anchor id="captain-haddock"/>Aí está!
  Drones de parágrafo ligados...
  e ligados...
  e ligados...
</para>

Tendo colocado a âncora, você pode criar um link para ela:

<link linkend="captain-haddock">Vá para o lugar interessante</link> 
nesse longo, longo parágrafo.

Se você linkar para um elemento curto, ou para o início de um elemento, é mais fácil dar ao dito elemento uma id e usá-la como alvo do link.

Se você incluir fragmentos de código no seu documento, coloque-os num elemento programlisting (listagem de programa). Tudo que você digitar será renderizado como estiver escrto, incluindo quebras de linhas, espaços em branco, etc. E além disso, uma fonte de tamanho fixo será utilizada nos documentos renderizados. O termo "listagem de programa" pode interpretado de forma abrangente aqui: você pode usá-lo para fragmentos de SQL ou exemplos de DocBook XML. Este documento - especialmente na seção sobre elementos, a qual você está lendo agora - é cheia de programlisting's de modo que você já viu como elas se parecem:

Programlistings são renderizadas deste jeito.

Use um elemento screen (tela) para mostrar o que o usuário vê ou deverá ver numa tela de computador em modo texto, ou numa janela de terminal. Aqui também, seu layout será preservado e uma fonte de tamanho fixo será usada, mas a semântica é diferente. Ela pode ou não ter aparência diferente de uma listagem de programa na saída. Este é um exemplo curto, mostrando o que acontece se você tentar gerar um alvo não existente na árvore de manuais:

<screen>
D:\Firebird\manual_incl_howto\src\build>build ugh
java version "1.4.2_01"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_01-b06)
Java HotSpot(TM) Client VM (build 1.4.2_01-b06, mixed mode)

Buildfile: build.xml

BUILD FAILED
Target `ugh' does not exist in this project.
</screen>

E aqui como isso é renderizado:

D:\Firebird\manual_incl_howto\src\build>build ugh
java version "1.4.2_01"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_01-b06)
Java HotSpot(TM) Client VM (build 1.4.2_01-b06, mixed mode)

Buildfile: build.xml

BUILD FAILED
Target `ugh' does not exist in this project.

literallayout, assim como screen e programlisting, mantém seu layout intacto, mas geralmente não muda a fonte - a não ser que você altere o atributo class para "monospaced". É também mais genérico que os outros dois anteriores no contexto de que não há nenhum significado atrelado a seu conteúdo - você pode colocar qualquer tipo de texto aqui o qual você deseje preserver o layout.

Exemplo de fonte:

<literallayout>
The Sick Rose

Oh Rose, thou art sick!
The invisible worm
That flies in the night,
In the howling storm,

Has found out thy bed
Of crimson joy,
And his dark secret love
Doth thy life destroy.

  -- William Blake
</literallayout>

Saída:

Um example é um exemplo formal com um título. Geralmente se dá um id ao mesmo para possa ser referenciado de outros lugares no documento. Um índice de exemplos é gerado automaticamente quando o documento é renderizado. Você freqüentemente encontrará programlisting's em um exemplo, mas este pode conter screens, paras, listas, etc.

Eis um exemplo de um example:

<example id="docwritehowto-sql-example">
  <title>Um exemplo SQL</title>
  <para>Com este comando você pode listar todos os registros na tabela
    COUNTRY:</para>
  <programlisting>SELECT * FROM COUNTRY;</programlisting>
</example>

Na saída terá o seguinte aspecto:

SELECT * FROM COUNTRY;

Se você deseja um exemplo sem um título obrigatório, use um informalexample (exemplo informal). Exemplos informais são também deixados de fora do índice de exemplos.

Use a tag filename para marcar nomes de arquivos no mais abrangente sentido. Atributos podem opcionalmente indicar que o mesmo é um arquivo de cabeçalho, um diretório, etc.

Coloque seu documento no subdiretório<filename
class="directory">src/docs/firebirddocs</filename>.

Na saída lê-se:

command e application são ambos usados para programas executáveis. command é geralmente escolhido para programas menores e comandos internos; seu conteúdo deve ser o comando exato de disparado em uma linha de comando; application é usado para programas maiores e não precisa ser o nome do arquivo executável. Ambos podem se referir ao mesmo programa.

Digite <command>netscape&amp;</command> numa janela de terminal para
iniciar o <application>Netscape Navigator</application>.

Isto é renderizado como:

envar denota uma variável de ambiente.

(subscrito - sobrescrito)

Fazem o que é esperado:

Após inventar a fórmula e = mc<superscript>2</superscript>, eu
realmente tive vontade de um copo de H<subscript>2</subscript>O
líquido!

Saída: Após inventar a fórmula e = mc², eu realmente tive vontade de um copo de H₂O líquido!

O uso de varname e constant (nome de varíavel e constante - respectivamente) deve ser óbvio. A tag <database> não é só para bancos de dados, mas também para objetos do banco de dados:

A tabela <database class="table">COUNTRY</database> tem dois campos:
<database class="field">COUNTRY</database> e
<database class="field">CURRENCY</database>.

Saída: A tabela COUNTRY tem dois campos: COUNTRY e CURRENCY.

(função, parâmetro e valor de retorno - respectivamente)

Esses três falam por si mesmos, eu confio.

A função <function>log</function> tem os parâmetros
<parameter>a</parameter> e <parameter>b</parameter>.

Saída: A função log tem os parâmetros a e b.

prompt é usado para uma string que indica que o usuário deve entrar algum texto; userinput refere-se ao texto entrado pelo usuário (não necessariamente num prompt); computeroutput é texto exibido pelo computador:

Digite <userinput>convidado</userinput> no prompt
<prompt>login:</prompt> e o servidor irá saudá-lo com um
<computeroutput>Bem-vindo, usuário convidado</computeroutput>.

Saída: Digite convidade no prompt login: e o servidor irá saudá-lo com um Bem-vindo, usuário convidade.

O texto de uma tecla do teclado, ou o seu nome comum:

Pressione a tecla <keycap>Del</keycap> para apagar a mensagem, ou 
<keycap>ESPAÇO</keycap> para movê-la.

Saída: Pressione a tecla Del para apagar a mensagem, ou SPACE para movê-la.

Este elemento foi usado extensivamente durane este docuemento: ele marca tags, elementos, atributos, entidades, etc de SGML e XML :

Se é um diretório, ajuste o atributo
<sgmltag class="attribute">class</sgmltag> do elemento 
<sgmltag class="element">filename</sgmltag> para to
<sgmltag class="attvalue">directory</sgmltag>.

Saída: Se é um diretório, ajuste o atributo class do elemento filename para directory.

Outros possíveis valores de para sgmltag.class são: starttag, endtag, emptytag e genentity (para uma entidade).

(ênfase - título de citação - primeiro termo)

Use emphasis para enfatizar palavras em geral, citetitle para títulos de livro etc, e firstterm se você introduzir um novo conceito ou palavras para os seus leitores:

Nós usamos <firstterm>DocBook XML</firstterm> para nossa documentação 
do Firebird. Uma introdução curta segue;
<emphasis>por favor</emphasis> leia-a cuidadosamente! Se você deseja
saber mais sobre o assunto, compre <citetitle>DocBook – The Definitive 
Guide</citetitle>.

Saída: Nós usamos DocBook XML para nossa documentação do Firebird. Uma introdução curta segue; por favor leia-a cuidadosamente! Se deseja saber mais sobre o assunto, compre DocBook – The Definitive Guide.

(citação - literal)

Use quote para uma citação em linha (ao oposto de um blockquote). Caracteres aspas serão inseridas automaticamente. Usando quote ao invés de digitando as aspas por você mesmo (o que é perfeitamente legal) tem a vantagem de que nós podemos alterar o tipo de aspas através das folhas de estilo se nós quisermos.

Um literal é um fragmento de texto ou palavra para ser lido literalmente. É um elemento bem genérico, freqüentemente usado para fazer certas palavras se destacarem tipograficamente:

A qualquer custo evite usar a palavra <literal>monstruoso</literal> 
em sua documentação.

Saída: A qualquer custo evite usar a palavra monstruoso em sua documentação.