/usr/share/man/man1의 맨페이지에서 모든 명령 개요를 어떻게 올바르게 추출합니까?

Question 1

~~그냥 달리면 안 돼man foo.gz~~당신처럼 보입니다~할 수 있다실행 man foo.1.gz하지만 더 -l깨끗해 보입니다. 에서 man man:

   -l, --local-file
          Activate `local' mode.  Format and display  local  manual  files
          instead  of  searching  through  the system's manual collection.
          Each manual page argument will be interpreted as an nroff source
          file in the correct format.  No cat file is produced.  If '-' is
          listed as one of the arguments, input will be taken from  stdin.
          When  this  option  is  not used, and man fails to find the page
          required, before displaying the error message,  it  attempts  to
          act as if this option was supplied, using the name as a filename
          and looking for an exact match.

따라서 스크립트는 다음과 같아야 합니다.

#!/usr/bin/env bash
## synopses - extract all synopses in /usr/share/man/man1

## No need to cd into the directory, you can just use globs     
for i in /usr/share/man/man1/ajc*.gz; do
    ## This will print the name of the command.      
    basename "${i//.1.gz}"
    man -l "$i"  | 
       awk '/^SYNOPSIS/{a=1; getline}
            (/^[a-zA-z0-9_]/ && a==1){a=0} 
            (a==1 && /./){print}' | tr -s [:space:]

done

내가 제공하는 명령 awk은 귀하의 접근 방식(예를 들어 테스트)보다 더 잘 작동하며 man ajc이제 여러 줄 개요에서도 작동합니다. 표시되는 오류의 대부분은 관련이 없으며 다른 오류는 파일 이름을 처리하는 방식으로 인해 발생했습니다. 이것이 더 잘 작동하는지 알려주세요.

Answer

~~그냥 달리면 안 돼man foo.gz~~당신처럼 보입니다~할 수 있다실행 man foo.1.gz하지만 더 -l깨끗해 보입니다. 에서 man man:

   -l, --local-file
          Activate `local' mode.  Format and display  local  manual  files
          instead  of  searching  through  the system's manual collection.
          Each manual page argument will be interpreted as an nroff source
          file in the correct format.  No cat file is produced.  If '-' is
          listed as one of the arguments, input will be taken from  stdin.
          When  this  option  is  not used, and man fails to find the page
          required, before displaying the error message,  it  attempts  to
          act as if this option was supplied, using the name as a filename
          and looking for an exact match.

따라서 스크립트는 다음과 같아야 합니다.

#!/usr/bin/env bash
## synopses - extract all synopses in /usr/share/man/man1

## No need to cd into the directory, you can just use globs     
for i in /usr/share/man/man1/ajc*.gz; do
    ## This will print the name of the command.      
    basename "${i//.1.gz}"
    man -l "$i"  | 
       awk '/^SYNOPSIS/{a=1; getline}
            (/^[a-zA-z0-9_]/ && a==1){a=0} 
            (a==1 && /./){print}' | tr -s [:space:]

done

내가 제공하는 명령 awk은 귀하의 접근 방식(예를 들어 테스트)보다 더 잘 작동하며 man ajc이제 여러 줄 개요에서도 작동합니다. 표시되는 오류의 대부분은 관련이 없으며 다른 오류는 파일 이름을 처리하는 방식으로 인해 발생했습니다. 이것이 더 잘 작동하는지 알려주세요.

Question 2

발생한 오류는 모두 여기에서 해결됩니다.

man man

MANWIDTH- $MANWIDTH이 설정되면 해당 값은 매뉴얼 페이지의 서식을 지정하는 줄 길이로 사용됩니다. 설정되지 않은 경우 매뉴얼 페이지는 현재 터미널에 적합한 행 길이로 형식화됩니다(사용 가능한 경우 ioctl(2) 값을 사용 $COLUMNS하거나 둘 다 사용할 수 없는 경우 80자로 대체). Cat 페이지는 기본 형식을 사용할 수 있는 경우, 즉 터미널 줄 길이가 66~80자 사이인 경우에만 저장됩니다.

MAN_KEEP_FORMATTING- 일반적으로 출력이 터미널(예: 파일 또는 파이프)로 지정되지 않는 경우 특수 도구 없이 결과를 더 쉽게 읽을 수 있도록 서식 지정 문자가 삭제됩니다. 그러나 $MAN_KEEP_FORMATTING비어 있지 않은 값으로 설정되면 이러한 형식 지정 문자가 유지됩니다. 이는 서식 지정 문자를 해석할 수 있는 man 주위의 래퍼에 유용할 수 있습니다.

MAN_KEEP_STDERR- 일반적으로 출력이 터미널(일반적으로 호출기)로 전달될 때 형식화된 매뉴얼 페이지 버전을 생성하는 데 사용된 명령의 오류 출력은 호출기 표시를 방해하지 않도록 삭제됩니다. 와 같은 프로그램은 groff잘못된 정렬과 같은 인쇄상의 문제에 대해 상대적으로 사소한 오류 메시지를 생성하는 경우가 많습니다. 이러한 오류 메시지는 매뉴얼 페이지와 함께 표시될 때 보기 흉하고 일반적으로 혼란스럽습니다. 그러나 일부 사용자는 어쨌든 이를 보고 싶어하므로 $MAN_KEEP_STDERR비어 있지 않은 값으로 설정하면 오류 출력이 평소대로 표시됩니다.

이제 다른 작업을 수행하는 방법에 대해 설명합니다.

나는 이것이 당신이 원하는 것을 한다고 생각합니다.

for f in /usr/share/man/man1/*gz ; do
    man -P "sed -ne '1,/^[Nn]/d;/^ /{H;b}
    /^[Ss]..[Yy]..[Nn]/{g;:n
    N;/\n\(\n\)[^ ].*/!bn;s//\1/
    s/.\x08//g;s/\(\n\)  */\1/g;
    w /dev/stderr' -ne '};/./q'" -l "$f"
done 2>~/file

이는 다음 라인만 출력 sed하도록 지정합니다.PAGER이름그리고 그 뒤를 따르는 사람들개요a 이외의 것으로 시작하는 다른 줄을 만날 때까지 <space>. 인쇄합니다아무것도 아님<space>그것 으로 시작하지 않는 첫 번째 줄이 다음과 같은 경우이름시작과 일치하지 않습니다 [Ss][Yy][Nn]. 모든 경우에 다음과 같은 두 번째 줄에서 파일 읽기를 모두 종료합니다.이름로 시작하지 않는 것입니다 <space>. 출력에서 선행 슬래시 <spaces>와 모든 응답 슬래시를 지웁니다 .\b

for방금 루프에서 실행했는데 man단 1분 만에 내 전체 라이브러리에 걸쳐 루프가 실행되었습니다.

man터미널에 쓰는지 파이프/파일에 쓰는지에 따라 출력을 조정합니다. 따라서 그렇게 하라고 지시하면 PAGER가 완전히 무시됩니다. 그것은 예상치 못한 일이었습니다. 그러나 나는 그것을 속이고 sed의 write 함수를 사용하여 >&2에 기록하고 이를 리디렉션했기 때문에 더 이상 현명하지 못했습니다.

참고 사항 - 하지만 @terdon이 더 나은 방법일 수 있습니다. 파일당 하나 를 얻을 수 있기 때문에 이것을 더 쉽게 조정할 수 sed있고 터미널 너비에 맞추려고 하지 않기 때문에 형식이 조금 더 좋지만 분명히 man해당 \백슬래시를 |pipe.

Answer