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

Jonathan Neuschäfer
2020-02-21T15:59:57Z

[-- Attachment #1: Type: text/plain, Size: 1206 bytes --]

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@gmx.net> 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@gmx.net>
>
> 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 #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]