Beautify docbook files

1 files changed, 295 insertions, 1278 deletions

diff --git a/tde-i18n-pt/docs/tdeedu/kturtle/programming-reference.docbook b/tde-i18n-pt/docs/tdeedu/kturtle/programming-reference.docbook
index a075038a995..a1b30fe35bd 100644
--- a/tde-i18n-pt/docs/tdeedu/kturtle/programming-reference.docbook
+++ b/tde-i18n-pt/docs/tdeedu/kturtle/programming-reference.docbook
@@ -1,179 +1,58 @@
 <!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
      Thanks a lot in advance.-->
 <chapter id="reference">
-<title
->Referência de Programação em &logo; do &kturtle;</title>
-<para
->Esta é a referência para o &logo; do &kturtle;. Neste capítulo iremos tocar brevemente em todos os <link linkend="different-instructions"
->tipos de instruções diferentes</link
->. Depois, serão explicados os <link linkend="commands"
->comandos</link
->, um por um. De seguida, serão explicados os <link linkend="containers"
->contentores</link
->, a <link linkend="math"
->matemática</link
->, as <link linkend="questions"
->questões</link
-> e os <link linkend="controlling-execution"
->controladores de execução</link
->. Por último, ser-lhe-á mostrado como criar os seus próprios comandos com o <link linkend="learn"
->learn</link
->.</para>
+<title>Referência de Programação em &logo; do &kturtle;</title>
+<para>Esta é a referência para o &logo; do &kturtle;. Neste capítulo iremos tocar brevemente em todos os <link linkend="different-instructions">tipos de instruções diferentes</link>. Depois, serão explicados os <link linkend="commands">comandos</link>, um por um. De seguida, serão explicados os <link linkend="containers">contentores</link>, a <link linkend="math">matemática</link>, as <link linkend="questions">questões</link> e os <link linkend="controlling-execution">controladores de execução</link>. Por último, ser-lhe-á mostrado como criar os seus próprios comandos com o <link linkend="learn">learn</link>.</para>
 
 <sect1 id="different-instructions">
-<title
->Tipos Diferentes de Instruções</title>
-<para
->Como em qualquer linguagem, o LOGO tem diferentes tipos de palavras e símbolos. Aqui, será explicada a diferença entre os vários tipos.</para>
+<title>Tipos Diferentes de Instruções</title>
+<para>Como em qualquer linguagem, o LOGO tem diferentes tipos de palavras e símbolos. Aqui, será explicada a diferença entre os vários tipos.</para>
 
 <sect2 id="command">
-<title
->Comandos</title>
-<para
->Ao usar os comandos, você diz à tartaruga ou ao &kturtle; para fazer algo. Alguns comandos precisam de dados introduzidos, enquanto outros trazem resultados. <screen
-># o 'forward' é um comando que necessita de dados de entrada, neste caso o número 100:
+<title>Comandos</title>
+<para>Ao usar os comandos, você diz à tartaruga ou ao &kturtle; para fazer algo. Alguns comandos precisam de dados introduzidos, enquanto outros trazem resultados. <screen># o 'forward' é um comando que necessita de dados de entrada, neste caso o número 100:
 forward 100
 </screen>
 </para>
-<para
->Para uma ideia geral de todos os comandos que o &kturtle; suporta, venha <link linkend="commands"
->aqui</link
->.</para>
+<para>Para uma ideia geral de todos os comandos que o &kturtle; suporta, venha <link linkend="commands">aqui</link>.</para>
 </sect2>
 
 <sect2 id="number">
-<title
->Números</title>
-<para
->O mais provável é que você já conheça alguma coisa sobre os números. A forma como estes são usados no &kturtle; não é muito diferente da língua falada ou da matemática. </para>
-<para
->Temos então os números conhecidos por naturais: <userinput
->0</userinput
->, <userinput
->1</userinput
->, <userinput
->2</userinput
->, <userinput
->3</userinput
->, <userinput
->4</userinput
->, <userinput
->5</userinput
->, etc. Os números negativos: <userinput
->-1</userinput
->, <userinput
->-2</userinput
->, <userinput
->-3</userinput
->, etc. Finalmente, os números decimais ou fraccionários, como por exemplo: <userinput
->0.1</userinput
->, <userinput
->3.14</userinput
->, <userinput
->33.3333</userinput
->, <userinput
->-5.05</userinput
->, <userinput
->-1.0</userinput
->. </para>
-<para
->Os números podem ser usados em <link linkend="math"
->cálculos matemáticos</link
-> e <link linkend="questions"
->perguntas</link
->. Também podem ser colocados em <link linkend="containers"
->contentores</link
->.</para>
-<para
->Os números ficam <glossterm
->realçados</glossterm
-> a azul no <link linkend="the-code-editor"
->editor de código</link
->.</para>
+<title>Números</title>
+<para>O mais provável é que você já conheça alguma coisa sobre os números. A forma como estes são usados no &kturtle; não é muito diferente da língua falada ou da matemática. </para>
+<para>Temos então os números conhecidos por naturais: <userinput>0</userinput>, <userinput>1</userinput>, <userinput>2</userinput>, <userinput>3</userinput>, <userinput>4</userinput>, <userinput>5</userinput>, etc. Os números negativos: <userinput>-1</userinput>, <userinput>-2</userinput>, <userinput>-3</userinput>, etc. Finalmente, os números decimais ou fraccionários, como por exemplo: <userinput>0.1</userinput>, <userinput>3.14</userinput>, <userinput>33.3333</userinput>, <userinput>-5.05</userinput>, <userinput>-1.0</userinput>. </para>
+<para>Os números podem ser usados em <link linkend="math">cálculos matemáticos</link> e <link linkend="questions">perguntas</link>. Também podem ser colocados em <link linkend="containers">contentores</link>.</para>
+<para>Os números ficam <glossterm>realçados</glossterm> a azul no <link linkend="the-code-editor">editor de código</link>.</para>
 </sect2>
 
 <sect2 id="string">
-<title
->Cadeias de caracteres</title>
-<para
->Primeiro um exemplo: <screen>
+<title>Cadeias de caracteres</title>
+<para>Primeiro um exemplo: <screen>
 print "Olá, sou uma cadeia de caracteres."
-</screen
-> Neste exemplo, o <userinput
->print</userinput
-> é um comando, enquanto o <userinput
->"Olá, sou uma cadeia de caracteres."</userinput
-> é, de facto, uma cadeia de caracteres. Estas começam e terminam com o símbolo <userinput
->"</userinput
->; com estes símbolos, o &kturtle; sabe que é uma cadeia de caracteres.</para>
-<para
->As cadeias de caracteres podem ser colocadas em <link linkend="containers"
->contentores</link
->. Porém, não podem ser usadas em <link linkend="math"
->cálculos matemáticos</link
-> nem em <link linkend="questions"
->questões</link
->.</para>
-<para
->As cadeias de caracteres ficam <glossterm
->realçadas</glossterm
-> a vermelho escura no <link linkend="the-code-editor"
->editor de código</link
->.</para>
+</screen> Neste exemplo, o <userinput>print</userinput> é um comando, enquanto o <userinput>"Olá, sou uma cadeia de caracteres."</userinput> é, de facto, uma cadeia de caracteres. Estas começam e terminam com o símbolo <userinput>"</userinput>; com estes símbolos, o &kturtle; sabe que é uma cadeia de caracteres.</para>
+<para>As cadeias de caracteres podem ser colocadas em <link linkend="containers">contentores</link>. Porém, não podem ser usadas em <link linkend="math">cálculos matemáticos</link> nem em <link linkend="questions">questões</link>.</para>
+<para>As cadeias de caracteres ficam <glossterm>realçadas</glossterm> a vermelho escura no <link linkend="the-code-editor">editor de código</link>.</para>
 </sect2>
 
 
 <sect2 id="name">
-<title
->Nomes</title>
-<para
->Ao usar a linguagem de programação &logo;, pode criar coisas novas. Se criar um programa irá necessitar normalmente de <link linkend="containers"
->contentores</link
-> e, em alguns casos, do <link linkend="learn"
->learn</link
-> para criar novos comandos. Ao criar um <link linkend="containers"
->contentor</link
-> ou um novo comando com o <link linkend="learn"
->learn</link
->, terá de indicar um nome.</para>
-<para
->Poderá escolher qualquer nome, desde que este não tenha já algum significado. Por exemplo, não poderá chamar a um contentor  <link linkend="forward"
->forward</link
->, dado que esse nome já é usado para um comando e, como tal, já tem um significado.<screen>
+<title>Nomes</title>
+<para>Ao usar a linguagem de programação &logo;, pode criar coisas novas. Se criar um programa irá necessitar normalmente de <link linkend="containers">contentores</link> e, em alguns casos, do <link linkend="learn">learn</link> para criar novos comandos. Ao criar um <link linkend="containers">contentor</link> ou um novo comando com o <link linkend="learn">learn</link>, terá de indicar um nome.</para>
+<para>Poderá escolher qualquer nome, desde que este não tenha já algum significado. Por exemplo, não poderá chamar a um contentor  <link linkend="forward">forward</link>, dado que esse nome já é usado para um comando e, como tal, já tem um significado.<screen>
 # Aqui o forward é usado como contentor, mas já tem um significado
 # pelo que irá produzir um erro:
 forward = 20
 
 # isto funciona:
 forward 20
-</screen
-> Os nomes só poderão conter letras, números e sublinhados (_). De qualquer forma, têm de começar por uma letra. </para>
-<para
->Por favor, leia a documentação sobre os <link linkend="containers"
->contentores</link
-> e o comando <link linkend="learn"
->learn</link
-> para uma melhor explicação e mais exemplos. </para>
+</screen> Os nomes só poderão conter letras, números e sublinhados (_). De qualquer forma, têm de começar por uma letra. </para>
+<para>Por favor, leia a documentação sobre os <link linkend="containers">contentores</link> e o comando <link linkend="learn">learn</link> para uma melhor explicação e mais exemplos. </para>
 </sect2>
 
 <sect2 id="assignment">
