☰

매뉴얼 페이지 그룹화 설명은 어디에 정의되어 있습니까?

tag-icon • tag-icon man
매뉴얼 페이지 그룹화 설명은 어디에 정의되어 있습니까?

"그룹 설명"이 이를 호출하는 올바른 방법인지는 확실하지 않지만 매뉴얼 페이지의 첫 번째 줄이 일반적으로 어디에 정의되어 있는지 궁금합니다. 이러한 설명의 대부분은 하나의 프로그램에만 국한되지 않습니다. 예를 들어 Slackware에서는 다음과 같습니다.

man rpc

인쇄:

RPC(3) BSD 라이브러리 기능 매뉴얼 RPC(3)

이름
     rpc — 원격 프로시저 호출을 위한 라이브러리 루틴

요약
    ...

매뉴얼 페이지에서 "BSD Library Functions Manual"이라는 설명은 어디에 정의되어 있습니까? 나는 이 패키지의 전체 소스 코드와 매뉴얼 페이지를 재귀적으로 검색했지만 아무것도 찾지 못했습니다.

답변1

rpc(3)의 헤더는 .Dt제목 매크로로 정의됩니다:

$ zcat  $(man -w 3 rpc) | head
.\" @(#)rpc.3n 1.31 93/08/31 SMI; from SVr4
.\" Copyright 1989 AT&T
.Dd May 7, 1993
.Dt RPC 3
.Os
.Sh NAME
.Nm rpc
.Nd library routines for remote procedure calls
.Sh SYNOPSIS
.In rpc/rpc.h

이에 대한 내용은 다음에서 읽을 수 있습니다 man 7 groff_mdoc.

TITLE MACROS
     The title macros are part of the page structure domain but are presented
     first and separately for someone who wishes to start writing a man page
     yesterday.  Three header macros designate the document title or manual
     page title, the operating system, and the date of authorship.  These
     macros are called once at the very beginning of the document and are used
     to construct headers and footers only.

 .Dt [⟨document title⟩] [⟨section number⟩] [⟨volume⟩]
         The document title is the subject of the man page and must be in
         CAPITALS due to troff limitations.  If omitted, ‘UNTITLED’ is
         used.  The section number may be a number in the range 1, ..., 9
         or ‘unass’, ‘draft’, or ‘paper’.  If it is specified, and no vol‐
         ume name is given, a default volume name is used.

         Under BSD, the following sections are defined:

         1   BSD General Commands Manual
         2   BSD System Calls Manual
         3   BSD Library Functions Manual
         4   BSD Kernel Interfaces Manual
         5   BSD File Formats Manual
         6   BSD Games Manual
         7   BSD Miscellaneous Information Manual
         8   BSD System Manager's Manual
         9   BSD Kernel Developer's Manual

예를 들어, 다음과 같이 변경하면 다음과 같은 결과가 .Dt RPC 9나타납니다.

RPC(9)   BSD Kernel Developer's Manual   RPC(9)

관련 정보