/usr/share/doc/htdig-doc/html/rundig.html is in htdig-doc 1:3.2.0b6-17.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
<head>
<title>
ht://Dig: rundig
</title>
</head>
<body bgcolor="#eef7ff">
<h1>
rundig
</h1>
<p>
ht://Dig Copyright © 1995-2004 <a href="THANKS.html">The ht://Dig Group</a><br>
Please see the file <a href="COPYING">COPYING</a> for
license information.
</p>
<hr size="4" noshade>
<dl>
<dd>
<h2>
Synopsis
</h2>
</dd>
<dd>
rundig [<em>options</em>]
</dd>
</dl>
<dl>
<dd>
<h2>
Description
</h2>
</dd>
<dd>
Rundig is a shell script that builds the databases necessary
for a typical ht://Dig setup. It runs <a href="htdig.html">
htdig</a> first to build the initial database, then it runs
<a href="htpurge.html">htpurge</a> to clean up the document
and word databases that were created by htdig.
It then runs <a href="htnotify.html">htnotify</a>, and finally
runs <a href="htfuzzy.html">htfuzzy</a> if necessary, to build
the endings and synonyms databases if they're missing or
outdated. Rundig uses the "-i" option to htdig, so it always
reindexes your web site from scratch when you run it.
</dd>
</dl>
<dl>
<dd>
<h2>
Options
</h2>
</dd>
<dd>
<dl compact>
<dt>
-a
</dt>
<dd>
Use alternate work files. Tells htdig and htpurge to
append <em>.work</em> to database files, causing a
second copy of the database to be built. This allows
the original files to be used by htsearch during the
indexing run. After htdig and htpurge are done building
the .work database files, rundig will move them into
place, replacing the original files.
<br>This option only works for building a new second
copy of the database from scratch, and not for updating
an existing database. To do that would require further
customization of the rundig script. It's not sufficient
to simply remove the "-i" option from htdig in the
script. See the <em>Customization</em> section below.
</dd>
<dt>
-c <em>configfile</em>
</dt>
<dd>
Use the specified <i>configfile</i> file instead of the
default.
</dd>
<dt>
-s
</dt>
<dd>
Print statistics about the dig after completion.
</dd>
<dt>
-v
</dt>
<dd>
Verbose mode. This increases the verbosity of the
programs. Using more than 2 is probably only useful for
debugging purposes. The default verbose mode (using
only one -v) gives a nice progress report while
digging and merging. This progress report can be a bit
cryptic, but is explained in the <a href="htdig.html">
htdig</a> documentation.
</dd>
</dl>
</dd>
</dl>
<dl>
<dd>
<h2>
Files
</h2>
</dd>
<dd>
<dl>
<dt>
<a href="attrs.html#bin_dir">BIN_DIR</a>/htdig, htpurge, htnotify, htfuzzy
</dt>
<dd>
The executable programs called by rundig.
</dd>
<dt>
<a href="attrs.html#config_dir">CONFIG_DIR</a>/htdig.conf
</dt>
<dd>
The default configuration file.
</dd>
<dt>
<a href="attrs.html#common_dir">COMMON_DIR</a>/english.0, english.aff, synonyms
</dt>
<dd>
The default fuzzy match dictionary (input) files.
</dd>
</dl>
</dd>
</dl>
<dl>
<dd>
<h2>
See Also
</h2>
</dd>
<dd>
<a href="htdig.html">htdig</a>,
<a href="htpurge.html">htpurge</a>,
<a href="htnotify.html">htnotify</a>,
<a href="htfuzzy.html">htfuzzy</a>,
<a href="htsearch.html" target="_top">htsearch</a>, and
<a href="attrs.html">Configuration file format</a>.
</dd>
</dl>
<dl>
<dd>
<h2>
Customization
</h2>
</dd>
<dd>
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 your
<a href="attrs.html#database_dir">database_dir</a> or
<a href="attrs.html#common_dir">common_dir</a> attributes
(you'll need to make the corresponding changes to the DBDIR
and COMMONDIR variables in the script), if you decide to
use other fuzzy algorithms that need their own databases
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 individual
programs in the package and how they interact.
<br>
<br>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.
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 the
<a href="http://www.htdig.org/files/contrib/scripts/rundig.sh">
rundig.sh</a> script in our contributed files.
</dd>
</dl>
<hr size="4" noshade>
Last modified: $Date: 2004/06/12 13:39:13 $
<br>
<a href="http://sourceforge.net/">
SourceForge</a>
</body>
</html>
|