about summary refs log tree commit diff
path: root/src/bootstrap/doc.rs
AgeCommit message (Collapse)AuthorLines
2018-06-03impl is_tool on Mode enumCollins Abitekaniza-2/+4
make is_tool inherent prop of mode fix errors from rebase resolve issues from review
2018-06-03refactor Mode enumCollins Abitekaniza-8/+8
2018-05-28Auto merge of #50892 - davidtwco:issue-50004, r=alexcrichtonbors-6/+82
Added rustdoc documentation to compiler docs. Fixes #50004. r? @alexcrichton (since you reviewed the last PR about compiler docs)
2018-05-22build the 2018 editionsteveklabnik-0/+6
2018-05-20Added rustdoc documentation step outputting into compiler documentation.David Wood-6/+82
2018-04-27Rollup merge of #49707 - steveklabnik:rustc-book, r=QuietMisdreavuskennytm-0/+1
Add "the Rustc book" This PR introduces a new book into the documentation, "The rustc book". We already have books for Cargo, and for Rustdoc, rustc should have some too. This book is focused on *users* of rustc, and provides a nice place to write documentation for users. I haven't put content here, but plan on scaffolding it out very soon, and wanted this PR open for a few discussions first. One of those is "what exactly should said TOC be?" I plan on having a proposed one up tomorrow, but figured I'd let people know to start thinking about it now. The big one is that we also will want to put https://github.com/rust-lang-nursery/rustc-guide in-tree as well, and the naming is... tough. I'm proposing: * doc.rust-lang.org/rustc is "The Rustc book", to mirror the other tools' books. * doc.rust-lang.org/rustc-contribution is "The Rustc contribution guide", and contains that book @nikomatsakis et al, any thoughts on this? I'm not attached to it in particular, but had to put something together to get this discussion going. I think mirroring the other tools is a good idea for this work, but am not sure where exactly that leaves yours. Fixes https://github.com/rust-docs/team/issues/11
2018-04-17Remove uses of Build across Builder stepsMark Simulacrum-115/+103
2018-04-14Rollup merge of #49465 - ollie27:rustbuild_test_docs, ↵kennytm-1/+4
r=steveklabnik,QuietMisdreavus,frewsxcv,GuillaumeGomez Add docs for the test crate with the std docs If the compiler docs aren't going to include the test crate then it may as well be included with std. Fixes #49388
2018-04-09Add rustc book to the build systemsteveklabnik-0/+1
2018-04-05Rollup merge of #49654 - davidtwco:issue-29893, r=alexcrichtonkennytm-0/+1
Host compiler documentation: Include private items Fixes #29893. Now that compiler documentation is being hosted, including private items seems sensible as these types are going to be being used by contributors working on the compiler. However, including this means that doc comments that contain codeblocks with invalid Rust and can fail the documenting of a given crate (as evidenced by the changes in the second commit included in this PR). We'd need some way of ensuring that this cannot happen so that these failures don't cause documenting to fail. I'm unsure whether this change to documentation steps will cause this to happen already or if something new will be required. r? @alexcrichton
2018-04-04Documenting private items in compiler docs.David Wood-0/+1
2018-04-03Avoid printing output when in dry run modeMark Simulacrum-12/+12
2018-04-03Refactor to use a dry-run config instead of cfg(test)Mark Simulacrum-15/+20
This ensures that each build will support the testing design of "dry running" builds. It's also checked that a dry run build is equivalent step-wise to a "wet" run build; the graphs we generate when running are directly compared node/node and edge/edge, both for order and contents.
2018-04-03Stub out less codeMark Simulacrum-1/+0
2018-04-03Stub out various functions during testingMark Simulacrum-0/+1
2018-03-28Add docs for the test crate with the std docsOliver Middleton-1/+4
If the compiler docs aren't going to include the test crate then it may as well be included with std.
2018-03-22Remove std/test documentation from compiler docs.David Wood-12/+4
2018-03-22Only generate documentation for local rustc crates.David Wood-4/+31
2018-03-21Add support to rustbuild for a 'rustc docs' component tarballDavid Wood-29/+104
2018-03-09rustbuild: Fix MSBuild location of `llvm-config.exe`Alex Crichton-1/+1
For LLD integration the path to `llvm-config` needed to change to inside the build directory itself (for whatever reason) but the build directory is different on MSBuild than it is on `ninja` for MSVC builds, so the path to `llvm-config.exe` was actually wrong and not working! This commit removes the `Build::llvm_config` function in favor of the source of truth, the `Llvm` build step itself. The build step was then updated to find the right build directory for MSBuild as well as `ninja` for where `llvm-config.exe` is located. Closes #48749
2018-03-02Don't produce TOCs for doc markdown filessteveklabnik-0/+1
Currently, we are producing headers for markdown files, which is generally not what we want. As such, passing this flag causes them to render normally.
2018-02-11Change Step to be invoked with a path when in default mode.Mark Simulacrum-1/+1
Previously, a Step would be able to tell on its own when it was invoked "by-default" (that is, `./x.py test` was called instead of `./x.py test some/path`). This commit replaces that functionality, invoking each Step with each of the paths it has specified as "should be invoked by." For example, if a step calls `path("src/tools/cargo")` and `path("src/doc/cargo")` then it's make_run will be called twice, with "src/tools/cargo" and "src/doc/cargo." This makes it so that default handling logic is in builder, instead of spread across various Steps. However, this meant that some Step specifications needed to be updated, since for example `rustdoc` can be built by `./x.py build src/librustdoc` or `./x.py build src/tools/rustdoc`. A `PathSet` abstraction is added that handles this: now, each Step can not only list `path(...)` but also `paths(&[a, b, ...])` which will make it so that we don't invoke it with each of the individual paths, instead invoking it with the first path in the list (though this shouldn't be depended on). Future work likely consists of implementing a better/easier way for a given Step to work with "any" crate in-tree, especially those that want to run tests, build, or check crates in the std, test, or rustc crate trees. Currently this is rather painful to do as most of the logic is duplicated across should_run and make_run. It seems likely this can be abstracted away into builder somehow.
2018-01-27rustc: Load the `rustc_trans` crate at runtimeAlex Crichton-1/+1
Building on the work of # 45684 this commit updates the compiler to unconditionally load the `rustc_trans` crate at runtime instead of linking to it at compile time. The end goal of this work is to implement # 46819 where rustc will have multiple backends available to it to load. This commit starts off by removing the `extern crate rustc_trans` from the driver. This involved moving some miscellaneous functionality into the `TransCrate` trait and also required an implementation of how to locate and load the trans backend. This ended up being a little tricky because the sysroot isn't always the right location (for example `--sysroot` arguments) so some extra code was added as well to probe a directory relative to the current dll (the rustc_driver dll). Rustbuild has been updated accordingly as well to have a separate compilation invocation for the `rustc_trans` crate and assembly it accordingly into the sysroot. Finally, the distribution logic for the `rustc` package was also updated to slurp up the trans backends folder. A number of assorted fallout changes were included here as well to ensure tests pass and such, and they should all be commented inline.
2018-01-18Auto merge of #47528 - GuillaumeGomez:rollup, r=GuillaumeGomezbors-2/+2
Rollup of 6 pull requests - Successful merges: #47250, #47313, #47398, #47468, #47471, #47520 - Failed merges:
2018-01-17Update Cargo and its dependenciesAlex Crichton-1/+1
This'll probably have a bunch of build errors, so let's try and head those off and find them sooner rather than later!
2018-01-17Rollup merge of #47250 - GuillaumeGomez:test-rustdoc-js, r=Mark-SimulacrumGuillaume Gomez-2/+2
Test rustdoc js Add tests for the rustdoc search. It was heavily required because of all the recent breaking changes that happened while I went through improvements in doc search (add search in/for generic search for example).
2018-01-15Auto merge of #46196 - projektir:rbe-submodule, r=steveklabnikbors-1/+2
Adding RBE as a submodule #46194 Adding RBE as a submodule to start issue #46194.
2018-01-13Adding RBE as a submodule #46194projektir-1/+2
2018-01-12End of rustdoc-js tool add into builderGuillaume Gomez-2/+2
2018-01-12Remove unused argument `rustc_cargo`.O01eg-1/+1
2018-01-04rustc: Don't use relative paths for extended errorsAlex Crichton-1/+2
These no longer work now that Cargo changes the cwd of rustc while it's running. Instead use an absolute path that's set by rustbuild.
2017-11-29rustbuild: Fix a typo with the Cargo bookAlex Crichton-1/+1
The usage of `Path::new` prevented out-of-tree builds (like the bots do) from working by accident! Closes #46195
2017-11-20Auto merge of #45998 - ollie27:doc_book_css, r=steveklabnikbors-16/+11
Fix broken CSS for book redirect pages rust.css has to be next to the font files so we shouldn't copy it for only the book redirect pages, instead just use the version that is already there. This also removes the duplicate code creating version_info.html. Fixes: #45974
2017-11-15Fix broken CSS for book redirect pagesOliver Middleton-16/+11
rust.css has to be next to the font files so we shouldn't copy it for only the book redirect pages, instead just use the version that is already there. This also removes the duplicate code creating version_info.html.
2017-11-14link the cargo book into the bookshelfsteveklabnik-3/+6
2017-11-14Start shipping the Cargo booksteveklabnik-45/+43
Fixes #44910 Fixes #39588 See both of those bugs for more details.
2017-10-22Don't build docs for removed libcollections.leonardo.yvens-1/+1
2017-10-22Auto merge of #45433 - ollie27:rustbuild_nomicon, r=Mark-Simulacrumbors-1/+1
rustbuild: Fix path for the nomicon
2017-10-21rustbuild: Fix path for the nomiconOliver Middleton-1/+1
2017-10-14rustbuild: Don't try to build rustdoc API docs with compiler docsOliver Middleton-5/+3
rustdoc is built separately to rustc now so the docs would need to be generated separately as well. Also rustdoc doesn't build at stage 1 which prevented the compiler docs being built at stage 1.
2017-08-29rustbuild: Don't require cross-compiled error indexAlex Crichton-5/+0
All architectures use the same errors, no need to cross-compile a version only to not look at it.
2017-08-16Implement a temp redirect for cargo docsCarol (Nichols || Goulding)-0/+45
As discussed in https://github.com/rust-lang/cargo/issues/4040#issuecomment-321639074 This is a redirect meant to be replaced once cargo docs have been converted to mdbook. We just want *a* URL to ride the trains for now so that we can print doc.rust-lang.org/cargo in the paper book and guarantee that it will go *somewhere* useful by the time the book is printed. Implemented as a meta redirect in HTML because we don't currently have any google juice at doc.rust-lang.org/cargo to lose.
2017-08-15use field init shorthand EVERYWHEREZack M. Davis-2/+2
Like #43008 (f668999), but _much more aggressive_.
2017-08-15Auto merge of #43863 - steveklabnik:ship-the-rustdoc-book, r=frewsxcvbors-0/+1
Ship the rustdoc book Fixes #42322, as it's the last step. Blocked on https://github.com/rust-lang/rust/pull/43790, though they will not conflict. r? @rust-lang/docs
2017-08-14start building the rustdoc booksteveklabnik-0/+1
2017-08-13Rollup merge of #43814 - Eijebong:fix_typos2, r=petrochenkovGuillaume Gomez-1/+1
Fix some typos Follow up of #43794 If refined my script a little bit and found some more.
2017-08-13Build rustdoc only at the top stageMark Simulacrum-6/+6
2017-08-12Fix some typosBastien Orivel-1/+1
2017-07-27Correct a few run.host invocations where run.target is intended.Mark Simulacrum-2/+2
2017-07-27Allow changing rustdoc which builds the book.Mark Simulacrum-10/+13