mirror of
https://github.com/jorgebucaran/fisher
synced 2024-08-17 12:31:05 +02:00
181 lines
4.9 KiB
Groff
181 lines
4.9 KiB
Groff
.\" generated with Ronn/v0.7.3
|
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
|
.
|
|
.TH "FISHER\-FAQ" "7" "February 2016" "" "fisherman"
|
|
.
|
|
.SH "NAME"
|
|
\fBfisher\-faq\fR \- Frequently Asked Questions
|
|
.
|
|
.SH "SYNOPSIS"
|
|
This document attempts to answer some of Fisherman most frequently asked questions\. Feel free to create a new issue in the Fisherman issue tracker if your question is not answered here\.
|
|
.
|
|
.SS "What is Fisherman?"
|
|
Fisherman is a plugin manager for fish that lets you share and reuse code, prompts and configurations easily\.
|
|
.
|
|
.SS "What do I need to know to use Fisherman?"
|
|
Nothing\. You can continue using your shell as usual\. When you are ready to learn more just type \fBfisher help\fR or \fBfisher help tour\fR\.
|
|
.
|
|
.SS "How do I access the documentation?"
|
|
Fisherman documentation is based in UNIX \fBman(1)\fR pages\. For basic usage and command enter \fBfisher help\fR\. For help about a specific \fIcommand\fR, enter \fBfisher help <command>\fR\. The following guides are also available:
|
|
.
|
|
.P
|
|
fisher help \fBfaq\fR: Fisherman FAQ
|
|
.
|
|
.br
|
|
fisher help \fBtour\fR: Fisherman Tour
|
|
.
|
|
.br
|
|
fisher help \fBconfig\fR: Fisherman Configuration
|
|
.
|
|
.br
|
|
fisher help \fBplugins\fR: Creating Fisherman Plugins
|
|
.
|
|
.br
|
|
fisher help \fBcommands\fR: Creating Fisherman Commands
|
|
.
|
|
.br
|
|
fisher help \fBfishfile\fR: Fishfile Format
|
|
.
|
|
.br
|
|
.
|
|
.SS "What are Fisherman plugins?"
|
|
Plugins are written in fish and extend the shell core functionality, run initialization code, add completions or documentations to other commands, etc\. See \fBfisher help plugins\fR\.
|
|
.
|
|
.P
|
|
Plugins may list any number of dependencies to other plugins using a \fIfishfile\fR\.
|
|
.
|
|
.SS "What is a Fishfile?"
|
|
A plain text file that lists what plugins you have installed or a plugin\'s dependencies to other plugins\.
|
|
.
|
|
.P
|
|
Fishfiles let you share plugin configurations across multiple installations, allow plugins to declare dependencies, and prevent information loss in case of system failure\. See also \fBfisher help fishfile\fR\.
|
|
.
|
|
.SS "What kind of Fisherman plugins are there?"
|
|
There is no technical distinction between plugins, themes, commands, etc\., but there is a \fIconceptual\fR difference\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBStandalone Utilities\fR: Plugins that define one or more functions, meant to be used at the command line\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBPrompts / Themes\fR: Plugins that modify the appearance of the fish prompt by defining a \fBfish_prompt\fR and / or \fBfish_right_prompt\fR functions\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBExtension Commands\fR: Plugins that extend Fisherman default commands\. An extension plugin must define one or more functions like \fBfisher_<my_command>\fR\. For specific information about commands, see \fBfisher help commands\fR and then return to this guide\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBConfiguration Plugins\fR: Plugins that include one or more \fBmy_plugin\.config\.fish\fR files\. Files that follow this convention are evaluated at the start of the session\.
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
See \fBfisher help plugins\fR and \fBfisher help commands\fR\.
|
|
.
|
|
.SS "Does Fisherman support Oh My Fish plugins and themes?"
|
|
Yes\. To install either a plugin or theme use their URL:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
fisher install omf/plugin\-{rbenv,tab} omf/theme\-scorphish
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
You can use the same mechanism to install any valid plugin from any given URL\. See also \fBCompatibility\fR in \fBfisher help tour\fR\.
|
|
.
|
|
.SS "What does Fisherman do exactly every time I create a new shell session?"
|
|
Essentially, add Fisherman functions and completions to the \fB$fish_{function,complete}_path\fR and evaluate files that follow the convention \fB*\.config\.fish\fR\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
set fish_function_path {$fisher_config,$fisher_home}/functions $fish_function_path
|
|
set fish_complete_path {$fisher_config,$fisher_home}/completions $fish_complete_path
|
|
|
|
for file in $fisher_config/conf\.d/*\.config\.fish
|
|
source $file
|
|
end
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
See \fB$fisher_home/config\.fish\fR for the full code\.
|
|
.
|
|
.SS "How is Fisherman faster than Oh My Fish and other systems?"
|
|
Fisherman ameliorates the slow shell start problem using a flat dependency tree instead of loading a directory hierarchy per plugin\. This also means that Fisherman performance does not decline depending on the number of plugins installed\. See also \fBFlat Tree\fR in \fBfisher help tour\fR\.
|
|
.
|
|
.SS "How can I upgrade from an existing Oh My Fish or Wahoo installation?"
|
|
Remove the \fB$OMF_PATH\fR and \fB$OMF_CONFIG\fR variables from your \fBconfig\.fish\fR\.
|
|
.
|
|
.P
|
|
Backup dotfiles and other sensitive data\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
rm \-rf {$OMF_PATH,$OMF_CONFIG}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Install Fisherman\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
curl \-sL install\.fisherman\.sh | fish
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SS "How do I use fish as my default shell?"
|
|
Add Fish to \fB/etc/shells\fR:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
echo "/usr/local/bin/fish" | sudo tee \-a /etc/shells
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Make Fish your default shell:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
chsh \-s /usr/local/bin/fish
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
To switch back to another shell\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
chsh \-s /bin/another/shell
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
|