4.3.1 Creating and Editing Candidate Generators

You can create a candidate generator with the command p-search-add-candidate-generator (C). After following the creation process the candidate generator will be added to the session. The order that the candidate generators are added is insignificant. Duplicate candidates added by candidate generators are ignored.

C (p-search-add-candidate-generator)

Initialize the addition process of a candidate generator. The initialization process has two steps: first you must select the candidate generator that you want to add. The candidate generators available to be added are defined by the items in the variable p-search-candidate-generators. After selecting the candidate you want to create, you will be prompted with a transient menu to set it up. Once the candidate generator is configured to your liking, you can press c to finish the creation process. The in-progress candidate generator will show up in the buffer with the text “loading”.

e (p-search-edit-dwim)

This command edits the entity at the point, which can be candidate generators, mappings, or priors. When executed, the transient menu used to create the entity will reappear. You can make any adjustments you want, and then press e to finish the editing.

k (p-search-kill-entity-at-point)

This command removes the entity at the point, be it a candidate generator, mapping, or prior. After the removal, the entire calculation process restarts.

User Option: p-search-candidate-generators

This variable stores a list of the candidate generators (p-search-candidate-generator-p) known to p-search. When creating a candidate generator, you will usually call add-to-list to add the desired candidate generator.

Usually the package that creates the candidate generator should be responsible for adding it to this variable. See Creating Priors more information on creating priors.