j  � ht://Dig: rundig� � 0  

rundig



W ht://Dig Copyright © 1995-2002 The ht://Dig Group
8 Please see the file COPYING for license information.






Synopsis



 rundig [options]





 Description



> Rundig is a shell script that builds the databases necessary= for a typical ht://Dig setup. It runs = htdig first to build the initial database, then it runs? htmerge to create a document index> and word database from the files that were created by htdig.@ It then runs htnotify, and finally@ runs htfuzzy if necessary, to build: the endings and synonyms databases if they're missing or> outdated. Rundig uses the "-i" option to htdig, so it always7 reindexes your web site from scratch when you run it.





Options





 -a

7 Use alternate work files. Tells htdig and htmerge to5 append .work to database files, causing a7 second copy of the database to be built. This allows7 the original files to be used by htsearch during the: indexing run. After htdig and htmerge are done building7 the .work database files, rundig will move them into' place, replacing the original files.7
This option only works for building a new second: copy of the database from scratch, and not for updating9 an existing database. To do that would require further: customization of the rundig script. It's not sufficient5 to simply remove the "-i" option from htdig in the8 script. See the Customization section below.

 -c configfile

: Use the specified configfile file instead of the default.

 -s

3 Print statistics about the dig after completion.

 -v

4 Verbose mode. This increases the verbosity of the: programs. Using more than 2 is probably only useful for6 debugging purposes. The default verbose mode (using2 only one -v) gives a nice progress report while9 digging and merging. This progress report can be a bit9 cryptic, but is explained in the  htdig documentation.







Files





, BIN_DIR/htdig, htmerge, htnotify, htfuzzy

, The executable programs called by rundig.

 CONFIG_DIR/htdig.conf

" The default configuration file.

. COMMON_DIR/english.0, english.aff, synonyms

, The default fuzzy match dictionary files.







See Also



! htdig,% htmerge,' htnotify,% htfuzzy,9 htsearch, and5 Configuration file format.





 Customization



: Because rundig is a shell script, it's easy to customize: it as needed. It's also necessary to customize it if you change the settings of your7 database_dir or; common_dir attributes= (you'll need to make the corresponding changes to the DBDIR; and COMMONDIR variables in the script), if you change the6 database_base6 attribute (there's an embedded "db." filename in the script), if you decide to: use other fuzzy algorithms that need their own databases7 rebuilt, or if you change the names of the endings or< synonyms databases or source files. Before customizing the= script, be sure to familiarize yourself with the individual0 programs in the package and how they interact.
<
A common mistake is to assume that you can simply take> the "-i" option off the htdig command line in rundig to make> rundig update rather than reindexing from scratch. This will: work as long as you don't use the "-a" option to rundig.? The file manipulations that rundig -a does assume that you've> created a new database from scratch, and all files are moved; from .work files to the original file locations. However,: nothing is done before running htdig to move or copy the? db.wordlist and db.docdb to .work files before running htdig.7 The end result is that a rundig -a will still reindex? your site from scratch. When it comes to more drastic changes: such as this, many users chose to write their own custom< script, rather than modifying rundig. For example, see theA 0 rundig.sh script in our contributed files.


, Last modified: $Date: 2002/01/28 05:14:24 $ ÿÿ