________________________________________________________________________

This file is part of Logtalk <https://logtalk.org/>  
Copyright 1998-2018 Paulo Moura <pmoura@logtalk.org>

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 directory contains example scripts for creating GNU Prolog generated
executable files that embed Logtalk.

The following scripts are provided:

- `gprolog_embed_logtalk.sh`  
	creates a `logtalk` executable that embeds the Logtalk compiler and
	runtime; starts the top-level interpreter when run

Known issues
------------

A `gplc` limitation when compiling calls to multifile predicates requires
files that contain those calls but don't define clauses for the multifile
predicates to include the multifile predicate directives.

`gplc` seems to collect file initialization goals in a stack. This may
dictate listing the files being compiled by it in a specific order to
avoid predicate existence errors.

________________________________________________________________________

This file is part of Logtalk <https://logtalk.org/>  
Copyright 1998-2018 Paulo Moura <pmoura@logtalk.org>

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 directory contains example scripts for creating GNU Prolog generated
executable files that embed Logtalk.

The following scripts are provided:

- `gprolog_embed_logtalk.sh`  
	creates a `logtalk` executable that embeds the Logtalk compiler and
	runtime; starts the top-level interpreter when run

Known issues
------------

The script generates some `suspicious predicate {}/1` warnings. These can
be safely ignored.

A `gplc` limitation when compiling calls to multifile predicates requires
files that contain those calls but don't define clauses for the multifile
predicates to include the multifile predicate directives (or to meta-call
the multifile predicates).

`gplc` seems to collect file initialization goals in a stack. This may
dictate listing the files being compiled by it in a specific order to
avoid predicate existence errors.

Update documentation of the GNU Prolog embedding script
Update documentation of the GNU Prolog embedding script
