From 0cd706254ae68d8aa132bbcced011574138bf2df Mon Sep 17 00:00:00 2001
From: Frank LENORMAND <lenormf@gmail.com>
Date: Wed, 2 Sep 2020 11:57:34 +0300
Subject: [PATCH 1/2] rc clang grep: Make docstrings more readable

---
 rc/tools/clang.kak | 7 ++++---
 rc/tools/grep.kak  | 8 ++++----
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/rc/tools/clang.kak b/rc/tools/clang.kak
index 586a97f5..e72b64da 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 are showned 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..3edbec45 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 the optional arguments are forwarded to the grep utility
+} grep %{ evaluate-commands %sh{
      if [ $# -eq 0 ]; then
          set -- "${kak_selection}"
      fi

From f84c550d303b6a8d4663d334644b0d43d07eff64 Mon Sep 17 00:00:00 2001
From: Maxime Coste <mawww@kakoune.org>
Date: Sun, 6 Sep 2020 10:56:37 +1000
Subject: [PATCH 2/2] Apply suggestions from code review

Co-authored-by: Screwtapello <thristian@gmail.com>
Co-authored-by: Johannes Altmanninger <aclopte@gmail.com>
---
 rc/tools/clang.kak | 2 +-
 rc/tools/grep.kak  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/rc/tools/clang.kak b/rc/tools/clang.kak
index e72b64da..23637970 100644
--- a/rc/tools/clang.kak
+++ b/rc/tools/clang.kak
@@ -157,7 +157,7 @@ define-command -hidden clang-show-error-info %{
 
 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
+    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 }
diff --git a/rc/tools/grep.kak b/rc/tools/grep.kak
index 3edbec45..f68d20e8 100644
--- a/rc/tools/grep.kak
+++ b/rc/tools/grep.kak
@@ -6,7 +6,7 @@ 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
+    All optional arguments are forwarded to the grep utility
 } grep %{ evaluate-commands %sh{
      if [ $# -eq 0 ]; then
          set -- "${kak_selection}"