h/fish-shell
1
Fork 0
mirror of https://github.com/fish-shell/fish-shell.git synced 2026-05-06 22:51:14 -03:00
Code Issues Packages Projects Releases Wiki Activity
Files
c4593828f40bd2a6d2c1e9ebe1e7ab820d2c4076
fish-shell/doc_src/cmds
History
Fabian Homborg c4593828f4 commandline: Add --is-valid option (#8142) 
* commandline: Add --is-valid option to query whether it's syntactically complete

This means querying when the commandline is in a state that it could
be executed. Because our `execute` bind function also inserts a
newline if it isn't.

One case that's not handled right now: `execute` also expands
abbreviations, those can technically make the commandline invalid
again.

Unfortunately we have no real way to *check* without doing the
replacement.

Also since abbreviations are only available in command position when
you _execute_ them the commandline will most likely be valid.

This is enough to make transient prompts work:

```fish
function reset-transient --on-event fish_postexec
    set -g TRANSIENT 0
end

function maybe_execute
    if commandline --is-valid
        set -g TRANSIENT 1
        commandline -f repaint
    else
        set -g TRANSIENT 0
    end
    commandline -f execute
end

bind \r maybe_execute
```

and then in `fish_prompt` react to $TRANSIENT being set to 1.
2021-08-14 11:29:22 +02:00
..
_.rst
Add an "_" builtin to call into gettext (#7036)
2020-05-29 20:53:44 +02:00
abbr.rst
Update docs for multi-erase in abbr and set
2020-10-04 12:39:32 +02:00
alias.rst
docs: Links for the function-related commands
2021-05-08 12:12:56 +02:00
and.rst
doc: add interlinks between true ←→ false and and ←→ or cmds
2020-02-23 23:41:16 -08:00
argparse.rst
docs: Replace all internal links with :ref:s
2021-03-26 19:32:14 +01:00
begin.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
bg.rst
docs: note job expansion in bg/fg/jobs arguments
2021-02-28 20:56:23 +08:00
bind.rst
Provide functions to toggle commandline prefix/suffix
2021-06-23 20:51:20 +02:00
block.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
break.rst
doc: add interlinks between break and continue commands
2020-03-09 19:24:38 +01:00
breakpoint.rst
doc: homogenize commands titles
2020-04-04 10:44:53 +02:00
builtin.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
case.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
cd.rst
docs: Reword cd a bit
2021-07-23 18:00:57 +02:00
cdh.rst
doc: add section about directory history / stack
2020-04-18 10:40:48 +02:00
command.rst
Let command, jobs and type take --query instead of --quiet
2020-09-04 16:55:09 +02:00
commandline.rst
commandline: Add --is-valid option (#8142)
2021-08-14 11:29:22 +02:00
complete.rst
docs: Document how complete groups options
2021-07-23 19:29:16 +02:00
contains.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
continue.rst
doc: add interlinks between break and continue commands
2020-03-09 19:24:38 +01:00
count.rst
docs: Make more code lines shorter
2021-02-02 08:35:38 +01:00
dirh.rst
doc: add section about directory history / stack
2020-04-18 10:40:48 +02:00
dirs.rst
doc: add section about directory history / stack
2020-04-18 10:40:48 +02:00
disown.rst
docs: Link builtins
2020-03-21 15:31:25 +01:00
echo.rst
docs: Use \ instead of \\ in examples (#7286)
2020-08-26 18:29:03 +02:00
else.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
emit.rst
doc: homogenize commands titles
2020-04-04 10:44:53 +02:00
end.rst
doc: homogenize commands titles
2020-04-04 10:44:53 +02:00
eval.rst
doc: add links to 'source' command from 'eval' and 'functions'
2020-03-21 13:21:38 +01:00
exec.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
exit.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
false.rst
doc: add interlinks between true ←→ false and and ←→ or cmds
2020-02-23 23:41:16 -08:00
fg.rst
docs: note job expansion in bg/fg/jobs arguments
2021-02-28 20:56:23 +08:00
fish_add_path.rst
docs: Fix markup for code blocks
2020-10-10 21:49:33 +02:00
fish_breakpoint_prompt.rst
docs: Less "the user", more "you"
2020-09-18 16:53:59 +02:00
fish_command_not_found.rst
Call "fish_command_not_found" if a command wasn't found
2020-09-06 11:15:54 +02:00
fish_config.rst
fish_config: Add CLI-based theme selector
2021-07-14 18:56:19 +02:00
fish_git_prompt.rst
docs: use monospace for inline code snippets more consistently
2020-10-26 19:25:41 +01:00
fish_greeting.rst
docs: Add fish_title and fish_greeting
2020-10-28 17:44:45 +01:00
fish_hg_prompt.rst
Fixed sentence in fish_hg_prompt docs
2020-12-28 19:39:27 +01:00
fish_indent.rst
fish_indent: Change --debug-level to --debug with flog categories
2020-12-14 19:36:18 +01:00
fish_is_root_user.rst
Fix paste-o that duplicated documentation header.
2020-06-30 23:45:41 +02:00
fish_key_reader.rst
docs: Add completions for fish_key_reader
2020-04-19 07:06:31 +02:00
fish_mode_prompt.rst
docs: link and explicit instructions on creating a blank fish_mode_prompt
2020-06-06 22:52:13 +08:00
fish_opt.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
fish_prompt.rst
docs: Update example prompt in fish_prompt docs
2020-10-02 19:02:10 +02:00
fish_right_prompt.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
fish_status_to_signal.rst
Remove dunderscores from __fish_status_to_signal (#7597)
2021-01-03 15:15:57 +01:00
fish_svn_prompt.rst
Synopses examples for vcs services now function as intended
2020-10-02 23:45:38 +02:00
fish_title.rst
docs: Add fish_title and fish_greeting
2020-10-28 17:44:45 +01:00
fish_update_completions.rst
doc: homogenize commands titles
2020-04-04 10:44:53 +02:00
fish_vcs_prompt.rst
Synopses examples for vcs services now function as intended
2020-10-02 23:45:38 +02:00
fish.rst
document --no-config
2021-07-27 23:00:23 +02:00
for.rst
doc: homogenize commands titles
2020-04-04 10:44:53 +02:00
funced.rst
docs: Fix spacing on key combinations
2020-03-21 13:20:34 +01:00
funcsave.rst
docs: Don't speak of "initialization files"
2021-05-28 20:49:57 +02:00
function.rst
function: note limits on signal triggers in documentation
2021-07-11 23:03:39 +08:00
functions.rst
docs: Remove obsolete part from functions
2021-05-19 19:09:46 +02:00
help.rst
docs: Link builtins
2020-03-21 15:31:25 +01:00
history.rst
history.rst: clarify that "history search" is the default command
2020-08-04 21:44:26 +02:00
if.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
isatty.rst
docs/isatty: Mention default value for FILE DESCRIPTOR
2020-09-05 15:54:48 +02:00
jobs.rst
docs: note job expansion in bg/fg/jobs arguments
2021-02-28 20:56:23 +08:00
math.rst
math: Make function parentheses optional (#7877)
2021-03-30 17:21:28 +02:00
nextd.rst
doc: add section about directory history / stack
2020-04-18 10:40:48 +02:00
not.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
open.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
or.rst
doc: add interlinks between true ←→ false and and ←→ or cmds
2020-02-23 23:41:16 -08:00
popd.rst
doc: add section about directory history / stack
2020-04-18 10:40:48 +02:00
prevd.rst
doc: add section about directory history / stack
2020-04-18 10:40:48 +02:00
printf.rst
Fix punctuation in footnote
2021-08-10 21:01:39 +02:00
prompt_login.rst
Add a "prompt_login" helper function
2021-04-30 17:07:54 +02:00
prompt_pwd.rst
prompt_pwd: Update docs
2021-08-09 17:42:00 +02:00
psub.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
pushd.rst
Improve the documentation for pushd
2021-05-04 13:21:46 -07:00
pwd.rst
docs: Document that the man pages are for our builtins
2021-07-16 18:21:41 +02:00
random.rst
docs: Reword random
2020-09-10 20:48:13 +02:00
read.rst
docs: Remove references to read history
2021-02-02 09:42:57 +01:00
realpath.rst
docs: Document that the man pages are for our builtins
2021-07-16 18:21:41 +02:00
return.rst
Let "return" exit a script (#8148)
2021-07-21 22:33:39 +02:00
set_color.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
set.rst
set -q: Return 255 if no variable name was passed
2021-08-14 10:55:21 +02:00
source.rst
docs: don't quote code snippets
2020-04-13 22:56:22 +02:00
status.rst
docs: Update status docs
2021-04-14 21:46:51 +02:00
string-collect.rst
Docs for "$(cmd)" and $(cmd)
2021-07-13 21:33:42 +02:00
string-escape.rst
docs: Use \ instead of \\ in examples (#7286)
2020-08-26 18:29:03 +02:00
string-join0.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
string-join.rst
Fix a Sphinx warning
2021-05-04 13:50:09 -07:00
string-length.rst
docs
2021-08-04 21:09:47 +02:00
string-lower.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
string-match.rst
string: Add "--groups-only" to match
2021-07-16 20:27:54 +02:00
string-pad.rst
docs
2021-08-04 21:09:47 +02:00
string-repeat.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
string-replace.rst
docs: Use \ instead of \\ in examples (#7286)
2020-08-26 18:29:03 +02:00
string-split0.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
string-split.rst
docs: Use \ instead of \\ in examples (#7286)
2020-08-26 18:29:03 +02:00
string-sub.rst
Add string sub --end (#6765)
2020-03-22 15:53:09 +01:00
string-trim.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
string-unescape.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
string-upper.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
string.rst
string: Quit early if --quiet is satisfied
2020-12-01 18:55:01 +01:00
suspend.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
switch.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
test.rst
docs: Document that the man pages are for our builtins
2021-07-16 18:21:41 +02:00
time.rst
docs: Document that the man pages are for our builtins
2021-07-16 18:21:41 +02:00
trap.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
true.rst
doc: add interlinks between true ←→ false and and ←→ or cmds
2020-02-23 23:41:16 -08:00
type.rst
Let command, jobs and type take --query instead of --quiet
2020-09-04 16:55:09 +02:00
ulimit.rst
docs: Link builtins
2020-03-21 15:31:25 +01:00
umask.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
vared.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
wait.rst
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
while.rst
docs: Make more code lines shorter
2021-02-02 08:35:38 +01:00