idlwave-help-find-in-doc-header

idlwave-help-find-in-doc-header is a compiled Lisp function in `idlw-help.el'.

(idlwave-help-find-in-doc-header NAME TYPE CLASS KEYWORD &optional EXACT)

Find the requested help in the doc-header above point.

First checks if there is a doc-lib header which describes the correct
routine. Then tries to find the KEYWORDS section and the KEYWORD, if
given. Returns the point which should be window start of the help
window. If EXACT is non-nil, the full help position must be found -
down to the keyword requested. This setting is for context help, if
the exact spot is needed.

If EXACT is nil, the position of the header is returned if it
describes the correct routine - even if the keyword description cannot
be found. TYPE is ignored.

This function expects a more or less standard routine header. In
particular it looks for the `NAME:' tag, either with a colon, or alone
on a line. Then `NAME:' must be followed by the routine name on the
same or the next line. When KEYWORD is non-nil, looks first for a
`KEYWORDS' section. It is amazing how inconsistent this is through
some IDL libraries I have seen. We settle for a line containing an
upper case "KEYWORD" string. If this line is not found we search
for the keyword anyway to increase the hit-rate

When one of these sections exists we check for a line starting with any of

/KEYWORD KEYWORD- KEYWORD= KEYWORD

with spaces allowed between the keyword and the following dash or equal sign.
If there is a match, we assume it is the keyword description.