fish-shell/doc_src
Fabian Boehm 6706b15fbc fish_add_path: Automatically enable verbose mode for interactive use
fish_add_path can be used either interactively, in the commandline,
or in config.fish. That's its greatest strength, it's a very
DWIM-style command.

One of the compromises that entails, however, is that it can't really
be very loud about what it does. If it skips a path, it can't write a
warning because it might be used in config.fish.

But it *can* if it's used interactively. So we try to detect that case
and enable verbose mode automatically.

That means if you do

```fish
fish_add_path /opt/mytool/bin/mytool
```

it may tell you "Skipping path because it is a file instead of a
directory:".

The check isn't perfect, it goes through status current-command and
isatty, but it should be good for most cases (and be false in config.fish).
2024-06-06 16:47:39 +02:00
..
cmds fish_add_path: Automatically enable verbose mode for interactive use 2024-06-06 16:47:39 +02:00
python_docs_theme docs: use canonical key names in :kbd: tags 2024-04-20 15:36:29 +02:00
commands.rst docs: Add fish_should_add_to_history to commands list 2024-03-09 12:09:00 +01:00
completions.rst docs: Some rewording on completions 2024-05-10 17:40:18 +02:00
conf.py Enable Sphinx man_show_urls config 2024-04-20 13:34:08 +02:00
contributing.rst Improve CONTRIBUTING and add it to the docs 2023-06-01 18:09:02 +02:00
design.rst docs: Fix typos 2022-09-17 21:31:06 +08:00
faq.rst docs: use canonical key names in :kbd: tags 2024-04-20 15:36:29 +02:00
fish_for_bash_users.rst fish_for_bash_users: Put explanation on subshells first 2024-05-15 22:44:07 +02:00
fish_indent_lexer.py docs: restore default highlighting keywords and options in HTML 2022-01-16 14:07:19 +01:00
fish_synopsis.py Document the ! (not) and . (source) aliases more 2024-04-20 13:34:08 +02:00
index.rst docs: Some slight rewordings 2023-08-23 23:08:56 +02:00
interactive.rst builtin bind: make function keys lowercase (f1 instead of F1) 2024-05-22 22:38:06 +02:00
language.rst docs: Simplify Combining Lists section 2024-05-15 20:18:17 +02:00
license.rst Add musl libc to our license.rst 2024-05-26 16:07:27 -04:00
prompt.rst docs/prompt: A few small fixes 2024-02-03 11:12:11 +01:00
relnotes.rst docs: call the CHANGELOG "release notes" 2021-02-25 22:46:24 +08:00
tutorial.rst docs: use canonical key names in :kbd: tags 2024-04-20 15:36:29 +02:00