-<title
->Atribuições</title>
-<para
->As atribuições são feitas com o símbolo <userinput
->=</userinput
->. Nas linguagens de programação é melhor ler o <userinput
->=</userinput
-> simples não como um 'é igual a' mas sim como um 'fica igual a'. O termo 'é igual a' é mais apropriado para o <userinput
->==</userinput
->, que é uma <link linkend="questions"
->pergunta</link
->.</para>
-<para
->As atribuições são usadas normalmente por duas razões, (1) para adicionar conteúdo aos <link linkend="containers"
->contentores</link
-> e (2) para modificar o conteúdo de um contentor. Por exemplo: <screen
->x = 10
+<title>Atribuições</title>
+<para>As atribuições são feitas com o símbolo <userinput>=</userinput>. Nas linguagens de programação é melhor ler o <userinput>=</userinput> simples não como um 'é igual a' mas sim como um 'fica igual a'. O termo 'é igual a' é mais apropriado para o <userinput>==</userinput>, que é uma <link linkend="questions">pergunta</link>.</para>
+<para>As atribuições são usadas normalmente por duas razões, (1) para adicionar conteúdo aos <link linkend="containers">contentores</link> e (2) para modificar o conteúdo de um contentor. Por exemplo: <screen>x = 10
 # o contentor 'x' contém agora o número 10
 W = "A minha idade é: "
 # o contentor W contém agora o texto "A minha idade: "
@@ -181,805 +60,359 @@ W = "A minha idade é: "
 print W + x
 </screen>
 </para>
-<para
->Para mais exemplos, veja a secção que explica os <link linkend="containers"
->contentores</link
->.</para>
+<para>Para mais exemplos, veja a secção que explica os <link linkend="containers">contentores</link>.</para>
 </sect2>
 
 <sect2 id="math-symbols">
-<title
->Símbolos Matemáticos</title>
-<para
->O &kturtle; suporta todos os símbolos matemáticos básicos: a adição (<userinput
->+</userinput
->), a subtracção (<userinput
->-</userinput
->), a multiplicação (<userinput
->*</userinput
->), a divisão (<userinput
->/</userinput
->) e os parêntesis <userinput
->(</userinput
-> e <userinput
->)</userinput
->.</para>
-<para
->Para uma explicação completa e mais exemplos, veja a secção de <link linkend="math"
->matemática</link
->.</para>
+<title>Símbolos Matemáticos</title>
+<para>O &kturtle; suporta todos os símbolos matemáticos básicos: a adição (<userinput>+</userinput>), a subtracção (<userinput>-</userinput>), a multiplicação (<userinput>*</userinput>), a divisão (<userinput>/</userinput>) e os parêntesis <userinput>(</userinput> e <userinput>)</userinput>.</para>
+<para>Para uma explicação completa e mais exemplos, veja a secção de <link linkend="math">matemática</link>.</para>
 </sect2>
 
 <sect2 id="question">
-<title
->Perguntas</title>
-<para
->Podem ser feitas algumas perguntas simples, onde nesse caso a resposta será 'true' (verdadeira) ou 'false' (falsa).</para>
-<para
->A utilização das perguntas é explicada de forma extensa na secção de <link linkend="questions"
->perguntas</link
->.</para>
+<title>Perguntas</title>
+<para>Podem ser feitas algumas perguntas simples, onde nesse caso a resposta será 'true' (verdadeira) ou 'false' (falsa).</para>
+<para>A utilização das perguntas é explicada de forma extensa na secção de <link linkend="questions">perguntas</link>.</para>
 </sect2>
 
 <sect2 id="questions-glue">
-<title
->Palavras de Colagem de Perguntas</title>
-<para
->As perguntas podem ser coladas em conjunto com o que se denomina por 'cola das perguntas'. As palavras de colagem são o <userinput
->and</userinput
-> (e), o <userinput
->or</userinput
-> (ou) e uma palavra especial: a <userinput
->not</userinput
-> (não).</para>
-<para
->A utilização da colagem de perguntas é explicada na secção de <link linkend="question-glue"
->Colagem de Perguntas</link
->.</para>
+<title>Palavras de Colagem de Perguntas</title>
+<para>As perguntas podem ser coladas em conjunto com o que se denomina por 'cola das perguntas'. As palavras de colagem são o <userinput>and</userinput> (e), o <userinput>or</userinput> (ou) e uma palavra especial: a <userinput>not</userinput> (não).</para>
+<para>A utilização da colagem de perguntas é explicada na secção de <link linkend="question-glue">Colagem de Perguntas</link>.</para>
 </sect2>
 
 
 <sect2 id="comment">
-<title
->Comentários</title>
-<para
->Os comentários são linhas que começam por um <userinput
->#</userinput
->. Por exemplo: <screen>
+<title>Comentários</title>
+<para>Os comentários são linhas que começam por um <userinput>#</userinput>. Por exemplo: <screen>
 # isto é um comentário!
 print "isto não é um comentário"
 # a linha anterior não é um comentário, mas a próxima é:
 # print "isto não é um comentário"
-</screen
-> Nas linhas comentadas, poderão ser adicionadas notas ao código, para nós ou para outra pessoa ler. Os comentários são usados para: (1) adicionar uma pequena descrição ao programa, (2) para explicar como é que funciona um determinado excerto de código se este for ligeiramente complicado e (3) para 'desactivar' linhas de código que deverão ser (temporariamente) ignoradas (veja a última linha do exemplo).</para>
-<para
->As linhas comentadas ficam <glossterm
->realçadas</glossterm
-> com um amarelo escuro no <link linkend="the-code-editor"
->editor de código</link
->.</para>
+</screen> Nas linhas comentadas, poderão ser adicionadas notas ao código, para nós ou para outra pessoa ler. Os comentários são usados para: (1) adicionar uma pequena descrição ao programa, (2) para explicar como é que funciona um determinado excerto de código se este for ligeiramente complicado e (3) para 'desactivar' linhas de código que deverão ser (temporariamente) ignoradas (veja a última linha do exemplo).</para>
+<para>As linhas comentadas ficam <glossterm>realçadas</glossterm> com um amarelo escuro no <link linkend="the-code-editor">editor de código</link>.</para>
 </sect2>
 
 </sect1>
 
 
 <sect1 id="commands">
-<title
->Comandos</title>
-<para
->Ao usar os comandos, você diz à tartaruga ou ao &kturtle; para fazer algo. Alguns comandos precisam de dados introduzidos, enquanto outros trazem resultados. Nesta secção iremos explicar todos os comandos que podem ser usados no &kturtle;. Repare que todos os comandos incorporados ficam <glossterm
->realçados</glossterm
-> a verde escuro no <link linkend="the-code-editor"
->editor de código</link
->, para que possa ajudar a distingui-los.</para>
+<title>Comandos</title>
+<para>Ao usar os comandos, você diz à tartaruga ou ao &kturtle; para fazer algo. Alguns comandos precisam de dados introduzidos, enquanto outros trazem resultados. Nesta secção iremos explicar todos os comandos que podem ser usados no &kturtle;. Repare que todos os comandos incorporados ficam <glossterm>realçados</glossterm> a verde escuro no <link linkend="the-code-editor">editor de código</link>, para que possa ajudar a distingui-los.</para>
 
 <sect2 id="moving-the-turtle">
-<title
->Mover a tartaruga</title>
-<para
->Existem vários comandos para mover a tartaruga pelo ecrã.</para>
+<title>Mover a tartaruga</title>
+<para>Existem vários comandos para mover a tartaruga pelo ecrã.</para>
   
 <sect3 id="forward">
-  <title
->forward (fw)</title>
+  <title>forward (fw)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->forward</term>
-      <listitem
-><para
-><screen
->forward X</screen>
-O <userinput
->forward</userinput
-> move a tartaruga para a frente X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rasto. O <userinput
->forward</userinput
-> pode ser abreviado para <userinput
->fw</userinput
-></para
-></listitem>
+    <varlistentry> 
+      <term>forward</term>
+      <listitem><para><screen>forward X</screen>
+O <userinput>forward</userinput> move a tartaruga para a frente X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rasto. O <userinput>forward</userinput> pode ser abreviado para <userinput>fw</userinput></para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="backward">
-  <title
->backward (bw)</title>
+  <title>backward (bw)</title>
   <variablelist>
