[racket-dev] confusing doc for "in-directory"
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