Como compilar arquivos manuais .1

Question

Eu tenho arquivos .c, .h e .1, como posso compilá-los juntos em um arquivo executável. Tudo claro com arquivos .c e .h, mas eu também tenho .1 como eu posso ver no conteúdo que é usado para manual, como pode vinculá-los com o programa?

    

Answer 1

I have also .1 as I can see from the content it is used for manual

Sim, estas estão escritas na marcação groff . Eles não são compilados, eles são interpretados em tempo de execução via man ou algum outro visualizador (usando groff como backend).

O .1 na verdade denota a seção manual (consulte man man ). Quando um executável é instalado em um elemento do caminho do executável do sistema (por exemplo, /usr/bin ), a página do manual correspondente também é geralmente instalada em um subdiretório de, por exemplo, /usr/share/man . Freqüentemente eles são comprimidos também (então foobar.1.gz ).

man systems mantêm um cache e fazem alguma indexação do conteúdo (por apropos , etc.), mas como isso é invocado difere entre as implementações. Tradicionalmente, o comando de atualização era makewhatis , mas o sistema mais recente de mandb usa mandb . As distribuições geralmente configuram isso para executar em intervalos regulares via cron , em vez de fazê-lo como parte da instalação, pois pode consumir um pouco de tempo.