| 1 | ================================================================ |
|---|
| 2 | Logtalk - Open source object-oriented logic programming language |
|---|
| 3 | Release 2.43.3 |
|---|
| 4 | |
|---|
| 5 | Copyright (c) 1998-2011 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 | |
|---|
| 12 | Quick start |
|---|
| 13 | =========== |
|---|
| 14 | |
|---|
| 15 | |
|---|
| 16 | Starting up Logtalk |
|---|
| 17 | ------------------- |
|---|
| 18 | |
|---|
| 19 | 1. Install Logtalk by using either the installer provided for your |
|---|
| 20 | operating-system (when available) or by following the instructions |
|---|
| 21 | on the "INSTALL.txt" file. |
|---|
| 22 | |
|---|
| 23 | On POSIX operating-systems, the following shell scripts are installed |
|---|
| 24 | by default for running Logtalk with selected back-end Prolog compilers |
|---|
| 25 | (which must be up-to-date and properly installed before running these |
|---|
| 26 | scripts!): |
|---|
| 27 | |
|---|
| 28 | * B-Prolog: bplgt |
|---|
| 29 | * CxProlog: cxlgt |
|---|
| 30 | * ECLiPSe: eclipselgt |
|---|
| 31 | * GNU Prolog: gplgt |
|---|
| 32 | * Lean Prolog: lplgt |
|---|
| 33 | * Qu-Prolog: qplgt |
|---|
| 34 | * SICStus Prolog: sicstuslgt |
|---|
| 35 | * SWI-Prolog: swilgt |
|---|
| 36 | * XSB: xsblgt (first run must use sudo) |
|---|
| 37 | * XSB 64 bits: xsb64lgt (first run must use sudo) |
|---|
| 38 | * XSB MT: xsbmtlgt (first run must use sudo) |
|---|
| 39 | * XSB MT 64 bits: xsbmt64lgt (first run must use sudo) |
|---|
| 40 | * YAP: yaplgt |
|---|
| 41 | |
|---|
| 42 | If you get an unexpected failure when using one of the Prolog integration |
|---|
| 43 | scripts, consult the "configs/NOTES.txt" file in the Logtalk installation |
|---|
| 44 | folder for compatibility notes or consult the integration script man page. |
|---|
| 45 | |
|---|
| 46 | On MacOS X systems, "/opt/local/bin" must be in your PATH to run the scripts. |
|---|
| 47 | Terminal command files for running Logtalk with selected back-end Prolog |
|---|
| 48 | compilers are also available on the Logtalk installation folder (by default, |
|---|
| 49 | "/opt/local/share/logtalk/scripts/macosx/command_files"; for easy access, the |
|---|
| 50 | installer creates an alias to the Logtalk folder in the Applications folder. |
|---|
| 51 | |
|---|
| 52 | On Windows systems, shortcuts for running Logtalk with selected back-end |
|---|
| 53 | Prolog compilers are created on the "Start Menu/Programs/Logtalk" menu. |
|---|
| 54 | If you get an unexpected failure when using one of the Prolog integration |
|---|
| 55 | shortcuts, consult the "configs/NOTES.txt" file in the Logtalk installation |
|---|
| 56 | folder for compatibility notes. |
|---|
| 57 | |
|---|
| 58 | 2. Open the "manuals/index.html" file with a web browser. |
|---|
| 59 | |
|---|
| 60 | 3. Select the "Tutorial" link. This will provide you with a basic |
|---|
| 61 | understanding of some of the main Logtalk concepts. |
|---|
| 62 | |
|---|
| 63 | 4. Go back to the "index.html" file, select the "User Manual" link, then |
|---|
| 64 | the "Installing Logtalk" and "Writing, Running, and Debugging Logtalk |
|---|
| 65 | Programs" links. This will provide you with a basic understanding of |
|---|
| 66 | how to start Logtalk as well as how to compile and load Logtalk code. |
|---|
| 67 | |
|---|
| 68 | |
|---|
| 69 | Running the examples |
|---|
| 70 | -------------------- |
|---|
| 71 | |
|---|
| 72 | You may now try some of the provided examples: |
|---|
| 73 | |
|---|
| 74 | 1. Open the "examples" sub-directory. There you find several sub-directories |
|---|
| 75 | with ready to run examples and a "NOTES.txt" file containing general |
|---|
| 76 | instructions and a brief description of each example. Select and open one |
|---|
| 77 | of the examples sub-directory. |
|---|
| 78 | |
|---|
| 79 | 2. Read the example "NOTES.txt" file for a description of the example. |
|---|
| 80 | |
|---|
| 81 | 3. Open the "SCRIPT.txt" file for instructions on how to load the example |
|---|
| 82 | and for sample queries that you may try by copying-and-pasting them to |
|---|
| 83 | your Prolog interpreter top-level. |
|---|
| 84 | |
|---|
| 85 | |
|---|
| 86 | Writing your own programs |
|---|
| 87 | _________________________ |
|---|
| 88 | |
|---|
| 89 | Ready to start writing your own programs? |
|---|
| 90 | |
|---|
| 91 | 1. Read the User Manual sections on "Programming in Logtalk" and "Running |
|---|
| 92 | and debugging Logtalk programs". |
|---|
| 93 | |
|---|
| 94 | 2. Take a look at the "wenv" sub-directory. There you will find syntax |
|---|
| 95 | configuration files for popular text editors which enable syntax coloring |
|---|
| 96 | and other text services when editing Logtalk source files. |
|---|
| 97 | |
|---|
| 98 | 3. Create a sub-directory with a suitable name to hold all the files of |
|---|
| 99 | your application. You may want to define the application directory path |
|---|
| 100 | in a "settings.lgt" file in order to easily load your application (see |
|---|
| 101 | the file "CUSTOMIZE.txt" for details). |
|---|
| 102 | |
|---|
| 103 | 4. Copy to this sub-directory a loader file from one of the example |
|---|
| 104 | directories and modify it to load your own source files. |
|---|
| 105 | |
|---|
| 106 | 5. Have fun! |
|---|
