Re: How do I use GNAT.Directory_Operations.Iteration?

["Nasser M. Abbasi" <nma@12000.org>]

On 3/15/2011 4:15 AM, Simon Wright wrote:

>
> The actual documentation is at
> http://gcc.gnu.org/onlinedocs/gcc-4.5.0/gnat_rm/GNAT_002eDirectory_005fOperations_002eIteration-_0028g_002
>ddiopit_002eads_0029.html#GNAT_002eDirectory_005fOperations_002eIteration-_0028g_002ddiopit_002eads_0029
> (gosh, what a URL! might be better to start here:
> http://gcc.gnu.org/onlinedocs/gcc-4.5.0/gnat_rm/The-GNAT-Library.html#The-GNAT-Library
> and look for g-diopit.ads)
>

Yes, I know about those, and have visited them, but they do not have the source code?
All what it says:

"9.56 GNAT.Directory_Operations.Iteration (g-diopit.ads)

A child unit of GNAT.Directory_Operations providing additional
operations for iterating through directories."

But how to use it? The same link for the gcc part, I looked at also.
I was looking for the source code, to get an idea how to call it.

> and it's not helpful (specially to a newcomer).
>
> There's a discussion of the use of generic formal subprograms at
> http://en.wikibooks.org/wiki/Ada_Programming/Generics#Generic_formal_subprograms
>

>> When I write something myself, I try to always put a small example
>> at the top, as part of it documentation, of how to call or use it.
>> It would be nice if these had such examples.
>
> Agreed, to some extent. Though it'd only really be helpful here if you'd
> never come across generic formal subprograms before. The comments in the
> spec (the secret GNAT documentation!) seem pretty explicit, aside only
> from the language detail that the OP had trouble with.

Well, considering that Ada is used very little relatively speaking,
then one can say that almost all programmers can be classified as Ada
newbies.

So, having documentation readily available on how to call or use something
will make it easier for the rest of use to start using Ada, else a newbie
can get frustrated and drop it.

Many of us learn better by seeing examples, I know I do.

--Nasser