diff --git a/rc/tools/clang.kak b/rc/tools/clang.kak
index 586a97f5..23637970 100644
--- a/rc/tools/clang.kak
+++ b/rc/tools/clang.kak
@@ -155,9 +155,10 @@ define-command -hidden clang-show-error-info %{
         fi
     } }
 
-define-command clang-enable-diagnostics -docstring %{Activate automatic error reporting and diagnostics
-Information about the analysis are showned after the buffer has been parsed with the clang-parse function} \
-%{
+define-command clang-enable-diagnostics -docstring %{
+    Activate automatic error reporting and diagnostics
+    Information about the analysis will be shown after the buffer has been parsed with the clang-parse function
+} %{
     add-highlighter window/clang_flags flag-lines default clang_flags
     hook window -group clang-diagnostics NormalIdle .* %{ clang-show-error-info }
     hook window -group clang-diagnostics WinSetOption ^clang_errors=.* %{ info; clang-show-error-info }
diff --git a/rc/tools/grep.kak b/rc/tools/grep.kak
index 39aecf19..f68d20e8 100644
--- a/rc/tools/grep.kak
+++ b/rc/tools/grep.kak
@@ -4,10 +4,10 @@ declare-option -docstring "name of the client in which utilities display informa
     str toolsclient
 declare-option -hidden int grep_current_line 0
 
-define-command -params .. -file-completion \
-    -docstring %{grep [<arguments>]: grep utility wrapper
-All the optional arguments are forwarded to the grep utility} \
-    grep %{ evaluate-commands %sh{
+define-command -params .. -file-completion -docstring %{
+    grep [<arguments>]: grep utility wrapper
+    All optional arguments are forwarded to the grep utility
+} grep %{ evaluate-commands %sh{
      if [ $# -eq 0 ]; then
          set -- "${kak_selection}"
      fi