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

Home » Public Forums » archive » Re: HELP adding entries to MAN_PROC
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: HELP adding entries to MAN_PROC [message #793] Thu, 04 February 1993 13:51
knight is currently offline  knight
Messages: 37
Registered: January 1992
Member
In article <1kqqq6INN4h3@maz4.sma.ch>, oet@sma.ch (Thomas Oettli) writes:
|> In article <107906@netnews.upenn.edu> mark@ginger.biophys.upenn.edu (Mark Elliott) writes:
|> >
|> > DOES ANYONE KNOW HOW TO ADD ENTRIES TO IDL'S ON LINE HELP PROGRAM, MAN_PROC?
...(omitted text)...
|> >
|> Try mk_library_help:
|>
|> EXAMPLE:
|>
|> IDL> mk_library_help, !DIR+'/lib/userlib',!DIR+'/help/test.help'
|>
|> IDL> ?
|>
|> You will now have description of all procedures in the subdir userlib
|> on the button 'test'.
|>

I use this method also, and it helps the novice as well as the expert, who
wants to review a routine's action or parameter list. In addition, I build
into each routine a /help keyword to print its header. For example,

myroutine,/help

produces the header via the doc_library routine. The only things needed in the
code are:

pro myroutine,help=help,...
...
if keyword_set(help) then begin & doc_library,'myroutine' & return & endif
...

Fred
--
=Fred Knight (knight@ll.mit.edu) (617) 981-2027
C-483\\MIT Lincoln Laboratory\\244 Wood Street\\Lexington, MA 02173
Re: HELP adding entries to MAN_PROC [message #794 is a reply to message #793] Thu, 04 February 1993 02:23 Go to previous message
oet is currently offline  oet
Messages: 28
Registered: February 1993
Junior Member
In article <107906@netnews.upenn.edu> mark@ginger.biophys.upenn.edu (Mark Elliott) writes:
>
>
>
> DOES ANYONE KNOW HOW TO ADD ENTRIES TO IDL'S ON LINE HELP PROGRAM, MAN_PROC?
>
>
> We have a created a directory $IDL/ourlib containing IDL programs used
> by our group. I would like to add the DOC_LIBRARY descriptions of these files to
> MAN_PROC. I have determined that MAN_PROC calls MP_WIDGETS, which scans the
> $IDL/help directory for "*.help" files. Each ".help" file generates a category
> of help topics in the widget. The format of these files is clear, but not trivial
> to generate.
> Is there a program in the IDL distribution which scans a directory and
> constructs a ".help" file? This appears to be all I would need to add descriptions
> of our "home-made" programs to the HELP widget.
>
> Any response greatly appreciated.
>
Try mk_library_help:

EXAMPLE:

IDL> mk_library_help, !DIR+'/lib/userlib',!DIR+'/help/test.help'

IDL> ?

You will now have description of all procedures in the subdir userlib
on the button 'test'.


--
|Thomas Oettli Internet: Thomas.Oettli@sma.ch |
|Swiss Meteorological Institute CServe: 100015.3543@compuserve.com |
|Kraehbuehlstr. 58 X.400 (PP) : |
|8044 Zuerich S=oet/O=sma/PRMD=SWITCH/ADMD=ARCOM/C=CH/ |
| FAX: +41 1 256 92 78, Phone: +41 1 256 93 16 |
  Switch to threaded view of this topic Create a new topic Submit Reply
Previous Topic: wirtefits
Next Topic: Setting PLOT colors on TRUE_COLOR display??

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

Current Time: Wed Oct 08 15:13:49 PDT 2025

Total time taken to generate the page: 0.00504 seconds