+ (macrolet ((check (form)
+ `(or ,form
+ (error "misbehavior in DESCRIBE of ~S:~% ~S" i ',form))))
+ (check (char= #\x (char s 0)))
+ ;; one leading #\NEWLINE from FRESH-LINE or the like, no more
+ (check (char= #\newline (char s 1)))
+ (check (char/= #\newline (char s 2)))
+ ;; one trailing #\NEWLINE from TERPRI or the like, no more
+ (let ((n (length s)))
+ (check (char= #\newline (char s (- n 1))))
+ (check (char/= #\newline (char s (- n 2))))))))
+
+\f
+;;; Tests of documentation on types and classes
+(defclass foo ()
+ ()
+ (:documentation "FOO"))
+(defstruct bar "BAR")
+(define-condition baz ()
+ ()
+ (:documentation "BAZ"))
+(deftype quux ()
+ "QUUX"
+ 't)
+(defstruct (frob (:type vector)) "FROB")
+(macrolet
+ ((do-class (name expected &optional structurep)
+ `(progn
+ (assert (string= (documentation ',name 'type) ,expected))
+ (assert (string= (documentation (find-class ',name) 'type) ,expected))
+ (assert (string= (documentation (find-class ',name) 't) ,expected))
+ ,@(when structurep
+ `((assert (string= (documentation ',name 'structure) ,expected))))
+ (let ((new1 (symbol-name (gensym "NEW1")))
+ (new2 (symbol-name (gensym "NEW2")))
+ (new3 (symbol-name (gensym "NEW3")))
+ (new4 (symbol-name (gensym "NEW4"))))
+ (declare (ignorable new4))
+ (setf (documentation ',name 'type) new1)
+ (assert (string= (documentation (find-class ',name) 'type) new1))
+ (setf (documentation (find-class ',name) 'type) new2)
+ (assert (string= (documentation (find-class ',name) 't) new2))
+ (setf (documentation (find-class ',name) 't) new3)
+ (assert (string= (documentation ',name 'type) new3))
+ ,@(when structurep
+ `((assert (string= (documentation ',name 'structure) new3))
+ (setf (documentation ',name 'structure) new4)
+ (assert (string= (documentation ',name 'structure) new4))))))))
+ (do-class foo "FOO")
+ (do-class bar "BAR" t)
+ (do-class baz "BAZ"))
+
+(assert (string= (documentation 'quux 'type) "QUUX"))
+(setf (documentation 'quux 'type) "NEW4")
+(assert (string= (documentation 'quux 'type) "NEW4"))
+
+(assert (string= (documentation 'frob 'structure) "FROB"))
+(setf (documentation 'frob 'structure) "NEW5")
+(assert (string= (documentation 'frob 'structure) "NEW5"))
+
+(define-compiler-macro cmacro (x)
+ "compiler macro"
+ x)
+
+(define-compiler-macro (setf cmacro) (y x)
+ "setf compiler macro"
+ y)
+
+(with-test (:name (documentation compiler-macro))
+ (unless (equal "compiler macro"
+ (documentation 'cmacro 'compiler-macro))
+ (error "got ~S for cmacro"
+ (documentation 'cmacro 'compiler-macro)))
+ (unless (equal "setf compiler macro"
+ (documentation '(setf cmacro) 'compiler-macro))
+ (error "got ~S for setf macro" (documentation '(setf cmacro) 'compiler-macro))))
+
+(with-test (:name (documentation lambda))
+ (let ((f (lambda () "aos the zos" t))
+ (g (sb-int:named-lambda fii () "zoot the fruit" t)))
+ (dolist (doc-type '(t function))
+ (assert (string= (documentation f doc-type) "aos the zos"))
+ (assert (string= (documentation g doc-type) "zoot the fruit")))
+ (setf (documentation f t) "fire")
+ (assert (string= (documentation f t) "fire"))
+ (assert (string= (documentation g t) "zoot the fruit"))))
+
+(with-test (:name (documentation flet))
+ (assert
+ (string= (documentation
+ (flet ((quux (x)
+ "this is FLET quux"
+ (/ x 2)))
+ #'quux)
+ t)
+ "this is FLET quux")))
+
+(with-test (:name (documentation labels))
+ (assert
+ (string= (documentation
+ (labels ((rec (x)
+ "this is LABELS rec"
+ (if (plusp x)
+ (* x (rec (1- x)))
+ 1)))
+ #'rec)
+ t)
+ "this is LABELS rec")))
+
+(let ((x 1))
+ (defun docfoo (y)
+ "bar"
+ (incf x y)))
+
+(with-test (:name (documentation closure))
+ (assert (string= (documentation 'docfoo 'function) "bar"))
+ (assert (string= (documentation #'docfoo t) "bar"))
+ (assert (string= (setf (documentation 'docfoo 'function) "baz") "baz"))
+ (assert (string= (documentation 'docfoo 'function) "baz"))
+ (assert (string= (documentation #'docfoo t) "baz")))
+
+#+sb-doc
+(with-test (:name (documentation built-in-macro))
+ (assert (documentation 'trace 'function)))
+
+#+sb-doc
+(with-test (:name (documentation built-in-function))
+ (assert (documentation 'cons 'function)))