-    <varlistentry
->  
-      <term
->backward</term>
-      <listitem
-><para
-><screen
->backward X</screen>
-O <userinput
->backward</userinput
-> move a tartaruga para trás X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rasto. O <userinput
->backward</userinput
-> pode ser abreviado para <userinput
->bw</userinput
->.</para
-></listitem>
+    <varlistentry>  
+      <term>backward</term>
+      <listitem><para><screen>backward X</screen>
+O <userinput>backward</userinput> move a tartaruga para trás X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rasto. O <userinput>backward</userinput> pode ser abreviado para <userinput>bw</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="turnleft">
-  <title
->turnleft (tl)</title>
+  <title>turnleft (tl)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->turnleft</term>
-      <listitem
-><para
-><screen
->turnleft X</screen>
-O <userinput
->turnleft</userinput
-> diz à tartaruga para se virar X graus para a esquerda. O <userinput
->turnleft</userinput
-> pode ser abreviado para <userinput
->tl</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>turnleft</term>
+      <listitem><para><screen>turnleft X</screen>
+O <userinput>turnleft</userinput> diz à tartaruga para se virar X graus para a esquerda. O <userinput>turnleft</userinput> pode ser abreviado para <userinput>tl</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="turnright">
-  <title
->turnright (tr)</title>
+  <title>turnright (tr)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->turnright</term>
-      <listitem
-><para
-><screen
->turnright X</screen>
-O <userinput
->turnright</userinput
-> diz à tartaruga para se virar X graus para a direita. O <userinput
->turnright</userinput
-> pode ser abreviado para <userinput
->tr</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>turnright</term>
+      <listitem><para><screen>turnright X</screen>
+O <userinput>turnright</userinput> diz à tartaruga para se virar X graus para a direita. O <userinput>turnright</userinput> pode ser abreviado para <userinput>tr</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="direction">
-  <title
->direction (dir)</title>
+  <title>direction (dir)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->direction</term>
-      <listitem
-><para
-><screen
->direction X</screen>
-O <userinput
->direction</userinput
-> configura a direcção da tartaruga para um ângulo de X graus a contar do zero, e isto não é relativo à direcção anterior da tartaruga. O <userinput
->direction</userinput
-> pode ser abreviado para <userinput
->dir</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>direction</term>
+      <listitem><para><screen>direction X</screen>
+O <userinput>direction</userinput> configura a direcção da tartaruga para um ângulo de X graus a contar do zero, e isto não é relativo à direcção anterior da tartaruga. O <userinput>direction</userinput> pode ser abreviado para <userinput>dir</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="center">
-  <title
->center</title>
+  <title>center</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->center</term>
-      <listitem
-><para
-><screen
->center</screen>
-O <userinput
->center</userinput
-> move a tartaruga para o centro da área de desenho.</para
-></listitem>
+    <varlistentry> 
+      <term>center</term>
+      <listitem><para><screen>center</screen>
+O <userinput>center</userinput> move a tartaruga para o centro da área de desenho.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="go">
-  <title
->go</title>
+  <title>go</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->go</term>
-      <listitem
-><para
-><screen
->go X,Y</screen>
-O <userinput
->go</userinput
-> manda a tartaruga ir para um dado local da área de desenho. Este local está a X <glossterm linkend="pixels"
->pixels</glossterm
-> do lado esquerdo da área de desenho e a Y <glossterm linkend="pixels"
->pixels</glossterm
-> do topo da área. Lembre-se que, ao usar o comando <userinput
->go</userinput
->, a tartaruga não irá desenhar nenhuma linha.</para
-></listitem>
+    <varlistentry> 
+      <term>go</term>
+      <listitem><para><screen>go X,Y</screen>
+O <userinput>go</userinput> manda a tartaruga ir para um dado local da área de desenho. Este local está a X <glossterm linkend="pixels">pixels</glossterm> do lado esquerdo da área de desenho e a Y <glossterm linkend="pixels">pixels</glossterm> do topo da área. Lembre-se que, ao usar o comando <userinput>go</userinput>, a tartaruga não irá desenhar nenhuma linha.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="gox">
-  <title
->gox</title>
+  <title>gox</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->gox</term>
-      <listitem
-><para
-><screen
->gox X</screen>
-Ao usar o comando <userinput
->gox</userinput
->, a tartaruga irá mover-se X <glossterm linkend="pixels"
->pixels</glossterm
-> a partir da esquerda da área de desenho, mantendo à mesma a sua altura.</para
-></listitem>
+    <varlistentry> 
+      <term>gox</term>
+      <listitem><para><screen>gox X</screen>
+Ao usar o comando <userinput>gox</userinput>, a tartaruga irá mover-se X <glossterm linkend="pixels">pixels</glossterm> a partir da esquerda da área de desenho, mantendo à mesma a sua altura.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="goy">
-  <title
->goy</title>
+  <title>goy</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->goy</term>
-      <listitem
-><para
-><screen
->goy Y</screen>
-Ao usar o comando <userinput
->goy</userinput
->, a tartaruga irá mover-se Y <glossterm linkend="pixels"
->pixels</glossterm
-> a partir do topo da área de desenho, mantendo à mesma a sua distância ao lado esquerdo da área de desenho.</para
-></listitem>
+    <varlistentry> 
+      <term>goy</term>
+      <listitem><para><screen>goy Y</screen>
+Ao usar o comando <userinput>goy</userinput>, a tartaruga irá mover-se Y <glossterm linkend="pixels">pixels</glossterm> a partir do topo da área de desenho, mantendo à mesma a sua distância ao lado esquerdo da área de desenho.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="pen">
-<title
->A tartaruga tem um traço</title>
-<para
->A tartaruga tem um traço e vai desenhando uma linha à medida que a tartaruga se move. Existem alguns comandos para controlar o traço. Nesta secção iremos explicar estes comandos.</para>
+<title>A tartaruga tem um traço</title>
+<para>A tartaruga tem um traço e vai desenhando uma linha à medida que a tartaruga se move. Existem alguns comandos para controlar o traço. Nesta secção iremos explicar estes comandos.</para>
 <sect3 id="penup">
-  <title
->penup (pu)</title>
+  <title>penup (pu)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->penup</term>
-      <listitem
-><para
-><screen
->penup</screen>
-O <userinput
->penup</userinput
-> levanta o traço da área de desenho. Quando o traço está <quote
->em cima</quote
->, não é desenhada nenhuma linha à medida que a tartaruga se move. Veja também o <userinput
->pendown</userinput
->. O <userinput
->penup</userinput
-> pode ser abreviado para <userinput
->pu</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>penup</term>
+      <listitem><para><screen>penup</screen>
+O <userinput>penup</userinput> levanta o traço da área de desenho. Quando o traço está <quote>em cima</quote>, não é desenhada nenhuma linha à medida que a tartaruga se move. Veja também o <userinput>pendown</userinput>. O <userinput>penup</userinput> pode ser abreviado para <userinput>pu</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="pendown">
-  <title
->pendown (pd)</title>
+  <title>pendown (pd)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->pendown</term>
-      <listitem
-><para
-><screen
->pendown</screen>
-O <userinput
->pendown</userinput
-> carrega no traço para baixo na área de desenho. Quando o traço está <quote
->em baixo</quote
->, é desenhada uma linha à medida que a tartaruga se move. Veja também o <userinput
->penup</userinput
->. O <userinput
->pendown</userinput
-> pode ser abreviado para <userinput
->pd</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>pendown</term>
+      <listitem><para><screen>pendown</screen>
+O <userinput>pendown</userinput> carrega no traço para baixo na área de desenho. Quando o traço está <quote>em baixo</quote>, é desenhada uma linha à medida que a tartaruga se move. Veja também o <userinput>penup</userinput>. O <userinput>pendown</userinput> pode ser abreviado para <userinput>pd</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="setpenwidth">
-  <title
->penwidth (pw)</title>
+  <title>penwidth (pw)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->penwidth</term>
-      <listitem
-><para
-><screen
->penwidth X</screen>
-O <userinput
->penwidth</userinput
-> configura a espessura do traço para X <glossterm linkend="pixels"
->pixels</glossterm
->. O <userinput
->penwidth</userinput
-> pode ser abreviado para <userinput
->pw</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>penwidth</term>
+      <listitem><para><screen>penwidth X</screen>
+O <userinput>penwidth</userinput> configura a espessura do traço para X <glossterm linkend="pixels">pixels</glossterm>. O <userinput>penwidth</userinput> pode ser abreviado para <userinput>pw</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="setfgcolor">
-  <title
->pencolor (pc)</title>
+  <title>pencolor (pc)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->pencolor</term>
-      <listitem
-><para
-><screen
->pencolor R,G,B</screen>
-O <userinput
->pencolor</userinput
-> configura a cor do traço. O <userinput
->pencolor</userinput
-> recebe uma <glossterm linkend="rgb"
->combinação de RGB</glossterm
-> como parâmetro. O <userinput
->pencolor</userinput
-> pode ser abreviado para <userinput
->pc</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>pencolor</term>
+      <listitem><para><screen>pencolor R,G,B</screen>
+O <userinput>pencolor</userinput> configura a cor do traço. O <userinput>pencolor</userinput> recebe uma <glossterm linkend="rgb">combinação de RGB</glossterm> como parâmetro. O <userinput>pencolor</userinput> pode ser abreviado para <userinput>pc</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="canvas">
-<title
->Comandos para controlar a área de desenho</title>
-<para
->Existem vários comandos para controlar a área de desenho.</para>
+<title>Comandos para controlar a área de desenho</title>
+<para>Existem vários comandos para controlar a área de desenho.</para>
 <sect3 id="resizecanvas">
-  <title
->canvassize (cs)</title>
+  <title>canvassize (cs)</title>
   <variablelist>
     <varlistentry>
