README.md

@@ -30,15 +30,12 @@ A minimalist Vim plugin manager.
 
 <img src="https://raw.githubusercontent.com/junegunn/i/master/vim-plug/installer.gif" height="450">
 
-## Pros.
+### Pros.
 
-- Minimalist design
+- Easy to set up: Single file. No boilerplate code required.
-    - Just one file with no dependencies. Super easy to set up.
+- Easy to use: Concise, intuitive syntax
-    - Concise, intuitive syntax that you can learn within minutes. No boilerplate code required.
-    - No feature bloat
-- Extremely stable with flawless backward compatibility
-    - Works perfectly with all versions of Vim since 2006 and all versions of Neovim ever released
 - [Super-fast][40/4] parallel installation/update
+  (with any of `+job`, `+python`, `+python3`, `+ruby`, or [Neovim][nv])
 - Creates shallow clones to minimize disk space usage and download time
 - On-demand loading for [faster startup time][startup-time]
 - Can review and rollback updates
@@ -47,19 +44,17 @@ A minimalist Vim plugin manager.
 - Support for externally managed plugins
 
 [40/4]: https://raw.githubusercontent.com/junegunn/i/master/vim-plug/40-in-4.gif
+[nv]: http://neovim.org/
 [startup-time]: https://github.com/junegunn/vim-startuptime-benchmark#result
 
-## Installation
+### Installation
 
 [Download plug.vim](https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim)
 and put it in the "autoload" directory.
 
-<details>
+#### Vim
-<summary>Click to see the instructions</summary>
 
-### Vim
+###### Unix
-
-#### Unix
 
 ```sh
 curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
@@ -71,94 +66,59 @@ file as suggested [here][auto].
 
 [auto]: https://github.com/junegunn/vim-plug/wiki/tips#automatic-installation
 
-#### Windows (PowerShell)
+###### Windows (PowerShell)
 
 ```powershell
 iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
     ni $HOME/vimfiles/autoload/plug.vim -Force
 ```
 
-### Neovim
+#### Neovim
 
-#### Unix, Linux
+###### Unix, Linux
 
 ```sh
 sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
        https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'
 ```
 
-#### Linux (Flatpak)
+###### Linux (Flatpak)
 
 ```sh
 curl -fLo ~/.var/app/io.neovim.nvim/data/nvim/site/autoload/plug.vim --create-dirs \
     https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
 ```
 
-#### Windows (PowerShell)
+###### Windows (PowerShell)
 
 ```powershell
 iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
     ni "$(@($env:XDG_DATA_HOME, $env:LOCALAPPDATA)[$null -eq $env:XDG_DATA_HOME])/nvim-data/site/autoload/plug.vim" -Force
 ```
 
-</details>
-
-## Usage
-
-Add a vim-plug section to your `~/.vimrc` (or `~/.config/nvim/init.vim` for Neovim)
-
-1. Begin the section with `call plug#begin()`
-1. List the plugins with `Plug` commands
-1. End the section with `call plug#end()`
-
-For example,
-
-```vim
-call plug#begin()
-
-" List your plugins here
-Plug 'tpope/vim-sensible'
-
-call plug#end()
-```
-
-Reload the file or restart Vim, then you can,
-
-* `:PlugInstall` to install the plugins
-* `:PlugUpdate` to install or update the plugins
-* `:PlugDiff` to review the changes from the last update
-* `:PlugClean` to remove plugins no longer in the list
-
-> [!NOTE]
-> That's basically all you need to know to get started. The rest of the
-> document is for advanced users who want to know more about the features and
-> options.
-
-> [!TIP]
-> `plug#end()` automatically executes `filetype plugin indent on` and `syntax
-> enable`. We believe this is a good default for most users, but if you don't
-> want this behavior, you can revert the settings after the call.
->
-> ```vim
-> call plug#end()
-> filetype indent off   " Disable file-type-specific indentation
-> syntax off            " Disable syntax highlighting
-> ```
-
 ### Getting Help
 
-- See [tutorial] page to learn more about the basics of vim-plug
+- See [tutorial] page to learn the basics of vim-plug
 - See [tips] and [FAQ] pages for common problems and questions
