/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]。それぞれの場合、2行目のファイルの読み取りを完全に停止します。名前で始まらない<space>。出力から先行スラッシュ<spaces>とすべてのバックスラッシュを消去します。\b

for私はこれを繰り返し実行しましたが、ライブラリman全体を見るのに1分しかかかりませんでした。

man端末に書き込むかパイプ/ファイルに書き込むかによって出力を調整します。したがって、これを行うように指示すると、ポケットベルを完全に放棄します。これは予期しないことです。しかし、私はそれをだまして、sedのwrite関数を使用して>＆2に書き込んでリダイレクトしたので、合理的ではありませんでした。

しかし、@terdonがおそらくより良いアプローチであることに注意することが重要です。各ファイルをインポートするので、カスタマイズしやすく、sed端末の幅に合わせようとしないため、フォーマットは少し良いですが、明らかにman\ backslashesは書きません|pipe。

Answer