LaTeX.net.br > LaTeX FAQ > Os prazeres dos erros do TeX > 417 Como lidar com erros

417 Como lidar com erros

Já que o TeX é um processador de macros, suas mensagens de erro tendem a ser difíceis de entender; essa é uma (aparentemente invariável) propriedade de processadores de macros. Knuth fala sobre esse problema no TeXbook, sugerindo que você adquira as habilidades investigativas de um Sherlock Holmes dos dias atuais; apesar de essa abordagem ter um certo charme, ela não é boa para o usuário de ‘produção’ do (La)TeX. Esta resposta (proveniente, em parte, de um artigo de Sebastian Rahtz no TUGboat 16(4)) oferece direcionamentos gerais para lidar com relatórios de erro do TeX, e outras respostas desta seção falam sobre como lidar com erros comuns (mas desconcertantes) que você pode encontrar. Há uma longa lista de “dicas” no artigo de Sebastian, incluindo as seguintes:

Olhe para os erros do TeX; as mensagens podem parecer complicadas à primeira vista, mas, muitas vezes, elas contêm pistas diretas para o problema. Veja A estrutura das mensagens de erro A estrutura das mensagens de erro para obter detalhes.
Leia o arquivo log; ele contém dicas para dicas de coisas que talvez você não entenda, coisas que, muitas vezes, nem apareceram como mensagens de erro.
Atente-se ao quanto de contexto o TeX te dá. As mensagens de erro dão alguns trechos de código TeX (ou do próprio documento) que mostram realmente onde o erro “ocorreu”; é possível controlar quanto desse ‘contexto’ o TeX te dá. O LaTeX (hoje em dia) instrui o TeX a só te dar uma linha de contexto, mas você pode mudar isso dizendo
```
\setcounter{errorcontextlines}{999}
```
no preâmbulo do seu documento. (Se você não for um programador de macro confiante, não se envergonhe de diminuir um pouco o 999; alguns erros prosseguem indefinidamente, e encontrar a diferença entre aquelas linhas pode ser um grande desafio.)
Como último recurso, ‘tracing’ (rastrear) pode ser um método útil; ler um ‘trace’ (rastreio) do (La)TeX inteiro requer bastante disposição, mas, depois que você aprende, o rastreamento pode te levar rapidamente à origem do problema. Você precisa ler o TeXbook (veja Livros sobre TeX) com muita atenção para entender o rastreamento.
O comando \tracingall atribui o valor máximo de tracing; também configura a saída para ir até o terminal interativo, o que é uma faca de dois gumes (já que a saída tende a ser muito vasta —todos os rastreamentos mais simples são mais bem examinados em um editor de texto após o evento). O pacote trace (distribuído, a princípio, com o lançamento de 2001 do LaTeX) dispõe de um rastreio mais gerenciável. Seu comando \traceon dá o que o \tracingall oferece, mas suprime o rastreamento de partes prolixas do próprio LaTeX O pacote também dispõe de um comando \traceoff (não existe comando "off" para \tracingall) e uma opção de pacote (logonly), que permite que você restrinja a saída ao terminal.

O melhor conselho para quem está diante de um erro do TeX é não entrar em pânico: a maioria dos erros comuns estará exposta quando você for à linha de origem que o TeX recomendar. Se essa abordagem não funcionar, as respostas restantes desta seção lidam com alguns dos erros mais estranhos que você pode encontrar. Geralmente, você não precisará apelar para o grande público para conseguir ajuda, mas, se você apelar, não se esqueça de reportar todo o histórico (veja errorcontextlines, acima) e assim em diante.

trace.sty: Distributed as part of 2etools

This answer last edited: 2011-06-01

This question on the Web: http://latex.net.br/faq/FAQ-erroradvice.html

Do you have any question? Ask on: latex.net.br - we love qood questions!