summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMaxime Coste <frrrwww@gmail.com>2014-02-19 03:45:41 +0000
committerMaxime Coste <frrrwww@gmail.com>2014-03-02 01:08:12 +0000
commit1764ce0bdc2b2ec3a563b01480ff7b07906b0b7d (patch)
tree4c13b1dea21bd32f0e3da1a921a49c9df6da18dc
parentaab390ab92009048186fe5feee00d21c048eadb0 (diff)
Add docstrings to some commands
-rw-r--r--rc/client.kak3
-rw-r--r--rc/cpp.kak2
-rw-r--r--rc/ctags.kak3
-rw-r--r--rc/make.kak2
4 files changed, 6 insertions, 4 deletions
diff --git a/rc/client.kak b/rc/client.kak
index 4362e65b..a1a58a35 100644
--- a/rc/client.kak
+++ b/rc/client.kak
@@ -6,7 +6,8 @@ decl str termcmd %sh{
fi
}
-def new -shell-params %{ nop %sh{
+def new -docstring 'create a new kak client for current session' \
+ -shell-params %{ nop %sh{
if (( $# != 0 )); then kakoune_params="-e '$@'"; fi
setsid ${kak_opt_termcmd} "kak -c ${kak_session} ${kakoune_params}" < /dev/null >& /dev/null &
}}
diff --git a/rc/cpp.kak b/rc/cpp.kak
index d5825cc9..1edb9b6c 100644
--- a/rc/cpp.kak
+++ b/rc/cpp.kak
@@ -74,7 +74,7 @@ hook global BufNew .*\.(h|hh|hpp|hxx|H) _cpp_insert_include_guards
decl str-list alt_dirs ".;.."
-def alt %{ %sh{
+def alt -docstring "Jump to the alternate file (header/implementation)" %{ %sh{
shopt -s extglob
alt_dirs=${kak_opt_alt_dirs//;/ }
file=$(basename ${kak_buffile})
diff --git a/rc/ctags.kak b/rc/ctags.kak
index 757346c3..bfc0c2fc 100644
--- a/rc/ctags.kak
+++ b/rc/ctags.kak
@@ -5,6 +5,7 @@
def -shell-params \
-shell-completion 'readtags -p "$1" | cut -f 1 | sort | uniq' \
+ -docstring 'jump to tag definition' \
tag \
%{ %sh{
if [[ -z "$1" ]]; then tagname=${kak_selection}; else tagname=$1; fi
@@ -59,7 +60,7 @@ def ctags-disable-autoinfo %{ rmhooks window ctags-autoinfo }
decl str ctagsopts "-R ."
-def gentags %{
+def gentags -docstring 'generate tag file asynchronously' %{
echo -color Information "launching tag generation in the background"
%sh{ (
if ctags -f .tags.kaktmp ${kak_opt_ctagsopts}; then
diff --git a/rc/make.kak b/rc/make.kak
index 7ea15934..09f5591b 100644
--- a/rc/make.kak
+++ b/rc/make.kak
@@ -23,7 +23,7 @@ hook global WinSetOption filetype=make %{
hook global WinSetOption filetype=(?!make).* %{ rmhl make; rmhooks buffer make-hooks }
-def errjump %{
+def errjump -docstring 'Jump to error location' %{
try %{
exec gll<a-?> "Entering directory" <ret>
exec s "Entering directory '([^']+)'.*\n([^:]+):(\d+):(\d+):[^\n]+\'" <ret>l