This patch adds tests for Rust 1.54.0, 1.55.0 and 1.56.0. To make the
tests pass, we have to take care of some changes like more details
elements and changed heading levels. To make it easier to generate the
tests for new Rust versions, we also add two bash scripts that take care
of that.
This patch removes unnecessary borrows of references that are
automatically removed by the compiler. This takes care of the new
clippy lint needless_borrow.
Previously, we ran the tests in the CI with frehsly generated
documentation. We disable this option with this patch as we’ve updated
some dependencies so that the test cases no longer work properly.
Previosuly, we would always scroll by five lines if the PageUp or
PageDown button is hit in the tui viewer. With this patch, we customize
the scroll speed to one page (minus one line).
Previously, we assumed that the documentation generated by cargo is
placed in the target directory relative to the current working
directory. This is only true if the CARGO_TARGET_DIR and
CARGO_BUILD_TARGET_DIR environment variables are not set.
With this patch, we check the CARGO_TARGET_DIR and
CARGO_BUILD_TARGET_DIR environment variables to determine the target
directory. It could also be set in the Cargo configuration file, but
that would be too complicated to check. In the future, we might be able
to use the cargo config subcommand to determie the target directory.
This patch adds the --locked flag to the cargo install invocation in
INSTALL.md as this makes sure that the users ends up with tested and
working dependency versions.
This path adds support for the new search index format introduced in
Rust 1.52.0. With this new format, the index items are no longer
serialized as an array of structs but as arrays of the struct fields.
This patch adds tests for Rust 1.52.0. With Rust 1.52.0, the format of
the search index changed so we have to disable the search index tests.
Otherwise we can copy the snapshots with only small modifications taking
into account the change from simple quotes and apostrophes ("') to
typographically correct ones (“”’).
This patch adds test cases for Rust 1.51.0. We have to disable the
struct_anyhow_error test case as the structure of the Deref method
sections has changed.
This patch adds tests for Rust 1.50.0 which we can mostly copy from
1.49.0. There is only a small change to the abbreviated descriptions in
the search index and to edition-specific code.
With Rust 1.48.0, support for link shorthands, i. e. `[Test]` instead of
`[Test][]`, was added. Therefore, some of the links are now rendered
correctly. Otherwise we can just copy the snapshots and don’t need any
code changes.
This patch adds the o command to the tui viewer that can be used to open
items. The command uses the same lookup logic as the rusty-man program:
First, it tries to find a direct match. If none is found, it uses the
search index to find partial matches.
This match adds the Sources struct that is a wrapper for a vector of
Source structs. It now contains the lookup logic that was previously
contained in functions in main.rs.
Previously, we would either use the pager set in the PAGER environment
variable or "less -cr" for the rich and plain viewer. This caused
problems if, for example, the PAGER environment variable was set to
"less", see ticket #22:
https://todo.sr.ht/~ireas/rusty-man/22
To fix this issue, we now use the LESS environment variable to set the
less options. This makes sure that setting PAGER does not override the
options.
This minor release introduces a new interactive viewer, tui. It also
adds syntax highlighting for code in the documentation and support for
Rust 1.47.0.
This lint tells us to use the std::matches! macro instead of a match or
if let expression that yields a bool. But the matches! macro was added
in Rust 1.42, and our MSRV is 1.40. I don’t want to bump the MSRV only
for this change, so we ignore the lint.
Rust 1.47.0 introduced the Notable Traits section that lists information
about types used in code block. As we only want to display the code
block itself without meta-information, this patch ignores the
notable-traits class when extracting the text from nodes.
This patch adds vim-like keybindings to the tui viewer: hjkl for
navigation, G and g (instead of gg) for End and Home, and Ctrl+F and
Ctrl+B for Page Down and Up.
In the last patch, we added the termion dependency for the tui viewer.
With this patch, we remove the ansi_term, atty and terminal_size
dependencies and use termion instead.
With this patch, we replace cursive’s default ncurses backend with the
termion backend. This has multiple reasons:
- The ncurses backend has safety issues, see [0].
- ncurses requires a pre-installed library and a C compiler, introducing
additional build dependencies. Termion is implemented in Rust only.
- ncurses does not work on Windows, while termion works in all terminals
that support ANSI escape codes.
Per default, the termion backend does not buffer the output which may
cause flickering [1]. Therefore, we also use the
cursive_buffered_backend that buffers the output and fixes the
flickering problem.
[0] https://github.com/gyscos/cursive/issues/488
[1] https://github.com/gyscos/cursive/issues/142
We’ve moved the HtmlView into a separate crate, so we can replace our
own HtmlView with cursive_markup::MarkupView. We only have to implement
a custom Renderer that applies the syntax highlighting to code snippets.
This patch adds links to the items in the module member list. This only
applies for the tui viewer, as the links wouldn’t provide any additional
information for the plain and rich viewers.
In the previous commit, we used the Option::zip method to make querying
the focus and the links in the HtmlView struct easier. But Option::zip
has only been added in Rust 1.46, so we replace it with a custom utility
function to keep compatibility with Rust 1.40.
This patch adds a new viewer, tui, that provides an interactive
interface using cursive. This viewer makes it possible to follow links
to other documentation items and to open external links in a web
browser.
Previously, we only used the underline effect to highlight links in the
rich viewer, but we did not provide any information about their target.
With this patch, we print a list of link at the end of a block, similar
to the plain text viewer.
We are currently always listing the links in the plain text viewer when
rendering HTML, so we no longer need the show_links field that could be
used to disable link listing.
When changing the viewer to use the text-style crate, we mistakenly
changed the format for links in the rich viewer from underline to bold.
This patch fixes that mistake.
