5.4.3 Conversion Options

Timeout (s)

Especifica o tempo (em segundos) máximo que o DMHelp ficará convertendo seu arquivo de entrada.

Este parâmetro é útil caso você especifique, erradamente, macros ou includes "cíclicos" o que deixaria o DMHelp em loop.

O valor default é 20 segundos.

No entanto, caso você processe manuais muito grandes pode aumentar o quanto desejar este valor pois, mesmo se, por uma eventual configuarção errada do seu manual, o DMHelp entrar em loop, ainda assim, a conversão poderá ser encerrada pela tecla Esc (escape).

Importante: o Timeout só se aplica na leitura e interpretação dos arquivos fontes e não se aplica na geração dos arquivos de saída e, também não se aplica no Spell Check. Isto é assim porque apenas na leitura e interpretação dos seus arquivos é que o Loop pode ocorrer. Assim sendo, mesmo o valor default sendo 20 segundos o tempo total de conversão pode ser maior.

Check Box: Show Gauge

Indica se será exibido o Gauge que indica que o programa está processando.

A não exibição do Gauge torna a conversão ligeiramente mais rápida, mas, após conversões observadas no mundo inteiro, não se obteve uma redução significativa do tempo de conversão.

Procure sempre utilizar a exibição do Gauge, pois torna a conversão mais "confortável" (visualmente).

Warnings

Existem mensagens de Warnings (que não são necessariamente erros) que você pode habilitar ou não de acordo com a sua conveniência.

Check Box: Auto Define Field Kind AP

Se estiver habilitada será gerada uma mensagem de Warning sempre que você especificar o comando <FI [atributos]> (FI), e especificar o atributo to Apply in RTF, ou to Apply in HTML Single Page, ou ainda to Apply in HTML Multi Page sem antes especificar Field Kind = AP. ou seja, se esta opção estiver setada, por exemplo:

<FI APH={Teste}>

gerará uma mensagem de Warning, pois o certo seria:

<FI K=AP APH={Teste}>

Check Box: Auto Define Field Kind DT

Se estiver habilitada será gerada uma mensagem de Warning sempre que você especificar o comando <FI [atributos]> (FI), e especificar o atributo Date Time Format sem antes especificar Field Kind = DT. ou seja, se esta opção estiver setada, por exemplo:

<FI DTFM={%dd}>

gerará uma mensagem de Warning, pois o certo seria:

<FI K=DT DTFM={%dd}>

Check Box: Auto Define Field Kind IM

Se estiver habilitada será gerada uma mensagem de Warning sempre que você especificar o comando <FI [atributos]> (FI), e especificar o atributo Image File Name sem antes especificar Field Kind = IM. ou seja, se esta opção estiver setada, por exemplo:

<FI IMFM={MyImage.jpg}>

gerará uma mensagem de Warning, pois o certo seria:

<FI K=IM IMFM={MyImage.jpg}>

Check Box: Macros Redefinition

Se esta opção estiver setada será gerada uma mensagem de Warning sempre que uma macro for definida com um nome de uma macro já previamente definida.

Isto em si não é um erro, pois você pode definir uma macro qualquer, utilizá-la normalmente, e, a partir de determinado ponto de seu documento definir outra macro, mas com mesmo nome. Neste caso, a partir desse ponto, todas as aplicações da macro com esse nome utilizarão a última definição sendo a primeira "descartada" (ficando aplicadas, no entanto, nos locais onde fora previamente utilizada).

Por via das dúvidas não se recomenda a redefinição de macros com mesmo nome.

Check Box: Unused Macros

Quando esta opção é setada, ao final de uma conversão serão exibidas as macros definidas mas não utilizadas.

Isto não é um erro, pois é muito comum a construção de "bancos de dados" de macros onde você utiliza apenas as macros necessárias no seu documento.

De qualquer maneira este parâmetro ajuda você a observar o "estado de utilização" das macros definidas, no seu documento.