---

This file is part of Logtalk https://logtalk.org/ SPDX-FileCopyrightText: 1998-2023 Paulo Moura <pmoura@logtalk.org> SPDX-License-Identifier: Apache-2.0

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

This is an EXPERIMENTAL SWI-Prolog pack specific README file. The actual Logtalk README file can be found at `../logtalk-3.77.0/README.md`. Follows some notes on this experimental pack version of Logtalk.

This experimental pack differs from the officially supported pack in that it loads Logtalk into a module named logtalk instead of loading it into the user pseudo-module. This alternative can be in principle used with other backend Prolog systems. Note, however, that the lack of an accepted Prolog module standard and the differences between modules systems (e.g. in operator and meta-predicate handling) can cause portability issues and different behavior in corner cases.

The pack version of Logtalk is mainly targeted for specific application deployment scenarios. For development, using one of the installers available from the Logtalk website is strongly advised for a much better user experience.

Installing this pack simplifies loading Logtalk on-demand by simply using the directive (or the corresponding query):

:- use_module(library(logtalk)).

When using the directive above, the LOGTALKHOME and LOGTALKUSER shell environment variables are set, just for the duration of the SWI-Prolog process, to the full path of the `../logtalk-3.77.0` directory.

For easy access to the contents of the Logtalk installation folder (e.g. documentation or examples) you can create a symbolic link to the `../logtalk-3.77.0` directory (in e.g. your home directory). Its full path can be easily found by using the query:

?- pack_info(logtalk).

The `../logtalk-3.77.0` directory contains a settings.lgt file that makes loading of Logtalk silent. If you make other changes to this file, or to other contents of the `../logtalk-3.77.0` directory, be sure to make a backup before upgrading or removing this pack.

The `../logtalk-3.77.0` directory contains several handy scripts but due to a limitation of the archive library in SWI-Prolog 7.3.28 and older versions used for extracting the pack files, the executable permission of the script files was not preserved. If you're not running SWI-Prolog 7.3.29 or a later version, this issue can be manually fixed after installing the pack using the following steps (adjust the logtalk-3.77.0 directory full path if necessary for your installation):

$ cd $HOME/lib/swipl/pack/logtalk/logtalk-3.77.0
$ chmod a+x scripts/cleandist.sh
$ ./scripts/cleandist.sh