...

A estrutura básica é formada por um bloco de comentários, com um identificador especial no seu início (/*/{Protheus.doc}), seguido de um comentário sucinto, seguido ou não por marcadores especiais. Algo semelhante a:

/*/{Protheus.doc} areaQuad

Efetua o cálculo da área de alguns quadriláteros.

@author José Silva

@since 20/11/2012

@version P10 R4

@param nBase, numérico, Medida do lado ou da base

@param [nAltura], numérico, Medida da altura

@param [nBaseMenor], numérico, Medida da base menor (trapézios)

@return numérico, Área calculada

/*/

User Function areaQuad(nBase, nAltura, nBaseMenor)

...

Uso

Adicione um bloco de comentário do ProtheusDOC no elemento que você deseja descrever em seu programa-fonte.

...

Em seguida, para iniciar o assistente de geração do ProtheusDOC, clique em “Arquivo” > “Novo” > “Outras...”. Expanda a seção “TOTVS Tools”, escolha a opção “ProtheusDoc Generator” e clique em “Avançar >” (Next >).

Localize e selecione o programa-fonte que será documentado em seguida clique em “Avançar >” (Next >).

Clique em “Concluir” (Finish) para gerar a documentação utilizando o template padrão e o local padrão de exportação (C:\export).

Localize a pasta de exportação. Ela apresentará a mesma estrutura do projeto onde o programa-fonte está localizado.

...

Caso deseje, você pode criar um template customizado adicionando, removendo e/ou alterando a estrutura utilizando o modelo do Velocity.

*IMPORTANTE* O arquivo do template deve estar com o encoding UTF-8.

Ao gerar a nova documentação, selecione o template customizado e/ou defina um local alternativo para a exportação da documentação.

...