Re: Literate Programming in Ada, AdaDoc, AdaBrowse

["Björn Persson" <spam-away@nowhere.nil>]

Marius Amado Alves wrote:

> Compare:
> 
>   http://www.liacc.up.pt/~maa/files/g-io_aux.ads
>   http://www.liacc.up.pt/~maa/files/g-io_aux-edited.ads

The license block is too long, but otherwise I like the original version 
a lot better.

If there's anything special I need to be aware of about a particular 
function, then I want it to be noted in the most obvious place. I don't 
want to scroll down to check if perchance there might be a note about 
this function at the bottom of the file.

You also removed some important information: Where does the 
parameterless Get_Line read from? Which line does it get? Does it always 
return the whole line, from line break to line break, or could it be 
just part of the line in some cases? If so, which part and in which 
cases? We can assume that the second Get_Line reads from the file we 
pass to it, but does it otherwise work the same as the first Get_Line or 
are there any differences? The original file answers all of those questions.

-- 
Björn Persson                              PGP key A88682FD
                    omb jor ers @sv ge.
                    r o.b n.p son eri nu