GBBopen 1.5 Reference -- undefine-ks

undefine-ks

undefine-ks ks-name &rest ignored-initargs => deleted-ks-unit-instance [Macro]

Purpose
Undefine (delete) a knowledge source (KS).

Package :agenda-shell

Module :agenda-shell

Arguments and values

ks-name		A symbol naming the KS (not evaluated, but the remaining arguments are evaluated)
ignored-initargs		The remaining initialization arguments are ignored
deleted-ks-unit-instance		A KS unit instance or `nil`

Returns
The deleted KS unit instance, if KS ks-name was undefined (deleted).

Description
A KS is undefined by deleting the unit instance corresponding to the KS. The undefine-ks macro provides a convenient shortcut for undefining a KS by minimally editing the defining form (such as from within an editor buffer).

See also
define-ks
ks-enabled-p

Examples
Undefine the KS named initial. The following forms are all equivalent:

  > (undefine-ks initial
       :trigger-events '((control-shell-started-event)) 
       :execution-function #'initial-ks-function)
  #<deleted-unit-instance ks initial>
  > (undefine-ks initial)
  #<deleted-unit-instance ks initial>
  > (delete-instance 
       (find-instance-by-name 'initial '(ks :plus-subclasses)))
  #<deleted-unit-instance ks initial>  
  > (delete-instance 
       (find-instance-by-name 'initial '(ks +)))
  #<deleted-unit-instance ks initial>
  >

The GBBopen Project

undefine-ks