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=ham
	autolearn_force=no version=3.4.4
X-Google-Thread: 103376,c406e0c4a6eb74ed
X-Google-Attributes: gid103376,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!news1.google.com!news.glorb.com!fr.ip.ndsoftware.net!fu-berlin.de!uni-berlin.de!not-for-mail
From: "Martin Dowie" <martin.dowie@baesystems.com>
Newsgroups: comp.lang.ada
Subject: Re: ADA Popularity Discussion Request
Date: Thu, 19 Aug 2004 15:53:33 +0100
Organization: BAE SYSTEMS
Message-ID: <4124bda4$1_1@baen1673807.greenlnk.net>
References: <49dc98cf.0408110556.18ae7df@posting.google.com>
 <b47de02.0408161309.151f6a53@posting.google.com>
 <4121E4B4.5080609@noplace.com> <4121ebcf$1_1@baen1673807.greenlnk.net>
 <4121F314.6080108@noplace.com> <4121fda9$1_1@baen1673807.greenlnk.net>
 <412202F8.50305@noplace.com>
X-Trace: news.uni-berlin.de 1uHWzTYvZRLo2GlduVOqdwAZWZNcH0A3LjyLejqEMM6cwaMD9j
X-Orig-Path: baen1673807.greenlnk.net!baen1673807!not-for-mail
X-Priority: 3
X-MSMail-Priority: Normal
X-Newsreader: Microsoft Outlook Express 5.50.4807.1700
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4807.1700
X-Original-NNTP-Posting-Host: baen1673807.greenlnk.net
Xref: g2news1.google.com comp.lang.ada:2853
Date: 2004-08-19T15:53:33+01:00
List-Id: <comp.lang.ada>

Marin David Condic wrote:
> Give some thought to some kind of "textbook" format. User's guides are
> nice if you already know basically how to use the library and just
> want to look up the specifics of what a call to some subroutine does.
> But something that addresses "What the heck to I *do* with this
> package???" might help people get started with it. You know: "Suppose
> you want to maintain a mailing list of people and search it based on
> last name..." Explaining how to do that with a container library and
> pointing at code or code snippets can be invaluable to a new user.

Part of the problem with writing examples is that the _best_ way to
use the library will come with the new access level rules wrt access
to subprograms. Just now we have the 'cludgy' Ada95 ways, e.g.

procedure Process (C : Cursor) is
begin
   ...
end Process;

procedure Do_Something (V : Vector) is
begin
   Iterate (V, Process'Access);
end Do_Something;

Can become

procedure Do_Something (V : Vector) is
   procedure Process (C : Cursor) is
   begin
      ...
   end Process;
begin
   Iterate (V, Process'Access);
end Do_Something;

Which is a bit nicer...

However, since the versions I'm providing are Ada95, I guess I
could try and write up something in that style but with a very large
health warning! :-)

Cheers

-- Martin