From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-0.9 required=5.0 tests=BAYES_00,FORGED_GMAIL_RCVD, FREEMAIL_FROM autolearn=no autolearn_force=no version=3.4.4 X-Google-Thread: 103376,34e28efa1a88ae84 X-Google-Attributes: gid103376,domainid0,public,usenet X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news4.google.com!feeder.news-service.com!news.motzarella.org!motzarella.org!not-for-mail From: =?ISO-8859-1?Q?S=E9bastien?= Newsgroups: comp.lang.ada Subject: Re: Access procedure to pointer Date: Mon, 02 Jun 2008 12:24:49 +0000 Organization: A noiseless patient Spider Message-ID: References: <483C48B5.9060303@gmail.com> <483D209D.5010408@gmail.com> <483D72F0.9090308@gmail.com> <49d0600f-e5cd-4d95-9ca4-1eb25a832437@l17g2000pri.googlegroups.com> <483DE480.9020208@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: feeder.motzarella.org U2FsdGVkX19roAOxaAYR/IYqc/idtE5C/QyzcV/ow4/OwKi8N/e471Ajw/k4gmKXTbF7FQyZVK9oTcUTMQ3BTeFma8cG6ITWCjn7P3wbAcY7cp9rgWmv8fFfX8z294Kge16a24S5cpoNMCDOWsge4g== X-Complaints-To: Please send complaints to abuse@motzarella.org with full headers NNTP-Posting-Date: Mon, 2 Jun 2008 12:24:54 +0000 (UTC) In-Reply-To: X-Auth-Sender: U2FsdGVkX191OoWaJJxO9ZkS3lisEc0jeUrV78oQsgrdV3VrYQbmlw== Cancel-Lock: sha1:od/jU3MSW5Q5Mx/tWhk0wkkot7k= User-Agent: Thunderbird 2.0.0.14 (Windows/20080421) Xref: g2news1.google.com comp.lang.ada:513 Date: 2008-06-02T12:24:49+00:00 List-Id: > 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.