Ubuntu 및 기타 GNU Linux 배포판과 같은 비BSD 시스템에서 일반적으로 사용할 수 있는 BSD 맨페이지를 만드는 데 일반적으로 사용되는 MDoc 매크로가 있습니까? 크로스 플랫폼 문서를 작성할 때 맨페이지를 디자인하는 데 이를 사용하는 것이 안전한가요?
답변1
이 매크로는 문제없이 사용하실 수 있을 것 같습니다.
나는 세 가지 샘플 운영 체제인 ubuntu 14.04, debian 7.8, fedora 21을 살펴보았는데 모두 groff 패키지를 사용하여 mandoc 매크로를 포함하고(mandoc 명령은 아님) 이에 대한 매뉴얼 페이지를 제공합니다: mdoc(7).
다음 매크로를 사용하여 실제로 매뉴얼 페이지가 설치되었는지 확인했습니다.
find /usr/share/man/man1/ -type f |
while read f;do if gzip -d <$f | fgrep '.Dd'; then echo $f; fi; done
그리고 ftp(1), ssh-agent(1), ncal(1)과 같은 여러 파일을 찾았습니다. 이 명령을 시도했는데 man
올바르게 표시되었습니다.
그러므로 대부분의 시스템은 groff가 설치되어 있으면 이 매뉴얼 페이지를 읽을 수 있습니다. 내가 사용해 볼 수 있는 Mac OSX를 가지고 있는 사람이 있나요?
답변2
일반적인 UNIX 시스템은 mdoc 매크로를 지원하지 않으므로 이식 가능한 매뉴얼 페이지 작성을 선호한다면 mdoc를 사용하지 마십시오.