This is a read-only archive of lispforum.com. The forum was locked to new users and posts and is preserved here as static HTML from a database snapshot taken on 2019-09-07.

Writing a macro for docstring for lambda

2 posts · 1429 views

I am trying to debug some code I wrote, and I realized that what I need to do is replace many of my lambda functions with lambda functions that have doc strings attached.
But these docs strings need to be generated on the fly. But the docstring that lisp accepts must be a string, not something that evaluates to a string.

What I have come up with so far is:
(defmacro doclambda (args dexpr &body body)
  (let ((multiquotes (mapcar (lambda(k)(list 'quote k)) body)))
  `(eval `(lambda ,(quote ,args) ,,dexpr ,,@multiquotes))))
which doesn't quite work. The generated lambda doesn't have the right environment. So this seems to work:
(setf dlam (let* ((v 5) (vstr (write-to-string v))) 
(doclambda(x) (concatenate 'string "doc" vstr) (declare (type integer x)) (+ x 2))))
(documentation dlam 'function)
(funcall dlam 3)
But this doesn't:
(setf dlam (let* ((v 5) (vstr (write-to-string v))) 
(doclambda(x) (concatenate 'string "doc" vstr) (declare (type integer x)) (+ x v 2))))
(documentation dlam 'function)
(funcall dlam 3)
I assume that the problem is my use of eval. How can this be rewritten to not use eval?

Richard

Re: Writing a macro for docstring for lambda

The piece of information you need is that documentation is setfable.
(let ((f (lambda (x) (* 2 x))))
  (setf (documentation f 'function) "double a number")
  (print (documentation f 'function)))
Armed with this info, writing the macro is easy,
(defmacro doclambda (args doc &body body)
  (let ((f (gensym)))
    `(let ((,f (lambda ,args ,@body)))
       (setf (documentation ,f 'function) ,doc)
       ,f)))