Re: [PATCH v5 0/2] docs: Integrate rustdoc into Rust documentation

From: Carlos Bilbao
Date: Wed Jan 04 2023 - 14:55:38 EST


On 1/4/23 08:53, Jonathan Corbet wrote:

Miguel Ojeda <miguel.ojeda.sandonis@xxxxxxxxx> writes:

I think I understand now what you meant by "fail more gracefully". I
thought you meant fail with a better/proper message given versioning
information or similar, but you primarily meant avoid breaking the
entire docs build if the Rust part fails, right?
Both would be nice, but not breaking the docs build would be at the top
of my list.


There's a bunch of simple workarounds we can use to keep going even if
rustdoc fails, if that is agreeable. I'd test but maybe something like:

ifeq ($(CONFIG_RUST),y)
    $(Q)$(MAKE) rustdoc || true
endif

or:

ifeq ($(CONFIG_RUST),y)
    $(Q)$(MAKE) -k rustdoc
endif

or:

ifeq ($(CONFIG_RUST),y)
    -$(Q)$(MAKE) -k rustdoc
endif

Thanks,

jon


Thanks,

Carlos