Re: Ada help file indexed by keyword

[Manuel Collado <m.collado@domain.invalid>]

Georg Bauhaus escribi�:
> Manuel Collado schrieb:
>> I'm looking for an Ada95/2005 help or reference document indexed by
>> keyword (reserved word or standard library identifier).
>>
>> The purpose is to integrate it into an academic IDE, so it should be
>> possible to put the cursor in the editing window over a meaningful word,
>> and invoke help about it.
>>
>> So far I've found the ARM in several formats, but none of them can be
>> accessed as described. There is also the Ada wikibook, that also lacks
>> the required feature. Even GNAT/GPS seems to lack it.
> 
> The wikibook has this feature. The book authors have made templates
> that, if used, will make, e.g., a reserved word into a link to a pages
> with info about the word.  There are some programs and editor macro
> files (Vim and Emacs) to help with automatic addition of such.  These
> are mentioned on the wikibook authors' pages (in wikibook.org).

Do you suggest converting every instance of common words like 'with', 
'use', 'for', 'while', ... into a link to index entries? :-)

> 
> One of these programs is the following. I should prepare an update,
> though, for some new wikibook template syntax.
> http://home.arcor.de/bauhaus/Tools/ASnip/

Well, I'm not looking for a tool to create the help system, but for a 
ready-to-use one. In fact my course is not about Ada programming, but 
about Programming Environments. My students will be asked to customize 
an existing IDE by adding additional features not already available, via 
invocation of external tools. Like contextual help for Ada keywords or 
standard library elements while editing Ada sources.

Hope this clarifies the idea.

-- 
Manuel Collado - http://lml.ls.fi.upm.es/~mcollado