doc/plugins.md in power_stencil-0.9.8 vs doc/plugins.md in power_stencil-0.10.0
- old
+ new
@@ -10,10 +10,11 @@
- [Enhance `power_stencil` command line](#enhance-power_stencil-command-line)
- [What are plugins ?](#what-are-plugins-)
- [Creating plugin local to the project](#creating-plugin-local-to-the-project)
- [Plugin creation](#plugin-creation)
- [Adding new subcommands to `PowerStencil`](#adding-new-subcommands-to-powerstencil)
+ - [Updating zsh auto-completion](#updating-zsh-auto-completion)
- [Providing entity types and templates](#providing-entity-types-and-templates)
- [Providing custom build process](#providing-custom-build-process)
- [Plugin capabilities and structure](#plugin-capabilities-and-structure)
- [Proposed default plugin structure and life-cycle](#proposed-default-plugin-structure-and-life-cycle)
- [Fully manually created plugin](#fully-manually-created-plugin)
@@ -181,10 +182,19 @@
MYPLUGIN PLUGIN WAZ HERE !!
```
Wow it worked ! Useless, but worked ! But it's a good demo on how to create your own subcommands in `PowerStencil`.
+## Updating zsh auto-completion
+
+When you add a plugin to a project, be it local or from a separated gem, you may want to update the command-line auto-completion for that project as new plugins may add extra command-line options and sub-commands.
+
+You do that as you probably already [dit it initially][completion].
+
+ $ power_stencil adm --zsh-completion
+
+
## Providing entity types and templates
Of course you can provide new entity types and templates templates within plugin. The plugin created contains a demo entity type which brings its own template template (and even a custom build, but we will see that in next paragraph).
You can see in the output of `power_stencil info` (in _availaible entity types_) that a new entity type has been added to the project by the plugin: `myplugin_entity`
@@ -505,9 +515,10 @@
[Documentation root]: ../README.md "Back to documentation root"
[entities]: entities.md "Entities in PowerStencil"
[builds]: builds.md "Builds in PowerStencil"
[templates]: templates.md "Templates in PowerStencil"
[post-process]: builds.md#post-process-actions "post-process actions in builds"
+[completion]: ../README.md#command-line-auto-completion "how to setup zsh command-line auto-completion"
<!-- Code links -->
<!-- Illustrations -->
\ No newline at end of file