From be827c7b8efad5afc6c800ea47989001ae4a8522 Mon Sep 17 00:00:00 2001 From: Jorge Bucaran Date: Sat, 7 May 2016 19:12:59 +0900 Subject: [PATCH] Simplify, remove hard to maintain numbers. --- README.md | 95 ++++++++++++++++++------------------------------------- 1 file changed, 30 insertions(+), 65 deletions(-) diff --git a/README.md b/README.md index ce2ee06..b67bbfb 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ [travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg [organization]: https://github.com/fisherman -[fish-shell]: https://github.com/fish-shell/fish-shell +[fish]: https://fish.sh [fisherman]: http://fisherman.sh [online]: http://fisherman.sh/#search @@ -19,9 +19,9 @@ [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] -# [fisherman] - fish plugin manager +# [fisherman] -fisherman is a concurrent plugin manager for [fish-shell]. +A plugin manager for [fish]. Translations: [日本語], [简体中文], [한국어], [Русский], [Català], [Português], [Español]. @@ -37,8 +37,6 @@ Translations: [日本語], [简体中文], [한국어], [Русский], [Catal ## Install -With curl. - ```sh curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman ``` @@ -54,13 +52,7 @@ fisher simple Install from multiple sources. ``` -fisher z fzf omf/{grc,thefuck} -``` - -Install from a URL. - -``` -fisher https://github.com/edc/bass +fisher z fzf edc/bass omf/tab ``` Install a gist. @@ -72,30 +64,29 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2 Install a local directory. ```sh -fisher ~/my_aliases +fisher ~/plugin ``` -Edit your [fishfile](#6-what-is-a-fishfile-and-how-do-i-use-it) and run `fisher` to satisfy changes. +Edit your [fishfile](#what-is-a-fishfile-and-how-do-i-use-it) and run `fisher` to satisfy changes. ```sh -$EDITOR fishfile # add plugins +$EDITOR ~/.config/fish/fishfile fisher ``` -See what's installed. +List what you've installed. ```ApacheConf fisher ls -@ my_aliases # this is a local directory -* simple # this is the current prompt +@ plugin # a local directory +* simple # the current prompt bass fzf - grc - thefuck + tab z ``` -See everything available. +List everything that's available. ``` fisher ls-remote @@ -110,7 +101,7 @@ fisher up Update some plugins. ``` -fisher up bass z fzf thefuck +fisher up bass z fzf ``` Remove plugins. @@ -131,13 +122,19 @@ Get help. fisher help z ``` +Uninstall fisherman. + +``` +fisher self-uninstall +``` + ## FAQ -### 1. What is the required fish version? +### What is the required fish version? \>=2.2.0. -For [snippet](#8-what-is-a-plugin) support, upgrade to 2.3.0 or append the following code to your *~/.config/fish/config.fish*. +For [snippet](#what-is-a-plugin) support, upgrade to >=2.3.0 or append the following code to your *~/.config/fish/config.fish*. ```fish for file in ~/.config/fish/conf.d/*.fish @@ -145,66 +142,34 @@ for file in ~/.config/fish/conf.d/*.fish end ``` -### 2. How do I use fish as my default shell? - -Add fish to the list of login shells in */etc/shells* and make it the default. - -```sh -echo "/usr/local/bin/fish" | sudo tee -a /etc/shells -chsh -s /usr/local/bin/fish -``` - -### 3. How do I uninstall fisherman? - -```fish -fisher self-uninstall -``` - -### 4. Is fisherman compatible with oh my fish themes and plugins? +### Is fisherman compatible with oh-my-fish themes and plugins? Yes. -### 5. Where does fisherman put stuff? +### Where does fisherman put stuff? The cache and configuration go in *~/.cache/fisherman* and *~/.config/fisherman* respectively. The fishfile is saved to *~/.config/fish/fishfile*. -### 6. What is a fishfile and how do I use it? +### What is a fishfile and how do I use it? The fishfile *~/.config/fish/fishfile* lists all the installed plugins. You can let fisherman take care of this file for you automatically, or write in the plugins you want and run `fisher` to satisfy the changes. -``` -fisherman/simple -fisherman/z -omf/thefuck -omf/grc -``` +This mechanism only installs plugins and missing dependencies. To remove plugins, use `fisher rm`. -This mechanism only installs plugins and missing dependencies. To remove a plugin, use `fisher rm` instead. - -### 7. Where can I find the list of fish plugins? - -Browse the [organization] or use the [online] search to discover content. - -### 8. What is a plugin? +### What is a plugin? A plugin is: -1. a directory or git repo with a function *.fish* file either at the root level of the project or inside a *functions* directory +1. a directory or git repo with one or more *.fish* functions either at the root level of the project or inside a *functions* directory 2. a theme or prompt, i.e, a *fish_prompt.fish*, *fish_right_prompt.fish* or both files -3. a snippet, i.e, one or more *.fish* files inside a directory named *conf.d* that are evaluated by fish at the start of the shell +3. a snippet, i.e, one or more *.fish* files inside a directory named *conf.d*, evaluated by fish at the start of the session -### 9. How can I list plugins as dependencies to my plugin? +### How can I list plugins as dependencies to my plugin? -Create a new *fishfile* file at the root level of your project and write in the plugin dependencies. - -```fish -owner/repo -https://github.com/owner/repo -https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32 -``` +Create a new *fishfile* file at the root level of your project and write in the plugins you'd like to depend on.