UNIX 매뉴얼 페이지에 "하위 섹션"을 추가하기 위한 준표준이 있습니까?

UNIX 매뉴얼 페이지에 "하위 섹션"을 추가하기 위한 준표준이 있습니까?

알고 싶습니다. 매크로 패키지를 사용하여 UNIX 매뉴얼 페이지를 작성하는 방법에는 (장 제목)과 (섹션)이 man있습니다 . 하지만 "하위 섹션"을 갖고 싶다면 어떻게 해야 할까요?.SH.SS

그런 기준이 있나요? 일부 페이지에서 (적어도 troff) 의 글꼴 크기를 수정하는 것을 본 것 같지만 .SS실제로 일부 (준) 표준이 있는지 궁금합니다.

답변1

나는 짧은 대답이 "아니요"라고 믿습니다. 매뉴얼 페이지에는 하위 섹션에 대한 표준이 없습니다.

이 문제는 작년 9월에 발생했습니다.메일링 linux-man리스트, 많은 자료가 선별되어 있지만 man그렇게 하는 데 허용되는 관용구를 아는 사람은 아무도 없습니다.

제가 강조하고 싶은 점은 "필요하다면매뉴얼 페이지, [그러면] 전체 페이지에 대한 토론 수준이 너무 개략적입니다. "맨 페이지를 여러 문서로 나누는 것을 금지하는 법은 없습니다. 이것이 groff와 Perl이 하는 일입니다.

심지어원본 man매크로 패키지의 매뉴얼 페이지(1979)심지어 분할된 매크로를 기록하지 않은 채 문 밖으로 나갔습니다 SS.

나에게 있어서 이러한 (의도적인?) 감독은 "간결한" 문서라는 매뉴얼 페이지의 원래 개념과 일치하는 것 같습니다.

만약 당신이 이것을 해야만 한다면, 나는 당신만의 매크로를 작성하거나 TP스레드에서 논의된 것처럼 그것을 남용하지 않을 것입니다 linux-man. 아마도 "가져오기 헤더"를 사용할 것입니다. 즉, 제목으로 시작하는 단락을 이탤릭체나 굵은 글씨로 표시합니다.

.P
.B Error handling.
The Z language does not support an exception mechanism.
Therefore you have to check return values at every point blah blah blah

답변2

Perl의 POD 문서 형식 은 다양한 형식으로 변환될 수 있으며 pod2man.Pod::Man

  • =head1로 번역 .SH, 사용.IX Header "...."
  • =head2로 번역 .SS, 사용.IX Subsection "...."
  • =head3다음을 사용하여 기울임꼴 글꼴로 번역됩니다..IX Subsection "...."
  • =head4다음을 사용하여 일반 텍스트로 변환됩니다..IX Subsection "...."

=head3and 의 제목 텍스트 는 다음과 같이 =head4s로 둘러싸여 있습니다 ..PP

.PP
title text
.IX Subsection "title text"
.PP

관련 정보