マニュアルページで特定のオプションを検索する


14

man特定のオプションについて学ぶためだけにコマンドを実行していることがよくあります。ほとんどの場合、オプションの実際の説明に到達するまで、約40のマッチをステップスルーするffmpeg必要gccがあるような場合を除いて、オプションを検索できます...

幸運にも「オプション」という単語を検索して、そこから近づき、そこから洗練していくこともできますが、問題のオプションに確実に直接ジャンプできたらいいと思います。オプションを解析し、検索できるデータベースを構築できるツールがあればクールですが、数ページのgroffマークアップを見た後、私はそれが最善の努力だと判断しましたgroffマークアップにメタ情報がないため...私の理想的な世界では、emacsの女性モードは特定のオプションの検索をサポートします... :)

manページで特定のオプションに直接ジャンプするためのヒントはありますか?

回答:


5

これを行うためのスクリプトを次に示します。と呼ばれてます。

$ he cp    
SYNOPSIS
       cp [OPTION]... [-T] SOURCE DEST
       cp [OPTION]... SOURCE... DIRECTORY
       cp [OPTION]... -t DIRECTORY SOURCE...

$ he gcc -dD
       -dD Dump all macro definitions, at the end of preprocessing, in addition to normal output.

$ he rsync -v
        -v, --verbose               increase verbosity

$ he bash getopts
       getopts optstring name [args]
              getopts is used by shell procedures to parse positional parameters.  optstring contains the option characters to be recognized; if a character is  followed  by  a  colon,  the  option  is
              expected  to  have  an  argument, which should be separated from it by white space.  The colon and question mark characters may not be used as option characters.  Each time it is invoked,
              getopts places the next option in the shell variable name, initializing name if it does not exist, and the index of the next argument to be processed into the variable OPTIND.  OPTIND  is
              initialized  to  1 each time the shell or a shell script is invoked.  When an option requires an argument, getopts places that argument into the variable OPTARG.  The shell does not reset
              OPTIND automatically; it must be manually reset between multiple calls to getopts within the same shell invocation if a new set of parameters is to be used.

              When the end of options is encountered, getopts exits with a return value greater than zero.  OPTIND is set to the index of the first non-option argument, and name is set to ?.

              getopts normally parses the positional parameters, but if more arguments are given in args, getopts parses those instead.

              getopts can report errors in two ways.  If the first character of optstring is a colon, silent error reporting is used.  In normal operation diagnostic messages are printed  when  invalid
              options or missing option arguments are encountered.  If the variable OPTERR is set to 0, no error messages will be displayed, even if the first character of optstring is not a colon.

              If  an  invalid  option  is  seen, getopts places ? into name and, if not silent, prints an error message and unsets OPTARG.  If getopts is silent, the option character found is placed in
              OPTARG and no diagnostic message is printed.

              If a required argument is not found, and getopts is not silent, a question mark (?) is placed in name, OPTARG is unset, and a diagnostic message is printed.  If getopts is silent, then  a
              colon (:) is placed in name and OPTARG is set to the option character found.

              getopts returns true if an option, specified or unspecified, is found.  It returns false if the end of options is encountered or an error occurs.

ただし、そのようなスクリプトにアクセスできない場合は、単に実行してlessから、/^ *-option(スペースに注意してgccください)と入力/^ *-dDEnter-dDます。たとえば、manページに入力して、オプションのドキュメントを検索します。

これは、オプションが通常行の先頭に表示されるため機能します。


1
大きなひげを生やしたクマの男がこれのためにあなたのつま先にキスすることを想像してください!
セファー

ハハ!ありがとう!またhe、「短いヘルプ」のように、スクリプトの名前をに変更したことに注意してください。最新バージョンでは、上にあるgithubの
ミケル

2

これは私が使用する機能です。私は「マン検索」を「マン」と呼んでいます。

mans ()
{
    local pages string;
    if [[ -n $2 ]]; then
        pages=(${@:2});
        string="$1";
    else
        pages=$1;
    fi;
    man ${2:+--pager="less -p \"$string\" -G"} ${pages[@]}
}

使用法:

$ mans ^OPTIONS grep find xargs

甘い!私が望んでいた「理想的な」ルックアップテーブル型のソリューションではありませんが、それでも非常に便利です。ありがとう。
mgalgs

1
以下に示すように、ほとんどの場合、探しているのはインデントの後の行の先頭なので、パターンは通常のようになりmans '^ *<something>' <page>ます。詳細については私の答えをご覧ください。
ミケル
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.