ADD-DEFAULT-HINTS

add to the default hints
Major Section:  SWITCHES-PARAMETERS-AND-MODES


Examples:
(add-default-hints '((computed-hint-1 clause)
                     (computed-hint-2 clause
                                      stable-under-simplificationp)))
(add-default-hints '((computed-hint-3 id clause world))
                   :at-end t)

Note: This is an event! It does not print the usual event summary but nevertheless changes the ACL2 logical world and is so recorded. It is local to the book or encapsulate form in which it occurs (see add-default-hints! for a corresponding non-local event).

General Forms:
(add-default-hints lst)
(add-default-hints lst :at-end flg)
where lst is a list. Generally speaking, the elements of lst should be suitable for use as computed-hints.

This event is completely analogous to set-default-hints, the difference being that add-default-hints appends the indicated hints to the front of the list of default hints, so that they are tried first -- or, if flg is supplied and evaluates to other than nil, at the end of the list, so that they are tried last -- rather than replacing the default hints with the indicated hints. Each new hint is thus considered after each existing hints when both are applied to the same goal. Also See set-default-hints, see remove-default-hints, and see default-hints.

Finally, note that the effects of set-default-hints, add-default-hints, and remove-default-hints are local to the book in which they appear. Thus, users who include a book with such forms will not have their default hints affected by such forms. In order to export the effect of setting the default hints, use set-default-hints!, add-default-hints!, or remove-default-hints!.

For a related feature, which however is only for advanced system builders, see override-hints.