-      <term
->canvassize</term>
-      <listitem
-><para
-><screen
->canvassize X,Y</screen>
-Com o comando <userinput
->canvassize</userinput
-> você poderá alterar o tamanho da área de desenho. Ele recebe dois parâmetros X e Y à entrada, em que o X é a nova largura da área de desenho em <glossterm linkend="pixels"
->pixels</glossterm
->, e o Y é a nova altura da mesma área em <glossterm linkend="pixels"
->pixels</glossterm
->. O <userinput
->canvassize</userinput
-> pode ser abreviado para <userinput
->cs</userinput
->.</para
-></listitem>
+      <term>canvassize</term>
+      <listitem><para><screen>canvassize X,Y</screen>
+Com o comando <userinput>canvassize</userinput> você poderá alterar o tamanho da área de desenho. Ele recebe dois parâmetros X e Y à entrada, em que o X é a nova largura da área de desenho em <glossterm linkend="pixels">pixels</glossterm>, e o Y é a nova altura da mesma área em <glossterm linkend="pixels">pixels</glossterm>. O <userinput>canvassize</userinput> pode ser abreviado para <userinput>cs</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="setbgcolor">
-  <title
->canvascolor (cc)</title>
+  <title>canvascolor (cc)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->canvascolor</term>
-      <listitem
-><para
-><screen
->canvascolor R,G,B</screen>
-O <userinput
->canvascolor</userinput
-> define a cor da área de desenho. O <userinput
->canvascolor</userinput
-> recebe uma <glossterm linkend="rgb"
->combinação RGB</glossterm
-> como parâmetro. O <userinput
->canvascolor</userinput
-> pode ser abreviado para <userinput
->cc</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>canvascolor</term>
+      <listitem><para><screen>canvascolor R,G,B</screen>
+O <userinput>canvascolor</userinput> define a cor da área de desenho. O <userinput>canvascolor</userinput> recebe uma <glossterm linkend="rgb">combinação RGB</glossterm> como parâmetro. O <userinput>canvascolor</userinput> pode ser abreviado para <userinput>cc</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="wrapon">
-  <title
->wrapon</title>
+  <title>wrapon</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->wrapon</term>
-      <listitem
-><para
-><screen
->wrapon</screen>
-Com o comando <userinput
->wrapon</userinput
-> você poderá activar a <glossterm linkend="wrapping"
->envolvência</glossterm
-> para a área de desenho. Por favor veja o glossário para saber o que é a <glossterm linkend="wrapping"
->envolvência</glossterm
->.</para
-></listitem>
+    <varlistentry> 
+      <term>wrapon</term>
+      <listitem><para><screen>wrapon</screen>
+Com o comando <userinput>wrapon</userinput> você poderá activar a <glossterm linkend="wrapping">envolvência</glossterm> para a área de desenho. Por favor veja o glossário para saber o que é a <glossterm linkend="wrapping">envolvência</glossterm>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="wrapoff">
-  <title
->wrapoff</title>
+  <title>wrapoff</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->wrapoff</term>
-      <listitem
-><para
-><screen
->wrapoff</screen>
-Com o comando <userinput
->wrapoff</userinput
-> você poderá desactivar a <glossterm linkend="wrapping"
->envolvência</glossterm
-> para a área de desenho. Isto significa que a tartaruga poder-se-á mover para fora da área de desenho e <quote
->perder-se</quote
->. Por favor veja o glossário se quiser saber o que é a <glossterm linkend="wrapping"
->envolvência</glossterm
->.</para
-></listitem>
+    <varlistentry> 
+      <term>wrapoff</term>
+      <listitem><para><screen>wrapoff</screen>
+Com o comando <userinput>wrapoff</userinput> você poderá desactivar a <glossterm linkend="wrapping">envolvência</glossterm> para a área de desenho. Isto significa que a tartaruga poder-se-á mover para fora da área de desenho e <quote>perder-se</quote>. Por favor veja o glossário se quiser saber o que é a <glossterm linkend="wrapping">envolvência</glossterm>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="clean">
-<title
->Comandos para limpar</title>
-<para
->Existem dois comandos para limpar a área de desenho, depois de você ter deixado tudo confuso.</para>
+<title>Comandos para limpar</title>
+<para>Existem dois comandos para limpar a área de desenho, depois de você ter deixado tudo confuso.</para>
 <sect3 id="clear">
-  <title
->clear (cr)</title>
+  <title>clear (cr)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->clear</term>
-      <listitem
-><para
-><screen
->clear</screen>
-Com o <userinput
->clear</userinput
->, você poderá limpar todos os desenhos da área respectiva. Tudo o resto permanece igual: a posição e o ângulo da tartaruga, a cor da área de trabalho, a visibilidade da tartaruga e o tamanho da área de desenho. O <userinput
->clear</userinput
-> pode ser abreviado para <userinput
->cr</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>clear</term>
+      <listitem><para><screen>clear</screen>
+Com o <userinput>clear</userinput>, você poderá limpar todos os desenhos da área respectiva. Tudo o resto permanece igual: a posição e o ângulo da tartaruga, a cor da área de trabalho, a visibilidade da tartaruga e o tamanho da área de desenho. O <userinput>clear</userinput> pode ser abreviado para <userinput>cr</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="reset">
-  <title
->reset</title>
+  <title>reset</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->reset</term>
-      <listitem
-><para
-><screen
->reset</screen>
-O <userinput
->reset</userinput
-> limpa tudo de forma mais abrangente que o comando <userinput
->clear</userinput
->. Depois de um comando <userinput
->reset</userinput
->, tudo fica tal e qual estava quando você iniciou o &kturtle;. A tartaruga é posicionada no meio do ecrã, a cor da área de desenho é branca e a tartaruga irá desenhar uma linha preta na área de desenho.</para
-></listitem>
+    <varlistentry> 
+      <term>reset</term>
+      <listitem><para><screen>reset</screen>
+O <userinput>reset</userinput> limpa tudo de forma mais abrangente que o comando <userinput>clear</userinput>. Depois de um comando <userinput>reset</userinput>, tudo fica tal e qual estava quando você iniciou o &kturtle;. A tartaruga é posicionada no meio do ecrã, a cor da área de desenho é branca e a tartaruga irá desenhar uma linha preta na área de desenho.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="sprites">
-<title
->A tartaruga é uma imagem móvel</title>
-<para
->Muitas das pessoas não sabem o que são as imagens móveis ('sprites'), daí uma breve explicação: as imagens móveis são pequenas imagens que podem percorrer o ecrã (para mais informações, veja o glossário sobre as <glossterm linkend="sprites"
->imagens móveis</glossterm
->). </para>
-<para
->A seguir você irá encontrar uma apresentação completa de todos os comandos que lidam com imagens móveis.</para>
-<para
->[A versão actual do &kturtle; não suporta ainda o uso de imagens móveis que não apenas a tartaruga. Nas versões futuras, você poderá mudar a tartaruga para outra coisa ao seu gosto]</para>
+<title>A tartaruga é uma imagem móvel</title>
+<para>Muitas das pessoas não sabem o que são as imagens móveis ('sprites'), daí uma breve explicação: as imagens móveis são pequenas imagens que podem percorrer o ecrã (para mais informações, veja o glossário sobre as <glossterm linkend="sprites">imagens móveis</glossterm>). </para>
+<para>A seguir você irá encontrar uma apresentação completa de todos os comandos que lidam com imagens móveis.</para>
+<para>[A versão actual do &kturtle; não suporta ainda o uso de imagens móveis que não apenas a tartaruga. Nas versões futuras, você poderá mudar a tartaruga para outra coisa ao seu gosto]</para>
 <sect3 id="spriteshow">
-  <title
->show</title>
+  <title>show</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->show (ss)</term>
-      <listitem
-><para
-><screen
->show</screen>
-O <userinput
->show</userinput
-> torna a tartaruga visível de novo depois de ter ficado escondida. O <userinput
->show</userinput
-> pode ser abreviado para <userinput
->ss</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>show (ss)</term>
+      <listitem><para><screen>show</screen>
+O <userinput>show</userinput> torna a tartaruga visível de novo depois de ter ficado escondida. O <userinput>show</userinput> pode ser abreviado para <userinput>ss</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="spritehide">
-  <title
->hide (sh)</title>
+  <title>hide (sh)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->hide</term>
-      <listitem
-><para
-><screen
->hide</screen>
-O <userinput
->hide</userinput
-> esconde a tartaruga. Isto pode ser usado se a tartaruga não couber no seu desenho. O <userinput
->hide</userinput
-> pode ser abreviado para <userinput
->sh</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>hide</term>
+      <listitem><para><screen>hide</screen>
+O <userinput>hide</userinput> esconde a tartaruga. Isto pode ser usado se a tartaruga não couber no seu desenho. O <userinput>hide</userinput> pode ser abreviado para <userinput>sh</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="writing">
-<title
->Será que as tartarugas escrevem texto?</title>
-<para
->A resposta é: <quote
->sim</quote
->. A tartaruga sabe escrever e pode escrever tudo o que lhe disser para escrever.</para>
+<title>Será que as tartarugas escrevem texto?</title>
+<para>A resposta é: <quote>sim</quote>. A tartaruga sabe escrever e pode escrever tudo o que lhe disser para escrever.</para>
 <sect3 id="print">
-  <title
->print</title>
+  <title>print</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->print</term>
-      <listitem
-><para
-><screen
->print X</screen>
-O comando <userinput
->print</userinput
-> é usado para dizer à tartaruga para escrever algo na área de desenho. O <userinput
->print</userinput
-> recebe números e texto como parâmetros. Você poderá executar o <userinput
->print</userinput
-> para vários parâmetros com o sinal <quote
->+</quote
->. Veja aqui um pequeno exemplo: <screen
->ano = 2004
+    <varlistentry> 
+      <term>print</term>
+      <listitem><para><screen>print X</screen>
+O comando <userinput>print</userinput> é usado para dizer à tartaruga para escrever algo na área de desenho. O <userinput>print</userinput> recebe números e texto como parâmetros. Você poderá executar o <userinput>print</userinput> para vários parâmetros com o sinal <quote>+</quote>. Veja aqui um pequeno exemplo: <screen>ano = 2004
 autor = "Ze"
 print "O " + autor + " iniciou o projecto do KTurtle em " + ano + " e ainda continua a gostar de trabalhar nele!"
 </screen>
-      </para
-></listitem>
+      </para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="fontsize">
-  <title
->fontsize</title>
+  <title>fontsize</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->fontsize</term>
-      <listitem
-><para
-><screen
->fontsize X</screen>
-O <userinput
->fontsize</userinput
-> configura o tamanho da letra que é usado pelo <userinput
->print</userinput
->. O <userinput
->fontsize</userinput
-> recebe um parâmetros que deverá ser um número. O tamanho é definido em <glossterm linkend="pixels"
->pixels</glossterm
->.</para
-></listitem>
+    <varlistentry> 
+      <term>fontsize</term>
+      <listitem><para><screen>fontsize X</screen>
+O <userinput>fontsize</userinput> configura o tamanho da letra que é usado pelo <userinput>print</userinput>. O <userinput>fontsize</userinput> recebe um parâmetros que deverá ser um número. O tamanho é definido em <glossterm linkend="pixels">pixels</glossterm>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="random">
-<title
->Um comando que joga aos dados por si</title>
-<para
->Existe um comando que lança os dados para si, que se chama <userinput
->random</userinput
-> e é muito útil para alguns resultados inesperados.</para>
+<title>Um comando que joga aos dados por si</title>
+<para>Existe um comando que lança os dados para si, que se chama <userinput>random</userinput> e é muito útil para alguns resultados inesperados.</para>
   <variablelist>
