blob42/rusty-man
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
0c22a6d393
rusty-man/README.md

100 lines
3.0 KiB
Markdown
Raw Normal View History

Initial project scaffolding This patch contains the initial project scaffolding, based on the files generated by cargo new.
2020-01-12 10:50:40 +00:00
<!---
SPDX-FileCopyrightText: 2020 Robin Krahl <robin.krahl@ireas.org>
SPDX-License-Identifier: MIT
-->
# rusty-man
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
```
$ rusty-man rusty-man | head -4
rusty-man Module rusty-man rusty-man
DESCRIPTION
rusty-man is a command-line viewer for documentation generated by `rustdoc`.
```
Initial project scaffolding This patch contains the initial project scaffolding, based on the files generated by cargo new.
2020-01-12 10:50:40 +00:00
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
## Example Usage
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
Before running rusty-man, make sure that you generated the documentation with
`cargo doc`:
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
```
$ cd rusty-man && cargo doc
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
```
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
Then you can open the documentation for an item:
```
$ rusty-man kuchiki::NodeRef
```
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
You don’t have to specificy the full item name:
```
$ rusty-man NodeRef
```
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
If the documentation is not placed in `./target/doc` or
`/usr/share/doc/rust{,-doc}/html`, you have to manually set the source path
using the `-s`/`--source` option:
```
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
$ rusty-man --source ~/.rustup/toolchains/stable-*/share/doc/html io::Error
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
```
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
If there are multiple matches for the keyword, rusty-man will show you a list
of all matching items:
```
Fix wrong command in example usage
2020-07-20 08:29:55 +00:00
$ rusty-man --source ~/.rustup/toolchains/stable-*/share/doc/rust/html u8
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
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
```
Update readme This patch updates the readme with better usage examples and with the documentation for rusty-man itself. Signed-off-by: Robin Krahl <robin.krahl@ireas.org>
2020-07-24 10:36:49 +00:00
For more usage information, run `rusty-man --help`.
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
## Installation
Update installation instructions This patch adds information about installing from crates.io and suggests checking out the latest release when installing from source.
2020-07-24 11:45:23 +00:00
To install rusty-man, clone this repository and use cargo to build the project,
or use `cargo install`. See the [`INSTALL.md`](./INSTALL.md) file for more
information.
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
Use crossterm instead of termion With this patch, we replace the termion dependency with crossterm. This should make it possible to compile and run rusty-man on other platforms than Unix.
2020-07-24 11:18:35 +00:00
rusty-man should run on all platforms supported by [`crossterm`][]. If you
have trouble running rusty-man on your platform or if you want to help porting
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
rusty-man to other platforms, please let me know.
## Contributing
Contributions to this project are very welcome! You can contribute by writing
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
code or documentation or by testing. See the [`CONTRIBUTING.md`][] file for
more information.
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
If you are looking for a good starting point, have a look at the [issues with
the label “good first issue”][issues] in rusty-man’s issue tracker.
Initial project scaffolding This patch contains the initial project scaffolding, based on the files generated by cargo new.
2020-01-12 10:50:40 +00:00
## Minimum Supported Rust Version
Add --viewer option and plain text viewer This patch adds a new --viewer command line option that lets the user select a viewer that displays the documentation. It also adds a default viewer implementation that uses html2text to generate plain text from the HTML documentation. html2text requires the ptr_cast feature and we use the Option::as_deref method in the viewer implementation, so we have to update the minimum supported Rust version to 1.40.
2020-07-16 19:01:29 +00:00
This crate supports Rust 1.40 or later.
Initial project scaffolding This patch contains the initial project scaffolding, based on the files generated by cargo new.
2020-01-12 10:50:40 +00:00
## Contact
For bug reports, patches, feature requests or other messages, please send a
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
mail to the mailing list [~ireas/rusty-man-dev@lists.sr.ht][] ([public
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
archive][]) or [contact me directly][]. You can also use the rusty-man [issue
tracker][] for bug reports or features requests.
Initial project scaffolding This patch contains the initial project scaffolding, based on the files generated by cargo new.
2020-01-12 10:50:40 +00:00
## License
This project is licensed under the [MIT License][].
`rusty-man` complies with [version 3.0 of the REUSE specification][reuse].
Use crossterm instead of termion With this patch, we replace the termion dependency with crossterm. This should make it possible to compile and run rusty-man on other platforms than Unix.
2020-07-24 11:18:35 +00:00
[`crossterm`]: https://lib.rs/crossterm
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
[`CONTRIBUTING.md`]: ./CONTRIBUTING.md
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
[issues]: https://todo.sr.ht/~ireas/rusty-man?search=label:%22good%20first%20issue%22%20status%3Aopen
[~ireas/rusty-man-dev@lists.sr.ht]: mailto:~ireas/rusty-man-dev@lists.sr.ht
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
[contact me directly]: mailto:robin.krahl@ireas.org
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
[public archive]: https://lists.sr.ht/~ireas/rusty-man-dev
[issue tracker]: https://todo.sr.ht/~ireas/rusty-man
Initial project scaffolding This patch contains the initial project scaffolding, based on the files generated by cargo new.
2020-01-12 10:50:40 +00:00
[MIT license]: https://opensource.org/licenses/MIT
[reuse]: https://reuse.software/practices/3.0/
Reference in New Issue Copy Permalink