Linux-mtd Archive on lore.kernel.org
 help / color / Atom feed
* [PATCH 1/4] MAINTAINERS: Add ubifs-authentication.rst to UBIFS
@ 2020-02-14 17:08 Jonathan Neuschäfer
  2020-02-14 17:08 ` [PATCH 2/4] docs: ubifs-authentication: Add a top-level heading Jonathan Neuschäfer
                   ` (2 more replies)
  0 siblings, 3 replies; 6+ messages in thread
From: Jonathan Neuschäfer @ 2020-02-14 17:08 UTC (permalink / raw)
  To: linux-mtd
  Cc: Rob Herring, Miklos Szeredi, Jonathan Corbet,
	Mauro Carvalho Chehab, Richard Weinberger, Jonathan Cameron,
	linux-doc, Jonathan Neuschäfer, David S. Miller,
	Greg Kroah-Hartman, Tobin C. Harding, Stefan Hajnoczi,
	Jaskaran Singh, Mauro Carvalho Chehab, Daniel W. S. Almeida,
	linux-kernel

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/

^ permalink raw reply	[flat|nested] 6+ messages in thread

* [PATCH 2/4] docs: ubifs-authentication: Add a top-level heading
  2020-02-14 17:08 [PATCH 1/4] MAINTAINERS: Add ubifs-authentication.rst to UBIFS Jonathan Neuschäfer
@ 2020-02-14 17:08 ` Jonathan Neuschäfer
  2020-02-14 17:08 ` [PATCH 3/4] docs: filesystems: link ubifs-authentication.rst Jonathan Neuschäfer
  2020-02-14 17:08 ` [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning Jonathan Neuschäfer
  2 siblings, 0 replies; 6+ messages in thread
From: Jonathan Neuschäfer @ 2020-02-14 17:08 UTC (permalink / raw)
  To: linux-mtd
  Cc: Rob Herring, Miklos Szeredi, Jonathan Corbet,
	Mauro Carvalho Chehab, Richard Weinberger, Jonathan Cameron,
	linux-doc, Jonathan Neuschäfer, David S. Miller,
	Greg Kroah-Hartman, Tobin C. Harding, Stefan Hajnoczi,
	Jaskaran Singh, Daniel W. S. Almeida, linux-kernel

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/

^ permalink raw reply	[flat|nested] 6+ messages in thread

* [PATCH 3/4] docs: filesystems: link ubifs-authentication.rst
  2020-02-14 17:08 [PATCH 1/4] MAINTAINERS: Add ubifs-authentication.rst to UBIFS Jonathan Neuschäfer
  2020-02-14 17:08 ` [PATCH 2/4] docs: ubifs-authentication: Add a top-level heading Jonathan Neuschäfer
@ 2020-02-14 17:08 ` Jonathan Neuschäfer
  2020-02-14 17:08 ` [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning Jonathan Neuschäfer
  2 siblings, 0 replies; 6+ messages in thread
From: Jonathan Neuschäfer @ 2020-02-14 17:08 UTC (permalink / raw)
  To: linux-mtd
  Cc: Rob Herring, Miklos Szeredi, Jonathan Corbet,
	Mauro Carvalho Chehab, Richard Weinberger, Jonathan Cameron,
	linux-doc, Jonathan Neuschäfer, Eric Biggers,
	David S. Miller, Greg Kroah-Hartman, Tobin C. Harding,
	Stefan Hajnoczi, Jaskaran Singh, Daniel W. S. Almeida,
	linux-kernel

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/

^ permalink raw reply	[flat|nested] 6+ messages in thread

* [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning
  2020-02-14 17:08 [PATCH 1/4] MAINTAINERS: Add ubifs-authentication.rst to UBIFS Jonathan Neuschäfer
  2020-02-14 17:08 ` [PATCH 2/4] docs: ubifs-authentication: Add a top-level heading Jonathan Neuschäfer
  2020-02-14 17:08 ` [PATCH 3/4] docs: filesystems: link ubifs-authentication.rst Jonathan Neuschäfer
@ 2020-02-14 17:08 ` Jonathan Neuschäfer
  2020-02-19 11:17   ` Jonathan Corbet
  2 siblings, 1 reply; 6+ messages in thread
From: Jonathan Neuschäfer @ 2020-02-14 17:08 UTC (permalink / raw)
  To: linux-mtd
  Cc: Rob Herring, Miklos Szeredi, Jonathan Corbet,
	Mauro Carvalho Chehab, Richard Weinberger, Jonathan Cameron,
	linux-doc, Jonathan Neuschäfer, David S. Miller,
	Greg Kroah-Hartman, Tobin C. Harding, Stefan Hajnoczi,
	Jaskaran Singh, Daniel W. S. Almeida, linux-kernel

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/

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning
  2020-02-14 17:08 ` [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning Jonathan Neuschäfer
@ 2020-02-19 11:17   ` Jonathan Corbet
  2020-02-21 15:59     ` Jonathan Neuschäfer
  0 siblings, 1 reply; 6+ messages in thread
From: Jonathan Corbet @ 2020-02-19 11:17 UTC (permalink / raw)
  To: Jonathan Neuschäfer
  Cc: Miklos Szeredi, Rob Herring, Mauro Carvalho Chehab,
	Richard Weinberger, Jonathan Cameron, linux-doc,
	Greg Kroah-Hartman, David S. Miller, linux-mtd, Tobin C. Harding,
	Stefan Hajnoczi, Jaskaran Singh, Daniel W. S. Almeida,
	linux-kernel

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/

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning
  2020-02-19 11:17   ` Jonathan Corbet
@ 2020-02-21 15:59     ` Jonathan Neuschäfer
  0 siblings, 0 replies; 6+ messages in thread
From: Jonathan Neuschäfer @ 2020-02-21 15:59 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Miklos Szeredi, Rob Herring, Mauro Carvalho Chehab,
	Richard Weinberger, Jonathan Cameron, linux-doc,
	Jonathan Neuschäfer, David S. Miller, Greg Kroah-Hartman,
	linux-mtd, Tobin C. Harding, Stefan Hajnoczi, Jaskaran Singh,
	Daniel W. S. Almeida, linux-kernel

[-- 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/

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, back to index

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-02-14 17:08 [PATCH 1/4] MAINTAINERS: Add ubifs-authentication.rst to UBIFS Jonathan Neuschäfer
2020-02-14 17:08 ` [PATCH 2/4] docs: ubifs-authentication: Add a top-level heading Jonathan Neuschäfer
2020-02-14 17:08 ` [PATCH 3/4] docs: filesystems: link ubifs-authentication.rst Jonathan Neuschäfer
2020-02-14 17:08 ` [PATCH 4/4] docs: ubifs-authentication: fix Sphinx warning Jonathan Neuschäfer
2020-02-19 11:17   ` Jonathan Corbet
2020-02-21 15:59     ` Jonathan Neuschäfer

Linux-mtd Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-mtd/0 linux-mtd/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-mtd linux-mtd/ https://lore.kernel.org/linux-mtd \
		linux-mtd@lists.infradead.org
	public-inbox-index linux-mtd

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.infradead.lists.linux-mtd


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git