-    <varlistentry
-> 
-      <term
->random</term>
-      <listitem
-><para
-><screen
->random X,Y</screen>
-O <userinput
->random</userinput
-> é um comando que recebe parâmetros e devolve resultados. Como parâmetros são necessários dois números, em que o primeiro define o resultado mínimo (X) e o segundo o máximo (Y). O resultado é um número escolhido aleatoriamente que é maior ou igual ao mínimo e menor ou igual ao máximo. Aqui está um pequeno exemplo: <screen>
+    <varlistentry> 
+      <term>random</term>
+      <listitem><para><screen>random X,Y</screen>
+O <userinput>random</userinput> é um comando que recebe parâmetros e devolve resultados. Como parâmetros são necessários dois números, em que o primeiro define o resultado mínimo (X) e o segundo o máximo (Y). O resultado é um número escolhido aleatoriamente que é maior ou igual ao mínimo e menor ou igual ao máximo. Aqui está um pequeno exemplo: <screen>
       repeat 500 [
         x = random 1,20
         forward x
         turnleft 10 - x
       ]
-      </screen
-> Com o comando 'random', você poderá adicionar um pouco de confusão ao seu programa.</para
-></listitem>
+      </screen> Com o comando 'random', você poderá adicionar um pouco de confusão ao seu programa.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="dialogs">
-<title
->Entrada de dados e reacção através de janelas</title>
-<para
->Uma janela poderá pedir alguma alguma reacção em especial ou a introdução de determinados dados. O &kturtle; tem dois comandos para janelas, nomeadamente o <userinput
->message</userinput
-> e o <userinput
->inputwindow</userinput
-></para>
+<title>Entrada de dados e reacção através de janelas</title>
+<para>Uma janela poderá pedir alguma alguma reacção em especial ou a introdução de determinados dados. O &kturtle; tem dois comandos para janelas, nomeadamente o <userinput>message</userinput> e o <userinput>inputwindow</userinput></para>
 <sect3 id="message">
-  <title
->message</title>
+  <title>message</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->message</term>
-      <listitem
-><para
-><screen
->message X</screen>
-O comando <userinput
->message</userinput
-> recebe uma <link linkend="string"
->cadeia de caracteres</link
-> à entrada. Mostra então uma janela que contém o texto da <link linkend="string"
->cadeia de caracteres</link
->. <screen
->ano = 2004
+    <varlistentry> 
+      <term>message</term>
+      <listitem><para><screen>message X</screen>
+O comando <userinput>message</userinput> recebe uma <link linkend="string">cadeia de caracteres</link> à entrada. Mostra então uma janela que contém o texto da <link linkend="string">cadeia de caracteres</link>. <screen>ano = 2004
 autor = "Ze"
 print "O " + autor + " iniciou o projecto do KTurtle em " + ano + " e ainda continua a gostar de trabalhar nele!"
 </screen>
-      </para
-></listitem>
+      </para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="inputwindow">
-  <title
->inputwindow</title>
+  <title>inputwindow</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->inputwindow</term>
-      <listitem
-><para
-><screen
->inputwindow X</screen>
-O <userinput
->inputwindow</userinput
-> recebe uma <link linkend="string"
->cadeia de caracteres</link
-> à entrada. Mostra uma janela que contém o texto da cadeia de caracteres, tal como acontece no <link linkend="message"
->message</link
->. Contudo, para além disso, também mostra um campo de texto na janela. Através deste campo, o utilizador poderá introduzir um <link linkend="number"
->número</link
-> ou uma <link linkend="string"
->cadeia de caracteres</link
-> que poderá ser guardada num <link linkend="containers"
->contentor</link
->. Por exemplo <screen>
+    <varlistentry> 
+      <term>inputwindow</term>
+      <listitem><para><screen>inputwindow X</screen>
+O <userinput>inputwindow</userinput> recebe uma <link linkend="string">cadeia de caracteres</link> à entrada. Mostra uma janela que contém o texto da cadeia de caracteres, tal como acontece no <link linkend="message">message</link>. Contudo, para além disso, também mostra um campo de texto na janela. Através deste campo, o utilizador poderá introduzir um <link linkend="number">número</link> ou uma <link linkend="string">cadeia de caracteres</link> que poderá ser guardada num <link linkend="containers">contentor</link>. Por exemplo <screen>
 in = inputwindow "Que idade tem?"
 out = 2003 - in
 print "Em 2003, você tinha " + out + " anos a dada altura."
-</screen
-> Quando um utilizador cancelar a janela ou não introduzir nada de todo, o <link linkend="containers"
->contentor</link
-> fica vazio.</para
-></listitem>
+</screen> Quando um utilizador cancelar a janela ou não introduzir nada de todo, o <link linkend="containers">contentor</link> fica vazio.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
@@ -990,45 +423,23 @@ print "Em 2003, você tinha " + out + " anos a dada altura."
 
 
 <sect1 id="containers">
-<title
->Contentores</title>
-<para
->Os contentores são letras ou palavras que podem ser usadas pelo programador para guardar algum número ou algum texto. Os contentores que contêm um número chamam-se <link linkend="variables"
->variáveis</link
->, enquanto que os que contêm texto chamam-se <link linkend="strings"
->cadeias de caracteres</link
->.</para>
+<title>Contentores</title>
+<para>Os contentores são letras ou palavras que podem ser usadas pelo programador para guardar algum número ou algum texto. Os contentores que contêm um número chamam-se <link linkend="variables">variáveis</link>, enquanto que os que contêm texto chamam-se <link linkend="strings">cadeias de caracteres</link>.</para>
 
-<para
->Os contentores que não são usados não contêm nada. Por exemplo, um: <screen>
+<para>Os contentores que não são usados não contêm nada. Por exemplo, um: <screen>
 print N
-</screen
-> Isto não irá imprimir nada. Se tentar fazer <link linkend="math"
->operações matemáticas</link
-> com contentores vazios, irá obter erros. </para>
+</screen> Isto não irá imprimir nada. Se tentar fazer <link linkend="math">operações matemáticas</link> com contentores vazios, irá obter erros. </para>
 
 <sect2 id="variables">
-<title
->Variáveis: contentores de números</title>
-<para
->Vamos começar com um exemplo: <screen>
+<title>Variáveis: contentores de números</title>
+<para>Vamos começar com um exemplo: <screen>
 x = 3
 print x
-</screen
-> Na primeira linha, a letra <userinput
->x</userinput
-> passou a ser uma variável (um contentor de números). Como poderá ver, o valor da variável <userinput
->x</userinput
-> passou a 3. Na segunda linha, o valor é impresso.</para>
-<para
->Lembre-se que, se quisesse imprimir um <quote
->x</quote
->, então deveria ser escrito <screen
->print "x"
+</screen> Na primeira linha, a letra <userinput>x</userinput> passou a ser uma variável (um contentor de números). Como poderá ver, o valor da variável <userinput>x</userinput> passou a 3. Na segunda linha, o valor é impresso.</para>
+<para>Lembre-se que, se quisesse imprimir um <quote>x</quote>, então deveria ser escrito <screen>print "x"
 </screen>
 </para>
-<para
->Isso foi fácil, mas agora há um exemplo um pouco mais difícil: <screen>
+<para>Isso foi fácil, mas agora há um exemplo um pouco mais difícil: <screen>
 A = 2004
 B = 25
 C = A + B
@@ -1041,372 +452,148 @@ print A + " mais " + B
 backward 30
 # o próximo comando imprime "1979"
 print A - B
-</screen
-> Nas duas primeiras linhas, as variáveis <userinput
->A</userinput
-> e <userinput
->B</userinput
-> são configuradas como sendo iguais a 2004 e 25. Na terceira linha, a variável <userinput
->C</userinput
-> fica igual a <userinput
->A + B</userinput
->, o que dá 2029. O resto do exemplo consiste em 3 comandos <userinput
->print</userinput
-> com <userinput
->backward 30</userinput
-> no meio. O <userinput
->backward 30</userinput
-> está lá para garantir que cada resultado fica numa linha diferente. Neste exemplo, você vê também que as variáveis podem ser usadas nos <link linkend="math"
->cálculos matemáticos</link
->.</para>
+</screen> Nas duas primeiras linhas, as variáveis <userinput>A</userinput> e <userinput>B</userinput> são configuradas como sendo iguais a 2004 e 25. Na terceira linha, a variável <userinput>C</userinput> fica igual a <userinput>A + B</userinput>, o que dá 2029. O resto do exemplo consiste em 3 comandos <userinput>print</userinput> com <userinput>backward 30</userinput> no meio. O <userinput>backward 30</userinput> está lá para garantir que cada resultado fica numa linha diferente. Neste exemplo, você vê também que as variáveis podem ser usadas nos <link linkend="math">cálculos matemáticos</link>.</para>
 </sect2>
 
 <sect2 id="strings">
-<title
->Contentores de texto (cadeias de caracteres)</title>
-<para
->No código do programa, o texto normal é iniciado e termina normalmente com aspas. Como já foi visto: <screen>
+<title>Contentores de texto (cadeias de caracteres)</title>
+<para>No código do programa, o texto normal é iniciado e termina normalmente com aspas. Como já foi visto: <screen>
 print "Olá programador!"
-</screen
-> O texto fica delimitado com as aspas. Estes pedaços de texto normal são chamados então de <link linkend="strings"
->cadeias de caracteres</link
->.</para>
-<para
->As cadeias de caracteres são bastante parecidas com as variáveis. A maior diferença é que as cadeias de caracteres não podem ser usadas em <link linkend="math"
->cálculos matemáticos</link
-> e <link linkend="questions"
->perguntas</link
->. Um exemplo da utilização das cadeias de caracteres: <screen>
+</screen> O texto fica delimitado com as aspas. Estes pedaços de texto normal são chamados então de <link linkend="strings">cadeias de caracteres</link>.</para>
+<para>As cadeias de caracteres são bastante parecidas com as variáveis. A maior diferença é que as cadeias de caracteres não podem ser usadas em <link linkend="math">cálculos matemáticos</link> e <link linkend="questions">perguntas</link>. Um exemplo da utilização das cadeias de caracteres: <screen>
 x = "Olá "
 nome = inputwindow "por favor indique o seu nome..."
 print x + nome + ", como é que está?
