Re: Access procedure to pointer

[Sébastien <seb.morand@gmail.com>]

> You could read the .ads files. They are well written and concise. I
> don't see what other form of documentation would be much better. 

I can and I do, but just because I don't have any choice. Of course Ada 
is easy to read, but there is no hyperlink navigation, this is quite 
boring. For instance you find out a function, let's say the 
documentation is clear, yes but ada is strongly typed and then have a 
lot of new type in order to assure safety and quality of the code. So 
you have then to find the definition of the type and so on...

Documentation is the most important part of any technology. Even if Ada 
code is well documented, a user friendly version of the documentation 
easy to read and to navigate will be a better way to promote the 
language and help new developer. If your technology is reliable, well 
designed but with no documentation, don't even try to promote it in 
professional world, it will be a waste of time.

> You mention javadoc in another post. That's just a massaged form of
> comments and code from java source code. In java, that makes sense,
> because there is no separation of interface from implementation (no
> analogy of .ads vs .adb). So reading the java source files is tedious
> and confusing, if all you want is a list of functions you could call.
> 
> For Ada, that's simply not necessary; .ads files serve the same
> purpose, without needing a separate tool. 

I completly disagree, even if ada source code is far easier to read than 
any other language. See remarks above.

Moreover, a document should hide the implementation detail in order to 
be clearer and more concise. In ada, ads and adb are often in the same 
directory in all installation I tried, so it's not really helping.

Moreover no documentation means no index or any stuff like that, no 
search form to find all the files that could be usefull for you. At 
least, the name of the file in ada distribution are not really 
meaningful, s-interr.ads does not mean anything to me.