aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src
Commit message (Collapse)AuthorAge
* Rename "snippets" to "conf" internally, and document them as snippetsGravatar David Adam2016-04-06
| | | | Discussed in #2896.
* Fix a couple of minor issues in string examplesGravatar Mark Griffiths2016-04-05
| | | | | | | Print correct return code in 2nd example Remove syntax colouring in \cg Signed-off-by: Mark Griffiths <mark@thebespokepixel.com>
* make the string man page more readableGravatar Kurtis Rader2016-04-04
| | | | | | | I didn't notice when I merged commit cb6d5d76c8232264f66c9a1db895d9dd69d77bc3 by thebespokepixel.com that it removed the explicit wrapping in the `string` man page. That makes `man string` harder to read so reinstate the explicit wrapping.
* Customisable extra configuration, completion and function directoriesGravatar David Adam2016-04-04
| | | | | | | | | | | | | | | - Add options to the autotools build to set the path for the "vendor" or "extra" configuration snippets, functions and completions directories. - Remove the vendor_completions directory from the Xcode build, as these are relocatable and compiling the paths in does not make sense. This allows packaging tools like Homebrew and Nix to use a common directory outside of the main prefix for third-party completions, and to make these available for programmatic discovery through `pkg-config`. Closes #2113
* update lexicon for latest docsGravatar Mark Griffiths2016-04-04
| | | | | | | | | | | | | | | | | | | | | | | | | | | Closes #2699 Fixes issues with: * 'string' function synopsis * Redirection display issues * Better file & path detection * Rendering of % & @ chars in both html and man * @ symbol in tutorial Improves robustness by implementing an @EOL marker to prevent hold buffer dumping extra chars after the end of an expression. Added new '{{' and '}}' meta-chars for when you want curly braces in a regexp that was previously tripping up the lexicon. Improve man/html presentation consistency for * string * printf * prompt_pwd * type Use cli-styling for 'practical' examples. Add <bs> tag for presenting content with preceding backslash. Signed-off-by: Mark Griffiths <mark@thebespokepixel.com>
* remove "doc" make target and rename "user_doc"Gravatar Kurtis Rader2016-03-30
| | | | Fixes #2874
* clarify behavior of ** globGravatar Kurtis Rader2016-03-29
| | | | Fixes #2680
* Reword: Always call suggestions sugggestionsGravatar Fabian Homborg2016-03-29
| | | | Not completions.
* Document pager searchGravatar Fabian Homborg2016-03-29
| | | | Fixes #2866.
* Document more keybindingsGravatar Fabian Homborg2016-03-29
| | | | Fixes #2866.
* Only read .fish files in the snippets directoriesGravatar Fabian Homborg2016-03-26
| | | | | This would allow us to add a README and allows users to easily disable something temporarily.
* limit size of cd history to 25 directoriesGravatar Kurtis Rader2016-03-23
| | | | | | | | | | | | | | | The existing implementation grows the $dirprev array without bounds. Besides causing what would appear to be a memory leak it also makes the nextd and prevd commands more expensive than they need to be. It also makes it harder to create a useful "menu" cd command. In addition to implementing a reasonable limit on the size of the $dirprev array I've reformatted the code using fish_indent. Update the documentation to include mentions of the $dirprev and $dirnext variables as well as the limit on how much directory history is kept. Fixes 2836
* Add missing "Universal Variables" to tutorial.hdrGravatar Nyanpasu2016-03-22
|
* implement swap-selection-start-stop functionGravatar Federico Ferri2016-03-20
| | | | | | | | | The swap-selection-start-stop function goes to the other end of the highlighted text, the equivalent of `o' for vim visual mode. Add binding to the swap-selection-start-stop function, `o' when in visual mode. Document swap-selection-start-stop, begin-selection, end-selection, kill-selection.
* Document more bind functionsGravatar Fabian Homborg2016-03-06
| | | | Fixes #2534 as backward-kill-path-component is now documented.
* Fix stylistic nit in glob documentationGravatar Fabian Homborg2016-03-03
| | | | The test is unnecessary.
* Migrate abbrs from =-separated to space-separatedGravatar Fabian Homborg2016-03-02
| | | | | | | | | We silently upgrade existing abbreviations and change the separator when saving. This does not yet warn when the user is using the old syntax. Resolves #2051
* reduce number of Unicode private-use charactersGravatar Kurtis Rader2016-02-28
| | | | | | | | | This narrows the range of Unicode codepoints fish reserves for its own use from U+E000 thru U+F8FE (6399 codepoints) to U+F600 thru U+F73F (320 codepoints). This is still not ideal since fish shouldn't be using any Unicode private-use codepoints but it's a step in the right direction. This partially addresses issue #2684.
* Clarify example in $PATH tutorialGravatar Fabian Homborg2016-02-29
| | | | See #2777
* Try to clarify test documentation for newbiesGravatar Fabian Homborg2016-02-28
| | | | See #2773
* Add functions and configuration snippets hierarchyGravatar Fabian Homborg2016-02-26
| | | | | | | | | | | | This allows "vendors" (i.e. third-party upstreams interested in supporting fish) to add auto-loaded functions and eager-loaded configuration "snippets", while still allowing both the user and the administrator to fully override all of that. This has been inspired by systemd's configuration hierarchy, and implements a similar scheme whereby files with the same name in higher-ranking directories override files in lower-ranking ones. Fixes #1956
* Update index.hdr.inGravatar Adam Dymitruk2016-02-22
| | | | simple grammar correction
* add files for the fish logo as used for the fish-shell stickersGravatar Steve Stagg2016-02-22
|
* docs: Remove duplicate color variable listingGravatar Fabian Homborg2016-02-21
|
* Add fish_color_autosuggestion to docsGravatar Fabian Homborg2016-02-19
| | | | Fixes #2741.
* Reinstate failglob behaviour for most commandsGravatar Andreas Nordal2016-02-15
| | | | | | | | | | | | | | | | | Expand globs to zero arguments (nullglob) only for set, for and count. The warning about failing globs, and setting the accompanying $status, now happens regardless of mode, interactive or not. It is assumed that the above commands are the common cases where nullglob behaviour is desirable. More importantly, doing this with `set` is a real feature enabler, since the resulting empty array can be passed on to any command. The previous behaviour was actually all nullglob (since commit cab115c8b9933ae7db9412c66d452c0ccb2d7152), but this was undocumented; the failglob warning was still printed in interactive mode, and the documentation was bragging about failglob behaviour.
* Soften abbr-in-config.fish wordingGravatar Fabian Homborg2016-02-13
| | | | | This isn't as necessary anymore and having abbrs in config.fish is nice for e.g. storing it in git.
* Simplify escape character documentation in doc_src/bind.txtGravatar ridiculousfish2016-02-04
|
* Merge change for lengthened and configurable escape key timeoutGravatar ridiculousfish2016-02-04
|\
| * change default escape timeoutGravatar Kurtis Rader2016-02-04
| | | | | | | | | | | | | | | | This changes the default escape timeout for the default keybindings (emacs mode) to 300ms and the default for vi keybindings to 10ms. I couldn't resist fixing a few nits in the fish_vi_key_bindings.fish file since I was touching it to set the escape timeout.
| * incorporate suggestion by @oranjaGravatar Kurtis Rader2016-02-04
| |
* | fix several build warningsGravatar Kurtis Rader2016-01-28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This fixes all but one of the warnings documented in issue #2685. The sole remaining warning is from the string split '' abc example in doc_src/string.txt. That example results in the man page displaying string split {} abc I leave it to someone else to fix that problem (I'll open an issue specifically for it since it took some effort to track down the source of the warning). Resolves issue #2685.
* | Better document that binds in config.fish don't workGravatar Fabian Homborg2016-01-24
| | | | | | | | Fixes #230
* | Document that appending to universal variables in config.fish is not aGravatar Fabian Homborg2016-01-24
| | | | | | | | | | | | good idea Fixes #2058.
* | Document that abbrs should be added onceGravatar Fabian Homborg2016-01-24
| | | | | | | | | | While abbrs are still stored in a universal variable, it's much quicker to just add them once and not just put `abbr --add key value` in config.fish.
| * document the escape timeoutGravatar Kurtis Rader2016-01-21
| |
* | improve set_color and theme color documentationGravatar Kurtis Rader2016-01-14
| | | | | | | | | | | | | | | | | | This is meant to make it clear that fish cannot control the terminal window background color. It also augments the set_color documentation to describe how it decides which color the terminal can display. Resolves #2421. Resolves #2184.
* | Fix typos in indexGravatar Fabian Homborg2016-01-10
| | | | | | | | Fixes fish-site#30.
* | Shorten some of the language in random docsGravatar ridiculousfish2016-01-07
| |
* | clarify the documentation of builtin randomGravatar Kurtis Rader2016-01-07
| | | | | | | | | | | | | | | | | | The random builtin command may or may not produce values with a truly random distribution. So make the documentation reflect that reality. Also, make the command consistent with similar shells (e.g., bash, zsh) which produce a range of [0..32767]. Resolves issue #1272.
* | Tweak `complete` docs againGravatar Kevin Ballard2016-01-01
| | | | | | | | | | | | * Add a note to the `--wrap` docs saying that wrapping only works when specifying completions for commands, not for paths. * Add more info about how `--arguments` is handled.
* | Update the docs for `complete`Gravatar Kevin Ballard2016-01-01
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * Indicate which options can be repeated in the usage lines. * Reorder the options in usage slightly to group better. * Reorder the option descriptions to match the order as seen in usage. * Update some of the option descriptions. * Fix the documentation for -C to show that it must be `-CSTRING` instead of `-C STRING`. * Document the behavior of `-C` with no argument. * Tweak some of the explanatory text after the option list. * Delete `--authoritative` and `--unauthoritative` from the documentation entirely. Those options appear to not actually do anything in the new parser.
* | Remove phone number.Gravatar ffdd2015-12-26
| |
* | Mention correct config fileGravatar Jannik V2015-12-24
|/ | | While the tutorial explains how to set the `PATH` variable, it mentions the file `fish.config` but it should be `config.fish`.
* Document prompt_pwdGravatar Fabian Homborg2015-12-17
| | | | Fixes #253
* Merge pull request #2607 from jakwings/docGravatar Fabian Homborg2015-12-16
|\ | | | | Improve documentations (see #354)
* | configure/docs: update sf.net to sourceforge.netGravatar David Adam2015-12-15
| | | | | | | | | | | | Closes fish-shell/fish-site#29 [ci skip]
| * Doc: Link Cartesian Product in tutorial to main documentaion.Gravatar Jak Wings2015-12-14
| |
| * Doc: Introduce Cartesian Products on the main documentaion page.Gravatar Jak Wings2015-12-14
| |
| * Doc: Introduce another simple way to separate variable names from text.Gravatar Jak Wings2015-12-14
|/ | | | | This can avoid the confusion between brace expansion and the cartesian product behavior of arrays, even if braces can help to do some hacks.