| 1 | ================================================================ |
|---|
| 2 | Logtalk - Open source object-oriented logic programming language |
|---|
| 3 | Release 2.33.3 |
|---|
| 4 | |
|---|
| 5 | Copyright (c) 1998-2008 Paulo Moura. All Rights Reserved. |
|---|
| 6 | Logtalk is free software. You can redistribute it and/or modify |
|---|
| 7 | it under the terms of the "Artistic License 2.0" as published by |
|---|
| 8 | The Perl Foundation. Consult the "LICENSE.txt" file for details. |
|---|
| 9 | ================================================================ |
|---|
| 10 | |
|---|
| 11 | This folder contains a Prolog file, "libpaths.pl", which, when loaded, |
|---|
| 12 | defines the library paths for the Logtalk standard library and for all |
|---|
| 13 | the supplied examples. You may customize this file by adding the paths |
|---|
| 14 | to your own "libraries" in order to easily load your own source code. |
|---|
| 15 | |
|---|
| 16 | In order to easily compile and load library and example source files using |
|---|
| 17 | the notation <library>(<entity>), you will need to load the "libpaths.pl" |
|---|
| 18 | into your Prolog compiler after loading the Logtalk compiler/runtime. |
|---|
| 19 | |
|---|
| 20 | You might need to edit the "libpaths.pl" file in order to adapt it to |
|---|
| 21 | reflect your Logtalk installation, Prolog compiler, and operating-system |
|---|
| 22 | requirements (for example, some Prolog compilers do not accept or expand |
|---|
| 23 | environment variables occurring on paths). |
|---|
| 24 | |
|---|
| 25 | As defined, the provided "libpaths.pl" file is already compatible with |
|---|
| 26 | some of the most popular Prolog compilers, running on MacOS X, Linux, |
|---|
| 27 | Windows, Unix, and Unix-like operating-systems. |
|---|
| 28 | |
|---|
| 29 | The Prolog integration scripts, found on the "integration" directory, |
|---|
| 30 | automatically load the copy of the "libpaths.pl" file from the Logtalk |
|---|
| 31 | end-user directory created by the "scripts/cplgtdirs.*" scripts. See the |
|---|
| 32 | "INSTALL.txt" and "scripts/NOTES.txt" files for more details. Note that |
|---|
| 33 | some Prolog compilers do not support the <library>(<entity>) notation. |
|---|
| 34 | See the "configs/NOTES.txt" file for details. |
|---|
| 35 | |
|---|
| 36 | The somehow contrived code found on the "libpaths.pl" file is needed to |
|---|
| 37 | ensure compatibility with both the ISO Prolog standard and with most |
|---|
| 38 | Prolog compilers. The code could be greatly simplified by using a multifile |
|---|
| 39 | predicate directive for the library path dynamic predicate. Unfortunately, |
|---|
| 40 | not all Prolog compilers support multifile predicates. |
|---|
| 41 | |
|---|
| 42 | Prolog compilers that are expected to be compatible with the provided |
|---|
| 43 | "libpaths.pl" file as is, across operating-systems: |
|---|
| 44 | |
|---|
| 45 | * B-Prolog |
|---|
| 46 | * CIAO |
|---|
| 47 | * CxProlog |
|---|
| 48 | * ECLiPSe |
|---|
| 49 | * GNU-Prolog |
|---|
| 50 | * K-Prolog |
|---|
| 51 | * Qu-Prolog |
|---|
| 52 | * SICStus Prolog |
|---|
| 53 | * SWI-Prolog |
|---|
| 54 | * YAP |
|---|
| 55 | * XSB |
|---|
| 56 | |
|---|
| 57 | Prolog compilers that imply editing the provided "libpaths.pl" file due |
|---|
| 58 | to the lack of support for expanding environment variables on paths (just |
|---|
| 59 | replace the environment variable LOGTALKUSER by the actual path to your |
|---|
| 60 | Logtalk user folder): |
|---|
| 61 | |
|---|
| 62 | * Amzi! Prolog |
|---|
| 63 | * IF/Prolog |
|---|
| 64 | * JIProlog |
|---|
| 65 | * Quintus Prolog |
|---|
| 66 | |
|---|
| 67 | Feedback on other Prolog compilers is most appreciated. |
|---|
