[racket-dev] New keyword arguments to `racket/file` procedures

From: Matthew Flatt (mflatt at cs.utah.edu)
Date: Tue Jun 25 12:13:23 EDT 2013

At Tue, 25 Jun 2013 11:57:52 -0400, Sam Tobin-Hochstadt wrote:
> The package reorganization also involved some changes to
> `racket/file`, which added keyword arguments to, at least,
> `find-files`, `delete-directory/files`, `copy-directory/files`, and
> `pathlist-closure`. Unfortunately, none of these arguments are
> documented.  Should they have documentation, or are they purely
> internal? If the latter, I'd like to provide versions without the
> arguments for the purpose of Typed Racket, which is sensitive to
> whether functions have keyword arguments.

They're meant to be public, and they need to be documented.

I must admit that there were so many little changes in the conversion
that I started keeping a list of things to fix the docs instead of
fixing the docs right away. I still haven't really started working
through the list, but I certainly should get it done this week.

For what it's worth, here is my list:

 doc redirect-part property
 'indirect-link: racketmonname, seclink
 'no-depend-on as trigger for direct
 info-domain and 'lib-relative
 'config-dir for `find-system-path'
 removed path->relative-string/setup
 installer actions: 3rd argument is `user?'
 #:keep-modify-seconds? on copy-directory/files
 #:must-exist? on delete-directory/files
 'relative? implies framework-dir, dll-dir, config-dir as #f
 'exe-name handling: a relative GUI
 added 'core-exe-name
 pkg install --skip-installed, --catalog
 pathlist-closure, find-files, and #:follow-links
 tar and links
 ".startmenu", ".extreg", 'install-mode
 find-relevant-directories and 'no-user
 fix file-stamp-in-collection
 find-dir-for-pkg-link and --link-search
 pkg-desc can have a path
 pkg-install docs wrong: arg is pkg-desc list
 html-properties: {install,link}-resource


Posted on the dev mailing list.