3.11.5 Configuration

The behavior of the Emacs interface can be controlled by a set of user-configurable settings. Some of these can be changed on the fly, while some require Emacs to be restarted. To set a variable on the fly, type M-x set-variable <RET> VariableName <RET> Value <RET>. Note that variable names can be completed by typing a few characters and then pressing <TAB>.

To set a variable so that the setting is used every time Emacs is started, add lines of the following format to ~/.emacs:

     (setq VariableName Value)

Note that the Emacs interface is presently not using the `Customize' functionality to edit the settings.

The available settings are:

prolog-system

The Prolog system to use. Defaults to 'sicstus, which will be assumed for the rest of this chapter. See the on-line documentation for the meaning of other settings. For other settings of prolog-system the variables below named sicstus-something will not be used, in some cases corresponding functionality is available through variables named prolog-something.

sicstus-version

The version of SICStus that is used. Defaults to '(3 . 8). Note that the spaces are significant!

prolog-use-sicstus-sd

Set to t (the default) to enable the source-linked debugging extensions by default. The debugging can be enabled via the Prolog menu even if this variable is nil. Note that the source-linked debugging only works if sicstus-version is set correctly.

pltrace-port-arrow-assoc obsolescent

Only relevant for source-linked debugging, this controls how the various ports of invocation boxes (see Procedure Box) map to arrows that point into the current line of code in source code buffers. Initialized as:

          '(("call" . ">>>") ("exit" . "+++") ("ndexit" . "?++")
            ("redo" . "<<<") ("fail" . "---") ("exception" . "==>"))
     

where ndexit is the nondeterminate variant of the Exit port. Do not rely on this variable. It will change in future releases.

prolog-indent-width

How many positions to indent the body of a clause. Defaults to tab-width, normally 8.

prolog-paren-indent

The number of positions to indent code inside grouping parentheses. Defaults to 4, which gives the following indentation.

          p :-
                  (   q1
                  ;   q2,
                      q3
                  ).
     

Note that the spaces between the parentheses and the code are automatically inserted when <TAB> is pressed at those positions.

prolog-align-comments-flag

Set to nil to prevent single %-comments from being automatically aligned. Defaults to t.

Note that comments with one % are indented to comment-column, comments with two % to the code level, and that comments with three % are never changed when indenting.

prolog-indent-mline-comments-flag

Set to nil to prevent indentation of text inside /* ... */ comments. Defaults t.

prolog-object-end-to-0-flag

Set to nil to indent the closing } of an object definition to prolog-indent-width. Defaults to t.

sicstus-keywords

This is a list with keywords that are highlighted in a special color when used as directives (i.e. as :- keyword). Defaults to

          '((sicstus
               ("block" "discontiguous" "dynamic" "initialization"
                "meta_predicate" "mode" "module" "multifile" "public"
                "volatile")))
     

prolog-electric-newline-flag

Set to nil to prevent Emacs from automatically indenting the next line when pressing <RET>. Defaults to t.

prolog-hungry-delete-key-flag

Set to t to enable deletion of all white space before the cursor when pressing <DEL> (unless inside a comment, string, or quoted atom). Defaults to nil.

prolog-electric-dot-flag

Set to t to enable the electric dot function. If enabled, pressing . at the end of a non-empty line inserts a dot and a newline. When pressed at the beginning of a line, a new head of the last predicate is inserted. When pressed at the end of a line with only whitespace, a recursive call to the current predicate is inserted. The function respects the arity of the predicate and inserts parentheses and the correct number of commas for separation of the arguments. Defaults to nil.

prolog-electric-underscore-flag

Set to t to enable the electric underscore function. When enabled, pressing underscore (_) when the cursor is on a variable, replaces the variable with the anynomous variable. Defaults to nil.

prolog-old-sicstus-keys-flag

Set to t to enable the key-bindings of the old Emacs interface. These bindings are not used by default since they violate GNU Emacs recommendations. Defaults to nil.

prolog-use-prolog-tokenizer-flag

Set to nil to use built-in functions of Emacs for parsing the source code when indenting. This is faster than the default but does not handle some of the syntax peculiarities of Prolog. Defaults to t.

prolog-parse-mode

What position the parsing is done from when indenting code. Two possible settings: 'beg-of-line and 'beg-of-clause. The first is faster but may result in erroneous indentation in /* ... */ comments. The default is 'beg-of-line.

prolog-imenu-flag

Set to t to enable a new Predicate menu that contains all predicates of the current file. Choosing an entry in the menu moves the cursor to the start of that predicate. Defaults to nil.

prolog-info-predicate-index

The info node for the SICStus predicate index. This is important if the online help function is to be used (by pressing C-c ?, or choosing the Prolog/Help on predicate menu entry). The default setting is "(sicstus)Predicate Index".

prolog-underscore-wordchar-flag

Set to nil to not make underscore (_) a word-constituent character. Defaults to t.