rustdoc: allow searches to match against both type and name

[lolbinarycat]

repurposes existing syntax that previously had a nonsese meaning.

now fn:add, u8 -> u8 searches for fn items with "add" in the name, that take a u8 argument and return a u8.

the kind is included in anticipation that type based searches will soon work on items other than functions and methods.

fixes #131130

r? @notriddle

[rustbot]

Some changes occurred in HTML/CSS/JS.

cc @GuillaumeGomez, @jsha

[lolbinarycat]

cleaned up the formatting a bit, hopefully this satisfies tidy

[notriddle]

I can't say that I like that comma. If it's tough to get rid of it (I think it would be, since it would require infinite lookahead to distinguish fn:a b, c from fn:a b), here's an alternative suggestion:

Intra-doc links use a disambiguator that's separated from the item itself with an @ instead of a :, as in fn@add. Perhaps that could be the syntax for the extraNameElem, so that the sample query becomes fn@add u8 -> u8.

[lolbinarycat]

I can't say that I like that comma. If it's tough to get rid of it (I think it would be, since it would require infinite lookahead to distinguish fn:a b, c from fn:a b), here's an alternative suggestion:

why do we even allow spaces in item names?

[notriddle]

@lolbinarycat #108537 was when that was added. The idea was that name-based search worked well when space was used to separate path components, because it's easier than ::

[lolbinarycat]

ah, that makes sense. we should probably document that behavior somewhere.

i mean... if we're going treat spaces as :: in that case, we should probably do it here too, since this does support path-based search. i think adding less special cases to the syntax is a good thing, and it would be weird if fn:vec p worked but fn:vec p -> usize didn't.

ultimately, it might not be the "prettiest", but i think keeping the syntax easy to learn and understand is the most important thing.

[notriddle]

ah, that makes sense. we should probably document that behavior somewhere.

https://doc.rust-lang.org/nightly/rustdoc/read-documentation/search.html#search-by-name is supposed to describe it.

[bors]

☔ The latest upstream changes (presumably #127589) made this pull request unmergeable. Please resolve the merge conflicts.

[rust-log-analyzer]

The job x86_64-gnu-tools failed! Check out the build log: (web) (plain)

Click to see the possible cause of the failure (guessed by this bot)

.......... (130/134)
...F       (134/134)


/checkout/tests/rustdoc-gui/search-corrections.goml search-corrections... FAILED
[ERROR] `tests/rustdoc-gui/search-corrections.goml` line 100: ".error" not found: for command `assert-css: (".error", {
    "display": "block"
})`
[ERROR] `tests/rustdoc-gui/search-corrections.goml` line 103: ".error" not found: for command `assert-text: (
    ".error",
    "Query parser error: \"Generic type parameter NotableStructWithLongNamr does not accept generic parameters\"."

Error: ()
Build completed unsuccessfully in 0:03:20
  local time: Mon Nov 11 19:48:55 UTC 2024