---

This file is part of Logtalk https://logtalk.org/ SPDX-FileCopyrightText: 1998-2025 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 folder contains a single Prolog file, core.pl, which implements the Logtalk compiler and runtime. There are also several Logtalk source files defining built-in protocols, categories, and objects:

[101, 120, 112, 97, 110, 100, 105, 110, 103, 46, 108, 103, 116]

built-in expanding protocol specifying term- and goal-expansion predicates

[102, 111, 114, 119, 97, 114, 100, 105, 110, 103, 46, 108, 103, 116]

built-in forwarding protocol specifying the message forwarding predicate

[109, 111, 110, 105, 116, 111, 114, 105, 110, 103, 46, 108, 103, 116]

built-in monitoring protocol specifying the event handler predicates

[108, 111, 103, 116, 97, 108, 107, 46, 108, 103, 116]

built-in logtalk object defining message printing, question asking, debugging, and hacking predicates

[99, 111, 114, 101, 95, 109, 101, 115, 115, 97, 103, 101, 115, 46, 108, 103, 116]

built-in core_messages category defining the default translations for compiler messages

[117, 115, 101, 114, 46, 108, 103, 116]

definition of the built-in pseudo-object user

Before loading the core.pl file into your favorite Prolog compiler, you must first load the adapter file for your Prolog compiler, which you will find in the adapters directory, and the paths/paths.pl file, which defines essential library paths for starting Logtalk. The provided Prolog POSIX integration scripts and Windows scripts and shortcuts automate this process and should be used unless there's a strong reason to manually load Logtalk.

HTML documentation for the core entity APIs can be found on the docs directory (open the docs/index.html file with your web browser). The documentation for these tools can be regenerated using the shell scripts `../scripts/update_html_docs.sh and ../scripts/update_svg_diagrams.sh`.

The source files are indented using tabs (a common setting is a tab width equivalent to 4 spaces).