How to install/run the cargo-rustdoc-clippy

[jmcnamara]

I wanted to run clippy on code examples in rustdoc and came across your cargo-rustdoc-clippy at rust-lang/rust#56232

Could you give some guidance on how to install/run it? What I've tried so far:

I installed(??) it and made it executable as follows on macOS Ventura 13.2.1:

$ cp ~/Downloads/cargo-rustdoc-clippy.txt ~/.cargo/bin/cargo-rustdoc-clippy
$ chmod +x ~/.cargo/bin/cargo-rustdoc-clippy

It runs but gives errors on each file/example in this repo:

$ cargo +nightly rustdoc-clippy
    Finished test [unoptimized + debuginfo] target(s) in 0.03s
   Doc-tests rust_xlsxwriter

running 195 tests
error: multiple input filenames provided (first two filenames are `` and `-`)

error: multiple input filenames provided (first two filenames are `` and `-`)

error: multiple input filenames provided (first two filenames are `` and `-`)
...

Any hints on what I am going wrong or missing?

And thanks for making this available.

[Nemo157]

Ah whoops, my latest change to make it support spaces in args broke running it without any args, for now cargo rustdoc-clippy -- -- -Dwarnings will work (and it's sort of necessary to use in order to get a summary of which examples fail at the end anyway). I'll probably push an updated version soon that fixes it.

[Nemo157]

That was actually easier to fix than I expected aeaa138.

[jmcnamara]

Thank you. That works and is just what I was looking for.