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
_
Racket Developers list:
http://lists.racket-lang.org/dev
