https://github.com/rust-lang/rust http://git.dreamy.place/mirrors/rust/atom?h=1.80.1 2024-05-07T16:12:54+00:00 2024-05-07T16:12:54+00:00 Matthias Krüger matthias.krueger@famsik.de 2024-05-07T16:12:54+00:00 urn:sha1:7af9ad1465c32eaa6abdd4469161042467ad01ec rustdoc: dedup search form HTML This change constructs the search form HTML using JavaScript, instead of plain HTML. It uses a custom element because - the [parser]'s insert algorithm runs the connected callback synchronously, so we won't get layout jank - it requires very little HTML, so it's a real win in size [parser]: https://html.spec.whatwg.org/multipage/parsing.html#create-an-element-for-the-token This shrinks the standard library by about 60MiB, by my test. There should be no visible changes. Just use less disk space. 2024-05-06T04:21:04+00:00 Matthias Krüger matthias.krueger@famsik.de 2024-05-06T04:21:04+00:00 urn:sha1:b0fb3c56e012492721d475dabb952610a85dc553 [rustdoc] Fix bad color for setting cog in ayu theme Before:  After:  r? ````@notriddle```` 2024-05-05T18:07:12+00:00 Guillaume Gomez guillaume.gomez@huawei.com 2024-05-05T17:27:59+00:00 urn:sha1:0cbebd07ee23cacccf0fa5522d658a3ebfc4c19f 2024-05-05T15:15:08+00:00 Michael Howell michael@notriddle.com 2024-05-05T05:31:30+00:00 urn:sha1:eeb59f16a5f40e14dc29b95155b7f2569329e3ec This change constructs the search form HTML using JavaScript, instead of plain HTML. It uses a custom element because - the [parser]'s insert algorithm runs the connected callback synchronously, so we won't get layout jank - it requires very little HTML, so it's a real win in size [parser]: https://html.spec.whatwg.org/multipage/parsing.html#create-an-element-for-the-token This shrinks the standard library by about 60MiB, by my test. 2024-05-05T14:42:46+00:00 Guillaume Gomez guillaume1.gomez@gmail.com 2024-05-05T14:42:46+00:00 urn:sha1:042d0f5266f474491852b2055732698fceb41f14 rustdoc-search: search for references This feature extends rustdoc with syntax and search index information for searching borrow references. Part of https://github.com/rust-lang/rust/issues/60485 ## Preview - [`&mut`](https://notriddle.com/rustdoc-html-demo-11/reference/std/index.html?search=%26mut) - [`&Option<T> -> Option<&T>`](https://notriddle.com/rustdoc-html-demo-11/reference/std/index.html?search=%26Option%3CT%3E%20-%3E%20Option%3C%26T%3E) - [`&mut Option<T> -> Option<&mut T>`](https://notriddle.com/rustdoc-html-demo-11/reference/std/index.html?search=%26mut%20Option%3CT%3E%20-%3E%20Option%3C%26mut%20T%3E) Updated chapter of the book: https://notriddle.com/rustdoc-html-demo-11/reference/rustdoc/read-documentation/search.html ## Motivation See https://github.com/rust-lang/rust/pull/119676 ## Guide-level explanation You can't search by lifetimes, but other than that it's the same syntax references normally use. ## Reference-level description <table> <thead> <tr> <th>Shorthand</th> <th>Explicit names</th> </tr> </thead> <tbody> <tr><td colspan="2">Before this PR</td></tr> <tr> <td><code>[]</code></td> <td><code>primitive:slice</code> and/or <code>primitive:array</code></td> </tr> <tr> <td><code>[T]</code></td> <td><code>primitive:slice&lt;T&gt;</code> and/or <code>primitive:array&lt;T&gt;</code></td> </tr> <tr> <td><code>!</code></td> <td><code>primitive:never</code></td> </tr> <tr> <td><code>()</code></td> <td><code>primitive:unit</code> and/or <code>primitive:tuple</code></td> </tr> <tr> <td><code>(T)</code></td> <td><code>T</code></td> </tr> <tr> <td><code>(T,)</code></td> <td><code>primitive:tuple&lt;T&gt;</code></td> </tr> <tr> <td><code>(T, U -> V, W)</code></td> <td><code>fn(T, U) -> (V, W)</code>, Fn, FnMut, and FnOnce</td> </tr> <tr><td colspan="2">New additions with this PR</td></tr> <tr> <td><code>&</code></td> <td><code>primitive:reference</td> </tr> <tr> <td><code>&mut</code></td> <td><code>primitive:reference&lt;keyword:mut&gt;</td> </tr> <tr> <td><code>&T</code></td> <td><code>primitive:reference&lt;T&gt;</td> </tr> <tr> <td><code>&mut T</code></td> <td><code>primitive:reference&lt;keyword:mut, T&gt;</td> </tr> </tbody> </table> ### Search query grammar <code><pre><strong>borrow-ref = AMP *WS [MUT] *WS [arg]</strong> arg = [type-filter *WS COLON *WS] (path [generics] / slice-like / tuple-like / <strong>borrow-ref</strong>)</pre></code> ``` AMP = "&" MUT = "mut" ``` ## Future direction As described in https://github.com/rust-lang/rust/pull/118194 and https://github.com/rust-lang/rust/pull/119676 * The remaining type expression grammar (this is another step in the type expression grammar: `ReferenceType` is now supported) * Search subtyping and traits 2024-04-28T15:23:12+00:00 Guillaume Gomez guillaume.gomez@huawei.com 2024-04-10T18:36:02+00:00 urn:sha1:5a3509c2f47758cc714381bc2f2fa68583bd5a5a 2024-04-28T15:23:12+00:00 Guillaume Gomez guillaume.gomez@huawei.com 2024-04-10T18:29:15+00:00 urn:sha1:f780913c722a78ab87e3fea10af4b75c0e4c1b66 2024-04-28T15:23:11+00:00 Guillaume Gomez guillaume.gomez@huawei.com 2024-04-10T18:14:18+00:00 urn:sha1:f5b3b400f7c5f85d3e0a821d83f41b2b71985f9b 2024-04-19T21:31:21+00:00 Michael Howell michael@notriddle.com 2024-04-19T04:30:39+00:00 urn:sha1:3c4e180e681e9c3e8c68de51585a1debd1f4bbdb 2024-04-19T05:21:29+00:00 Michael Howell michael@notriddle.com 2024-04-19T05:20:08+00:00 urn:sha1:2e7d9e9acbdb48620e347529796bf1e35fd97c19 This needs to start downloading the descriptions after aliases have been added to the result set.