| /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: |
| |
