[racket-dev] confusing doc for "in-directory"

From: Matthew Flatt (mflatt at cs.utah.edu)
Date: Mon Apr 2 17:36:43 EDT 2012

I pushed a doc update, but forgot to reply. The documentation now
clarifies that `in-directory' recursively traverses subdirectories, and
it suggests `directory-list' for just the immediate content of a
directory.

At Wed, 28 Mar 2012 17:21:57 -0700, Eric Hanchrow wrote:
> http://docs.racket-lang.org/reference/sequences.html?q=read-directory#(def._((li
> b._racket/private/base..rkt)._in-directory))
>  says that the form will ``Return a sequence that produces all of the
> paths for files, directories, and links with dir. ''  That's
> ungrammatical, but worse, it gave me no clue that it will return all
> files _at any depth_, similar to the Unix comand "find dir".  I'd
> expected it to return only immediate children of dir, similarly to
> "find dir -mindepth 1 -maxdepth 1"; I was surprised when (in-directory
> "/tmp") complained about not being able to open
> "/tmp/some-subdirectory/" due to permissions problems.
> _________________________
>   Racket Developers list:
>   http://lists.racket-lang.org/dev

Posted on the dev mailing list.