Ricerca di un'opzione specifica in una pagina man


14

Mi trovo spesso a manricevere un comando solo per conoscere un'opzione specifica. Il più delle volte posso cercare l'opzione bene, a meno che non sia qualcosa di simile ffmpego in gcccui devo passare attraverso circa 40 corrispondenze fino a quando non arrivo alla descrizione effettiva dell'opzione ...

A volte posso essere fortunato e cercare la parola "opzioni" per avvicinarmi e poi perfezionarlo da lì, ma sarebbe bello se potessi saltare direttamente all'opzione in questione. Sarebbe bello se ci fosse uno strumento in grado di analizzare le opzioni e costruire un database su cui è possibile effettuare ricerche, ma dopo aver esaminato il markup groff per alcune pagine ho determinato che sarebbe solo uno sforzo di ipotesi a causa della mancanza di meta-informazioni nel markup groff ... Nel mio mondo ideale la modalità donna in emacs sosterrebbe la ricerca di opzioni specifiche ... :)

Qualche consiglio per passare direttamente a un'opzione specifica in una pagina man?

Risposte:


5

Ecco la mia sceneggiatura per farlo. Si chiama lui .

$ 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.

Ma se non si ha accesso a uno script del genere, basta eseguire less, quindi digitare /^ *-option(notare lo spazio), ad esempio, nella gccpagina man, digitare /^ *-dDEnterper trovare la documentazione per l' -dDopzione.

Questo funziona perché l'opzione appare di solito all'inizio della riga.


1
Immagina un grande orso barbuto che ti bacia le dita dei piedi per questo!
sepehr,

Ah ah! Grazie! Si noti inoltre che ho rinominato lo script in he, come in "breve guida". L'ultima versione è su github
Mikel,

2

Questa è la funzione che uso. Lo chiamo "mans" per "ricerca uomo".

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

Uso:

$ mans ^OPTIONS grep find xargs

Dolce! Non esattamente la soluzione "ideale" di tipo tabella di ricerca che speravo, ma comunque molto utile. Grazie.
mgalgs

1
Come notato di seguito, la maggior parte delle volte ciò che stai cercando è all'inizio della riga dopo un certo rientro, quindi il modello di solito sarà simile mans '^ *<something>' <page>. Vedi la mia risposta per maggiori dettagli.
Mikel
Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.