HuntnGather – Diff between revs 37 and 44

Subversion Repositories:
Rev:
Show entire fileIgnore whitespace
Rev 37 Rev 44
Line 1... Line 1...
1 Short: File indexing and search utilities. 1 Short: File indexing and search utilities.
2 Author: Wizardry and Steamworks 2 Author: Wizardry and Steamworks
3 Uploader: "Wizardry and Steamworks" <mail@grimore.org> 3 Uploader: "Wizardry and Steamworks" <mail@grimore.org>
4 Type: util/dir 4 Type: util/dir
5 Replaces: util/dir/HuntnGather.lha 5 Replaces: util/dir/HuntnGather.lha
6 Version: 1.7.4 6 Version: 1.7.5
7 Architecture: m68k-amigaos 7 Architecture: m68k-amigaos
Line 8... Line 8...
8   8  
9 Hunt & Gather - File search and indexing utilities. 9 Hunt & Gather - File search and indexing utilities.
Line 13... Line 13...
13   13  
Line 14... Line 14...
14 Released under the MIT License, all rights reserved. 14 Released under the MIT License, all rights reserved.
Line 15... Line 15...
15   15  
16 -=:[ Changes ]:=- -  
17   -  
18 20211105: -  
19 * Use a single binary for all CPUs. -  
-   16 -=:[ Changes ]:=-
20 * Refocus the documentation to match the latest changes. 17  
21 * MuForce and MuGuardianAngel memory usage stress testing. -  
22 * Large storage (cca. 8k directories / 80k files) stress testing. -  
Line 23... Line 18...
23 * Use locale for string comparisons on the Amiga. 18 20211114:
Line 24... Line 19...
24 * "Gather" now requires either of -a (add), -r (remove), -c (create). 19  
Line 59... Line 54...
59   54  
Line 60... Line 55...
60 -=:[ Usage ]:=- 55 -=:[ Usage ]:=-
Line 61... Line -...
61   -  
62 The "Gather" utility is used to index a path. The following command: 56  
63   -  
Line 64... Line 57...
64   57 The "Gather" utility is used to index a path. The following command:
65 Gather -c RAM: 58  
66   59 Gather -c RAM:
67   60  
Line 68... Line 61...
68 will create a file in the S: directory named "gather.db". "Gather"is 61 will create a file in the S: directory named "gather.db". "Gather"is
69 verbose by default and will show the user what the utility is doing 62 verbose by default and will show the user what the utility is doing
70 but the behaviour can be changed with the "-q" (quiet) flag that will -  
71 make "Gather" print only errors. -  
72   -  
Line -... Line 63...
-   63 but the behaviour can be changed with the "-q" (quiet) flag that will
Line 73... Line 64...
73 In order to look for a file, the "Hunt" utility is then invoked with 64 make "Gather" print only errors.
74 an AmigaOS search pattern, for instance, the pattern "#?test#?: 65  
75   66 In order to look for a file, the "Hunt" utility is then invoked with
Line 113... Line 104...
113 a path with the "-r" parameter does not take a long time compared to 104 a path with the "-r" parameter does not take a long time compared to
114 adding files to the database. 105 adding files to the database.
Line 115... Line 106...
115   106  
Line 116... Line 107...
116 -=:[ Gather ]:=- 107 -=:[ Gather ]:=-
117   108  
118 "Gather" requires that one of the following parameters is specified: 109 "Gather" requires that one of the following parameters is specified:
119 * -a (add files to an already existing database), 110 * -a (add files to an already existing database),
120 * -r (remove files from an already existing database), 111 * -r (remove files from an already existing database),
121 * -c (delete the previous database file and create a new database). 112 * -c (delete the previous database file and create a new database).
122   113  
123 The "Gather" utility takes several paths as parameters representing 114 The "Gather" utility takes several paths as parameters representing
124 the paths to be indexed; for example, all the following paths are -  
125 valid: -  
126   -  
127   -  
Line -... Line 115...
-   115 the paths to be indexed; for example, all the following paths are
-   116 valid:
Line 128... Line 117...
128 RAM: 117  
129 DH0:System/ 118 RAM:
Line 130... Line 119...
130   119 DH0:System/
131   120  
132 When the "Gather" utility runs, a database is created at "S:gather.db" 121 When the "Gather" utility runs, a database is created at "S:gather.db"
133 containing all the found files. 122 containing all the found files.
134 123
Line 135... Line 124...
135 "Gather" is also happy to work with a different database file other 124 "Gather" is also happy to work with a different database file other
Line 136... Line 125...
136 than the default database at "S:gather.db" by passing the "-d" 125 than the default database at "S:gather.db" by passing the "-d"
137 parameter when "Gather" is invoked. For instance, the following 126 parameter when "Gather" is invoked. For instance, the following
Line 138... Line 127...
138 command invocation will create the database file at "T:gather.db" and 127 command invocation will create the database file at "T:gather.db" and
Line 139... Line 128...
139 index the paths "RAM:" and "HDH0:Icons": 128 index the paths "RAM:" and "HDH0:Icons":
140 129
Line 141... Line 130...
141 Gather -d T:gather.db RAM: HDH0:Icons 130 Gather -d T:gather.db RAM: HDH0:Icons
Line 142... Line 131...
142 131
143 Conversely, the "Hunt" utility can then be used to search specified 132 Conversely, the "Hunt" utility can then be used to search specified
144 database files: 133 database files:
Line 145... Line 134...
145 134
Line 146... Line 135...
146 Hunt -d T:gather.db #?test?# 135 Hunt -d T:gather.db #?test?#