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

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 [off-list ref] wrote:

quoted

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