On Tue, Jun 4, 2024 at 10:01 PM Ray Andrews <rayandrews@eastlink.ca> wrote:


On 2024-06-04 17:33, Lawrence Velázquez wrote:
I was reading 'info zsh history'
That shows the "History Expansion" section of the manual, which
does not mention the "history" builtin at all.

Ok, at least that's clear.  I should be using 'info zshbuiltins'.  'History Expansion' ... I'm taking that to be what the history command does so ... actually now that I look closely, it's obviously the wrong place.  And 'run-help history' goes somewhere else entirely.   

The term "history expansion" refers to the expansion of references into the command history. Those start with !, for example:

zsh% vi path/to/some/file
zsh% gcc !$ # compile the file I just edited

In general, the ! is followed by a selector that determines which item from the history you want to copy from. This can be an item number (which matches the one shown by history/fc -l), another (which means the most recent command), or a prefix string (which refers to the most recent command starting with that prefix, e.g. !ls to refer to the most recent ls command). The selector can be followed by modifiers to restrict the expansion to just part of the command: :0 for the command name, :* for the arguments without the command name, :$ for just the last argument, etc. The !!:$ expression (last word of the last command) is so common that it got its own shortcut, the !$ I used above.

History expansion is purely an interactive command-line feature; it doesn't work in scripts. If you need to access the history programmatically, use the fc command (or history, which is equivalent to fc -l). 

Anyway, that's what you were reading about. :)
--
Mark J. Reed <markjreed@gmail.com>