-</screen
-> Na segunda linha, a cadeia de caracteres <userinput
->x</userinput
-> fica igual a <quote
->Olá </quote
->. Na segunda linha, a cadeia de caracteres <userinput
->nome</userinput
-> é configurada como o resultado do comando <userinput
->inputwindow</userinput
->. Na terceira linha, o programa imprime uma composição de três cadeias de caracteres na área de desenho.</para>
-<para
->Este programa pede-lhe para introduzir o seu nome. Quando você, por exemplo, introduzir o nome <quote
->Zé</quote
->, o programa irá imprimir <quote
->Olá Zé, como é que está?</quote
->. Lembre-se que o sinal de mais (+) é o único símbolo matemático que você poderá usar com as cadeias de caracteres.</para>
+</screen> Na segunda linha, a cadeia de caracteres <userinput>x</userinput> fica igual a <quote>Olá </quote>. Na segunda linha, a cadeia de caracteres <userinput>nome</userinput> é configurada como o resultado do comando <userinput>inputwindow</userinput>. Na terceira linha, o programa imprime uma composição de três cadeias de caracteres na área de desenho.</para>
+<para>Este programa pede-lhe para introduzir o seu nome. Quando você, por exemplo, introduzir o nome <quote>Zé</quote>, o programa irá imprimir <quote>Olá Zé, como é que está?</quote>. Lembre-se que o sinal de mais (+) é o único símbolo matemático que você poderá usar com as cadeias de caracteres.</para>
 </sect2>
 </sect1>
 
 <sect1 id="math">
-<title
->Será que a Tartaruga Pode Fazer Contas?</title>
-<para
->Sim, o &kturtle; sabe fazer contas para si. Você poderá somar (+), subtrair (-), multiplicar (*) e dividir (/). Aqui está um exemplo no qual iremos usar todas as operações: <screen>
+<title>Será que a Tartaruga Pode Fazer Contas?</title>
+<para>Sim, o &kturtle; sabe fazer contas para si. Você poderá somar (+), subtrair (-), multiplicar (*) e dividir (/). Aqui está um exemplo no qual iremos usar todas as operações: <screen>
 a = 20 - 5
 b = 15 * 2
 c = 30 / 30
 d = 1 + 1
 print "a: "+a+", b: "+b+", c: "+c+", d: "+d 
-</screen
-> Será que sabe o valor de 'a', 'b', 'c' e 'd'? Repare por favor no uso do símbolo <userinput
->=</userinput
-> de <link linkend="assignment"
->atribuição</link
->.</para>
-<para
->Se você somente queria fazer um cálculo simples, você poderá fazer algo semelhante a isto: <screen
->print 2004-12
-</screen
-></para>
-<para
->Agora, um exemplo com parêntesis: <screen>
+</screen> Será que sabe o valor de 'a', 'b', 'c' e 'd'? Repare por favor no uso do símbolo <userinput>=</userinput> de <link linkend="assignment">atribuição</link>.</para>
+<para>Se você somente queria fazer um cálculo simples, você poderá fazer algo semelhante a isto: <screen>print 2004-12
+</screen></para>
+<para>Agora, um exemplo com parêntesis: <screen>
 print ( ( 20 - 5 ) * 2 / 30 ) + 1
-</screen
-> O que estiver entre parêntesis será calculado em primeiro lugar. Neste exemplo, o 20-5 será calculado, depois será multiplicado por 2, dividido por 30 e depois é adicionado 1 (o que dá 2).</para>
+</screen> O que estiver entre parêntesis será calculado em primeiro lugar. Neste exemplo, o 20-5 será calculado, depois será multiplicado por 2, dividido por 30 e depois é adicionado 1 (o que dá 2).</para>
 </sect1>
 
 <sect1 id="questions">
-<title
->Fazer perguntas, obter respostas...</title>
-<para
->O <link linkend="if"
-><userinput
->if</userinput
-></link
-> e o <link linkend="while"
-><userinput
->while</userinput
-></link
-> são <link linkend="controlling-execution"
->controladores de execução</link
-> que iremos discutir na próxima secção. Nesta secção iremos usar o comando <userinput
->if</userinput
-> para explicar as perguntas.</para>
+<title>Fazer perguntas, obter respostas...</title>
+<para>O <link linkend="if"><userinput>if</userinput></link> e o <link linkend="while"><userinput>while</userinput></link> são <link linkend="controlling-execution">controladores de execução</link> que iremos discutir na próxima secção. Nesta secção iremos usar o comando <userinput>if</userinput> para explicar as perguntas.</para>
 <sect2 id="q">
-<title
->Perguntas</title>
-<para
->Um exemplo simples de perguntas: <screen>
+<title>Perguntas</title>
+<para>Um exemplo simples de perguntas: <screen>
 x = 6
 if x &gt; 5 [
   print "olá"
 ]
-</screen
-> Neste exemplo, a pergunta é <userinput
->x &gt; 5</userinput
->, se a resposta a esta pergunta for <quote
->true</quote
-> (verdadeira), o código entre parêntesis rectos será executado. As perguntas são uma parte importante da programação e são usadas normalmente em conjunto com os <link linkend="controlling-execution"
->controladores de execução</link
->, como o <link linkend="if"
-><userinput
->if</userinput
-></link
->. Todos os números e <link linkend="variables"
->variáveis</link
-> (contentores de números) poderão ser comparados uns com os outros nas perguntas.</para>
-<para
->Aqui estão todas as perguntas possíveis: <table>
-<title
->Tipos de perguntas</title>
+</screen> Neste exemplo, a pergunta é <userinput>x &gt; 5</userinput>, se a resposta a esta pergunta for <quote>true</quote> (verdadeira), o código entre parêntesis rectos será executado. As perguntas são uma parte importante da programação e são usadas normalmente em conjunto com os <link linkend="controlling-execution">controladores de execução</link>, como o <link linkend="if"><userinput>if</userinput></link>. Todos os números e <link linkend="variables">variáveis</link> (contentores de números) poderão ser comparados uns com os outros nas perguntas.</para>
+<para>Aqui estão todas as perguntas possíveis: <table>
+<title>Tipos de perguntas</title>
 <tgroup cols="3">
 <tbody>
 <row>
-<entry
-><userinput
->a == b</userinput
-></entry>
-<entry
->igual a</entry>
-<entry
->a resposta é <quote
->true</quote
-> (verdadeira) se o <userinput
->a</userinput
-> for igual ao <userinput
->b</userinput
-></entry>
+<entry><userinput>a == b</userinput></entry>
+<entry>igual a</entry>
+<entry>a resposta é <quote>true</quote> (verdadeira) se o <userinput>a</userinput> for igual ao <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a != b</userinput
-></entry>
-<entry
->é diferente de</entry>
-<entry
->a resposta é <quote
->true</quote
-> (verdadeira) se o <userinput
->a</userinput
-> não for igual ao <userinput
->b</userinput
-></entry>
+<entry><userinput>a != b</userinput></entry>
+<entry>é diferente de</entry>
+<entry>a resposta é <quote>true</quote> (verdadeira) se o <userinput>a</userinput> não for igual ao <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &gt; b</userinput
-></entry>
-<entry
->maior que</entry>
-<entry
->a resposta é <quote
->true</quote
-> (verdadeira) se o <userinput
->a</userinput
-> for maior que o <userinput
->b</userinput
-></entry>
+<entry><userinput>a &gt; b</userinput></entry>
+<entry>maior que</entry>
+<entry>a resposta é <quote>true</quote> (verdadeira) se o <userinput>a</userinput> for maior que o <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &lt; b</userinput
-></entry>
-<entry
->menor que</entry>
-<entry
->a resposta é <quote
->true</quote
-> (verdadeira) se o <userinput
->a</userinput
-> for menor que o <userinput
->b</userinput
-></entry>
+<entry><userinput>a &lt; b</userinput></entry>
+<entry>menor que</entry>
+<entry>a resposta é <quote>true</quote> (verdadeira) se o <userinput>a</userinput> for menor que o <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &gt;= b</userinput
-></entry>
-<entry
->maior ou igual a</entry>
-<entry
->a resposta é <quote
->true</quote
-> (verdadeira) se o <userinput
->a</userinput
-> for maior ou igual ao <userinput
->b</userinput
-></entry>
+<entry><userinput>a &gt;= b</userinput></entry>
+<entry>maior ou igual a</entry>
+<entry>a resposta é <quote>true</quote> (verdadeira) se o <userinput>a</userinput> for maior ou igual ao <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &lt;= b</userinput
-></entry>
-<entry
->menor ou igual a</entry>
-<entry
->a resposta é <quote
->true</quote
-> (verdadeira) se o <userinput
->a</userinput
-> for menor ou igual ao <userinput
->b</userinput
-></entry>
+<entry><userinput>a &lt;= b</userinput></entry>
+<entry>menor ou igual a</entry>
+<entry>a resposta é <quote>true</quote> (verdadeira) se o <userinput>a</userinput> for menor ou igual ao <userinput>b</userinput></entry>
 </row>
 </tbody>
 </tgroup>
 </table>
 </para>
-<para
->As perguntas ficam <glossterm
->realçadas</glossterm
-> com azul claro no <link linkend="the-code-editor"
->editor de código</link
->.</para
-> 
+<para>As perguntas ficam <glossterm>realçadas</glossterm> com azul claro no <link linkend="the-code-editor">editor de código</link>.</para> 
 </sect2>
 
 <sect2 id="question-glue">
-<title
->Colagem de Perguntas</title>
-<para
->As perguntas também podem ser coladas umas às outras com <quote
->palavras de colagem de perguntas</quote
-> onde, desta forma, algumas perguntas tornam-se uma pergunta maior. <screen>
+<title>Colagem de Perguntas</title>
+<para>As perguntas também podem ser coladas umas às outras com <quote>palavras de colagem de perguntas</quote> onde, desta forma, algumas perguntas tornam-se uma pergunta maior. <screen>
 a = 1
 b = 5
 if (a &lt; 5) and (b == 5) [
   print "olá"
 ]
