comp.lang.idl-pvwave archive
Messages from Usenet group comp.lang.idl-pvwave, compiled by Paulo Penteado

Home » Public Forums » archive » Re: Calling Help Files
Show: Today's Messages :: Show Polls :: Message Navigator
E-mail to friend 
Switch to threaded view of this topic Create a new topic Submit Reply
Re: Calling Help Files [message #10739] Wed, 21 January 1998 00:00
David Foster is currently offline  David Foster
Messages: 341
Registered: January 1996
Senior Member
David Fanning wrote:
>
> Kerstin Voigt (voigt@dlr.de) writes:
>
>> does anybody know, how I can call a self created help file from within IDL
>> 5.0?
>> They have the standard Microsoft *.hlp-format (PC environment).
>
> To create an "authentic" IDL help file requires that you have
> a particular help file compiler, I believe. But since I always
> have a WWW browser open anyway, I've found it convenient
> to use HTML help for my IDL procedures. I simply use the
> template.pro file to create a template for my programs.
> (It uses the ";+" and ";-" convention to delineate a section
> of code used for comments.)
>
> Then I just use the MK_HTML_HELP routine from the IDL library
> to construct an HTML file from my IDL procedures and functions.
> It is all done in one step. This, for example, is what I use
> to build the help files for the program files on my web page.
>

I guess I am just plain primitive, but my help files are plain
ascii files, with a .doc extension. They are placed in the directories
where the .pro files live, and I use my program LHELP.PRO to display
them (easy interface, search capability, and can view .pro files as
well). No snazzy hypertext links or fancy fonts, but works quite well.

If you're interested you can download LHELP.PRO and supporting routines
via anonymous ftp:

bial8.ucsd.edu pub/software/idl/share/Lhelp/lhelp.tar.gz

Dave
--

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~
David S. Foster Univ. of California, San Diego
Programmer/Analyst Brain Image Analysis Laboratory
foster@bial1.ucsd.edu Department of Psychiatry
(619) 622-5892 8950 Via La Jolla Drive, Suite 2240
La Jolla, CA 92037
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~
Re: Calling Help Files [message #10769 is a reply to message #10739] Sat, 17 January 1998 00:00 Go to previous message
rivers is currently offline  rivers
Messages: 228
Registered: March 1991
Senior Member
In article <01bd2281$29a2c2a0$256af781@kat37t.ia.kp.dlr.de>, "Kerstin Voigt" <voigt@dlr.de> writes:
> Hi,
>
> does anybody know, how I can call a self created help file from within IDL
> 5.0?
> They have the standard Microsoft *.hlp-format (PC environment).

If you have a standard Microsoft .hlp file then it is very easy to call it
from within IDL. Do it as follows:

IDL> spawn, "start my_help_file.hlp"

This may look strange, so let me explain how it works. The "start" command
means that your help will run as a separate process, so the IDL "spawn" command
will return immediately. The fact that you are "starting" a file, rather than
a program, takes advantage of the Windows file type/application association
feature. When you "start" a .hlp file it automatically runs whatever
application is associated with .hlp files. If your Windows system is
configured correctly this will work fine.

Of course, this also works for other file types, for example "http".
The following IDL command will start your default browser (e.g. Netscape or
Internet Explorer, depending upon how you have set things up on your system)
and display RSI's home page:

IDL> spawn, "start http://www.rsinc.com"

The nice thing about this is that it will start your browser if it is not
already running, but if it is already running it will simply display this new
URL. I find this a very convenient way to display help information, e.g.

IDL> spawn, "start http://www.mysite.edu/IDL/my_help_file#my_topic"

Note that some Windows systems I have seen do not have a default browser
correctly configured. Internet Explorer offers an option to let you make it
your default browser. If you select this it will configure things correctly.
If you want to use Netscape, and it is not configured correctly, go into the
NT Explorer View/Folder Options/File Types menu and select "URL Hypertext
Transfer Protocol". Select Edit/Open/Edit, set "Application to use ... "
to be the full path to Netscape, select "Use DDE" and "DDE Message"="%1"
Application=Netscape, Topic=WWW_OpenURL.

Cheers,
Mark

____________________________________________________________
Mark Rivers (773) 702-2279 (office)
CARS (773) 702-9951 (secretary)
Univ. of Chicago (773) 702-5454 (FAX)
5640 S. Ellis Ave. (708) 922-0499 (home)
Chicago, IL 60637 rivers@cars.uchicago.edu (e-mail)

or:
Argonne National Laboratory (630) 252-0422 (office)
Building 434A (630) 252-0405 (lab)
9700 South Cass Avenue (630) 252-1713 (beamline)
Argonne, IL 60439 (630) 252-0443 (FAX)
Re: Calling Help Files [message #10774 is a reply to message #10769] Fri, 16 January 1998 00:00 Go to previous message
davidf is currently offline  davidf
Messages: 2866
Registered: September 1996
Senior Member
Kerstin Voigt (voigt@dlr.de) writes:


> does anybody know, how I can call a self created help file from within IDL
> 5.0?
> They have the standard Microsoft *.hlp-format (PC environment).

To create an "authentic" IDL help file requires that you have
a particular help file compiler, I believe. But since I always
have a WWW browser open anyway, I've found it convenient
to use HTML help for my IDL procedures. I simply use the
template.pro file to create a template for my programs.
(It uses the ";+" and ";-" convention to delineate a section
of code used for comments.)

Then I just use the MK_HTML_HELP routine from the IDL library
to construct an HTML file from my IDL procedures and functions.
It is all done in one step. This, for example, is what I use
to build the help files for the program files on my web page.

Cheers,

David

-----------------------------------------------------------
David Fanning, Ph.D.
Fanning Software Consulting
E-Mail: davidf@dfanning.com
Phone: 970-221-0438
Coyote's Guide to IDL Programming: http://www.dfanning.com/
  Switch to threaded view of this topic Create a new topic Submit Reply
Previous Topic: Re: Segmentation Fault
Next Topic: Re: Maximum entropy filtering

-=] Back to Top [=-
[ Syndicate this forum (XML) ] [ RSS ] [ PDF ]

Current Time: Sat Oct 11 16:13:13 PDT 2025

Total time taken to generate the page: 1.63535 seconds