[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/modus-operandi-theme f670dc2 027/112: Update README wit

From: Stefan Monnier
Subject: [elpa] externals/modus-operandi-theme f670dc2 027/112: Update README with note for HELM grep users
Date: Mon, 30 Mar 2020 15:59:31 -0400 (EDT)

branch: externals/modus-operandi-theme
commit f670dc2b932b68ad917d7d67d4992632e5d11e56
Author: Protesilaos Stavrou <address@hidden>
Commit: Protesilaos Stavrou <address@hidden>

    Update README with note for HELM grep users
    The topic was presented in issue 21, specifically this comment of mine:
 README.org | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/README.org b/README.org
index c402597..293cf2c 100644
--- a/README.org
+++ b/README.org
@@ -243,7 +243,7 @@ the "full support" may not be 100% true…
 + git-lens
 + git-timemachine
 + gnus
-+ helm*
++ helm* (also see [[#h:e4408911-e186-4825-bd4f-4d0ea55cd6d6][section below on 
Helm's grep-related functions]])
 + helm-ls-git
 + helm-xref
 + highlight-blocks
@@ -380,6 +380,38 @@ effect/: less intense colours (but still accessible) for 
 interfaces and the intended styles for the content you are actually
 working on.
+** Note for HELM users of grep or grep-like functions
+   :CUSTOM_ID: h:e4408911-e186-4825-bd4f-4d0ea55cd6d6
+   :END:
+There is one face from the Helm package that is meant to highlight the
+matches of a grep or grep-like command (=ag= or =ripgrep=).  It is
+=helm-grep-match=.  However, this face can only apply when the user does
+not pass =--color=always= as a command-line option for their command.
+This is the docstring for the aforementioned face, which is defined in
+the =helm-grep.el= library (visit a library with =M-x find-library=).
+Face used to highlight grep matches. Have no effect when grep backend
+use "--color="
+The user must either remove =--colour= from the flags passed to the grep
+function, or explicitly use =--colour=never= (or equivalent).  Helm
+provides user-facing customisation options for configuring the grep
+function's output, such as =helm-grep-default-command= and
+When =--colour=always= is applied, the grep output will use red-coloured
+text with bold letter forms to present the matching text in the list of
+candidates.  That presentation is still accessible, though I have not
+been able to track its source in order to identify some other possible
+means of controlling it.
+I presented 
screen shots of this in issue 21]].
 * Contributing
   :CUSTOM_ID: h:25ba8d6f-6604-4338-b774-bbe531d467f6

reply via email to

[Prev in Thread] Current Thread [Next in Thread]