-</screen
-> Neste exemplo, a palavra de colagem <userinput
->and</userinput
-> é usada para colar 2 perguntas (<userinput
->a &lt; 5</userinput
->, <userinput
->b == 5</userinput
->) em conjunto. Se um lado do <userinput
->and</userinput
-> der uma resposta <quote
->false</quote
-> (falsa), a pergunta toda irá responder <quote
->false</quote
->, porque, com a palavra de colagem <userinput
->and</userinput
->, ambos os lados precisam de ser <quote
->true</quote
-> para que a resposta seja <quote
->true</quote
-> (verdadeira). Por favor não se esqueça de usar os parêntesis à volta das perguntas!</para>
+</screen> Neste exemplo, a palavra de colagem <userinput>and</userinput> é usada para colar 2 perguntas (<userinput>a &lt; 5</userinput>, <userinput>b == 5</userinput>) em conjunto. Se um lado do <userinput>and</userinput> der uma resposta <quote>false</quote> (falsa), a pergunta toda irá responder <quote>false</quote>, porque, com a palavra de colagem <userinput>and</userinput>, ambos os lados precisam de ser <quote>true</quote> para que a resposta seja <quote>true</quote> (verdadeira). Por favor não se esqueça de usar os parêntesis à volta das perguntas!</para>
 
-<para
->Segue-se uma vista esquemática; pode encontrar uma explicação mais detalhada de seguida: <table>
-<title
->Palavras de colagem de perguntas</title>
+<para>Segue-se uma vista esquemática; pode encontrar uma explicação mais detalhada de seguida: <table>
+<title>Palavras de colagem de perguntas</title>
 <tgroup cols="2">
 <tbody>
 <row>
-<entry
-><userinput
->and</userinput
-></entry>
-<entry
->ambos os lados têm de ser <quote
->true</quote
-> (verdadeiros) para a resposta ser <quote
->true</quote
-> (verdadeira)</entry>
+<entry><userinput>and</userinput></entry>
+<entry>ambos os lados têm de ser <quote>true</quote> (verdadeiros) para a resposta ser <quote>true</quote> (verdadeira)</entry>
 </row>
 <row>
-<entry
-><userinput
->or</userinput
-></entry>
-<entry
->se um dos lados for <quote
->true</quote
-> (verdadeiros) a resposta é <quote
->true</quote
-> (verdadeira)</entry>
+<entry><userinput>or</userinput></entry>
+<entry>se um dos lados for <quote>true</quote> (verdadeiros) a resposta é <quote>true</quote> (verdadeira)</entry>
 </row>
 <row>
-<entry
-><userinput
->not</userinput
-></entry>
-<entry
->Caso especial: só funciona com uma pergunta! Muda o 'true' para 'false' e o 'false' para 'true'.</entry>
+<entry><userinput>not</userinput></entry>
+<entry>Caso especial: só funciona com uma pergunta! Muda o 'true' para 'false' e o 'false' para 'true'.</entry>
 </row>
 </tbody>
 </tgroup>
 </table>
 </para>
-<para
->As palavras de colagem ficam <glossterm
->realçadas</glossterm
-> a púrpura no <link linkend="the-code-editor"
->editor de código</link
->.</para>
+<para>As palavras de colagem ficam <glossterm>realçadas</glossterm> a púrpura no <link linkend="the-code-editor">editor de código</link>.</para>
 
 <sect3 id="and">
-<title
->and</title>
-<para
->Quando são coladas duas perguntas em conjunto com o <userinput
->and</userinput
->, ambos os lados do <userinput
->and</userinput
-> terão ser 'true' para que o resultado também seja 'true' (verdadeiro). Por exemplo: <screen>
+<title>and</title>
+<para>Quando são coladas duas perguntas em conjunto com o <userinput>and</userinput>, ambos os lados do <userinput>and</userinput> terão ser 'true' para que o resultado também seja 'true' (verdadeiro). Por exemplo: <screen>
 a = 1
 b = 5
 if ((a &lt; 10) and (b == 5)) and (a &lt; b) [
   print "olá"
 ]
-</screen
-> Nestes exemplo, poderá ver uma pergunta colada a outra pergunta também colada.</para>
+</screen> Nestes exemplo, poderá ver uma pergunta colada a outra pergunta também colada.</para>
 </sect3>
 
 <sect3 id="or">
-<title
->or</title>
-<para
->Se uma das duas perguntas coladas em conjunto com o <userinput
->or</userinput
-> for 'true' (verdadeira), o resultado será também 'true'. Por exemplo: <screen>
+<title>or</title>
+<para>Se uma das duas perguntas coladas em conjunto com o <userinput>or</userinput> for 'true' (verdadeira), o resultado será também 'true'. Por exemplo: <screen>
 a = 1
 b = 5
 if ((a &lt; 10) or (b == 10)) or (a == 0) [
   print "olá"
 ]
-</screen
-> Neste exemplo, irá ver uma pergunta colada a outra pergunta, também esta colada.</para>
+</screen> Neste exemplo, irá ver uma pergunta colada a outra pergunta, também esta colada.</para>
 </sect3>
 
 <sect3 id="not">
