03/20: gnu: the-silver-searcher: Fix & improve description.

[Tobias Geerinckx-Rice]

nckx pushed a commit to branch master
in repository guix.

commit 6acff0f90069898bac69a49cfa173725bd6b9e6e
Author: Tobias Geerinckx-Rice <address@hidden>
Date:   Tue Jan 24 15:33:07 2017 +0100

    gnu: the-silver-searcher: Fix & improve description.
    
    * gnu/packages/code.scm (the-silver-searcher)[description]: Fix typo, use
    @command and @file mark-up, and clarify a bit.
---
 gnu/packages/code.scm |    9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/gnu/packages/code.scm b/gnu/packages/code.scm
index 061ec27..f91fdab 100644
--- a/gnu/packages/code.scm
+++ b/gnu/packages/code.scm
@@ -3,6 +3,7 @@
 ;;; Copyright © 2015 Andreas Enge <address@hidden>
 ;;; Copyright © 2015 Ricardo Wurmus <address@hidden>
 ;;; Copyright © 2016 Efraim Flashner <address@hidden>
+;;; Copyright © 2017 Tobias Geerinckx-Rice <address@hidden>
 ;;;
 ;;; This file is part of GNU Guix.
 ;;;
@@ -209,9 +210,11 @@ COCOMO model or user-provided parameters.")
     (home-page "http://geoff.greer.fm/ag/";)
     (synopsis "Fast code searching tool")
     (description
-     "The silver searcher, or 'ag', is tool for quickly searching through
-files, but compared to grep is much faster and respects files like .gitignore,
-.hgignore, etc.")
+     "The Silver Searcher (@command{ag}) is a tool for quickly searching large
+numbers of files.  It's intended primarily for source code repositories, and
+respects files like @file{.gitignore} and @file{.hgignore}.  It's also an order
+of magnitude faster than its inspiration, @command{ack}, and less specialised
+tools such as @command{grep}.")
     (license license:asl2.0)))
 
 (define-public trio