This script is most useful when several documentation packages are being installed at the same time. You can speed up the installation by deferring the (sometimes lengthy) index optimization process and running it once after all the documentation has been installed. In this case, add the -n option to each instance of config_help and config_man in your installation scripts. This generates the .vbi bulk insert files and places them under _SearchIndex/Insert or _SearchIndex/Delete, depending on what is being added or removed. For topics or man sections being updated, the old data is placed under Delete and the new data is placed under Insert. Your installation script should then run config_search to process all the bulk insert files.
If there are more than 15 items in the queue to be indexed,
config_search defers the indexing process
and displays a message to this effect to standard error.
In this case, to index all the items in the queue,
specify the -f option:
/usr/man/bin/config_search -f
If the -L option is specified,
the processes are run on the given language (LANG);
otherwise all language versions are processed.
For example, the following command runs config_search on
all the topicID directories under the es
(Spanish language) directory:
config_search -L es
When run either automatically or manually, the config_search script performs the following actions:
0 | on success |
1 | on failure |
Support tools not found in /usr/man/binMake sure the ODSSI tools (in the ``base'' package) are installed on your system.
Cannot find documentation directory: /usr/lib/scohelpMake sure that /usr/lib/scohelp exists on your system.
Cannot configure documentation: permission denied: /usr/lib/scohelpMake sure that /usr/lib/scohelp is writable by root.
No documentation for language: LANGMake sure there are documentation files under /usr/lib/scohelp/LANG.
``Adding documents to the help system''