Re: Scheme file docstring format

[Neil Jerram]

I wrote:

     ;; reverse-directory-listing DIR
     ;;
     ;; Returns a list of file names in directory DIR.  The ordering is
     ;; reversed with respect to the ordering produced naturally by
     ;; readdir.
     ;;
     ;;-Author: Neil Jerram
     ;;-Updated: 21st May 2000
     
     (define (reverse-directory-listing dir-name)

D'oh!  The blank line between the end of the comment and the `(define
...)' should _not_ be there.  According to my proposal, if the Scheme
file looked like this, `reverse-directory-listing' would not have a
docstring at all.  So this example should be:

;; reverse-directory-listing DIR
;;
;; Returns a list of file names in directory DIR.  The ordering is
;; reversed with respect to the ordering produced naturally by
;; readdir.
;;
;;-Author: Neil Jerram
;;-Updated: 21st May 2000
(define (reverse-directory-listing dir-name)
  ...)

Regards,
        Neil