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=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable autolearn_force=no version=3.4.4 Path: eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!feeder.eternal-september.org!aioe.org!.POSTED!not-for-mail From: "J-P. Rosen" Newsgroups: comp.lang.ada Subject: Re: Visibility of Indexing aspects Date: Sat, 21 Jul 2018 07:58:18 +0200 Organization: Adalog Message-ID: References: <40d568da-4715-42de-8e28-98da39a5c974@googlegroups.com> <34f499f7-020f-4dcc-adad-0ab1113386d1@googlegroups.com> <9d69e7b5-6b2d-4607-9f7b-affa78c41620@googlegroups.com> <41c711cb-0300-4a41-93d3-e69297ae1945@googlegroups.com> <42de4aa3-9e7c-44b8-aa84-712cc7ce03c6@googlegroups.com> <9b6b6f10-5956-4a19-83f5-c1c015c62602@googlegroups.com> <1c2ccf88-588a-4a03-b0c7-5d7d5a5f4edb@googlegroups.com> NNTP-Posting-Host: TKk5kT01+2w6guVcOjcsiQ.user.gioia.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Complaints-To: abuse@aioe.org User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 Openpgp: preference=signencrypt X-Notice: Filtered by postfilter v. 0.8.3 Content-Language: fr Xref: reader02.eternal-september.org comp.lang.ada:53927 Date: 2018-07-21T07:58:18+02:00 List-Id: Le 21/07/2018 à 00:23, Jere a écrit : > I will say the RM would benefit with some visual examples for some > topics (Scoping, Visibility, Accessibility). Something like code > snippets with comments showing the various ins/outs of the > particular section above it. It might even go a long way in > clarifying some points of the "Heart of Darkness". I know it > isn't necessarily an easy task and if I was able to discern it all > better, I might take a stab at it (so maybe one day in the future). The 83 reference manual had more examples, and it was a deliberate decision to have less examples from 95 on. The rationale is that the RM is for precise definitions, lawyers and compiler writers, and that examples bring nothing formally except possible errors. The RM is definitely not for learning the language. BTW, have you seen anybody learning Fortran or C++ from its standard? In a sense, the wide availability of the RM made it too easy too look at for beginners! OTOH, if you want to write an "RM explained and commented" book, you are very welcome to do so, it would certainly be useful. -- J-P. Rosen Adalog 2 rue du Docteur Lombard, 92441 Issy-les-Moulineaux CEDEX Tel: +33 1 45 29 21 52, Fax: +33 1 45 29 25 00 http://www.adalog.fr