+;;; FIXME: There's already fun-name in code/describe.lisp, but it's
+;;; loaded after PCL, so it cannot be used, because we set
+;;; some documentation at the end of this file.
+(defun fun-name (x)
+ (if (typep x 'generic-function)
+ (sb-pcl:generic-function-name x)
+ (%fun-name x)))
+
+(defun real-function-name (name)
+ ;; Resolve the actual name of the function named by NAME
+ ;; e.g. (setf (name-function 'x) #'car)
+ ;; (real-function-name 'x) => CAR
+ (cond ((not (fboundp name))
+ nil)
+ ((and (symbolp name)
+ (special-operator-p name))
+ (%fun-name (fdefinition name)))
+ ((and (symbolp name)
+ (macro-function name))
+ (let ((name (%fun-name (macro-function name))))
+ (and (consp name)
+ (eq (car name) 'macro-function)
+ (cadr name))))
+ (t
+ (fun-name (fdefinition name)))))
+
+(defun ignore-nil-doc (type)
+ (style-warn "Ignoring documentation of type ~a for ~a."
+ type nil))
+
+(defun set-function-name-documentation (name documentation)
+ (cond ((not name)
+ (ignore-nil-doc 'function))
+ ((not (legal-fun-name-p name))
+ nil)
+ ((not (equal (real-function-name name) name))
+ (setf (random-documentation name 'function) documentation))
+ (t
+ (setf (fun-doc (or (and (symbolp name)
+ (macro-function name))
+ (fdefinition name)))
+ documentation)))
+ documentation)
+
+;;; functions, macros, and special forms
+(defmethod documentation ((x function) (doc-type (eql 't)))
+ (fun-doc x))
+
+(defmethod documentation ((x function) (doc-type (eql 'function)))
+ (fun-doc x))