How to use the persisted history for commands completion

[vindarel]

new doc: https://lem-project.github.io/usage/configuration/#commands-with-persistent-history

[daninus14]

I just tried reading this twice. I don't understand it. I can play around with the code and figure it out, but it's really not clear.

Is it just to add the code below to init.lisp and that's it?

(defvar *projects-history*)

(defun history ()
  "Return or create the projects' history struct.
  The history file is saved on (lem-home)/history/projects"
  (unless (boundp '*projects-history*)
    (let* ((pathname (merge-pathnames "history/projects" (lem-home)))
           (history (lem/common/history:make-history :pathname pathname)))
      (setf *projects-history* history)))
  *projects-history*)

It says:

First, create a global

"First" sounds like there's more to do. But the rest reads like an explanation of how lem already works. Are we supposed to be changing other files?

Maybe we can have subheadings

How To Add Command History

Understanding the Change

[vindarel]

This is a developer documentation, so, like, maybe we can't explain all the code.

To use the persisted history for command completion (M-x): it has been merged, there is nothing to do.

I might move this page to somewhere else.