-<title
->not</title>
-<para
->O <userinput
->not</userinput
-> é uma palavra de colagem de perguntas especial que só funciona para uma pergunta de cada vez. O <userinput
->not</userinput
-> muda o 'true' para 'false' e o 'false' para 'true'. Por exemplo: <screen>
+<title>not</title>
+<para>O <userinput>not</userinput> é uma palavra de colagem de perguntas especial que só funciona para uma pergunta de cada vez. O <userinput>not</userinput> muda o 'true' para 'false' e o 'false' para 'true'. Por exemplo: <screen>
 a = 1
 b = 5
 if not ((a &lt; 10) and (b == 5)) [
@@ -1416,14 +603,7 @@ else
 [
   print "não olá ;-)"
 ]
-</screen
-> Neste exemplo, a pergunta colada é igual a 'true', embora o <userinput
->not</userinput
-> a mude para 'false'. Como tal, no fim, será impresso o <userinput
->"não olá ;-)"</userinput
-> na <link linkend="the-canvas"
->área de desenho</link
->.</para>
+</screen> Neste exemplo, a pergunta colada é igual a 'true', embora o <userinput>not</userinput> a mude para 'false'. Como tal, no fim, será impresso o <userinput>"não olá ;-)"</userinput> na <link linkend="the-canvas">área de desenho</link>.</para>
 </sect3>
 
 </sect2>
@@ -1431,223 +611,92 @@ else
 </sect1>
 
 <sect1 id="controlling-execution">
-<title
->Controlar a execução</title>
-<para
->Os controladores de execução permitem-lhe &mdash; como o nome deles indica &mdash; controlar a execução.</para>
-<para
->Os comandos de controlo da execução ficam <glossterm
->realçados</glossterm
-> a verde escuro e a negrito. Os parêntesis rectos, que são mais usados em conjunto com os controladores de execução, ficam <glossterm
->realçados</glossterm
-> a verde claro.</para>
+<title>Controlar a execução</title>
+<para>Os controladores de execução permitem-lhe &mdash; como o nome deles indica &mdash; controlar a execução.</para>
+<para>Os comandos de controlo da execução ficam <glossterm>realçados</glossterm> a verde escuro e a negrito. Os parêntesis rectos, que são mais usados em conjunto com os controladores de execução, ficam <glossterm>realçados</glossterm> a verde claro.</para>
 
 <sect2 id="wait">
-<title
->Fazer a tartaruga esperar</title>
-<para
->Se já tentou programar um pouco no &kturtle;, você já poderá ter reparado que a tartaruga pode ser bastante rápida a desenhar. Este comando faz a tartaruga andar um pouco mais devagar.</para>
+<title>Fazer a tartaruga esperar</title>
+<para>Se já tentou programar um pouco no &kturtle;, você já poderá ter reparado que a tartaruga pode ser bastante rápida a desenhar. Este comando faz a tartaruga andar um pouco mais devagar.</para>
   <variablelist>
     <varlistentry>
-      <term
->wait</term>
-      <listitem
-><para
-><screen
->wait X</screen>
-O <userinput
->wait</userinput
-> faz a tartaruga esperar X segundos. <screen>
+      <term>wait</term>
+      <listitem><para><screen>wait X</screen>
+O <userinput>wait</userinput> faz a tartaruga esperar X segundos. <screen>
 repeat 36 [
   forward 5
   turnright 10
   wait 0.5
 ]
-</screen
-> Este código irá desenhar uma circunferência, mas a tartaruga irá esperar meio segundo a cada passo. Isto dá a noção de uma tartaruga vagarosa.</para
-></listitem>
+</screen> Este código irá desenhar uma circunferência, mas a tartaruga irá esperar meio segundo a cada passo. Isto dá a noção de uma tartaruga vagarosa.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="if">
-<title
->Executar o "if"</title>
+<title>Executar o "if"</title>
   <variablelist>
     <varlistentry>
-      <term
->if</term>
-      <listitem
-><para
-><screen
->if <link linkend="questions"
->pergunta</link
-> [ ... ]</screen>
-O código que é colocado no <quote
->...</quote
-> só será executado se (<userinput
->if</userinput
->) a resposta à <link linkend="questions"
->pergunta</link
-> for <quote
->true</quote
-> (verdadeira). Por favor leia, para obter mais informações sobre perguntas, a <link linkend="questions"
->secção de perguntas</link
->. <screen>
+      <term>if</term>
+      <listitem><para><screen>if <link linkend="questions">pergunta</link> [ ... ]</screen>
+O código que é colocado no <quote>...</quote> só será executado se (<userinput>if</userinput>) a resposta à <link linkend="questions">pergunta</link> for <quote>true</quote> (verdadeira). Por favor leia, para obter mais informações sobre perguntas, a <link linkend="questions">secção de perguntas</link>. <screen>
 x = 6
 if x &gt; 5 [
   print "O x é maior que cinco!"
 ]
-</screen
-> Na primeira linha, o <userinput
->x</userinput
-> é inicializado a 6. Na segunda linha, a <link linkend="questions"
->pergunta</link
-> <userinput
->x &gt; 5</userinput
-> é feita. Dado que a resposta a esta pergunta é verdadeira, o controlador de execução <userinput
->if</userinput
-> irá permitir que o código entre parêntesis rectos seja executado</para
-></listitem>
+</screen> Na primeira linha, o <userinput>x</userinput> é inicializado a 6. Na segunda linha, a <link linkend="questions">pergunta</link> <userinput>x &gt; 5</userinput> é feita. Dado que a resposta a esta pergunta é verdadeira, o controlador de execução <userinput>if</userinput> irá permitir que o código entre parêntesis rectos seja executado</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="while">
-<title
->O ciclo "while"</title>
+<title>O ciclo "while"</title>
   <variablelist>
     <varlistentry>
-      <term
->while</term>
-      <listitem
-><para
-><screen
->while <link linkend="questions"
->pergunta</link
-> [ ... ]</screen>
-O controlador de execução <userinput
->while</userinput
-> é um pouco como o <link linkend="if"
-><userinput
->if</userinput
-></link
->. A diferença é que o <userinput
->while</userinput
-> continua a repetir o código entre parêntesis até que a resposta à <link linkend="questions"
->pergunta</link
-> seja <quote
->false</quote
-> (falsa). <screen>
+      <term>while</term>
+      <listitem><para><screen>while <link linkend="questions">pergunta</link> [ ... ]</screen>
+O controlador de execução <userinput>while</userinput> é um pouco como o <link linkend="if"><userinput>if</userinput></link>. A diferença é que o <userinput>while</userinput> continua a repetir o código entre parêntesis até que a resposta à <link linkend="questions">pergunta</link> seja <quote>false</quote> (falsa). <screen>
 x = 1
 while x &lt; 5 [
   forward 10
   wait 1
   x = x + 1
 ]
-</screen
-> Na primeira linha, o <userinput
->x</userinput
-> fica igual a 1. Na segunda, a <link linkend="questions"
->pergunta</link
-> <userinput
->x &lt; 5</userinput
-> é feita. Dado que a resposta a esta pergunta é <quote
->true</quote
-> (verdadeira), o controlador de execução <userinput
->while</userinput
-> começa a execução do código entre parêntesis até que a resposta à <link linkend="questions"
->pergunta</link
-> seja <quote
->false</quote
-> (falsa). Neste caso, o código entre parêntesis será executado 4 vezes, dado que, de cada vez que a quinta linha é executada, o <userinput
->x</userinput
-> fica um número acima.</para
-></listitem>
+</screen> Na primeira linha, o <userinput>x</userinput> fica igual a 1. Na segunda, a <link linkend="questions">pergunta</link> <userinput>x &lt; 5</userinput> é feita. Dado que a resposta a esta pergunta é <quote>true</quote> (verdadeira), o controlador de execução <userinput>while</userinput> começa a execução do código entre parêntesis até que a resposta à <link linkend="questions">pergunta</link> seja <quote>false</quote> (falsa). Neste caso, o código entre parêntesis será executado 4 vezes, dado que, de cada vez que a quinta linha é executada, o <userinput>x</userinput> fica um número acima.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="else">
-<title
->Se não, por outras palavras: "else"</title>
+<title>Se não, por outras palavras: "else"</title>
   <variablelist>
     <varlistentry>
-      <term
->else</term>
-      <listitem
-><para
-><screen
->if pergunta [ ... ] else [ ... ]</screen>
-O <userinput
->else</userinput
-> pode ser usado para além do controlador de execução <link linkend="if"
-><userinput
->if</userinput
-></link
->. O código entre parêntesis a seguir ao <userinput
->else</userinput
-> só é executado se a resposta à <link linkend="questions"
->pergunta</link
-> que é feita for <quote
->false</quote
-> (falsa). <screen>
+      <term>else</term>
+      <listitem><para><screen>if pergunta [ ... ] else [ ... ]</screen>
+O <userinput>else</userinput> pode ser usado para além do controlador de execução <link linkend="if"><userinput>if</userinput></link>. O código entre parêntesis a seguir ao <userinput>else</userinput> só é executado se a resposta à <link linkend="questions">pergunta</link> que é feita for <quote>false</quote> (falsa). <screen>
 x = 4
 if x &gt; 5 [
   print "O x é maior que cinco!"
 ] else [
   print "O x é menor que seis!"
 ]
-</screen
-> A <link linkend="questions"
->pergunta</link
-> testa se o <userinput
->x</userinput
-> é maior que 5. Dado que o <userinput
->x</userinput
-> fica igual a 4 na primeira linha, a resposta à pergunta é <quote
->false</quote
-> (falsa). Isto significa que o código entre parêntesis a seguir ao <userinput
->else</userinput
-> é executado.</para
-></listitem>
+</screen> A <link linkend="questions">pergunta</link> testa se o <userinput>x</userinput> é maior que 5. Dado que o <userinput>x</userinput> fica igual a 4 na primeira linha, a resposta à pergunta é <quote>false</quote> (falsa). Isto significa que o código entre parêntesis a seguir ao <userinput>else</userinput> é executado.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="for">
-<title
->O ciclo "for", um ciclo de contagem</title>
+<title>O ciclo "for", um ciclo de contagem</title>
   <variablelist>
     <varlistentry>
-      <term
->for</term>
-      <listitem
-><para
-><screen
->for <userinput
->ponto inicial</userinput
-> a <userinput
->ponto final</userinput
-> [ ... ]</screen>
-O ciclo <userinput
->for</userinput
-> é um <quote
->ciclo de contagem</quote
->, ou seja, faz de contador para si. <screen>
+      <term>for</term>
+      <listitem><para><screen>for <userinput>ponto inicial</userinput> a <userinput>ponto final</userinput> [ ... ]</screen>
+O ciclo <userinput>for</userinput> é um <quote>ciclo de contagem</quote>, ou seja, faz de contador para si. <screen>
 for x = 1 to 10 [
   print x * 7
   forward 15
 ]
-</screen
-> De cada vez que o código entre parêntesis é executado, o <userinput
->x</userinput
-> é incrementado de uma unidade, até que o valor do <userinput
->x</userinput
-> chegue a 10. O código entre parêntesis imprime o valor de <userinput
->x</userinput
-> multiplicado por 7. Depois de este programa terminar a sua execução, você irá ver a tabuada dos 7 na área de desenho.</para
-></listitem>
+</screen> De cada vez que o código entre parêntesis é executado, o <userinput>x</userinput> é incrementado de uma unidade, até que o valor do <userinput>x</userinput> chegue a 10. O código entre parêntesis imprime o valor de <userinput>x</userinput> multiplicado por 7. Depois de este programa terminar a sua execução, você irá ver a tabuada dos 7 na área de desenho.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
@@ -1656,39 +705,15 @@ for x = 1 to 10 [
 
 
 <sect1 id="learn">
-<title
->Crie os seus próprios comandos com o <quote
->learn</quote
-></title>
-<para
->O <userinput
->learn</userinput
-> é um comando muito especial, porque é usado para criar os seus próprios comandos. O comando que criar poderá receber <glossterm linkend="input-output"
->parâmetros</glossterm
-> e devolver <glossterm linkend="input-output"
->resultados</glossterm
->. Vamos ver como é que é criado um novo comando. <screen>
+<title>Crie os seus próprios comandos com o <quote>learn</quote></title>
+<para>O <userinput>learn</userinput> é um comando muito especial, porque é usado para criar os seus próprios comandos. O comando que criar poderá receber <glossterm linkend="input-output">parâmetros</glossterm> e devolver <glossterm linkend="input-output">resultados</glossterm>. Vamos ver como é que é criado um novo comando. <screen>
 learn circunferencia x [
   repeat 36 [
     forward x
     turnleft 10
   ]
 ]
-</screen
-> O novo comando chama-se <userinput
->circunferencia</userinput
->. O <userinput
->circunferencia</userinput
-> recebe um <glossterm linkend="input-output"
->parâmetro</glossterm
->, um número, para definir o tamanho da circunferência. O <userinput
->circunferencia</userinput
-> não devolve nenhum <glossterm linkend="input-output"
->resultado</glossterm
->. O comando <userinput
->circunferencia</userinput
-> pode agora ser usado como um comando normal. Veja este exemplo: <screen
->learn circunferencia X [
+</screen> O novo comando chama-se <userinput>circunferencia</userinput>. O <userinput>circunferencia</userinput> recebe um <glossterm linkend="input-output">parâmetro</glossterm>, um número, para definir o tamanho da circunferência. O <userinput>circunferencia</userinput> não devolve nenhum <glossterm linkend="input-output">resultado</glossterm>. O comando <userinput>circunferencia</userinput> pode agora ser usado como um comando normal. Veja este exemplo: <screen>learn circunferencia X [
   repeat 36 [
     forward X
     turnleft 10
@@ -1702,8 +727,7 @@ go 40,40
 circunferencia 50  
 </screen>
 </para>
-<para
->No próximo exemplo, vai ser criado um comando com um valor de resultado devolvido. <screen>
+<para>No próximo exemplo, vai ser criado um comando com um valor de resultado devolvido. <screen>
 learn multiplicarPeloProprio n [
   r = n * 1
   r = n * n
@@ -1711,14 +735,7 @@ learn multiplicarPeloProprio n [
 ]
 i = inputwindow "Por favor indique um número e carregue em OK"
 print "O " + i + " multiplicado por ele próprio é igual a: " + multiplicarPeloProprio i
-</screen
-> Neste exemplo, existe agora um comando novo chamado <userinput
->multiplicarPeloProprio</userinput
->. O parâmetro deste comando é multiplicado por ele próprio e é então devolvido, usando o comando <anchor id="return"/><userinput
->return</userinput
->. O comando <userinput
->return</userinput
-> é a forma de devolver um resultado de uma função criada. </para>
+</screen> Neste exemplo, existe agora um comando novo chamado <userinput>multiplicarPeloProprio</userinput>. O parâmetro deste comando é multiplicado por ele próprio e é então devolvido, usando o comando <anchor id="return"/><userinput>return</userinput>. O comando <userinput>return</userinput> é a forma de devolver um resultado de uma função criada. </para>
 </sect1>
 
 </chapter>