Re: Ada Reference Manual 2012 in info format

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

El 03/05/2012 17:03, Jerrid Kimball escribi�:
> On 05/01/2012 06:51 AM, Stephen Leake wrote:
>> Jerrid Kimball<jerrid@kimball.co> writes:
>>
>>> Thank you very much! These are very nice and emacs seems to handle
>>> info pages very well.
>>
>> Good to get some feedback :)
>>
>>> I'm slowly getting to putting some modern-looking versions on the web
>>> based on the work of a fellow #ada IRC channel visitor. I hope to get
>>> to it soon. I'll keep CLA informed!
>>
>> Hmm. What is "not modern" about info in Emacs? Many people think it is
>> the best of the currently available IDEs.
>
> You've encountered lexical ambiguity. I didn't intend to suggest that
> emacs' display of the info page isn't modern. My intent is to eventually
> put a RM tool on the interwebs that eclipses the official RM in its
> presentation and accompanying functionality. It's just another thing
> that will make Ada more appealing to the uninitiated. Small steps..
>
>>
>> I think you need a more precise adjective :)
>>
>> But if you do come up with something useful, perhaps it could be
>> incorporated into the ada-reference-manual Debian package.

If the aim is to make the ARM usable as a reference for developers (say 
from an IDE), then it will be necessary to have it indexed also by:
- language keywords
- library functions and other global symbols

In its current form, the ARM index is not adequate for using it as 
context sensitive help from within an Ada IDE.

To be more precise, you can't put the cursor in an editing window over 
an Ada keyword or over a library item identifier, request help on it, 
and automagically have the ARM opened at an appropriate place (or be 
offered a choice among appropriate places, if there are several).

Compare this with the Ada Programming WikiBook, that have a dedicated 
page for each individual Ada language keyword.

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