I have written a Macro which approaches an application in its
complexity. (In retrospect it might have been better as a standalone
application but there are advantages related to portability and
familiarity which mean that Excel is a natural home for it). We have
written a 50 page manual for the Macro.

I would like to embed the help files in the workbook somehow so that
the macro/application can be distributed as a single Excel workbook.

I have tried embedding the help file (in . chm format) in a hidden
worksheet as an OLEobject, and displaying it with
wsHelp.OLEObjects(fHelp).Show
and this is partially successful, but unfortunately this triggers a
rash of security warnings, and, more problematically, none of the
links in the embedded help file work.
Is there any way to embed a .chm file in such a way that it remains
functional? or can anyone think of another way to keep the help and
workbook together in one file? (I can display a seperate help file
trivially with
Shell "hh.exe " & ThisWorkBook.Path & "\helpfile.chm"
but I don't really want to trust the users to put the help file in the
right place.
I have put a very simple example file he
http://www.bodgesoc.org/HelpDemo.xls
This is a single worksheet with a button linked to an embedded version
of the HyperTerminal help file, it demonstrates the broken links
problem quite well.
(As always, use appropriate caution opening linked files from the
internet, but I promise that the linked file is harmless as posted.
Not that a black hat might not hack my website and change it of,
course.)