Getting help

ODSSI tools errors

During installation, the config_help(1M), config_man(1M), and config_views(1M) tools are run and the output captured to log files. After installation, you must run the config_search(1M) tool (with the -f option) to complete SCOhelp configuration.

These tools can return errors that might indicate a problem with the SCOhelp system; more typically, they return warnings that do not affect the integrity of SCOhelp.

The following paragraphs explain some of the messages you may see when running these tools.

config_search: LANG: No search collection at
/usr/lib/scohelp/LANG/_SearchIndex.
First run config_help or config_man

This message (where LANG is a language specifier such as es, fr, de, ja) indicates that config_search was run with either no options or a -L option that pointed to a particular language, and no input to the search index was found for that language. The result is that no search index processing is done for the indicated language, but otherwise SCOhelp is unaffected by this error. However, if there is documentation for LANG present on the system, you must run config_help and config_man, then run config_search again, this time with the -L LANG option.

mktitles: LANG: 1: Warning: manpage claims to be in
          section n: path

This error indicates a problem in the source file at /usr/man/path. Specifically, the file named by path is in section n, but the text in the file says that the page is in another section. The source file itself must be corrected or moved to the proper section under /usr/man. This is typically a problem caused by the application package that installed the manual pages.

mktitles: LANG: path: No documentation found.

The mktitles tool looks for documentation files in every directory it finds under /usr/lib/scohelp. It prints a message like the above for every directory in which it expected to find documentation files but found none. This usually occurs when a doc package has been removed, but the directories it used were not deleted during package removal. Directories are typically left behind in case users have added their own source files.

config_views: LANG: path parent view <view-name> does not exist

config_views: LANG: <view-name> view has non-existent OverviewURL: path

config_views: LANG: path view refers to non-existent URL: path

These messages usually indicate a reference to a topic view (a left frame table of contents) that does not exist. This is usually due to a reference in one package that depends on documentation in another package that is not currently installed. For example, if you install the BASEdoc package but not the ARCdoc (for ARCserveIT documentation) package, you see messages like this because the top-level BASEdoc view Backup and Restore does not have any ARCserveIT documentation to which it can point.