/trunk/HuntnGather/HuntnGather.readme |
@@ -3,7 +3,7 @@ |
Uploader: "Wizardry and Steamworks" <mail@grimore.org> |
Type: util/dir |
Replaces: util/dir/HuntnGather.lha |
Version: 1.7.4 |
Version: 1.7.5 |
Architecture: m68k-amigaos |
|
Hunt & Gather - File search and indexing utilities. |
@@ -15,15 +15,10 @@ |
|
-=:[ Changes ]:=- |
|
20211105: |
* Use a single binary for all CPUs. |
* Refocus the documentation to match the latest changes. |
* MuForce and MuGuardianAngel memory usage stress testing. |
* Large storage (cca. 8k directories / 80k files) stress testing. |
* Use locale for string comparisons on the Amiga. |
* "Gather" now requires either of -a (add), -r (remove), -c (create). |
* Allow multiple paths when issuing the "Gather" command. |
20211114: |
|
* Rewrite and preparations for pooling memory the Amiga way. |
|
-=:[ Introduction ]:=- |
|
|
@@ -61,22 +56,18 @@ |
|
The "Gather" utility is used to index a path. The following command: |
|
Gather -c RAM: |
|
Gather -c RAM: |
|
|
will create a file in the S: directory named "gather.db". "Gather"is |
verbose by default and will show the user what the utility is doing |
but the behaviour can be changed with the "-q" (quiet) flag that will |
make "Gather" print only errors. |
|
In order to look for a file, the "Hunt" utility is then invoked with |
an AmigaOS search pattern, for instance, the pattern "#?test#?: |
In order to look for a file, the "Hunt" utility is then invoked with |
an AmigaOS search pattern, for instance, the pattern "#?test#?: |
|
Hunt #?test#? |
|
Hunt #?test#? |
|
|
"Hunt" will then search the database previously generated by the |
"Gather" utility and will print out all the paths corresponding to the |
files matching the supplied pattern. |
@@ -115,44 +106,42 @@ |
|
-=:[ Gather ]:=- |
|
"Gather" requires that one of the following parameters is specified: |
* -a (add files to an already existing database), |
* -r (remove files from an already existing database), |
* -c (delete the previous database file and create a new database). |
"Gather" requires that one of the following parameters is specified: |
* -a (add files to an already existing database), |
* -r (remove files from an already existing database), |
* -c (delete the previous database file and create a new database). |
|
The "Gather" utility takes several paths as parameters representing |
the paths to be indexed; for example, all the following paths are |
valid: |
The "Gather" utility takes several paths as parameters representing |
the paths to be indexed; for example, all the following paths are |
valid: |
|
RAM: |
DH0:System/ |
|
RAM: |
DH0:System/ |
|
|
When the "Gather" utility runs, a database is created at "S:gather.db" |
containing all the found files. |
When the "Gather" utility runs, a database is created at "S:gather.db" |
containing all the found files. |
|
"Gather" is also happy to work with a different database file other |
than the default database at "S:gather.db" by passing the "-d" |
parameter when "Gather" is invoked. For instance, the following |
command invocation will create the database file at "T:gather.db" and |
index the paths "RAM:" and "HDH0:Icons": |
"Gather" is also happy to work with a different database file other |
than the default database at "S:gather.db" by passing the "-d" |
parameter when "Gather" is invoked. For instance, the following |
command invocation will create the database file at "T:gather.db" and |
index the paths "RAM:" and "HDH0:Icons": |
|
Gather -d T:gather.db RAM: HDH0:Icons |
Gather -d T:gather.db RAM: HDH0:Icons |
|
Conversely, the "Hunt" utility can then be used to search specified |
database files: |
Conversely, the "Hunt" utility can then be used to search specified |
database files: |
|
Hunt -d T:gather.db #?test?# |
Hunt -d T:gather.db #?test?# |
|
The previous "Hunt" command will search a database file located at |
"T:gather.db" for all files matching the pattern "#?test?". |
The previous "Hunt" command will search a database file located at |
"T:gather.db" for all files matching the pattern "#?test?". |
|
-=:[ Hunt ]:=- |
|
"Hunt" is the counterpart to "Gather" and will search a given database |
generated by the "Gather" utility for files matching the terms passed |
to "Hunt" on the command line. |
"Hunt" is the counterpart to "Gather" and will search a given database |
generated by the "Gather" utility for files matching the terms passed |
to "Hunt" on the command line. |
|
For instance: |
|