POSIX 도구를 참조할 때 매뉴얼 페이지 섹션 번호를 추가하는 것이 좋은 습관입니까? [폐쇄]

POSIX 도구를 참조할 때 매뉴얼 페이지 섹션 번호를 추가하는 것이 좋은 습관입니까? [폐쇄]

ls나는 때때로 stackexchange 및 Comment에 대한 이 답변과 같이 맨 페이지 자체가 ls(1)산문/텍스트( ls 의 경우)에서 수행하는 것처럼 맨 페이지 섹션 번호를 괄호 안에 추가하는 것과 같은 도구를 언급하는 사람들을 봅니다 . 이것이 좋은 습관입니까? 이 관행에 대한 출처가 있습니까? 대기업, 메일링 리스트 등과 같이 이 작업을 수행하는 평판이 좋은 "단체"가 있습니까?

답변1

어떤 경우에는 단일 이름이 여러 맨페이지를 참조할 때 모호성을 피하는 데 도움이 됩니다.

예를 들어 unlink매뉴얼 페이지는 세 개의 섹션으로 구분됩니다.

  1. unlink(1)은 사용자 수준 명령을 설명합니다.
  2. unlink(2)는 연결 해제 기능을 구현하는 커널 수준 시스템 호출을 설명합니다.
  3. unlink(3p)는 시스템 호출을 래핑하는 라이브러리 함수를 설명합니다. 이 페이지는 POSIX 프로그래머 매뉴얼의 일부입니다.

특정 상황에서 참조하려는 섹션을 명확히 하려면 섹션 번호를 지정하는 것이 도움이 됩니다.

이 명령이 질문에 언급되어 있으므로 이 명령에 대한 두 개의 맨페이지( 로컬 구현 및 POSIX 정의) ls가 있습니다 . 이 경우 섹션 번호를 지정하는 것이 유용할 수 있습니다.ls(1)ls(1p)

명시적인 맨페이지의 경우 섹션 번호는 많은 가치를 추가하지 않습니다. 예: 1) fstab, 다섯 번째 섹션 아래에 페이지가 있습니다. 2) cron, 여덟 번째 섹션 아래에 페이지가 있습니다.

위에 언급된 모든 맨페이지는 여기에 나열되어 있습니다.https://www.man7.org/linux/man-pages/dir_all_alphabetic.html

관련 정보