Improve and rename the sources searcher

FossilOrigin-Name: cf802026778f444a16c77cfe6037a3a47e77c26bb654a1293dc70fce545bfa65

Author: programandala-net

VERSIONS.adoc

@@ -1,6 +1,6 @@
 = Solo Forth version history
 :author: Marcos Cruz (programandala.net)
-:revdate: 2020-07-08
+:revdate: 2020-07-28
 :toc:
 
 // This file is part of Solo Forth
@@ -12,7 +12,7 @@
 // Version 0.14.0  {{{1
 == Version 0.14.0
 
-About to be released in 2020-06.
+About to be released in 2020-08.
 
 // Background image {{{2
 === Background image
@@ -333,6 +333,8 @@ http://qbi2005.windows.cervantesvirtual.com/wfrmVistaImagen.aspx?imagen=00096057
 - Make paren comments multiline in the Vim syntax file.
 - Make `do_create` and `do_variable` Z80 entries 8 T States faster, by
   moving them from the `noop` word to the `next` entry.
+- The sources searcher searches also the document sources. It's
+  renamed to <tools/seek>.
 
 // Other changes {{{2
 === Other changes

src/doc/manual_skeleton.adoc

@@ -1,7 +1,7 @@
 = Solo Forth: Version {version} for {dosname}
 :author: Marcos Cruz
 :producer: Marcos Cruz
-:revdate: 2020-07-27
+:revdate: 2020-07-28
 :doctype: book
 :lang: en
 ifdef::backend-html5[]
@@ -874,20 +874,20 @@ endif::trdos[]
 == How to search the source files
 
 A shell script is included in order to make searching the Forth
-sources for a regular expression a bit easier: <tools/search_sources>.
+sources for a regular expression a bit easier: <tools/seek>.
 
 The script uses ``ack`` by default; if ``ack`` is not installed,
-``grep`` is used instead.
+``grep`` is used instead. All parameters are passed to them.
 
 Usage examples:
 
 ----
-./tools/search_sources use-thru-index
-./tools/search_sources use-thru-index -l
-./tools/search_sources color
-./tools/search_sources ";\s:\s"
-./tools/search_sources "\-bank"
-./tools/search_sources "code\s+\S+\s+\("
+./tools/seek use-thru-index
+./tools/seek use-thru-index -l
+./tools/seek color
+./tools/seek ";\s:\s"
+./tools/seek "\-bank"
+./tools/seek "code\s+\S+\s+\("
 ----
 
 // How to test and benchmark {{{1

src/version.z80s

@@ -12,7 +12,7 @@ version_patch:                equ 0
 version_prerelease_id:        equ 'r'
   ; 'd' for "dev", 'p' for "pre", 'r' for "rc", zero if none
 
-version_prerelease:           equ 113
+version_prerelease:           equ 114
 
 version_build_high_part:      equ $0134
 version_build_low_part:       equ $3D18  ; build 20200728

tools/search_sources

@@ -0,0 +1,27 @@
+#!/bin/sh
+
+# seek
+
+# This file is part of Solo Forth
+# http://programandala.net/en.program.solo_forth.html
+
+# Last modified: 202007282046.
+# See change log at the end of the file.
+
+# Search the sources of Solo Forth using ack (by default) or grep
+# (when ack is not installed).  All parameters are passed
+# to them.
+
+# ==============================================================
+
+dirs="./src/kernel*.z80s ./src/lib/*.fs ./src/doc/*.adoc"
+
+ack $* -r $dirs 2>/dev/null || \
+grep $* -r $dirs 2>/dev/null
+
+# ==============================================================
+# Change log
+
+# 2020-03-01: Start.
+#
+# 2020-07-28: Search also the documentation sources. Rename to "seek".