Re: [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning

From: Jonathan NeuschÃfer
Date: Fri Feb 21 2020 - 10:59:57 EST


On Wed, Feb 19, 2020 at 04:17:58AM -0700, Jonathan Corbet wrote:
> On Fri, 14 Feb 2020 18:08:07 +0100
> Jonathan NeuschÃfer <j.neuschaefer@xxxxxxx> wrote:
>
> > This fixes the following warning:
> >
> > Documentation/filesystems/ubifs-authentication.rst:98: WARNING:
> > Inline interpreted text or phrase reference start-string without end-string.
> >
> > Signed-off-by: Jonathan NeuschÃfer <j.neuschaefer@xxxxxxx>
>
> So this, IMO, should be fixed in patch #2, when you're touching the file
> anyway. I don't see a lot of value in adding a warning to the docs build
> then immediately removing it.

Good point.

> Also, please send a cover letter with multi-part sets like this so we
> know what the overall objective is.

Ok, I'll remember to do that more.

In this case, I just saw this file and wanted it to work better with
Sphinx.

> Note also that Mauro is also playing with this file (and ubifs.txt, which
> really should be included as well) at the same time.

Hmm. I only saw Mauro's series after sending this one.

I think I'll respin this series after Mauro's is merged, to keep the
potential for merge conflicts low.


Thanks,
Jonathan NeuschÃfer

Attachment: signature.asc
Description: PGP signature