.\" Man page for apropos .\" .\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.) .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH APROPOS 1 2024-04-05 2.12.1 "설명서 페이저 유틸리티" .SH 이름 apropos \- 설명서 페이지 이름과 설명을 검색합니다 .SH 개요 \fBapropos\fP [\|\fB\-dalv?V\fP\|] [\|\fB\-e\fP\||\|\fB\-w\fP\||\|\fB\-r\fP\|] [\|\fB\-s\fP \fI목록\fP\|] [\|\fB\-m\fP \fI시스템\fP\|[\|,.\|.\|.\|]\|] [\|\fB\-M\fP \fI경로\fP\|] [\|\fB\-L\fP \fI로캘\fP\|] [\|\fB\-C\fP \fI파일\fP\|] \fI검색어\fP \&.\|.\|. .SH 설명 각 설명서 페이지에는 페이지 안에 간단한 설명이 있습니다. \fBapropos\fP은 \fI검색어\fP 처럼 설명을 검색합니다. \fI검색어\fP는 보통 (\fB\-r\fP)를 썼을 때처럼 정규 표현식이 들어가거나, 와일드카드(\fB\-w\fP) 문자가 들어가거나, 정확히 일치하는 검색어(\fB\-e\fP)가 들어갑니다. 이 옵션을 활용하면서, \fI검색어\fP에 따옴표로 둘러 쌓거나, 셸에서 특정 문자를 이스케이핑(\e)하여 해석을 막아야 할 수도 있습니다. 표준 일치 규칙에서는 페이지 이름 또는 설명서의 단어 범위내에서 일치하는 방식으로 검색할 수 있습니다. \fBapropos\fP에서 검색한 데이터베이스는 \fBmandb\fP 프로그램에서 업데이트합니다. 설치 상태에 따라 주기적 크론 작업으로 실행핧 수도 있고, 새 설명서 페이지를 설치할 때마다 직접 실행해야 할 수도 있습니다. .SH 옵션 .TP .if !'po4a'hide' .BR \-d ", " \-\-debug 디버깅 정보를 출력합니다. .TP .if !'po4a'hide' .BR \-v ", " \-\-verbose 경고 메시지를 자세하게 출력합니다. .TP .if !'po4a'hide' .BR \-r ", " \-\-regex 각 검색어를 정규 표현식으로 해석합니다. 기본 동작입니다. 각 검색어는 페이지 이름 및 설명과 개별적으로 비교합니다. 양 부분 어디와도 일치 여부를 비교할 수 있습니다. 일치 여부는 단어 범위로 제한하지 않습니다. .TP .if !'po4a'hide' .BR \-w ", " \-\-wildcard 셸 방식 와일드카드가 들어간 패턴으로 각 검색어를 해석합니다. 각 검색어를 페이지 이름과 설명에 각각 비교합니다. \fB\-\-exact\fP 옵션을 사용했다면 확장 검색어가 전체 설명 또는 페이지 이름에 일치하는 경우에만 일치 요소를 찾습니다. 이 경우가 아니라면, 검색어의 활용 범위를 설명의 단어 범위로 하여 찾을 수 있습니다. .TP .if !'po4a'hide' .BR \-e ", " \-\-exact 각 검색어는 페이지 이름과 설명에 정확히 일치해야 합니다. .TP .if !'po4a'hide' .BR \-a ", " \-\-and 지정 검색어에 모두 일치하는 항목만 표시합니다. 기본 동작은 어떤 검색어에든 일치하는 항목의 표시입니다. .TP .if !'po4a'hide' .BR \-l ", " \-\-long 터미널 폭에 맞춰 출력을 자르지 않습니다. 보통, 정돈이 제대로 안된 \fBNAME\fP 섹션의 깔끔하지 못한 출력을 다듬을 목적으로 터미널 폭으로 자릅니다. .TP \fB\-s\fP \fI목록\/\fP, \fB\-\-sections=\fP\fI목록\/\fP, \fB\-\-section=\fP\fI목록\fP 주어진 설명서 섹션에 대해서만 검색합니다. \fI목록\fP은 콜론 또는 쉼표로 구분한 섹션 목록입니다. \fI목록\fP의 항목이 "3"과 같은 단순 섹션이라면, "3", "3perl", "3x" 과 같은 식으로 설명 목록이 페이지에 들어갑니다. \fI목록\fP에 들어간 항목이 "3perl" 과 같은 확장자일 경우, 설명서 섹션의 정확한 페이지 부분만 목록에 들어갑니다. .TP \fB\-m\fP \fI시스템\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fI시스템\fP\|[\|,.\|.\|.\|] 이 시스템에서 다른 운영체제 설명서 페이지 설명에 접근한다면 이 옵션으로 검색할 수 있습니다. NewOS의 설명서 페이지의 설명을 검색하려면 \fB\-m\fP \fBNewOS\fP 옵션을 사용하십시오. \fI시스템\fP에는 쉼표로 구분한 운영 체제 이름 값으로 구성합니다. 운영 체제의 \fBwhatis\fP 자체 설명 검색 단어를 넣으려면, 인자 문자열에 시스템 이름 \fBman\fP을 넣습니다. 이 옵션은 $\fBSYSTEM\fP 환경 변수 값을 대신합니다. .TP \fB\-M\ \fP\fI경로\fP,\ \fB\-\-manpath=\fP\fI경로\fP 콜론으로 구분한 검색 대상 설명서 페이지 계층을 대신 지정합니다. 기본적으로 \fBapropos\fP은 $\fBMANPATH\fP 환경 변수가 비어있거나 설정하지 않는 한 이를 활용하는데, 비어 있거나 설정하지 않았을 경우에는 $\fBPATH\fP 환경 변수를 기반으로 적절한 맨 페이지 경로를 지정합니다. 이 옵션은 $\fBMANPATH\fP 내용을 대신합니다. .TP \fB\-L\ \fP\fI로캘\fP,\ \fB\-\-locale=\fP\fI로캘\fP \fBapropos\fP은 보통 $\fBLC_MESSAGES\fP와 $\fBLANG\fP 같은 다양한 환경 변수를 조사하는 C 함수 \fBsetlocale\fP(3)을 호출하여 현재 로캘을 결정합니다. 결정한 값을 임시로 대체 적용하려면 \fI로캘\fP 문자열을 바로 \fBapropos\fP에 전달하는 이 옵션을 사용하십시오. 참고로 페이지가 실제로 시작하는 부분을 검색하기 전까지는 아무런 영향을 주지 않습니다. 도움말 메시지와 같은 출력 결과는 항상 로캘을 초기에 결정한 다음 나타납니다. .TP \fB\-C\ \fP\fI파일\fP,\ \fB\-\-config\-file=\fP\fI파일\fP \fI\(ti/.manpath\fP 기본값 대신 사용자 설정 파일을 활용합니다. .TP .if !'po4a'hide' .BR \-? ", " \-\-help 도움말 메시지를 출력하고 나갑니다. .TP .if !'po4a'hide' .B \-\-usage 간단한 사용법 메시지를 출력하고 나갑니다. .TP .if !'po4a'hide' .BR \-V ", " \-\-version 버전 정보를 출력합니다. .SH "종료 상태" .TP .if !'po4a'hide' .B 0 프로그램 실행 성공. .TP .if !'po4a'hide' .B 1 사용법, 문법, 구성 파일 오류. .TP .if !'po4a'hide' .B 2 처리 오류. .TP .if !'po4a'hide' .B 16 지정한 단어에 일치하는 요소를 찾지 못했습니다. .SH 환경 .TP .if !'po4a'hide' .B SYSTEM $\fBSYSTEM\fP을 설정했다면, \fB\-m\fP 옵션의 인자 지정과 같이 동작합니다. .TP .if !'po4a'hide' .B MANPATH $\fBMANPATH\fP를 설정했다면, 콜론으로 구분한 설명서 페이지 검색 경로로 값을 해석합니다. 환경 변수 처리 방식의 기본 동작 및 자세한 내용은 \fBmanpath\fP(5)의 \fB검색 경로\fP 섹션을 살펴보십시오. .TP .if !'po4a'hide' .B MANWIDTH $\fBMANWIDTH\fP를 설정하면, 이 값을 터미널 폭으로 사용합니다(\fB\-\-long\fP 옵션 참조). 이 값을 설정하지 않으면 터미널 폭을 $\fBCOLUMNS\fP 값으로 계산하며, 가능하다면 \fBioctl\fP(2) 값을 활용합니다. 앞서 두가지 방식의 처리에 실패하면 80문자 폭으로 대체합니다. .TP .if !'po4a'hide' .B POSIXLY_CORRECT $\fBPOSIXLY_CORRECT\fP를 설정하면, 널 값이라 해도 기본 \fBapropos\fP 프로그램은 확장 정규 표현식(\fB\-r\fP)을 활용하여 검색합니다. 최근에는, 어쨌든지간에 기본 동작입니다. .SH 파일 .TP .if !'po4a'hide' .I /usr/share/man/index.(bt\^|\^db\^|\^dir\^|\^pag) 전통 전역 \fI색인\fP 데이터베이스 캐시입니다. .TP .if !'po4a'hide' .I /var/cache/man/index.(bt\^|\^db\^|\^dir\^|\^pag) FHS 준수 전역 \fI색인\fP 데이터베이스 캐시입니다. .TP .if !'po4a'hide' .I /usr/share/man/\|.\|.\|.\|/whatis 전통 \fBWHATIS\fP 텍스트 데이터베이스입니다. .SH "추가 참조" .if !'po4a'hide' .BR man (1), .if !'po4a'hide' .BR whatis (1), .if !'po4a'hide' .BR mandb (8) .SH 저작자 .nf .if !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .SH 버그 .if !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db