Fabian Boehm
d239e26f6b
docs: Add a missing newline
...
Sphinx is annoyingly specific here
2023-01-29 14:46:35 +01:00
Fabian Boehm
9043008933
abbr: Clarify universal variable message
...
And give explicit upgrade instructions.
2023-01-21 16:53:59 +01:00
Fabian Boehm
01d681067c
Bind ctrl-g to cancel as well
...
Classic emacs thing and the chord is so far unused.
Fixes #9484
2023-01-21 13:35:22 +01:00
mattmc3
cd17c1281d
Add argparse validation examples ( #9483 )
...
* Add argparse validation examples
* Remove invalid example
2023-01-19 11:06:51 +01:00
Eddie Lebow
1564c3e181
Minor formatting in Job Control documentation
2023-01-18 22:20:16 +01:00
Fabian Boehm
83d95cea35
docs: Reword quotes
...
Also explain that `$(foo)` is also done in double-quotes.
2023-01-18 16:39:37 +01:00
Fabian Boehm
d952ca1d1e
docs: Rename "index range expansion" to "slices"
...
It's a simpler term.
2023-01-17 17:08:10 +01:00
Fabian Boehm
dda0c8178d
docs: Remove "Variable scope for functions" chapter
...
This didn't need to be separately.
Also rename "More on universal variables" because it's the chapter on
universal variables.
2023-01-17 17:04:56 +01:00
Fabian Boehm
72a7111260
docs: Revise command substitution section
2023-01-16 18:36:59 +01:00
Fabian Boehm
97bef63af6
docs: Add more on conditionals
2023-01-16 17:53:08 +01:00
Fabian Boehm
78cc872904
Remove dangling footnote reference
2023-01-16 17:42:00 +01:00
Fabian Boehm
dc51a12b4f
docs: Mention env
...
Fixes #9482
2023-01-16 17:09:33 +01:00
Fabian Boehm
8203fdf631
docs/abbr: Just explain right out that uvars don't work anymore
2023-01-14 14:19:46 +01:00
Fabian Boehm
a322e3f180
docs: Fix typo
2023-01-13 22:53:02 +01:00
shenleban tongying
27952db9f7
docs: clearify global vs universal variable
2023-01-13 15:58:37 +01:00
Fabian Boehm
1d29ae7847
docs: Document more vi-mode bindings
...
These are quite incomplete and need more work.
2023-01-10 20:36:59 +01:00
Fabian Boehm
51bce422fd
docs: More about envvars
2023-01-09 20:33:37 +01:00
Fabian Boehm
16369a3abb
docs/interactive: More on custom bindings
2023-01-08 20:36:10 +01:00
Fabian Boehm
126647380a
docs: More on fish_greeting
2023-01-08 12:44:02 +01:00
Fabian Boehm
9e1c8a70bf
docs/string: Add a -- example to the match section
...
This keeps tripping people up. We can't mention it *everywhere*, but
lets see if it works just in "match", since that sees to be where
people hit it most.
2023-01-08 12:44:02 +01:00
David Adam
5db2d326f5
Bump copyright year
2023-01-06 18:26:21 +08:00
David Adam
c2ad9e44ec
docs: include fish_cursor_selection_mode in list of special variables
2023-01-01 22:44:09 +08:00
Fabian Boehm
c39c598996
docs/prompt_pwd: Fix envvar linking
2022-12-30 14:31:32 +01:00
Fabian Boehm
d14f39e583
docs/language: Some small bits
2022-12-30 13:52:55 +01:00
Fabian Boehm
3bacbeb2e1
docs/language: Improve argument parsing section
...
Better motivation and explanation.
2022-12-30 13:52:28 +01:00
Fabian Boehm
21c09c392b
docs/language: Improve an example
...
If a code sample uses prompt-style (with `>` lines) it needs to do
that consistently, or the rest is taken as output and not highlighted.
2022-12-28 20:42:33 +01:00
Fabian Boehm
ddcb14c8f8
docs: Make color variables envvar definitions
...
This allows linking them from elsewhere (currently fish_indent) and
also improves the formatting - the code formatting here isn't actually a good look.
2022-12-28 12:21:42 +01:00
Fabian Boehm
72ec20d3af
docs: Some more in the intro sections
2022-12-27 15:22:17 +01:00
Fabian Boehm
a63c21a663
docs: Some more on tutorial and combiners
2022-12-27 14:17:27 +01:00
Fabian Boehm
d1741c42f3
docs/interactive: Some slight rewordings and additions to bindings
2022-12-26 21:34:11 +01:00
Fabian Boehm
d6a117d2a4
docs/interactive: Move bindings under "Command line editor"
2022-12-26 21:19:48 +01:00
Fabian Boehm
4c39aeed87
abbr: Let --function use a mandatory argument
...
This now means `abbr --add` has two modes:
```fish
abbr --add name --function foo --regex regex
```
```fish
abbr --add name --regex regex replacement
```
This is because `--function` was seen to be confusing as a boolean flag.
2022-12-24 10:29:26 +01:00
Fabian Boehm
dfaafd733a
docs: Simplify exporting section
2022-12-21 16:24:00 +01:00
Fabian Boehm
d2cd6c1cd6
docs: Remove the term "wrapper"
...
This committed the sin of introducing a concept by giving it two
names:
> An alias, or wrapper, around ``ls`` might look like this
The term "wrapper" doesn't pull its weight here. It's simpler to just
call them aliases throughout. We do use "a simple wrapping function"
in another place, but that's to define "alias", not as a separate name.
2022-12-21 16:24:00 +01:00
Fabian Boehm
7435a2614d
docs: Link to abbr more
2022-12-21 16:24:00 +01:00
Fabian Boehm
285b0602e4
docs: Fix link
2022-12-19 20:22:27 +01:00
Fabian Boehm
f82e00dbf6
docs: Some on completions
2022-12-19 19:46:16 +01:00
Fabian Boehm
8dd89ff9dd
docs: Some work on commands
...
The difference between keywords and "decorations" isn't important here.
2022-12-19 19:39:47 +01:00
Fabian Boehm
8284e0499f
docs: Some work on redirections
2022-12-19 19:39:47 +01:00
Johannes Altmanninger
daa9e1c466
abbr.rst: fix --set-cursor example
...
Since the --set-cursor argument is now optional, we must not separate it
from the option.
2022-12-17 18:09:54 +01:00
Johannes Altmanninger
622a0278bc
interactive.rst: fix broken cross-reference
2022-12-17 18:09:54 +01:00
Fabian Boehm
9b45904539
docs/bind: Explain commandline -f
...
Fixes #9399
2022-12-16 20:41:57 +01:00
Fabian Boehm
95d672534e
docs: Explain how to skip abbrs
2022-12-16 17:10:45 +01:00
Fabian Boehm
0e194adb70
docs: More on abbr
2022-12-15 17:54:16 +01:00
Fabian Boehm
886b4b92b2
docs/abbr: Explain ctrl-space
...
This is now more important because we have regexes and global abbrs
2022-12-13 18:32:56 +01:00
ridiculousfish
b2ee9c73e1
Call out more forcefully that abbreviations are interactive only
2022-12-10 16:29:46 -08:00
ridiculousfish
d8dbb9b259
Switch abbreviation '-r' flag from --rename to --regex
...
This will be the more common option and provides consistency with
`string`.
2022-12-10 16:21:39 -08:00
ridiculousfish
e08f4db1f9
Rename abbreviation cursor "sentinel" to "marker"
...
Also default the marker to '%'. So you may write:
abbr -a L --position anywhere --set-cursor "% | less"
or set an explicit marker:
abbr -a L --position anywhere --set-cursor=! "! | less"
2022-12-10 16:15:03 -08:00
ridiculousfish
01039537b0
Remove abbreviation triggers
...
Per code review, this does not add enough value to introduce now.
Leaving the feature in history should want want to revisit this
in the future.
2022-12-10 16:15:00 -08:00
ridiculousfish
35a4688650
Rename abbreviation triggers
...
This renames abbreviation triggers from `--trigger-on entry` and
`--trigger-on exec` to `--on-space` and `--on-enter`. These names are less
precise, as abbreviations trigger on any character that terminates a word
or any key binding that triggers exec, but they're also more human friendly
and that's a better tradeoff.
2022-12-10 15:38:50 -08:00
