Fabian Homborg
4f4c9aac34
FAQ: Reword history substitution entry
...
[ci skip]
2020-02-21 19:52:42 +01:00
Fabian Homborg
fdfb8f67d9
FAQ: Remove non-frequently asked questions
...
I don't think I've ever had anyone ask about our usage of unicode
private use characters.
2020-02-21 19:48:20 +01:00
Fabian Homborg
415cbb9e0b
FAQ: Add question about mode prompt
...
This is actually a frequently asked question.
2020-02-21 19:45:14 +01:00
Aaron Gyes
85a0ca66e0
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
ridiculousfish
a8120359c7
Remove all of doc_src
...
See the last_doxygen tag for the last supported Doxygen build.
2019-02-24 19:40:27 -08:00
Fabian Homborg
8a93c7d0ea
abbr: Add "-q"/"--query" option
...
[ci skip]
2019-02-19 11:02:58 +01:00
Jonathan Revah
8e41e3337c
small typo in the tutorial. stderr is redirected using 2> rather than >2
2019-02-18 22:08:58 +01:00
Sabine Maennel
20c51b7da9
changes according to feedback
...
Changes according to the feedback have been made:
- What is a shell section has been moved before Installation and Start section
- Content changes have been made as suggested in both of the above sections.
2019-02-16 13:40:18 -08:00
Sabine Maennel
f6974e5a76
documentation
...
Start issue 740
- changed introduction section
- added installation section
- added what is a shell section
2019-02-16 13:40:18 -08:00
Fabian Homborg
ca5b7c0ec4
math: Allow --scale=max
2019-02-13 12:54:58 +01:00
Fabian Homborg
dc0746bc45
Let command -q
work
...
This required "-sq" to be used and errored if just "-q" was given.
Instead, if only "-q" is given, we behave just as if "-sq" was.
2019-02-12 20:34:19 +01:00
Fabian Homborg
fb7a6e5f34
Add builtin -q
...
Used to query for a builtin's existence, like `type -q` and `functions
-q` can be used to query for a things and a functions existence respectively.
2019-02-12 20:34:19 +01:00
Fabian Homborg
3382a2145f
doc_src/math: Document needed escaping harder
...
Fixes #5650 .
[ci skip]
2019-02-12 18:14:33 +01:00
Andrew Childs
fe73fbdb9a
Document that snippets are run before system config
2019-02-10 18:25:44 +01:00
Fabian Homborg
8c6ae4612b
Document fish_svn_prompt
2019-02-10 14:44:50 +01:00
Fabian Homborg
b19b1ee23a
Document fish_hg_prompt
2019-02-10 14:44:50 +01:00
Fabian Homborg
f7c981af63
Document vcs prompt
2019-02-10 14:44:50 +01:00
Fabian Homborg
c771334924
Rename __fish_vcs_prompt -> fish_vcs_prompt
...
Still keep a stub under the old name for compatibility.
2019-02-10 14:44:50 +01:00
Fabian Homborg
f2b08ec592
Document fish_git_prompt
...
Shows how convoluted the thing is, really.
2019-02-10 14:44:50 +01:00
Fabian Homborg
965fef739c
docs/tutorial: Remove mention of caret (^)
...
While this is still technically included, the tutorial should not
steer people towards it.
[ci skip]
2019-02-09 18:48:38 +01:00
Aaron Gyes
0abcf9265e
{forward,backward}-bigword on Shift-Left/Right
...
There was no way to do this at all without vi keybindings,
and it turns out shift-left/shift-right was available.
Fixes #1605
2019-02-07 13:11:34 -08:00
Fabian Homborg
7c8b444927
Reduce default escape delay
...
300ms was waaay too long, and even 100ms wasn't necessary.
Emacs' evil mode uses 10ms (0.01s), so let's stay a tad higher in case
some terminals are slow.
If anyone really wants to be able to type alt+h with escape, let them
raise the timeout.
Fixes #3904 .
2019-02-07 12:19:36 +01:00
Fabian Homborg
b03c62bd29
docs: Fix status is-command-substitution
...
The docs spoke of a short "is-command-sub" variant, which does not
exist.
Fixes #5624 .
[ci skip]
2019-02-07 08:56:30 +01:00
David Adam
4cc168ae11
Documentation for while: note updated exit status
...
From updates in #4982 .
2019-02-04 22:26:59 +08:00
Ashe Connor
c7635ed2c0
***.fish* ->
**.fish`
2019-01-31 22:03:12 +08:00
Ashe Connor
09ca268d50
fix "are equivalent" with same example
...
This was introduced in 87eb073
when ^ redirection was removed from the
docs.
2019-01-30 10:51:56 +01:00
Ashe Connor
d9d2ad1cd6
pcre2 -> regex
2019-01-30 10:47:07 +01:00
Jeremy
dc885d70b3
Rename Fisherman to Fisher in FAQ
...
Fisherman became Fisher and moved to a new repo. The previous link still worked, but the name and URL change was needed to avoid confusion.
2019-01-27 12:28:24 +01:00
ridiculousfish
730effa0d9
Remove an errant space from the docs
2019-01-26 16:32:37 -08:00
Dan Zimmerman
50448e4319
Enable configuring more pager colors
...
Originally I sought out to configure the foreground color of the
selected text in the pager. After reading a thread on a github issue I
was inpired to do more: now you can conifgure any part of the pager when
selected, and when a row is secondary. More specifically this commit adds the
ability to specify a pager row's:
- Prefix
- Completion text
- Description
- Background
when said row is selected or secondary.
2019-01-26 15:43:23 -08:00
Mahmoud Al-Qudsi
5adc07bf28
Document new type -p
support for functions
2019-01-23 17:51:47 -06:00
ridiculousfish
71b5591f21
Update docs on tab completions and searching
...
Fixes #5547
2019-01-22 14:41:16 -08:00
Aaron Raimist
1398ee9bbb
docs: list full command to change default shell
2019-01-18 10:38:12 +01:00
Mahmoud Al-Qudsi
1b23814f8b
Clarify the point of type --force-path
[docs]
...
[ci skip]
2019-01-16 17:42:11 -06:00
David Adam
4a8db53bcf
status docs: add current-command
...
Note deprecation of $_.
[ci skip]
2019-01-09 22:38:57 +08:00
Fabian Homborg
adb97772c5
doc_src/printf: Add missing space
...
[ci skip]
2019-01-06 13:46:11 +01:00
Fabian Homborg
72c0213d42
docs: Document $hostname
...
Fixes #5469 .
[ci skip]
2019-01-03 12:31:35 +01:00
hrvoj3e
69a1c5a3a1
Fix typos in anchor to fish_opt
2018-12-27 14:45:14 +01:00
Fabian Homborg
335c41f097
math: Document round
...
[ci skip]
2018-12-01 23:06:13 +01:00
Fabian Homborg
1785af156b
doc_src/string: Add a small regex reference
...
This isn't nearly all of
it (https://pcre.org/current/doc/html/pcre2syntax.html ), but it should
cover the most-used features.
[ci skip]
2018-12-01 09:54:05 +01:00
Fabian Homborg
85cecd30fb
docs: fish_color_search_match is also used in the pager
...
Fixes #5314 .
[ci skip]
2018-11-27 16:06:06 +01:00
Fabian Homborg
40799d9e95
docs: Use fish_exit event instead of waiting for a process
2018-11-25 19:13:18 +01:00
Fabian Homborg
8ab6078001
docs: Remove the last mention of process expansion
...
See #5286 .
2018-11-25 19:12:58 +01:00
David Adam
2dab869b41
Restore legacy CMD_DURATION and FISH_VERSION variables
...
Work on #4154 .
Effectively reverts fb8ae04f80
.
Discussed extensively in
https://github.com/fish-shell/fish-shell/pull/5320
2018-11-24 12:37:26 +08:00
Fabian Homborg
c729a97c43
builtin_read: Remove --all-lines
...
This was unused and needed to be warned about in the docs. Remove it
so nobody stumbles over it.
Fixes #5332 .
2018-11-20 16:56:52 +01:00
Mahmoud Al-Qudsi
31d17f4559
Rename string escape --style=pcre2
to string escape --style=regex
2018-11-16 20:22:06 -06:00
Wojciech Siewierski
75515a4917
Update the docs regarding floats support in test ( #5344 )
...
* Replace "env" with "expr" in the test manpage
I'm pretty sure `env` isn't capable of comparing numbers and the author meant `expr`.
* Update the docs regarding floats support in test
2018-11-16 13:32:15 +01:00
Mahmoud Al-Qudsi
680040d17d
Document new PCRE2 string escaping in CHANGELOG and string.txt
2018-11-15 12:00:56 -06:00
David Adam
322b232fc0
Clarify and improve read documentation
2018-11-12 23:13:41 +08:00
David Adam
8e5b1f9e4d
docs: drop reference to process expansion
2018-11-12 23:13:41 +08:00
Moritz Wilhelmy
9afc4b419e
Allow cd .
to re-enter the current directory
...
Closes #4543 .
2018-11-04 21:46:24 +08:00
santpent
22f794125f
add command substition indexing examples ( #5303 )
...
* add command substition indexing examples
following from issue #243
* Update index.hdr.in
2018-11-02 13:24:51 +01:00
Mahmoud Al-Qudsi
f695284a84
Add fish private mode info to changelog and manual
2018-10-24 19:33:48 +02:00
Fabian Homborg
57cf9055d5
FAQ: Add pkg-config/splitting question
...
Fixes #4855 .
2018-10-23 16:55:44 +02:00
Fabian Homborg
1d5e715008
source: Return error instead of implicitly reading from tty
...
For things like
source $undefined
or
source (nooutput)
it was quite annoying that it read from tty.
Instead we now require a "-" as the filename to read from the tty.
This does not apply to reading from stdin if it's redirected, so
something | source
still works.
Fixes #2633 .
2018-10-22 21:22:27 +02:00
Fabian Homborg
6c988abe28
Add $__fish_config_dir variable
...
Contains the path to the user config.fish (e.g. ~/.config/fish)
without having to do the `set -q XDG_CONFIG_HOME` dance.
See #5270 .
2018-10-21 15:42:25 +02:00
ridiculousfish
1b5ccb12d5
Document PATH variables
2018-10-20 12:31:44 -07:00
ridiculousfish
3f3b3a7006
Export arrays as colon delimited, and support path-style variables
...
This commit begins to bake in a notion of path-style variables.
Prior to this fix, fish would export arrays as ASCII record separator
delimited, except for a whitelist (PATH, CDPATH, MANPATH). This is
surprising and awkward for other programs to deal with, and there's no way
to get similar behavior for other variables like GOPATH or LD_LIBRARY_PATH.
This commit does the following:
1. Exports all arrays as colon delimited strings, instead of RS.
2. Introduces a notion of "path variable." A path variable will be
"colon-delimited" which means it gets colon-separated in quoted expansion,
and automatically splits on colons. In this commit we only do the exporting
part.
Colons are not escaped in exporting; this is deliberate to support uses
like
`set -x PYTHONPATH "/foo:/bar"`
which ought to work (and already do, we don't want to make a compat break
here).
2018-10-19 17:29:39 -07:00
Mahmoud Al-Qudsi
a8a9a823f2
Correct unescaped backslash in \n in string.txt
2018-10-14 16:40:27 -05:00
Dennis Schridde
e3643c610f
doc_src/set.txt: -U affects only the user running the command, not all users
2018-10-10 18:42:56 +02:00
Mahmoud Al-Qudsi
e212269ab1
Add status fish-path
...
Retrieves the fully resolved path to the currently executing fish binary
(regardless of PATH). Can be used to ensure that the same fish is
launched again from a script.
`get_executable_path()` moved from fish binary to libfish, also cleaned
up some duplicated (but differing!) definitions of PATH_MAX (which was
used by that function) in the process.
2018-10-09 22:34:41 -05:00
Adel Atallah
6a9f0fc0c1
Fix typo in the documentation
2018-10-09 16:52:27 +02:00
Jason
ca159ae4b8
Fix typo
2018-10-07 12:49:02 +02:00
ridiculousfish
0f0bb1e10f
Don't resolve symlinks with cd
...
This switches fish to a "virtual" PWD, where it no longer uses getcwd to
discover its PWD but instead synthesizes it based on normalizing cd against
the $PWD variable.
Both pwd and $PWD contain the virtual path. pwd is taught about -P to
return the physical path, and -L the logical path (which is the default).
Fixes #3350
2018-10-06 17:03:18 -07:00
Fabian Homborg
444f9f8715
Add separation of "preset" bindings
...
This allows for marking certain bindings as part of a preset, which allows us to
- only erase those when switching presets
- go back to the preset binding when erasing a user binding
- only show user customization if requested
- make bare bind statements in config.fish work (!!!11elf!!!)
Fixes #5191 .
Fixes #3699 .
2018-09-30 16:54:56 +02:00
David Adam
5cc92ffd70
Documentation for while: note new exit status changes
...
Work on #4982 .
2018-09-28 22:57:02 +08:00
Fabian Homborg
d44c21b580
Document/complete feature flags more
2018-09-16 10:39:15 +02:00
Fabian Homborg
bda147c7d3
Correct math docs
...
This was an oversight when math was changed to default to float output.
Also some more jokey stuff. Jokey stuff is nice.
2018-09-15 15:31:59 +02:00
Jason
5d59c6a1cd
Correct argument order for signal handler example
2018-09-10 19:05:06 +02:00
ridiculousfish
cbcabf6d00
Add support for fish_ambiguous_width
...
fish_ambiguous_width is a variable which controls the width of ambiguous CJK
characters.
Fixes #5149
2018-08-18 15:38:05 -07:00
David Adam
c5ec7daab4
Revert "license.hdr: add Apache2 license for wcwidth9"
...
This reverts commit 00f2099f29
. wcwidth9
has been removed.
2018-07-14 15:43:37 +08:00
ridiculousfish
87f646d84d
Correct spelling of 'consistently'
2018-07-09 20:55:55 -07:00
gkdoc
c04cb9c715
Update FORMATTING.md ( #5087 )
2018-07-09 20:54:56 -07:00
ridiculousfish
73c747d162
Add string join0
...
string join0 joins its arguments using NUL byte, which complements
string split0. For example it allows piping a variable through sort -z.
2018-07-01 15:56:34 -07:00
ridiculousfish
b1176323e7
Document string split0
2018-07-01 15:56:34 -07:00
David Adam
dc17869a84
commandline docs: add note that -b selects autosuggestion
...
Suggested in #5000 .
2018-06-29 21:28:46 +08:00
David Adam
00f2099f29
license.hdr: add Apache2 license for wcwidth9
...
The wcwidth code is derived entirely from neovim, not from vim.
2018-06-29 21:27:29 +08:00
Fabian Homborg
cbdd347ec6
Changelog range expansion change, expand docs
2018-06-25 17:57:06 +02:00
Fabian Homborg
81a987c39c
Fix range expansion with negative ends
...
If just one of the range ends is negative, this now forces direction away from it.
I.e. if the beginning is negative, we go in reverse.
If the end is negative, we go forwards.
This fixes cases like
$var[2..-1]
if $var only has one element.
2018-06-25 17:52:56 +02:00
ridiculousfish
e812b609f9
Update set man page to clarify scoping rules
...
"When an exported variable goes out of scope, it is unexported."
As requested in #5064
2018-06-23 15:18:38 -07:00
Sabine Maennel
b347b44d9e
added 2 sections to the tutorial
...
Added 2 sections to the tutorial:
- getting started
- switching to fish
This fixes issue #475
2018-06-04 20:39:08 -07:00
David Adam
8a6fe77f71
docs: remove unneeded dashes
2018-05-31 13:07:02 +08:00
David Adam
84f5d2082a
Mark arguments as optional in read docs synopsis
2018-05-31 13:07:02 +08:00
Fabian Homborg
ff47b2dad5
[docs] Some rewording to the builtins
...
Plus some additional examples.
2018-05-14 00:36:49 +02:00
Fabian Homborg
90023e6dfb
[docs] Reword abbr
...
Move the variable discussion to a section at the bottom.
2018-05-14 00:34:56 +02:00
Fabian Homborg
b3ce3e2b7c
[docs] Reword variable expansion and cartesian product
...
This should be a bit nicer to read.
2018-05-13 23:57:16 +02:00
Fabian Homborg
7c5297e785
Merge branch 'master' into issue_4848
2018-05-11 16:06:27 +02:00
Fabian Homborg
2c312d05df
[docs] Add more subsections
...
They are great!
2018-05-08 17:26:56 +02:00
Fabian Homborg
5b1731331e
[math] Add subsection headers to the docs
...
Otherwise this is printed as "math-syntax" in the man page.
2018-05-08 17:11:48 +02:00
David Adam
21890ccac7
function: restore '%self' functionality for --on-process-exit
...
One key use of process expansion, used in currently-shipped code, is for running a function on
current shell exit.
Restore the use of %self as a valid argument (and add `self`) and document this change.
(faho: Remove bare "self")
2018-05-08 11:17:07 +02:00
ridiculousfish
d623ac5040
Add future feature flags to the documentation
2018-05-06 12:06:06 -07:00
ridiculousfish
87eb073ff9
Remove some references to ^ redirection from the docs
...
Replace these with 2>
2018-05-06 11:53:14 -07:00
ridiculousfish
762c31be87
Feature flag support for ? wildcard
...
This partially reverts 6e56637cf0
and #4520
by bringing back the ? wildcard, guarded by the qmark-noglob feature flag.
2018-05-06 11:20:15 -07:00
ridiculousfish
7cbc0c371a
Remove a "common fish problems" section in the docs
...
This wasn't really that common.
2018-05-06 11:19:58 -07:00
Fabian Homborg
1a1ee352ff
[commandline] Change "--selection" to "--current-selection"
...
Plus documentation.
Work towards #4255 .
2018-05-05 21:41:03 +02:00
Mahmoud Al-Qudsi
bd8c8ceb59
Add line-delimited read presets with --line and --all-lines
...
Refer to changes in doc_src/read.txt for more info. Closes #4861 .
2018-04-17 21:34:22 -05:00
Fabian Homborg
701259d372
Remove ":" from argparse docs
...
Also improve some of the wording.
Fixes #4871 .
[ci skip]
2018-04-10 21:26:02 +02:00
Fabian Homborg
a89e9e7ba3
Improve read docs re splitting
...
Intentionally make no mention of $IFS, because it is deprecated.
Fixes #4861 .
2018-04-10 21:26:02 +02:00
Thom Chiovoloni
25169a44ed
Add alias -s/--save
, which saves the alias.
...
Also updates the `alias` documentation to mention the `-h`/`--help` option,
which was previously undocumented.
2018-04-09 01:08:56 +02:00
ridiculousfish
6e56637cf0
Remove support for the ? wildcard
...
Fixes #4520
2018-03-31 16:54:50 -07:00