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,FREEMAIL_FROM
	autolearn=unavailable autolearn_force=no version=3.4.4
X-Received: by 2002:a24:7546:: with SMTP id
 y67-v6mr12980120itc.26.1539582296576;
        Sun, 14 Oct 2018 22:44:56 -0700 (PDT)
X-Received: by 2002:aca:fdc7:: with SMTP id
 b190-v6mr252707oii.3.1539582296353;
 Sun, 14 Oct 2018 22:44:56 -0700 (PDT)
Path: 
 eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!feeder.eternal-september.org!news.uzoreto.com!2.eu.feeder.erje.net!4.us.feeder.erje.net!feeder.erje.net!feeder.usenetexpress.com!feeder-in1.iad1.usenetexpress.com!border1.nntp.dca1.giganews.com!nntp.giganews.com!z5-v6no435902ite.0!news-out.google.com!n199-v6ni469itn.0!nntp.google.com!z5-v6no435900ite.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail
Newsgroups: comp.lang.ada
Date: Sun, 14 Oct 2018 22:44:56 -0700 (PDT)
In-Reply-To: <7fcdcc97-67e4-473b-abc4-cd0ecd4501ad@googlegroups.com>
Complaints-To: groups-abuse@google.com
Injection-Info: glegroupsg2000goo.googlegroups.com;
 posting-host=62.121.55.154;
 posting-account=9KbC2woAAAA0kK2IAUr3-FkzJBtOzrhm
NNTP-Posting-Host: 62.121.55.154
References: <7fcdcc97-67e4-473b-abc4-cd0ecd4501ad@googlegroups.com>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <1cbc93ec-52c2-4827-bf00-c2935e4c6229@googlegroups.com>
Subject: Re: Is the Documentation In a spec File Usually Enough For You ?
From: =?UTF-8?B?SGVucmlrIEjDpHJrw7ZuZW4=?= <heharkon@gmail.com>
Injection-Date: Mon, 15 Oct 2018 05:44:56 +0000
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Xref: reader02.eternal-september.org comp.lang.ada:54574
Date: 2018-10-14T22:44:56-07:00
List-Id: <comp.lang.ada>

On Monday, 15 October 2018 03:42:05 UTC+3, pat...@spellingbeewinnars.org  w=
rote:
> Hi Everyone
>=20
> I was just reading through the list of libraries included in C++ boost. W=
e don't have matches for all of this but the libraries that ship with Ada h=
ave quite a bit of coverage too and I was surprised that we more or less ma=
tch up.
>=20
> The thing is, that the Ada libraries come with almost no documentation/ex=
ample code at all.
>=20
> Do you find that just reading through the spec files is enough for you to=
 understand how to use the library in most cases? I was thinking I would tr=
y more of them out but I also wonder if I am about to go off on a suicide m=
ission.
>=20
> -Patrick

My experience of Ada is still very limited, but so far I'd like to say that=
 I like the separate spec files, and for small "interfaces" the might be en=
ough. But I'm also a learn-by-example kind of person, so an example always =
gives me much more confidence when starting to use some new library. I don'=
t think that seeing just the types and function signatures is always enough=
 to convey the "intent" of that particular interface.

-H