headers
Mahmud Mohamed | 10 Oct 2010 05:08
Picon

bug in documentation?

 Hi,

I have just discovered AliceML, so please take this "bug report" with a
grain of salt.

The page for the Random manual:

http://www.ps.uni-saarland.de/alice/manual/library/rand.html

It says that the Random module can be used as follows:

  import signature RAND from "x-alice:/lib/data/RAND-sig"
  import structure Rand from "x-alice:/lib/data/Rand"

However, within the file system, said files are in lib/utility, not lib/data

Also, they seem to have been renamed to Random/RANDOM, since it's the
following calls that work:

import structure Random from "x-alice:/lib/utility/Random";
import signature RANDOM from "x-alice:/lib/utility/RANDOM-sig";

Regards.

- mahmud
Permalink | Reply | 1 comment |
headers
Andreas Rossberg | 10 Oct 2010 16:05
Favicon

Re: bug in documentation?

Hi Mahmud.

> The page for the Random manual:
>
> http://www.ps.uni-saarland.de/alice/manual/library/rand.html
>
> It says that the Random module can be used as follows:
>
>  import signature RAND from "x-alice:/lib/data/RAND-sig"
>  import structure Rand from "x-alice:/lib/data/Rand"

Right, that is a mistake in the docs. These components actually are  
located at /lib/system/, not /lib/data/. I fixed the docs online,  
thanks for pointing this out.

> However, within the file system, said files are in lib/utility, not  
> lib/data

Those are different components. Stuff in /lib/utility usually are  
"unofficial" auxiliary libraries, i.e. less polished, undocumented and  
primarily for internal use only. They usually work, but we don't  
guarantee user satisfaction. :)

Thanks,
/Andreas
Permalink | Reply | 0 comments |

Gmane