The script used to get confused if you ran it in a subdir of the OMPI
tree (e.g., it would report help files not found if source code
referred to a help file that was not under the subdir in which it was
run).
Now the script searches the whole tree for help files, but only
analyzes the source from the subdir in which it was started. Meaning:
it should always find all help files, and won't get confused like it
did before.
This commit was SVN r32548.
This script can be run from any sub-tree in the OMPI code base. It
does several things:
* Find all help-*txt files and index all the topics found in the
sub-tree.
* Find all C/C++ source files (.c, .cc, .h) in the sub-tree, and look
for various flavors of the opal_show_help() function (e.g.,
including orte_show_help()) and search for hard-coded filenames and
topics.
* Also look for special tokens (in comments) in the source code for
help topics that are not necessarily hard-coded (e.g., topics that
are snprintf'ed).
* For each filename/topic found, output a warning if a) the file does
not exist, or b) that the topic does not exist in that file.
* Output a warning for any topic that is not referenced in the source
code (i.e., orphaned/now-unused help messages).
* Output a warning for any help file that appears to be empty.
* Output a warning for any help file that appears to be unused (i.e.,
no topics in the help file are referenced in code).
This commit was SVN r31311.
