Re: [Libguestfs] [PATCH libnbd 0/4] Miscellaneous Rust cleanups
On Tue, Oct 10, 2023 at 03:06:06PM +0100, Richard W.M. Jones wrote:
Add an overview libnbd-rust(3) man page pointing to the real
documentation. This is like OCaml & Golang.
When reviewing the real rustdocs I noticed they basically converted
the man pages into plain text, resulting in lots of problems such as
internal links not working, no `code` annotations, etc. So I wrote a
simple POD to rustdoc translator. It is by no means perfect, but it
fixes many of the issues.
Also build the examples, to make sure we don't get any regressions.
For the series:
Reviewed-by: Eric Blake <eblake(a)redhat.com>
There is an XXX about displying links rather than just italicized
texts for pod L<> constructs linking to non-libnbd pages, which can be
solved later, but your approach for now is definitely better than
plain text.
--
Eric Blake, Principal Software Engineer
Red Hat, Inc.
Virtualization: qemu.org | libguestfs.org