You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
At the moment (rustc 1.56.0-nightly (b7404c8 2021-09-03)) the docs for this two functions are identical, and the only difference is file/dir. As a developer with primarily unix background, I don't really understand why there are two functions, and when I should use one versus the other. It would be helpful if the docs explained windows/unix difference, or linked upstream docs.
The text was updated successfully, but these errors were encountered:
matklad
added
the
A-docs
Area: documentation for any part of the project, including the compiler, standard library, and tools
label
Sep 4, 2021
Yes this could be improved. In Windows filesystems everything is either a file or directory, it doesn't have a separate category for symlinks (although the std sometimes tries hard to pretend otherwise). Therefore a file symlink must point to a file and a directory symlink must point to a directory. Otherwise the symlink will be broken.
EDIT: The underlying function is CreateSymbolicLinkW, which could be linked from the docs.
It should probably also be documented that creating symlinks currently requires the user to enable developer mode (Win10 only) or have elevated privileges.
At the moment (rustc 1.56.0-nightly (b7404c8 2021-09-03)) the docs for this two functions are identical, and the only difference is file/dir. As a developer with primarily unix background, I don't really understand why there are two functions, and when I should use one versus the other. It would be helpful if the docs explained windows/unix difference, or linked upstream docs.
The text was updated successfully, but these errors were encountered: