Por padrão, a macro mdoc está disponível em sistemas não-BSD?

Question

São as macros MDoc, comumente usadas para criar manpages BSD, comumente disponíveis em sistemas não-BSD (como o Ubuntu e outras distribuições GNU Linux)? É seguro projetar manpages usando-os ao escrever documentação multiplataforma?

    

Answer 1

Eu acho que você provavelmente pode usar essas macros sem problemas.

Eu olhei em 3 exemplos de SO's: ubuntu 14.04, debian 7.8, fedora 21, e eles todos usam o pacote groff para incluir as macros mandoc (embora não o comando mandoc) e fornecer uma página man sobre eles: mdoc (7).

Eu verifiquei se havia páginas de manual instaladas usando essas macros com:

find /usr/share/man/man1/ -type f |
while read f;do if gzip -d <$f | fgrep '.Dd'; then echo $f; fi; done

e encontrou vários arquivos, por exemplo, ftp (1), ssh-agent (1), ncal (1). Eu tentei o man comando sobre estes, e eles apareceram corretamente.

Portanto, se a maioria dos sistemas tiver o groff instalado, eles poderão ler essas páginas man. Alguém tem um mac osx para experimentar?

    

Answer 2

Um sistema UNIX típico não suporta as macros mdoc e se você gosta de escrever man pages portáveis, não use mdoc.