/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_FORMATTINGnull이 아닌 값으로 설정되면 이러한 형식 문자가 유지됩니다. 이는 형식 지정 문자를 해석할 수 있는 man 래퍼에 유용할 수 있습니다.

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

이제 다른 작업을 수행하는 방법에 대해 알아보겠습니다.

나는 이것이 귀하의 요구 사항을 충족한다고 생각합니다.

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이름그리고 다음 사람요약다른 Ephemer를 만날 때까지 <space>. 그것은 인쇄한다아무것도 없다첫 번째 줄이 <space>다음으로 시작 하지 않는 경우이름불일치가 시작됩니다 [Ss][Yy][Nn]. 각각의 경우 두 번째 줄에서 파일 읽기를 완전히 중지합니다.이름로 시작하지 않습니다 <space>. 출력에서 선행 슬래시 <spaces>와 모든 백슬래시를 지웁니다.\b

for방금 이것을 반복해서 실행했는데 전체 man라이브러리를 살펴보는 데 1분밖에 걸리지 않았습니다.

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

그러나 @terdon이 아마도 더 나은 접근 방식이라는 점에 유의하는 것이 중요합니다. 각 파일을 가져오므로 더 쉽게 사용자 정의할 수 있고 sed터미널 너비에 맞추려고 하지 않기 때문에 형식이 조금 더 좋지만 분명히 man\backslashes 는 쓰지 않습니다 |pipe.

Answer