[GUFSC] Re: [GUFSC] Construção de man pages

[Rafael R Obelheiro]

Caro,

On Wed, Nov 13, 2002 at 02:23:47PM -0200, Eder Mateus Nunes Goncalves wrote:
> 
> Existe alguma ferramenta que auxilie na construção de man pages, ou estas
> são construídas diretamente via algum editor de texto qualquer? Pergunto
> isto por que uma man page tem uma formatação específica, o que acredito
> seja criado por algum tipo de ferramenta.

Paginas de manual sao fontes troff (um tipo de linguagem de formatacao
de textos, como TeX) que usam os conjuntos de macros `an' ou `doc'.
Embora possam existir ferramentas que auxiliem na sua elaboracao (eu,
particularmente, nao conheco nenhuma), elas podem ser criadas com um
editor de textos qualquer, bastando conhecer um dos conjuntos de
macros citados.

Existe um mini-HOWTO que explica como escrever uma boa pagina de manual
em http://www.tldp.org/HOWTO/mini/Man-Page.html. Este documento contem 
tambem outros ponteiros uteis sobre troff.

Um abraco,
Rafael.