mdoc 맨페이지의 섹션은 무엇을 참조합니까?

mdoc 맨페이지의 섹션은 무엇을 참조합니까?

그래서 저는 프로젝트의 맨페이지를 작성하려고 생각하다가 마침내 이것을 발견했습니다.mdoc 매뉴얼 페이지. 무엇보다도 다음을 포함하여 맨페이지의 일반적인 레이아웃을 설명합니다.

   .\" .Sh CONTEXT
   .\" For section 9 functions only.
   .\" .Sh IMPLEMENTATION NOTES
   .\" Not used in OpenBSD.
   .\" .Sh RETURN VALUES
   .\" For sections 2, 3, and 9 function return values only.
   .\" .Sh ENVIRONMENT
   .\" For sections 1, 6, 7, and 8 only.

그런데 이 1, 6, 7, 8절이 실제로 무엇을 가리키는지 이해할 수 없습니까? 내 추측으로는 매뉴얼의 페이지(예: 시스템 호출의 2페이지)인 것 같은데, 별로 의미가 없습니다. 왜 1페이지의 반환 값이 아닌가요?

답변1

참조된 매뉴얼 페이지가 실제로 어떻게 보이는지 확인하십시오.문서(7). 이는 맨 페이지 컬렉션의 섹션 7에서 가져온 것임을 의미합니다."다양한 종류". 모든 매뉴얼 페이지가 전체 책인 경우 이러한 섹션은 장으로 간주됩니다.

RETURN VALUES이는 섹션 2, 3 또는 9에 배치할 매뉴얼 페이지를 작성 중인지 확인해야 함을 의미합니다 .

일반적인 명령은 섹션 1에서 찾을 수 있습니다.LS(1)그리고뒤(1)(둘 다 운영 체제와 함께 제공됩니다). 그러나 외부 프로젝트는 일반적으로 동일한 매핑을 사용합니다.포스트그레스(1)그리고MySQL(1). 후자는 관련 페이지를 참조하지 않기 때문에 매뉴얼 페이지의 덜 좋은 예입니다. 그러면 결국 온라인에서 검색하게 됩니다.페이지. 그런 사람이 되지 마세요!

바라보다섹션 13.2.범주에 대한 열거입니다.

전체 (그리고 간략함)13장 매뉴얼 페이지매뉴얼 페이지 대신에 더 고급 소개가 제공될 수도 있습니다.

사람들이 자주 놓치는 또 다른 고급 페이지는소개(7). 내 생각엔 이게 책의 첫 페이지인 것 같아사람들은 "책". 각 부분에는소개하다각 섹션을 설명하는 페이지:

숫자 카테고리

  1. 일반적인 명령
  2. 시스템 호출
  3. 라이브러리 기능
  4. 커널 인터페이스
  5. 파일 형식
  6. 게임
  7. 다양한 종류
  8. 시스템 관리자
  9. 커널 개발자

관련 정보