+- See [requirements] page for debugging information & tested configurations
+- Create an [issue](https://github.com/junegunn/vim-plug/issues/new)
 
 [tutorial]: https://github.com/junegunn/vim-plug/wiki/tutorial
 [tips]: https://github.com/junegunn/vim-plug/wiki/tips
 [FAQ]: https://github.com/junegunn/vim-plug/wiki/faq
+[requirements]: https://github.com/junegunn/vim-plug/wiki/requirements
 
-## Examples
+### Usage
 
-The following examples demonstrate the additional features of vim-plug.
+Add a vim-plug section to your `~/.vimrc` (or `stdpath('config') . '/init.vim'` for Neovim)
 
-### Vim script example
+1. Begin the section with `call plug#begin([PLUGIN_DIR])`
+1. List the plugins with `Plug` commands
+1. `call plug#end()` to update `&runtimepath` and initialize plugin system
+    - Automatically executes `filetype plugin indent on` and `syntax enable`.
+      You can revert the settings after the call. e.g. `filetype indent off`, `syntax off`, etc.
+
+#### Example
 
 ```vim
 call plug#begin()
@@ -172,55 +132,48 @@ call plug#begin()
 
 " Make sure you use single quotes
 
-" Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
+" Shorthand notation; fetches https://github.com/junegunn/vim-easy-align
-Plug 'junegunn/seoul256.vim'
+Plug 'junegunn/vim-easy-align'
 
 " Any valid git URL is allowed
-Plug 'https://github.com/junegunn/vim-easy-align.git'
+Plug 'https://github.com/junegunn/vim-github-dashboard.git'
+
+" Multiple Plug commands can be written in a single line using | separators
+Plug 'SirVer/ultisnips' | Plug 'honza/vim-snippets'
+
+" On-demand loading
+Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
+Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
+
+" Using a non-default branch
+Plug 'rdnetto/YCM-Generator', { 'branch': 'stable' }
 
 " Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
 Plug 'fatih/vim-go', { 'tag': '*' }
 
-" Using a non-default branch
+" Plugin options
-Plug 'neoclide/coc.nvim', { 'branch': 'release' }
+Plug 'nsf/gocode', { 'tag': 'v.20150303', 'rtp': 'vim' }
 
-" Use 'dir' option to install plugin in a non-default directory
+" Plugin outside ~/.vim/plugged with post-update hook
-Plug 'junegunn/fzf', { 'dir': '~/.fzf' }
-
-" Post-update hook: run a shell command after installing or updating the plugin
 Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': './install --all' }
 
-" Post-update hook can be a lambda expression
-Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
-
-" If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
-Plug 'nsf/gocode', { 'rtp': 'vim' }
-
-" On-demand loading: loaded when the specified command is executed
-Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
-
-" On-demand loading: loaded when a file with a specific file type is opened
-Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
-
 " Unmanaged plugin (manually installed and updated)
 Plug '~/my-prototype-plugin'
 
-" Call plug#end to update &runtimepath and initialize the plugin system.
+" Initialize plugin system
-" - It automatically executes `filetype plugin indent on` and `syntax enable`
+" - Automatically executes `filetype plugin indent on` and `syntax enable`.
 call plug#end()
 " You can revert the settings after the call like so:
 "   filetype indent off   " Disable file-type-specific indentation
 "   syntax off            " Disable syntax highlighting
-
-" Color schemes should be loaded after plug#end().
-" We prepend it with 'silent!' to ignore errors when it's not yet installed.
-silent! colorscheme seoul256
 ```
 
-### Lua example for Neovim
+Reload .vimrc and `:PlugInstall` to install plugins.
+
+#### Example (Lua configuration for Neovim)
 
 In Neovim, you can write your configuration in a Lua script file named
-`init.lua`. The following code is the Lua script equivalent to the Vim script
+`init.lua`. The following code is the Lua script equivalent to the VimScript
 example above.
 
 ```lua
@@ -229,49 +182,42 @@ local Plug = vim.fn['plug#']
 
 vim.call('plug#begin')
 
--- Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
+-- Shorthand notation; fetches https://github.com/junegunn/vim-easy-align
-Plug('junegunn/seoul256.vim')
+Plug('junegunn/vim-easy-align')
 
 -- Any valid git URL is allowed
-Plug('https://github.com/junegunn/vim-easy-align.git')
+Plug('https://github.com/junegunn/vim-github-dashboard.git')
+
+-- Multiple Plug commands can be written in a single line using ; separators
+Plug('SirVer/ultisnips'); Plug('honza/vim-snippets')
+
+-- On-demand loading
+Plug('preservim/nerdtree', { ['on'] = 'NERDTreeToggle' })
+Plug('tpope/vim-fireplace', { ['for'] = 'clojure' })
+
+-- Using a non-default branch
+Plug('rdnetto/YCM-Generator', { ['branch'] = 'stable' })
 
 -- Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
 Plug('fatih/vim-go', { ['tag'] = '*' })
 
--- Using a non-default branch
+-- Plugin options
-Plug('neoclide/coc.nvim', { ['branch'] = 'release' })
+Plug('nsf/gocode', { ['tag'] = 'v.20150303', ['rtp'] = 'vim' })
 
--- Use 'dir' option to install plugin in a non-default directory
+-- Plugin outside ~/.vim/plugged with post-update hook
-Plug('junegunn/fzf', { ['dir'] = '~/.fzf' })
-
--- Post-update hook: run a shell command after installing or updating the plugin
 Plug('junegunn/fzf', { ['dir'] = '~/.fzf', ['do'] = './install --all' })
 
--- Post-update hook can be a lambda expression
-Plug('junegunn/fzf', { ['do'] = function()
-  vim.fn['fzf#install']()
-end })
-
--- If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
-Plug('nsf/gocode', { ['rtp'] = 'vim' })
-
--- On-demand loading: loaded when the specified command is executed
-Plug('preservim/nerdtree', { ['on'] = 'NERDTreeToggle' })
-
--- On-demand loading: loaded when a file with a specific file type is opened
-Plug('tpope/vim-fireplace', { ['for'] = 'clojure' })
-
 -- Unmanaged plugin (manually installed and updated)
 Plug('~/my-prototype-plugin')
 
 vim.call('plug#end')
-
--- Color schemes should be loaded after plug#end().
--- We prepend it with 'silent!' to ignore errors when it's not yet installed.
-vim.cmd('silent! colorscheme seoul256')
 ```
 
-## Commands
+More examples can be found in:
+
+* https://gitlab.com/sultanahamer/dotfiles/-/blob/master/nvim/lua/plugins.lua?ref_type=heads
+
+### Commands
 
 | Command                             | Description                                                        |
 | ----------------------------------- | ------------------------------------------------------------------ |
@@ -283,10 +229,10 @@ vim.cmd('silent! colorscheme seoul256')
 | `PlugDiff`                          | Examine changes from the previous update and the pending changes   |
 | `PlugSnapshot[!] [output path]`     | Generate script for restoring the current snapshot of the plugins  |
 
-## `Plug` options
+### `Plug` options
 
 | Option                  | Description                                      |
-| ----------------------- | ----------------------------------------------------------- |
+| ----------------------- | ------------------------------------------------ |
 | `branch`/`tag`/`commit` | Branch/tag/commit of the repository to use       |
 | `rtp`                   | Subdirectory that contains Vim plugin            |
 | `dir`                   | Custom directory for the plugin                  |
@@ -294,9 +240,9 @@ vim.cmd('silent! colorscheme seoul256')
 | `do`                    | Post-update hook (string or funcref)             |
 | `on`                    | On-demand loading: Commands or `<Plug>`-mappings |
 | `for`                   | On-demand loading: File types                    |
-| `frozen`                | Do not remove and do not update unless explicitly specified |
+| `frozen`                | Do not update unless explicitly specified        |
 
-## Global options
+### Global options
 
 | Flag                | Default                           | Description                                            |
 | ------------------- | --------------------------------- | ------------------------------------------------------ |
@@ -309,19 +255,54 @@ vim.cmd('silent! colorscheme seoul256')
 | `g:plug_url_format` | `https://git::@github.com/%s.git` | `printf` format to build repo URL (Only applies to the subsequent `Plug` commands) |
 
 
-## Keybindings
+### Keybindings
 
 - `D` - `PlugDiff`
 - `S` - `PlugStatus`
 - `R` - Retry failed update or installation tasks
 - `U` - Update plugins in the selected range
-- `q` - Abort the running tasks or close the window
+- `q` - Close the window
 - `:PlugStatus`
     - `L` - Load plugin
 - `:PlugDiff`
     - `X` - Revert the update
 
-## Post-update hooks
+### Example: A small [sensible](https://github.com/tpope/vim-sensible) Vim configuration
+
+```vim
+call plug#begin()
+Plug 'tpope/vim-sensible'
+call plug#end()
+```
+
+### On-demand loading of plugins
+
+```vim
+" NERD tree will be loaded on the first invocation of NERDTreeToggle command
+Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
+
+" Multiple commands
+Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }
+
+" Loaded when clojure file is opened
+Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
+
+" Multiple file types
+Plug 'kovisoft/paredit', { 'for': ['clojure', 'scheme'] }
+
+" On-demand loading on both conditions
+Plug 'junegunn/vader.vim',  { 'on': 'Vader', 'for': 'vader' }
+
+" Code to execute when the plugin is lazily loaded on demand
+Plug 'junegunn/goyo.vim', { 'for': 'markdown' }
+autocmd! User goyo.vim echom 'Goyo is now loaded!'
+```
+
+The `for` option is generally not needed as most plugins for specific file types
+usually don't have too much code in the `plugin` directory. You might want to
+examine the output of `vim --startuptime` before applying the option.
+
+### Post-update hooks
 
 There are some plugins that require extra steps after installation or update.
 In that case, use the `do` option to describe the task to be performed.
@@ -364,22 +345,21 @@ A post-update hook is executed inside the directory of the plugin and only run
 when the repository has changed, but you can force it to run unconditionally
 with the bang-versions of the commands: `PlugInstall!` and `PlugUpdate!`.
 
-> [!TIP]
+Make sure to escape BARs and double-quotes when you write the `do` option
-> Make sure to escape BARs and double-quotes when you write the `do` option
+inline as they are mistakenly recognized as command separator or the start of
-> inline as they are mistakenly recognized as command separator or the start of
+the trailing comment.
-> the trailing comment.
+
->
+```vim
-> ```vim
+Plug 'junegunn/fzf', { 'do': 'yes \| ./install' }
-> Plug 'junegunn/fzf', { 'do': 'yes \| ./install' }
+```
-> ```
+
->
+But you can avoid the escaping if you extract the inline specification using a
-> But you can avoid the escaping if you extract the inline specification using a
+variable (or any Vimscript expression) as follows:
-> variable (or any Vim script expression) as follows:
+
->
+```vim
-> ```vim
+let g:fzf_install = 'yes | ./install'
-> let g:fzf_install = 'yes | ./install'
+Plug 'junegunn/fzf', { 'do': g:fzf_install }
-> Plug 'junegunn/fzf', { 'do': g:fzf_install }
+```
-> ```
 
 ### `PlugInstall!` and `PlugUpdate!`
 
@@ -393,71 +373,18 @@ The installer takes the following steps when installing/updating a plugin:
 
 The commands with the `!` suffix ensure that all steps are run unconditionally.
 
-## On-demand loading of plugins
+### Articles
 
-```vim
+- [Writing my own Vim plugin manager](http://junegunn.kr/2013/09/writing-my-own-vim-plugin-manager)
-" NERD tree will be loaded on the first invocation of NERDTreeToggle command
+- [Vim plugins and startup time](http://junegunn.kr/2014/07/vim-plugins-and-startup-time)
-Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
+- ~~[Thoughts on Vim plugin dependency](http://junegunn.kr/2013/09/thoughts-on-vim-plugin-dependency)~~
+    - *Support for Plugfile has been removed since 0.5.0*
 
-" Multiple commands
+### Collaborators
-Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }
-
-" Loaded when clojure file is opened
-Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
-
-" Multiple file types
-Plug 'kovisoft/paredit', { 'for': ['clojure', 'scheme'] }
-
-" On-demand loading on both conditions
-Plug 'junegunn/vader.vim',  { 'on': 'Vader', 'for': 'vader' }
-
-" Code to execute when the plugin is lazily loaded on demand
-Plug 'junegunn/goyo.vim', { 'for': 'markdown' }
-autocmd! User goyo.vim echom 'Goyo is now loaded!'
-```
-
-> [!NOTE]
-> #### Should I set up on-demand loading?
->
-> You probably don't need to.
->
-> A properly implemented Vim plugin should already load lazily without any
-> help from a plugin manager (`:help autoload`). So there are few cases where
-> these options actually make much sense. Making a plugin load faster is
-> the responsibility of the plugin developer, not the user. If you find
-> a plugin that takes too long to load, consider opening an issue on the
-> plugin's issue tracker.
->
-> Let me give you a perspective. The time it takes to load a plugin is usually
-> less than 2 or 3ms on modern computers. So unless you use a very large
-> number of plugins, you are unlikely to save more than 50ms. If you have
-> spent an hour carefully setting up the options to shave off 50ms, you
-> will have to start Vim 72,000 times just to break even. You should ask
-> yourself if that's a good investment of your time.
->
-> Make sure that you're tackling the right problem by breaking down the
-> startup time of Vim using `--startuptime`.
->
-> ```sh
-> vim --startuptime /tmp/log
-> ```
->
-> On-demand loading should only be used as a last resort. It is basically
-> a hacky workaround and is not always guaranteed to work.
-
-> [!TIP]
-> You can pass an empty list to `on` or `for` option to disable the loading
-> of the plugin. You can manually load the plugin using `plug#load(NAMES...)`
-> function.
->
-> See https://github.com/junegunn/vim-plug/wiki/tips#loading-plugins-manually
-
-
-## Collaborators
 
 - [Jan Edmund Lazo](https://github.com/janlazo) - Windows support
 - [Jeremy Pallats](https://github.com/starcraftman) - Python installer
 
-## License
+### License
 
 MIT

doc/plug.txt

@@ -1,114 +1,136 @@
-plug.txt	plug	Last change: Jun 1 2024
+plug.txt	plug	Last change: March 7 2024
 PLUG - TABLE OF CONTENTS                                         *plug* *plug-toc*
 ==============================================================================
 
-  vim-plug                          |vim-plug|
+  vim-plug
-    Pros.                           |plug-pros|
+    Pros.
-    Installation                    |plug-installation|
+    Installation
-    Usage                           |plug-usage|
+      Vim
-      Getting Help                  |plug-getting-help|
+        Unix
-    Examples                        |plug-examples|
+        Windows (PowerShell)
-      Vim script example            |plug-vim-script-example|
+      Neovim
-      Lua example for Neovim        |plug-lua-example-for-neovim|
+        Unix
-    Commands                        |plug-commands|
+        Windows (PowerShell)
-    Plug options                    |plug-options|
+    Getting Help
-    Global options                  |plug-global-options|
+    Usage
-    Keybindings                     |plug-keybindings|
+      Example
-    Post-update hooks               |plug-post-update-hooks|
+    Commands
-      PlugInstall! and PlugUpdate!  |pluginstall-and-plugupdate|
+    Plug options
-    On-demand loading of plugins    |plug-on-demand-loading-of-plugins|
+    Global options
-    Collaborators                   |plug-collaborators|
+    Keybindings
-    License                         |plug-license|
+    Example: A small sensible Vim configuration
+    On-demand loading of plugins
+    Post-update hooks
+    PlugInstall! and PlugUpdate!
+    Articles
+    Collaborators
+    License
 
 VIM-PLUG                                                              *vim-plug*
 ==============================================================================
 
 A minimalist Vim plugin manager.
 
+https://raw.githubusercontent.com/junegunn/i/master/vim-plug/installer.gif
 
-PROS.                                                                *plug-pros*
-==============================================================================
 
- - Minimalist design
+< Pros. >_____________________________________________________________________~
-   - Just one file with no dependencies. Super easy to set up.
+                                                                     *plug-pros*
-   - Concise, intuitive syntax that you can learn within minutes. No
+
-     boilerplate code required.
+ - Easy to set up: Single file. No boilerplate code required.
-   - No feature bloat
+ - Easy to use: Concise, intuitive syntax
- - Extremely stable with flawless backward compatibility
+ - {Super-fast}{1} parallel installation/update (with any of `+job`, `+python`,
-   - Works perfectly with all versions of Vim since 2006 and all versions of
+   `+python3`, `+ruby`, or {Neovim}{2})
-     Neovim ever released
- - {Super-fast}{1} parallel installation/update
  - Creates shallow clones to minimize disk space usage and download time
- - On-demand loading for {faster startup time}{2}
+ - On-demand loading for {faster startup time}{3}
  - Can review and rollback updates
  - Branch/tag/commit support
  - Post-update hooks
  - Support for externally managed plugins
 
   {1} https://raw.githubusercontent.com/junegunn/i/master/vim-plug/40-in-4.gif
-  {2} https://github.com/junegunn/vim-startuptime-benchmark#result
+  {2} http://neovim.org/
+  {3} https://github.com/junegunn/vim-startuptime-benchmark#result
 
 
-INSTALLATION                                                 *plug-installation*
+< Installation >______________________________________________________________~
-==============================================================================
+                                                             *plug-installation*
 
-{Download plug.vim}{3} and put it in the "autoload" directory.
+{Download plug.vim}{4} and put it in the "autoload" directory.
 
-       {3} https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
+       {4} https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
 
 
-USAGE                                                               *plug-usage*
+Vim~
-==============================================================================
+                                                                      *plug-vim*
 
-Add a vim-plug section to your `~/.vimrc` (or `init.vim` for Neovim)
 
-                                                           *plug#begin* *plug#end*
+>> Unix~
-
- 1. Begin the section with `call plug#begin()`
- 2. List the plugins with `Plug` commands
- 3. End the section with `call plug#end()`
-
-For example,
 >
-    call plug#begin()
+    curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
-
+        https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
-    " List your plugins here
-    Plug 'tpope/vim-sensible'
-
-    call plug#end()
 <
-Reload the file or restart Vim, then you can,
+You can automate the process by putting the command in your Vim configuration
+file as suggested {here}{5}.
 
-                                            *:PlugInstall* *:PlugUpdate* *:PlugDiff*
+     {5} https://github.com/junegunn/vim-plug/wiki/tips#automatic-installation
 
- - `:PlugInstall` to install the plugins
- - `:PlugUpdate` to install or update the plugins
- - `:PlugDiff` to review the changes from the last update
 
-[!NOTE] That's basically all you need to know to get started. The rest of the
+>> Windows (PowerShell)~
-document is for advanced users who want to know more about the features and
+>
-options.
+    iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
+        ni $HOME/vimfiles/autoload/plug.vim -Force
+<
 
+Neovim~
+                                                                   *plug-neovim*
+
+
+>> Unix~
+>
+    sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
+           https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'
+<
+
+>> Windows (PowerShell)~
+>
+    iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
+        ni "$(@($env:XDG_DATA_HOME, $env:LOCALAPPDATA)[$null -eq $env:XDG_DATA_HOME])/nvim-data/site/autoload/plug.vim" -Force
+<
 
 < Getting Help >______________________________________________________________~
                                                              *plug-getting-help*
 
- - See {tutorial}{4} page to learn more about the basics of vim-plug
+ - See {tutorial}{6} page to learn the basics of vim-plug
- - See {tips}{5} and {FAQ}{6} pages for common problems and questions
+ - See {tips}{7} and {FAQ}{8} pages for common problems and questions
+ - See {requirements}{9} page for debugging information & tested configurations
+ - Create an {issue}{10}
 
-                        {4} https://github.com/junegunn/vim-plug/wiki/tutorial
+                    {6} https://github.com/junegunn/vim-plug/wiki/tutorial
-                        {5} https://github.com/junegunn/vim-plug/wiki/tips
+                    {7} https://github.com/junegunn/vim-plug/wiki/tips
-                        {6} https://github.com/junegunn/vim-plug/wiki/faq
+                    {8} https://github.com/junegunn/vim-plug/wiki/faq
+                    {9} https://github.com/junegunn/vim-plug/wiki/requirements
+                    {10} https://github.com/junegunn/vim-plug/issues/new
 
 
-EXAMPLES                                                         *plug-examples*
+< Usage >_____________________________________________________________________~
-==============================================================================
+                                                                    *plug-usage*
 
-The following examples demonstrate the additional features of vim-plug.
+Add a vim-plug section to your `~/.vimrc` (or `stdpath('config') . '/init.vim'` for
+Neovim)
+
+                                                           *plug#begin* *plug#end*
+
+ 1. Begin the section with `call plug#begin([PLUGIN_DIR])`
+ 2. List the plugins with `Plug` commands
+ 3. `call plug#end()` to update 'runtimepath' and initialize plugin system
+   - Automatically executes `filetype plugin indent on` and `syntax enable`.
+     You can revert the settings after the call. e.g. `filetype indent off`,
+     `syntax off`, etc.
 
 
-< Vim script example >________________________________________________________~
+Example~
-                                                       *plug-vim-script-example*
+                                                                  *plug-example*
 >
     call plug#begin()
     " The default plugin directory will be as follows:
@@ -121,129 +143,69 @@ The following examples demonstrate the additional features of vim-plug.
 
     " Make sure you use single quotes
 
-    " Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
+    " Shorthand notation; fetches https://github.com/junegunn/vim-easy-align
-    Plug 'junegunn/seoul256.vim'
+    Plug 'junegunn/vim-easy-align'
 
     " Any valid git URL is allowed
-    Plug 'https://github.com/junegunn/vim-easy-align.git'
+    Plug 'https://github.com/junegunn/vim-github-dashboard.git'
+
+    " Multiple Plug commands can be written in a single line using | separators
+    Plug 'SirVer/ultisnips' | Plug 'honza/vim-snippets'
+
+    " On-demand loading
+    Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
+    Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
+
+    " Using a non-default branch
+    Plug 'rdnetto/YCM-Generator', { 'branch': 'stable' }
 
     " Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
     Plug 'fatih/vim-go', { 'tag': '*' }
 
-    " Using a non-default branch
+    " Plugin options
-    Plug 'neoclide/coc.nvim', { 'branch': 'release' }
+    Plug 'nsf/gocode', { 'tag': 'v.20150303', 'rtp': 'vim' }
 
-    " Use 'dir' option to install plugin in a non-default directory
+    " Plugin outside ~/.vim/plugged with post-update hook
-    Plug 'junegunn/fzf', { 'dir': '~/.fzf' }
-
-    " Post-update hook: run a shell command after installing or updating the plugin
     Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': './install --all' }
 
-    " Post-update hook can be a lambda expression
-    Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
-
-    " If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
-    Plug 'nsf/gocode', { 'rtp': 'vim' }
-
-    " On-demand loading: loaded when the specified command is executed
-    Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
-
-    " On-demand loading: loaded when a file with a specific file type is opened
-    Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
-
     " Unmanaged plugin (manually installed and updated)
     Plug '~/my-prototype-plugin'
 
-    " Call plug#end to update &runtimepath and initialize the plugin system.
+    " Initialize plugin system
-    " - It automatically executes `filetype plugin indent on` and `syntax enable`
+    " - Automatically executes `filetype plugin indent on` and `syntax enable`.
     call plug#end()
     " You can revert the settings after the call like so:
     "   filetype indent off   " Disable file-type-specific indentation
     "   syntax off            " Disable syntax highlighting
-
-    " Color schemes should be loaded after plug#end().
-    " We prepend it with 'silent!' to ignore errors when it's not yet installed.
-    silent! colorscheme seoul256
 <
+                                                                  *:PlugInstall*
 
-< Lua example for Neovim >____________________________________________________~
+Reload .vimrc and `:PlugInstall` to install plugins.
-                                                   *plug-lua-example-for-neovim*
 
-In Neovim, you can write your configuration in a Lua script file named
-`init.lua`. The following code is the Lua script equivalent to the Vim script
-example above.
->
-    local vim = vim
-    local Plug = vim.fn['plug#']
 
-    vim.call('plug#begin')
+< Commands >__________________________________________________________________~
+                                                                 *plug-commands*
 
-    -- Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
+ ------------------------------------+-------------------------------------------------------------------
-    Plug('junegunn/seoul256.vim')
-
-    -- Any valid git URL is allowed
-    Plug('https://github.com/junegunn/vim-easy-align.git')
-
-    -- Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
-    Plug('fatih/vim-go', { ['tag'] = '*' })
-
-    -- Using a non-default branch
-    Plug('neoclide/coc.nvim', { ['branch'] = 'release' })
-
-    -- Use 'dir' option to install plugin in a non-default directory
-    Plug('junegunn/fzf', { ['dir'] = '~/.fzf' })
-
-    -- Post-update hook: run a shell command after installing or updating the plugin
-    Plug('junegunn/fzf', { ['dir'] = '~/.fzf', ['do'] = './install --all' })
-
-    -- Post-update hook can be a lambda expression
-    Plug('junegunn/fzf', { ['do'] = function()
-      vim.fn['fzf#install']()
-    end })
-
-    -- If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
-    Plug('nsf/gocode', { ['rtp'] = 'vim' })
-
-    -- On-demand loading: loaded when the specified command is executed
-    Plug('preservim/nerdtree', { ['on'] = 'NERDTreeToggle' })
-
-    -- On-demand loading: loaded when a file with a specific file type is opened
-    Plug('tpope/vim-fireplace', { ['for'] = 'clojure' })
-
-    -- Unmanaged plugin (manually installed and updated)
-    Plug('~/my-prototype-plugin')
-
-    vim.call('plug#end')
-
-    -- Color schemes should be loaded after plug#end().
-    -- We prepend it with 'silent!' to ignore errors when it's not yet installed.
-    vim.cmd('silent! colorscheme seoul256')
-<
-
-COMMANDS                                                         *plug-commands*
-==============================================================================
-
- -------------------------------------+------------------------------------------------------------------
  Command                             | Description                                                       ~
- -------------------------------------+------------------------------------------------------------------
+ ------------------------------------+-------------------------------------------------------------------
-  `PlugInstall [name ...] [#threads]`  | Install plugins
+  `PlugInstall [name ...] [#threads]`  | Install plugins
-  `PlugUpdate [name ...] [#threads]`   | Install or update plugins
+  `PlugUpdate [name ...] [#threads]`   | Install or update plugins
   `PlugClean[!]`                       | Remove unlisted plugins (bang version will clean without prompt)
   `PlugUpgrade`                        | Upgrade vim-plug itself
   `PlugStatus`                         | Check the status of plugins
   `PlugDiff`                           | Examine changes from the previous update and the pending changes
-  `PlugSnapshot[!] [output path]`      | Generate script for restoring the current snapshot of the plugins
+  `PlugSnapshot[!] [output path]`      | Generate script for restoring the current snapshot of the plugins
- -------------------------------------+------------------------------------------------------------------
+ ------------------------------------+-------------------------------------------------------------------
 
 
-PLUG OPTIONS                                                      *plug-options*
+< Plug options >______________________________________________________________~
-==============================================================================
+                                                                  *plug-options*
+                                                                         *:Plug*
 
-                                                               *<Plug>-mappings*
+ ------------------------+-----------------------------------------------
-
- ------------------------+------------------------------------------------------------
  Option                  | Description                                   ~
- ------------------------+------------------------------------------------------------
+ ------------------------+-----------------------------------------------
   `branch` / `tag` / `commit`  | Branch/tag/commit of the repository to use
   `rtp`                    | Subdirectory that contains Vim plugin
   `dir`                    | Custom directory for the plugin
@@ -251,12 +213,12 @@ PLUG OPTIONS                                                      *plug-options*
   `do`                     | Post-update hook (string or funcref)
   `on`                     | On-demand loading: Commands or <Plug>-mappings
   `for`                    | On-demand loading: File types
-  `frozen`                 | Do not remove and do not update unless explicitly specified
+  `frozen`                 | Do not update unless explicitly specified
- ------------------------+------------------------------------------------------------
+ ------------------------+-----------------------------------------------
 
 
-GLOBAL OPTIONS                                             *plug-global-options*
+< Global options >____________________________________________________________~
-==============================================================================
+                                                           *plug-global-options*
 
      *g:plug_threads* *g:plug_timeout* *g:plug_retries* *g:plug_shallow* *g:plug_window*
                                               *g:plug_pwindow* *g:plug_url_format*
@@ -274,8 +236,10 @@ GLOBAL OPTIONS                                             *plug-global-options*
  --------------------+-----------------------------------+-----------------------------------------------------------------------------------
 
 
-KEYBINDINGS                                                   *plug-keybindings*
+< Keybindings >_______________________________________________________________~
-==============================================================================
+                                                              *plug-keybindings*
+
+                                                         *:PlugStatus* *:PlugDiff*
 
  - `D` - `PlugDiff`
  - `S` - `PlugStatus`
@@ -288,8 +252,43 @@ KEYBINDINGS                                                   *plug-keybindings*
    - `X` - Revert the update
 
 
-POST-UPDATE HOOKS                                       *plug-post-update-hooks*
+< Example: A small sensible Vim configuration >_______________________________~
-==============================================================================
+                               *plug-example-a-small-sensible-vim-configuration*
+>
+    call plug#begin()
+    Plug 'tpope/vim-sensible'
+    call plug#end()
+<
+
+< On-demand loading of plugins >______________________________________________~
+                                             *plug-on-demand-loading-of-plugins*
+>
+    " NERD tree will be loaded on the first invocation of NERDTreeToggle command
+    Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
+
+    " Multiple commands
+    Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }
+
+    " Loaded when clojure file is opened
+    Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
+
+    " Multiple file types
+    Plug 'kovisoft/paredit', { 'for': ['clojure', 'scheme'] }
+
+    " On-demand loading on both conditions
+    Plug 'junegunn/vader.vim',  { 'on': 'Vader', 'for': 'vader' }
+
+    " Code to execute when the plugin is lazily loaded on demand
+    Plug 'junegunn/goyo.vim', { 'for': 'markdown' }
+    autocmd! User goyo.vim echom 'Goyo is now loaded!'
+<
+The `for` option is generally not needed as most plugins for specific file
+types usually don't have too much code in the `plugin` directory. You might
+want to examine the output of `vim --startuptime` before applying the option.
+
+
+< Post-update hooks >_________________________________________________________~
+                                                        *plug-post-update-hooks*
 
 There are some plugins that require extra steps after installation or update.
 In that case, use the `do` option to describe the task to be performed.
@@ -324,14 +323,16 @@ A post-update hook is executed inside the directory of the plugin and only run
 when the repository has changed, but you can force it to run unconditionally
 with the bang-versions of the commands: `PlugInstall!` and `PlugUpdate!`.
 
-[!TIP] Make sure to escape BARs and double-quotes when you write the `do`
+Make sure to escape BARs and double-quotes when you write the `do` option
-option inline as they are mistakenly recognized as command separator or the
+inline as they are mistakenly recognized as command separator or the start of
-start of the trailing comment.
+the trailing comment.
 >
     Plug 'junegunn/fzf', { 'do': 'yes \| ./install' }
 <
 But you can avoid the escaping if you extract the inline specification using a
 variable (or any Vimscript expression) as follows:
+
+                                                                 *g:fzf_install*
 >
     let g:fzf_install = 'yes | ./install'
     Plug 'junegunn/fzf', { 'do': g:fzf_install }
@@ -342,8 +343,8 @@ variable (or any Vim script expression) as follows:
 
 The installer takes the following steps when installing/updating a plugin:
 
- 1. `git clone` or `git fetch` from its origin
+ 1. `git clone` or `git fetch` from its origin
- 2. Check out branch, tag, or commit and optionally `git merge` remote branch
+ 2. Check out branch, tag, or commit and optionally `git merge` remote branch
  3. If the plugin was updated (or installed for the first time)
    1. Update submodules
    2. Execute post-update hooks
@@ -352,77 +353,34 @@ The commands with the `!` suffix ensure that all steps are run
 unconditionally.
 
 
-ON-DEMAND LOADING OF PLUGINS                 *plug-on-demand-loading-of-plugins*
+< Articles >__________________________________________________________________~
-==============================================================================
+                                                                 *plug-articles*
->
-    " NERD tree will be loaded on the first invocation of NERDTreeToggle command
-    Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
 
-    " Multiple commands
+ - {Writing my own Vim plugin manager}{11}
-    Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }
+ - {Vim plugins and startup time}{12}
+ - ~~{Thoughts on Vim plugin dependency}{13}~~
+   - Support for Plugfile has been removed since 0.5.0
 
-    " Loaded when clojure file is opened
+             {11} http://junegunn.kr/2013/09/writing-my-own-vim-plugin-manager
-    Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
+             {12} http://junegunn.kr/2014/07/vim-plugins-and-startup-time
-
+             {13} http://junegunn.kr/2013/09/thoughts-on-vim-plugin-dependency
-    " Multiple file types
-    Plug 'kovisoft/paredit', { 'for': ['clojure', 'scheme'] }
-
-    " On-demand loading on both conditions
-    Plug 'junegunn/vader.vim',  { 'on': 'Vader', 'for': 'vader' }
-
-    " Code to execute when the plugin is lazily loaded on demand
-    Plug 'junegunn/goyo.vim', { 'for': 'markdown' }
-    autocmd! User goyo.vim echom 'Goyo is now loaded!'
-<
-[!NOTE] #### Should I set up on-demand loading?
-
-You probably don't need to.
-
-A properly implemented Vim plugin should already load lazily without any help
-from a plugin manager (`:help autoload`). So there are few cases where these
-options actually make much sense. Making a plugin load faster is the
-responsibility of the plugin developer, not the user. If you find a plugin
-that takes too long to load, consider opening an issue on the plugin's issue
-tracker.
-
-Let me give you a perspective. The time it takes to load a plugin is usually
-less than 2 or 3ms on modern computers. So unless you use a very large number
-of plugins, you are unlikely to save more than 50ms. If you have spent an hour
-carefully setting up the options to shave off 50ms, you will have to start Vim
-72,000 times just to break even. You should ask yourself if that's a good
-investment of your time.
-
-Make sure that you're tackling the right problem by breaking down the startup
-time of Vim using `--startuptime`.
->
-    vim --startuptime /tmp/log
-<
-On-demand loading should only be used as a last resort. It is basically a
-hacky workaround and is not always guaranteed to work.
-
-                                                                     *plug#load*
-
-[!TIP] You can pass an empty list to `on` or `for` option to disable the
-loading of the plugin. You can manually load the plugin using
-`plug#load(NAMES...)` function.
-
-See https://github.com/junegunn/vim-plug/wiki/tips#loading-plugins-manually
 
 
-COLLABORATORS                                               *plug-collaborators*
+< Collaborators >_____________________________________________________________~
-==============================================================================
+                                                            *plug-collaborators*
 
- - {Jan Edmund Lazo}{7} - Windows support
+ - {Jan Edmund Lazo}{14} - Windows support
- - {Jeremy Pallats}{8} - Python installer
+ - {Jeremy Pallats}{15} - Python installer
 
-                                           {7} https://github.com/janlazo
+                                          {14} https://github.com/janlazo
-                                           {8} https://github.com/starcraftman
+                                          {15} https://github.com/starcraftman
 
 
-LICENSE                                                           *plug-license*
+< License >___________________________________________________________________~
-==============================================================================
+                                                                  *plug-license*
 
 MIT
 
+
 ==============================================================================
 vim:tw=78:sw=2:ts=2:ft=help:norl:nowrap:

plug.vim

@@ -1,36 +1,67 @@
 " vim-plug: Vim plugin manager
 " ============================
 "
-" 1. Download plug.vim and put it in 'autoload' directory
+" Download plug.vim and put it in ~/.vim/autoload
 "
-"   # Vim
 "   curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
 "     https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
 "
-"   # Neovim
+" Edit your .vimrc
-"   sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
-"     https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'
 "
-" 2. Add a vim-plug section to your ~/.vimrc (or ~/.config/nvim/init.vim for Neovim)
+"   call plug#begin('~/.vim/plugged')
 "
-"   call plug#begin()
+"   " Make sure you use single quotes
 "
-"   " List your plugins here
+"   " Shorthand notation; fetches https://github.com/junegunn/vim-easy-align
-"   Plug 'tpope/vim-sensible'
+"   Plug 'junegunn/vim-easy-align'
 "
+"   " Any valid git URL is allowed
+"   Plug 'https://github.com/junegunn/vim-github-dashboard.git'
+"
+"   " Multiple Plug commands can be written in a single line using | separators
+"   Plug 'SirVer/ultisnips' | Plug 'honza/vim-snippets'
+"
+"   " On-demand loading
+"   Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
+"   Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
+"
+"   " Using a non-default branch
+"   Plug 'rdnetto/YCM-Generator', { 'branch': 'stable' }
+"
+"   " Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
+"   Plug 'fatih/vim-go', { 'tag': '*' }
+"
+"   " Plugin options
+"   Plug 'nsf/gocode', { 'tag': 'v.20150303', 'rtp': 'vim' }
+"
+"   " Plugin outside ~/.vim/plugged with post-update hook
+"   Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': './install --all' }
+"
+"   " Unmanaged plugin (manually installed and updated)
+"   Plug '~/my-prototype-plugin'
+"
+"   " Initialize plugin system
 "   call plug#end()
 "
-" 3. Reload the file or restart Vim, then you can,
+" Then reload .vimrc and :PlugInstall to install plugins.
 "
-"     :PlugInstall to install plugins
+" Plug options:
-"     :PlugUpdate  to update plugins
-"     :PlugDiff    to review the changes from the last update
-"     :PlugClean   to remove plugins no longer in the list
 "
-" For more information, see https://github.com/junegunn/vim-plug
+"| Option                  | Description                                      |
+"| ----------------------- | ------------------------------------------------ |
+"| `branch`/`tag`/`commit` | Branch/tag/commit of the repository to use       |
+"| `rtp`                   | Subdirectory that contains Vim plugin            |
+"| `dir`                   | Custom directory for the plugin                  |
+"| `as`                    | Use different name for the plugin                |
+"| `do`                    | Post-update hook (string or funcref)             |
+"| `on`                    | On-demand loading: Commands or `<Plug>`-mappings |
+"| `for`                   | On-demand loading: File types                    |
+"| `frozen`                | Do not update unless explicitly specified        |
+"
+" More information: https://github.com/junegunn/vim-plug
 "
 "
-" Copyright (c) 2024 Junegunn Choi
+" Copyright (c) 2017 Junegunn Choi
 "
 " MIT License
 "
@@ -207,6 +238,7 @@ endfunction
 
 function! plug#begin(...)
   if a:0 > 0
+    let s:plug_home_org = a:1
     let home = s:path(s:plug_fnamemodify(s:plug_expand(a:1), ':p'))
   elseif exists('g:plug_home')
     let home = s:path(g:plug_home)
@@ -783,11 +815,10 @@ endfunction
 function! s:syntax()
   syntax clear
   syntax region plug1 start=/\%1l/ end=/\%2l/ contains=plugNumber
-  syntax region plug2 start=/\%2l/ end=/\%3l/ contains=plugBracket,plugX,plugAbort
+  syntax region plug2 start=/\%2l/ end=/\%3l/ contains=plugBracket,plugX
   syn match plugNumber /[0-9]\+[0-9.]*/ contained
   syn match plugBracket /[[\]]/ contained
   syn match plugX /x/ contained
-  syn match plugAbort /\~/ contained
   syn match plugDash /^-\{1}\ /
   syn match plugPlus /^+/
   syn match plugStar /^*/
@@ -812,7 +843,6 @@ function! s:syntax()
   hi def link plug2       Repeat
   hi def link plugH2      Type
   hi def link plugX       Exception
-  hi def link plugAbort   Ignore
   hi def link plugBracket Structure
   hi def link plugNumber  Number
 
@@ -910,7 +940,7 @@ function! s:prepare(...)
     endif
   endfor
 
-  call s:job_abort(0)
+  call s:job_abort()
   if s:switch_in()
     if b:plug_preview == 1
       pc
@@ -946,8 +976,6 @@ function! s:close_pane()
   if b:plug_preview == 1
     pc
     let b:plug_preview = -1
-  elseif exists('s:jobs') && !empty(s:jobs)
-    call s:job_abort(1)
   else
     bd
   endif
@@ -1330,12 +1358,7 @@ function! s:update_finish()
   endif
 endfunction
 
-function! s:mark_aborted(name, message)
+function! s:job_abort()
-  let attrs = { 'running': 0, 'error': 1, 'abort': 1, 'lines': [a:message] }
-  let s:jobs[a:name] = extend(get(s:jobs, a:name, {}), attrs)
-endfunction
-
-function! s:job_abort(cancel)
   if (!s:nvim && !s:vim8) || !exists('s:jobs')
     return
   endif
@@ -1349,18 +1372,8 @@ function! s:job_abort(cancel)
     if j.new
       call s:rm_rf(g:plugs[name].dir)
     endif
-    if a:cancel
-      call s:mark_aborted(name, 'Aborted')
-    endif
   endfor
-
-  if a:cancel
-    for todo in values(s:update.todo)
-      let todo.abort = 1
-    endfor
-  else
   let s:jobs = {}
-  endif
 endfunction
 
 function! s:last_non_empty_line(lines)
@@ -1374,16 +1387,6 @@ function! s:last_non_empty_line(lines)
   return ''
 endfunction
 
-function! s:bullet_for(job, ...)
-  if a:job.running
-    return a:job.new ? '+' : '*'
-  endif
-  if get(a:job, 'abort', 0)
-    return '~'
-  endif
-  return a:job.error ? 'x' : get(a:000, 0, '-')
-endfunction
-
 function! s:job_out_cb(self, data) abort
   let self = a:self
   let data = remove(self.lines, -1) . a:data
@@ -1392,9 +1395,10 @@ function! s:job_out_cb(self, data) abort
   " To reduce the number of buffer updates
   let self.tick = get(self, 'tick', -1) + 1
   if !self.running || self.tick % len(s:jobs) == 0
+    let bullet = self.running ? (self.new ? '+' : '*') : (self.error ? 'x' : '-')
     let result = self.error ? join(self.lines, "\n") : s:last_non_empty_line(self.lines)
     if len(result)
-      call s:log(s:bullet_for(self), self.name, result)
+      call s:log(bullet, self.name, result)
     endif
   endif
 endfunction
@@ -1408,7 +1412,7 @@ endfunction
 
 function! s:job_cb(fn, job, ch, data)
   if !s:plug_window_exists() " plug window closed
-    return s:job_abort(0)
+    return s:job_abort()
   endif
   call call(a:fn, [a:job, a:data])
 endfunction
@@ -1480,16 +1484,17 @@ function! s:reap(name)
   endif
 
   let more = len(get(job, 'queue', []))
+  let bullet = job.error ? 'x' : more ? (job.new ? '+' : '*') : '-'
   let result = job.error ? join(job.lines, "\n") : s:last_non_empty_line(job.lines)
   if len(result)
-    call s:log(s:bullet_for(job), a:name, result)
+    call s:log(bullet, a:name, result)
   endif
 
   if !job.error && more
     let job.spec.queue = job.queue
     let s:update.todo[a:name] = job.spec
   else
-    let s:update.bar .= s:bullet_for(job, '=')
+    let s:update.bar .= job.error ? 'x' : '='
     call s:bar()
   endif
 endfunction
@@ -1568,12 +1573,6 @@ while 1 " Without TCO, Vim stack is bound to explode
 
   let name = keys(s:update.todo)[0]
   let spec = remove(s:update.todo, name)
-  if get(spec, 'abort', 0)
-    call s:mark_aborted(name, 'Skipped')
-    call s:reap(name)
-    continue
-  endif
-
   let queue = get(spec, 'queue', [])
   let new = empty(globpath(spec.dir, '.git', 1))
 
@@ -2314,10 +2313,7 @@ endfunction
 
 function! s:with_cd(cmd, dir, ...)
   let script = a:0 > 0 ? a:1 : 1
-  let pwsh = s:is_powershell(&shell)
+  return printf('cd%s %s && %s', s:is_win ? ' /d' : '', plug#shellescape(a:dir, {'script': script}), a:cmd)
-  let cd = s:is_win && !pwsh ? 'cd /d' : 'cd'
-  let sep = pwsh ? ';' : '&&'
-  return printf('%s %s %s %s', cd, plug#shellescape(a:dir, {'script': script, 'shell': &shell}), sep, a:cmd)
 endfunction
 
 function! s:system(cmd, ...)
@@ -2440,7 +2436,7 @@ function! s:clean(force)
   let errs = {}
   let [cnt, total] = [0, len(g:plugs)]
   for [name, spec] in items(g:plugs)
-    if !s:is_managed(name) || get(spec, 'frozen', 0)
+    if !s:is_managed(name)
       call add(dirs, spec.dir)
     else
       let [err, clean] = s:git_validate(spec, 1)

test/workflow.vader

@@ -804,14 +804,6 @@ Execute (Check &rtp after SomeCommand):
   AssertEqual g:first_rtp, split(&rtp, ',')[0]
   AssertEqual g:last_rtp, split(&rtp, ',')[-1]
 
-Execute (PlugClean should not care about frozen plugins):
-  call plug#begin()
-  Plug 'xxx/vim-easy-align', { 'frozen': 1 }
-  call plug#end()
-  PlugClean
-  AssertExpect 'Already clean', 1
-  q
-
 Execute (Common parent):
   call plug#begin()
   Plug 'junegunn/vim-pseudocl'