[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/urgrep b578b0f857 009/115: Add a README and more-detail
From: |
ELPA Syncer |
Subject: |
[elpa] externals/urgrep b578b0f857 009/115: Add a README and more-detailed docstrings |
Date: |
Wed, 10 May 2023 03:00:37 -0400 (EDT) |
branch: externals/urgrep
commit b578b0f857e31cdafb845687bf40d93d8ab81927
Author: Jim Porter <jporterbugs@gmail.com>
Commit: Jim Porter <jporterbugs@gmail.com>
Add a README and more-detailed docstrings
---
README.md | 15 +++++++++++++++
urgrep.el | 11 ++++++++---
2 files changed, 23 insertions(+), 3 deletions(-)
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..abb2c401f0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Urgrep - Universal Recursive Grep
+
+Urgrep is an experimental Emacs package to provide an alternative to `M-x
rgrep`
+(and similar packages) which will eventually support for *any* grep-like tool.
+Currently, `ag`, `git grep`, and `grep`/`find` are supported.
+
+## Using Urgrep
+
+Load the package and type `C-h f urgrep RET`. That should show you the basics
+while the interface stabilizes (at which point it will be documented here).
+
+## Contributing
+
+It's a bit early for other contributors, but thanks for the thought! (Hopefully
+this will change after not too long.)
diff --git a/urgrep.el b/urgrep.el
index 7ae7ba242f..df1ae7eef5 100644
--- a/urgrep.el
+++ b/urgrep.el
@@ -381,10 +381,15 @@ This depends on the current values of various urgrep
options."
;;;###autoload
(cl-defun urgrep (query &optional directory &aux
(urgrep-search-regexp urgrep-search-regexp))
- "Search in DIRECTORY for a given QUERY.
+ "Recursively search in DIRECTORY for a given QUERY.
+
+When called interactively, search in the project's root directory, or
+the current directory if there is no current project. With
\\[universal-argument] prefix,
+search in the current directory. With two \\[universal-argument] prefixes,
prompt for a
+directory to search in.
\\<urgrep-minibuffer-map>
-The following keys are bound in `urgrep-minibuffer-map', active when entering
-the search query:
+The following keys are bound in `urgrep-minibuffer-map', active
+when entering the search query:
Type \\[urgrep-toggle-regexp] to toggle regular-expression mode."
(interactive
- [elpa] externals/urgrep 4ec9d9febd 010/115: Fix behavior of temporarily overriding `urgrep-search-regexp', (continued)
- [elpa] externals/urgrep 4ec9d9febd 010/115: Fix behavior of temporarily overriding `urgrep-search-regexp', ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 7780887977 005/115: Add initial support for git grep, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep d965e6b848 007/115: Add the ability to toggle regexp mode when entering a search, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 764742fd14 006/115: Recurse submodules with git grep, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 6d9217c344 013/115: Rename urgrep-test.el to urgrep-tests.el, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep aba02cc3f9 017/115: Add support for ripgrep and ack, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 53d72fe09c 023/115: Don't cache tool results for hosts which can use VC-specific tools, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 266965a0a2 024/115: Add support for intelligent editing of previous search commands, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 350d6d1889 027/115: Add support for regexp-syntax and context with the grep backend, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 887114113c 001/115: Initial revision, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep b578b0f857 009/115: Add a README and more-detailed docstrings,
ELPA Syncer <=
- [elpa] externals/urgrep 026c54d11e 012/115: Add support for setting context, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep ca67ad1f4d 030/115: Use isearch-like bindings in the urgrep minibuffer, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 8bb469a526 036/115: Add some details about our buffer-local variables, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 9ff22a4481 041/115: Minor fixes to defcustoms, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep c879c02558 040/115: Add some docs and clean up spacing, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 5b792fe0de 045/115: Use symbols instead of strings for `urgrep-tools' keys, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 3dde21c501 047/115: Add `urgrep-setup-hook', ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep f686c2baa3 051/115: Fix off-by-one error with matches in Emacs 28; see Emacs bug#49624, ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep a9c1a98ea6 052/115: Prompt for directory first with 'C-u C-u M-x urgrep', ELPA Syncer, 2023/05/10
- [elpa] externals/urgrep 3002fdf731 054/115: Add support for specifying executable path in 'urgrep-preferred-tools', ELPA Syncer, 2023/05/10