É possível pressionar Shift-k e abrir um manual para um comando no Bash?

Question

No Vim você pode pressionar Shift - k e abrir um manual para uma string sob o cursor.

É possível configurar o Bash desta forma também (quando usar set -o vi )?

Por exemplo:

# '|' represents the position of a cursor.
$ |
# Write a command.
$ grep things *|
# Hit 'esc' to enter normal mode.
# Hit '3b' to move to 'grep'.
$ |grep things *
# Now I would like to hit 'Shift-k' to open 'man grep'.

    

Answer 1

Você pode vincular uma função bash a uma chave com bind -x . Nesta função, você pode acessar o conteúdo atual do buffer de entrada por meio das variáveis READLINE_LINE e READLINE_POINT .

run_man () {
  declare prefix="${READLINE_LINE:0:$READLINE_POINT}" suffix="${READLINE_LINE:$READLINE_POINT}"
  declare word="${prefix##*[!-+.0-9A-Z_a-z]}${suffix%%[!-+.0-9A-Z_a-z]*}"
  man "$word"
}
bind -m vi -x '"K": run_man'

Pode ser mais útil abrir a man page para a palavra na posição de comando do que para a palavra sob o cursor, mas isso requer uma análise mais complexa. O código de conclusão bash pode ajudar nisso. Ou você pode se contentar com a primeira palavra na linha, o que requer menos análise do que obter a palavra atual.

Para detectar bash builtins e mostrar a documentação bash em vez de uma página man, consulte comando universal help / man: ajuda com parciais parciais

P.S.

It'd be nice to be able to see man without deleting the whole command from the prompt.

Eu faço isso com frequência em zsh . Espero que seja possível no bash também, mas mais complicado de configurar.

    

Answer 2

Use apenas a expansão do histórico para fazer referência ao nome do comando do último comando fornecido.

$ grep something
$ man !:0

Como a expansão do histórico é feita antes da expansão do alias, se você quiser usar um alias, faça da seguinte forma:

alias k='man "$(history -p \!:0)"'

Em seguida, basta digitar k para ver a página man do último comando executado.

    

Answer 3

tl; dr

Não é uma operação padrão, mas você pode adicioná-la facilmente. Veja esta resposta (link) .

Se você ainda estiver disposto a invadir o código-fonte ...

Li o código-fonte de readline e parece é bastante factível para adicionar a funcionalidade desejada. readline já suporta a opção v , que permite que você entre no modo de edição e abra seu $EDITOR . Se alguém analisar a lógica de como readline abre $EDITOR , então deve ser muito fácil abrir man com a palavra sob o cursor como um argumento.

Aqui estão alguns exemplos interessantes:

• grep -RI EDITOR *

  doc/hsuser.texi:is used: @code{$@{FCEDIT:-$@{EDITOR:-vi@}@}}.  This says to use the
  doc/hsuser.texi:@env{EDITOR} variable if that is set, or @code{vi} if neither is set.
  doc/rluser.texi:@code{$VISUAL}, @code{$EDITOR}, and @code{emacs}
  examples/rlfe/ChangeLog:    * line options; use EDITOR/VISUAL to set vi/emacs preference.
  examples/rlfe/README:but if the the environment variable EDITOR is set to "vi" that
  examples/rlfe/rlfe.c: * line options; use EDITOR/VISUAL to set vi/emacs preference.
  examples/rlfe/rlfe.c:      if (getenv ("EDITOR") != 0)
  examples/rlfe/rlfe.c:   vi |= strcmp (getenv ("EDITOR"), "vi") == 0;
  

• grep -RI -C 5 editing-mode *.c

  bind.c-  { "bell-style",        V_STRING,       sv_bell_style },
  bind.c-  { "comment-begin",     V_STRING,       sv_combegin },
  bind.c-  { "completion-display-width", V_INT,   sv_compwidth },
  bind.c-  { "completion-prefix-display-length", V_INT,   sv_dispprefix },
  bind.c-  { "completion-query-items", V_INT,     sv_compquery },
  bind.c:  { "editing-mode",      V_STRING,       sv_editmode },
  bind.c-  { "emacs-mode-string", V_STRING,       sv_emacs_modestr },  
  bind.c-  { "history-size",      V_INT,          sv_histsize },
  bind.c-  { "isearch-terminators", V_STRING,     sv_isrchterm },
  bind.c-  { "keymap",            V_STRING,       sv_keymap },
  bind.c-  { "keyseq-timeout",    V_INT,          sv_seqtimeout },
  --
  --
  bind.c-  else if (_rl_stricmp (name, "completion-query-items") == 0)
  bind.c-    {
  bind.c-      sprintf (numbuf, "%d", rl_completion_query_items);
  bind.c-      return (numbuf);
  bind.c-    }
  bind.c:  else if (_rl_stricmp (name, "editing-mode") == 0)
  bind.c-    return (rl_get_keymap_name_from_edit_mode ());
  bind.c-  else if (_rl_stricmp (name, "history-size") == 0)
  bind.c-    {
  bind.c-      sprintf (numbuf, "%d", history_is_stifled() ? history_max_entries : 0);
  bind.c-      return (numbuf);
  --
  --
  funmap.c-  { "do-lowercase-version", rl_do_lowercase_version },
  funmap.c-  { "downcase-word", rl_downcase_word },
  funmap.c-  { "dump-functions", rl_dump_functions },
  funmap.c-  { "dump-macros", rl_dump_macros },
  funmap.c-  { "dump-variables", rl_dump_variables },
  funmap.c:  { "emacs-editing-mode", rl_emacs_editing_mode },
  funmap.c-  { "end-kbd-macro", rl_end_kbd_macro },
  funmap.c-  { "end-of-history", rl_end_of_history },
  funmap.c-  { "end-of-line", rl_end_of_line },
  funmap.c-  { "exchange-point-and-mark", rl_exchange_point_and_mark },
  funmap.c-  { "forward-backward-delete-char", rl_rubout_or_delete },
  --
  --
  funmap.c-  { "vi-column", rl_vi_column },
  funmap.c-  { "vi-complete", rl_vi_complete },
  funmap.c-  { "vi-delete", rl_vi_delete },
  funmap.c-  { "vi-delete-to", rl_vi_delete_to },
  funmap.c-  { "vi-eWord", rl_vi_eWord },
  funmap.c:  { "vi-editing-mode", rl_vi_editing_mode },
  funmap.c-  { "vi-end-bigword", rl_vi_eWord },
  funmap.c-  { "vi-end-word", rl_vi_end_word },
  funmap.c-  { "vi-eof-maybe", rl_vi_eof_maybe },
  funmap.c-  { "vi-eword", rl_vi_eword },
  funmap.c-  { "vi-fWord", rl_vi_fWord },