tmp

Author: rsteube

docs/src/freckles/cmd/init.md

@@ -2,6 +2,8 @@
 
 [Freckles] is backed by a [Git] repository located at `~/.local/share/freckles`.
 
+With `init` an new one is created.
+
 ```go
 {{#include ../../../../cmd/freckles/cmd/init.go:command}}
 ```
@@ -10,7 +12,9 @@
 
 ## Clone
 
-Completion for the `--clone` flag is provided by [ActionRepositorySearch].
+Alternatively an existing remote repository can be cloned with the `--clone` flag.
+
+Completion for it is provided by [ActionRepositorySearch].
 
 ```go
 {{#include ../../../../cmd/freckles/cmd/init.go:flagcompletion}}
@@ -49,8 +53,15 @@ Completion for the `--clone` flag is provided by [ActionRepositorySearch].
 > }
 > ```
 > ![](./init/macro.cast)
+>
+> Note that for performance reasons only the first 100 search results are presented.
+> Fast response times are important which limits what can be done in [Carapace].
+>
+> [Tabdance] will provide a solution for this in the future.
 
-[Actions]:https://carapace-sh.github.io/carapace/carapace/action.html
 [ActionRepositorySearch]:https://pkg.go.dev/github.com/carapace-sh/carapace-bin/pkg/actions/tools/git#ActionRepositorySearch
+[Actions]:https://carapace-sh.github.io/carapace/carapace/action.html
+[Carapace]:https://carapace.sh
 [Freckles]:https://github.com/rsteube/freckles
 [Git]:https://git-scm.com/
+[Tabdance]:https://tab.dance