Mirrors/fish-shell
2
0
Fork 0
mirror of https://github.com/fish-shell/fish-shell synced 2024-12-25 12:23:09 +00:00
Code Issues Projects Releases Packages Wiki Activity

Update suspend docs. When used, show how to resume

Browse source 
Fixes #3154
This commit is contained in:
Aaron Gyes 2016-07-01 01:18:07 -07:00
parent cbee315b1b
commit 9642fcb589
2 changed files with 13 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
doc_src/suspend.txt
View file

@ -10,8 +10,6 @@ suspend [--force]
`suspend` suspends execution of the current shell by sending it a `suspend` suspends execution of the current shell by sending it a
SIGTSTP signal, returning to the controlling process. It can be SIGTSTP signal, returning to the controlling process. It can be
resumed later by sending it a SIGCONT. In order to prevent suspending resumed later by sending it a SIGCONT. In order to prevent suspending
a shell that doesn't have a controlling process, it will not suspend a a shell that doesn't have a controlling process, it will not suspend
the shell if it is a login shell or if `$SHLVL` is less the shell if it is a login shell. This requirement is bypassed
`$suspend_minimum_SHLVL`, which defaults to three. This test is if the `--force` option is given or the shell is not interactive.
skipped if the `--force` option is given or the shell is not
interactive.

14
share/functions/suspend.fish
View file

@ -1,10 +1,16 @@
function suspend -d "Suspend the current shell." function suspend -d "Suspend the current shell."
if begin contains -- $argv --force if begin contains -- $argv --force
or not status --is-interactive and not status --is-login or not status --is-interactive and not status --is-login
end end
echo Suspending %self echo "Suspending" %self
kill -STOP %self echo -n (set_color --bold)" fg"(set_color normal) to resume
if contains -- $argv --force
echo " (or"(set_color --bold) "kill -CONT" %self (set_color normal)"from another terminal)"
end
kill -STOP %self
else else
echo 2>&1 Cannot suspend login shell. Use --force to override. echo 2>&1 "Refusing to suspend login shell. Use --force to override."
echo 2>&1 "This might hang your terminal."
end end
end end