[PATCH 1/4] MAINTAINERS: Add ubifs-authentication.rst to UBIFS

[PATCH 1/4] MAINTAINERS: Add ubifs-authentication.rst to UBIFS

[Jonathan Neuschäfer]

Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
---
 MAINTAINERS | 1 +
 1 file changed, 1 insertion(+)

diff --git a/MAINTAINERS b/MAINTAINERS
index 38fe2f3f7b6f..6a5365f10aa5 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -17047,6 +17047,7 @@ T:	git git://git.kernel.org/pub/scm/linux/kernel/git/rw/ubifs.git fixes
 W:	http://www.linux-mtd.infradead.org/doc/ubifs.html
 S:	Supported
 F:	Documentation/filesystems/ubifs.txt
+F:	Documentation/filesystems/ubifs-authentication.rst
 F:	fs/ubifs/

 UCLINUX (M68KNOMMU AND COLDFIRE)
--
2.20.1


______________________________________________________
Linux MTD discussion mailing list
http://lists.infradead.org/mailman/listinfo/linux-mtd/

[PATCH 2/4] docs: ubifs-authentication: Add a top-level heading

[Jonathan Neuschäfer]

There are two chapter headings, which otherwise both show up in the
table of contents in filesystems/index.html.

Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
---
 Documentation/filesystems/ubifs-authentication.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/filesystems/ubifs-authentication.rst b/Documentation/filesystems/ubifs-authentication.rst
index 6a9584f6ff46..12babb95a822 100644
--- a/Documentation/filesystems/ubifs-authentication.rst
+++ b/Documentation/filesystems/ubifs-authentication.rst
@@ -4,6 +4,10 @@
 .. sigma star gmbh
 .. 2018

+====================
+UBIFS Authentication
+====================
+
 Introduction
 ============

--
2.20.1


______________________________________________________
Linux MTD discussion mailing list
http://lists.infradead.org/mailman/listinfo/linux-mtd/

[PATCH 3/4] docs: filesystems: link ubifs-authentication.rst

[Jonathan Neuschäfer]

Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
---
 Documentation/filesystems/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
index 386eaad008b2..ac574d521f11 100644
--- a/Documentation/filesystems/index.rst
+++ b/Documentation/filesystems/index.rst
@@ -49,5 +49,6 @@ Documentation for filesystem implementations.
    autofs
    fuse
    overlayfs
+   ubifs-authentication
    virtiofs
    vfat
--
2.20.1


______________________________________________________
Linux MTD discussion mailing list
http://lists.infradead.org/mailman/listinfo/linux-mtd/

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

[Jonathan Neuschäfer]

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>
---
 Documentation/filesystems/ubifs-authentication.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/filesystems/ubifs-authentication.rst b/Documentation/filesystems/ubifs-authentication.rst
index 12babb95a822..97f3780c2620 100644
--- a/Documentation/filesystems/ubifs-authentication.rst
+++ b/Documentation/filesystems/ubifs-authentication.rst
@@ -100,7 +100,7 @@ of nodes. Eg. data nodes (`struct ubifs_data_node`) which store chunks of file
 contents or inode nodes (`struct ubifs_ino_node`) which represent VFS inodes.
 Almost all types of nodes share a common header (`ubifs_ch`) containing basic
 information like node type, node length, a sequence number, etc. (see
-`fs/ubifs/ubifs-media.h`in kernel source). Exceptions are entries of the LPT
+`fs/ubifs/ubifs-media.h` in kernel source). Exceptions are entries of the LPT
 and some less important node types like padding nodes which are used to pad
 unusable content at the end of LEBs.

--
2.20.1


______________________________________________________
Linux MTD discussion mailing list
http://lists.infradead.org/mailman/listinfo/linux-mtd/

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

[Jonathan Corbet]

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.

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

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

Thanks,

jon

______________________________________________________
Linux MTD discussion mailing list
http://lists.infradead.org/mailman/listinfo/linux-mtd/

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

[Jonathan Neuschäfer]

[-- Attachment #1.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 #1.2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[-- Attachment #2: Type: text/plain, Size: 144 bytes --]

______________________________________________________
Linux MTD discussion mailing list
http://lists.infradead.org/mailman/listinfo/linux-mtd/