Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

`x.py doc` cannot work when a junction point / symbolic link cannot be created. #43801

Open
kennytm opened this Issue Aug 11, 2017 · 0 comments

Comments

Projects
None yet
2 participants
@kennytm
Copy link
Member

kennytm commented Aug 11, 2017

... for instance, in a VirtualBox shared folder, which are mapped as network drive, does not support junction point on Windows, which causes Incorrect function. (os error 1) always.

Symbolic links (junction points) are used because:

Here what we're doing is creating a symlink (directory junction on
Windows) to the final output location. This is not done as an
optimization but rather for correctness. We've got three trees of
documentation, one for std, one for test, and one for rustc. It's then
our job to merge them all together.

Unfortunately rustbuild doesn't know nearly as well how to merge doc
trees as rustdoc does itself, so instead of actually having three
separate trees we just have rustdoc output to the same location across
all of them.

This way rustdoc generates output directly into the output, and rustdoc
will also directly handle merging.

There should be other way to achieve the same effect? For example forcing rustdoc to output to stage$N/$TARGET/doc (bootstrap already wrapped rustdoc so it should be fine).

@kennytm kennytm changed the title `x.py doc` cannot work on when a junction point / symbolic link cannot be created. `x.py doc` cannot work when a junction point / symbolic link cannot be created. Aug 11, 2017

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.