Add support for Rust 1.54.0, 1.55.0, 1.56.0
Avoid unnecessary borrows
$ rusty-man rusty-man | head -5 rusty-man Module rusty-man rusty-man DESCRIPTION rusty-man is a command-line viewer for documentation generated by `rustdoc`.
Before running rusty-man, make sure that you generated the documentation with
$ cd rusty-man && cargo doc
Then you can open the documentation for an item:
$ rusty-man kuchiki::NodeRef
You don’t have to specificy the full item name:
$ rusty-man NodeRef
If the documentation is not placed in
./target/doc or the Rust installation
directory, you have to manually set the source path using the
$ rusty-man --source my/other/crate/target/doc io::Error
If there are multiple matches for the keyword, rusty-man will show you a list of all matching items:
$ rusty-man --source my/other/crate/target/doc u8 Found mulitple matches for u8 – select one of: [ 0 ] core::u8: The 8-bit unsigned integer type. [ 1 ] std::u8: The 8-bit unsigned integer type. > 1
For more usage information, run
rusty-man has three viewers (select one with the
--viewer option) that
determine the output format:
plainprints the documentation to the standard output without formatting. This is the default for non-interactive use.
richprints the documentation to the standard output with formatting and optional syntax highlighting. This is the default for interactive use.
tuiis an interactive terminal interface. You can read the documentation and follow links.
To install rusty-man from source, clone this repository and use cargo to build
the project, or use
cargo install. See the
INSTALL.md file for more
information. rusty-man is also available as a package for these distributions:
rusty-manin the Arch User Repository
rusty-man is developed for Unix-like systems. It should run on other platforms
too, but with some limitations: The
tui viewers uses ANSI escape
codes, which are not supported on older Windows versions. If you have trouble
running rusty-man on your platform or if you want to help porting rusty-man to
other platforms, please let me know.
You can set rusty-man as the keyword program with
and then use
K to open the documentation for the item under the cursor. If
you want to apply this setting for all Rust files, add it to the
ftplugin/rust.vim file in your vim runtime directory (e. g.
Contributions to this project are very welcome! You can contribute by writing
code or documentation or by testing. See the
CONTRIBUTING.md file for
If you are looking for a good starting point, have a look at the issues with the label “good first issue” in rusty-man’s issue tracker.
This crate supports Rust 1.45.0 or later.
For bug reports, patches, feature requests or other messages, please send a mail to the mailing list ~email@example.com (public archive) or contact me directly. You can also use the rusty-man issue tracker for bug reports or features requests.
This project is licensed under the MIT License. For license information
for the data used by the test suite, see the
rusty-man complies with version 3.0 of the REUSE specification.