;;;; tests for problems in the interface presented to the user/programmer ;;;; This software is part of the SBCL system. See the README file for ;;;; more information. ;;;; ;;;; While most of SBCL is derived from the CMU CL system, the test ;;;; files (like this one) were written from scratch after the fork ;;;; from CMU CL. ;;;; ;;;; This software is in the public domain and is provided with ;;;; absolutely no warranty. See the COPYING and CREDITS files for ;;;; more information. (in-package :cl-user) ;;;; properties of symbols, e.g. presence of doc strings for public symbols ;;; FIXME: It would probably be good to require here that every ;;; external symbol either has a doc string or has some good excuse ;;; (like being an accessor for a structure which has a doc string). ;;;; tests of interface machinery ;;; APROPOS should accept a package designator, not just a package, and ;;; furthermore do the right thing when it gets a package designator. ;;; (bug reported and fixed by Alexey Dejneka sbcl-devel 2001-10-17) (assert (< 0 (length (apropos-list "PRINT" :cl)) (length (apropos-list "PRINT")))) ;;; Further, it should correctly deal with the external-only flag (bug ;;; reported by cliini on #lisp IRC 2003-05-30, fixed in sbcl-0.8.0.1x ;;; by CSR) (assert (= (length (apropos-list "" "CL")) (length (apropos-list "" "CL" t)))) (assert (< 0 (length (apropos-list "" "SB-VM" t)) (length (apropos-list "" "SB-VM")))) ;;; DESCRIBE shouldn't fail on rank-0 arrays (bug reported and fixed ;;; by Lutz Euler sbcl-devel 2002-12-03) (describe #0a0) (describe #(1 2 3)) (describe #2a((1 2) (3 4))) ;;; support for DESCRIBE tests (defstruct to-be-described a b) (defclass forward-describe-class (forward-describe-ref) (a)) ;;; DESCRIBE should run without signalling an error. (describe (make-to-be-described)) (describe 12) (describe "a string") (describe 'symbolism) (describe (find-package :cl)) (describe '(a list)) (describe #(a vector)) ;;; The DESCRIBE-OBJECT methods for built-in CL stuff should do ;;; FRESH-LINE and TERPRI neatly. (dolist (i (list (make-to-be-described :a 14) 12 "a string" #0a0 #(1 2 3) #2a((1 2) (3 4)) 'sym :keyword (find-package :keyword) (list 1 2 3) nil (cons 1 2) (make-hash-table) (let ((h (make-hash-table))) (setf (gethash 10 h) 100 (gethash 11 h) 121) h) (make-condition 'simple-error) (make-condition 'simple-error :format-control "fc") #'car #'make-to-be-described (lambda (x) (+ x 11)) (constantly 'foo) #'(setf to-be-described-a) #'describe-object (find-class 'to-be-described) (find-class 'forward-describe-class) (find-class 'forward-describe-ref) (find-class 'cons))) (let ((s (with-output-to-string (s) (write-char #\x s) (describe i s)))) (unless (and (char= #\x (char s 0)) ;; one leading #\NEWLINE from FRESH-LINE or the like, no more (char= #\newline (char s 1)) (char/= #\newline (char s 2)) ;; one trailing #\NEWLINE from TERPRI or the like, no more (let ((n (length s))) (and (char= #\newline (char s (- n 1))) (char/= #\newline (char s (- n 2)))))) (error "misbehavior in DESCRIBE of ~S" i)))) ;;; TYPEP, SUBTYPEP, UPGRADED-ARRAY-ELEMENT-TYPE and ;;; UPGRADED-COMPLEX-PART-TYPE should be able to deal with NIL as an ;;; environment argument (typep 1 'fixnum nil) (subtypep 'fixnum 'integer nil) (upgraded-array-element-type '(mod 5) nil) (upgraded-complex-part-type '(single-float 0.0 1.0) nil) ;;; We should have documentation for our extension package: (assert (documentation (find-package "SB-EXT") t)) ;;; DECLARE should not be a special operator (assert (not (special-operator-p 'declare))) ;;; WITH-TIMEOUT should accept more than one form in its body. (handler-bind ((sb-ext:timeout #'continue)) (sb-ext:with-timeout 3 (sleep 2) (sleep 2))) ;;; DOCUMENTATION should return nil, not signal slot-unbound (documentation 'fixnum 'type) (documentation 'class 'type) (documentation (find-class 'class) 'type)