2020-04-30 19:10:01

by Vitor Massaru Iha

[permalink] [raw]
Subject: [PATCH] docs: filesystems: fix `make htmldocs` warning

make htmldocs
Documentation/filesystems/orangefs.rst:124: WARNING: Literal block expected; none found.

Signed-off-by: Vitor Massaru Iha <[email protected]>
---
Documentation/filesystems/orangefs.rst | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/Documentation/filesystems/orangefs.rst b/Documentation/filesystems/orangefs.rst
index e41369709c5b..628dc220567e 100644
--- a/Documentation/filesystems/orangefs.rst
+++ b/Documentation/filesystems/orangefs.rst
@@ -119,9 +119,7 @@ it comes to that question::

/opt/ofs/bin/pvfs2-genconfig /etc/pvfs2.conf

-Create an /etc/pvfs2tab file::
-
-Localhost is fine for your pvfs2tab file:
+Create an /etc/pvfs2tab file. Localhost is fine for your pvfs2tab file::

echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2 defaults,noauto 0 0 > \
/etc/pvfs2tab
--
2.25.1


2020-04-30 19:51:45

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] docs: filesystems: fix `make htmldocs` warning

On Thu, 30 Apr 2020 16:07:37 -0300
Vitor Massaru Iha <[email protected]> wrote:

> make htmldocs
> Documentation/filesystems/orangefs.rst:124: WARNING: Literal block expected; none found.
>
> Signed-off-by: Vitor Massaru Iha <[email protected]>
> ---
> Documentation/filesystems/orangefs.rst | 4 +---
> 1 file changed, 1 insertion(+), 3 deletions(-)
>
> diff --git a/Documentation/filesystems/orangefs.rst b/Documentation/filesystems/orangefs.rst
> index e41369709c5b..628dc220567e 100644
> --- a/Documentation/filesystems/orangefs.rst
> +++ b/Documentation/filesystems/orangefs.rst
> @@ -119,9 +119,7 @@ it comes to that question::
>
> /opt/ofs/bin/pvfs2-genconfig /etc/pvfs2.conf
>
> -Create an /etc/pvfs2tab file::
> -
> -Localhost is fine for your pvfs2tab file:
> +Create an /etc/pvfs2tab file. Localhost is fine for your pvfs2tab file::
>
> echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2 defaults,noauto 0 0 > \
> /etc/pvfs2tab

Thanks, but this has already been fixed in docs-next.

jon

2020-04-30 19:59:27

by Vitor Massaru Iha

[permalink] [raw]
Subject: Re: [PATCH] docs: filesystems: fix `make htmldocs` warning

Hi Jon,

On Thu, 2020-04-30 at 13:47 -0600, Jonathan Corbet wrote:
> On Thu, 30 Apr 2020 16:07:37 -0300
> Vitor Massaru Iha <[email protected]> wrote:
>
> > make htmldocs
> > Documentation/filesystems/orangefs.rst:124: WARNING: Literal block
> > expected; none found.
> >
> > Signed-off-by: Vitor Massaru Iha <[email protected]>
> > ---
> > Documentation/filesystems/orangefs.rst | 4 +---
> > 1 file changed, 1 insertion(+), 3 deletions(-)
> >
> > diff --git a/Documentation/filesystems/orangefs.rst
> > b/Documentation/filesystems/orangefs.rst
> > index e41369709c5b..628dc220567e 100644
> > --- a/Documentation/filesystems/orangefs.rst
> > +++ b/Documentation/filesystems/orangefs.rst
> > @@ -119,9 +119,7 @@ it comes to that question::
> >
> > /opt/ofs/bin/pvfs2-genconfig /etc/pvfs2.conf
> >
> > -Create an /etc/pvfs2tab file::
> > -
> > -Localhost is fine for your pvfs2tab file:
> > +Create an /etc/pvfs2tab file. Localhost is fine for your pvfs2tab
> > file::
> >
> > echo tcp://localhost:3334/orangefs /pvfsmnt pvfs2
> > defaults,noauto 0 0 > \
> > /etc/pvfs2tab
>
> Thanks, but this has already been fixed in docs-next.

Sorry about that. I searched but I didn't find the documentation tree.
Could you point me to the git url?

Thanks,
Vitor

2020-04-30 20:06:39

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] docs: filesystems: fix `make htmldocs` warning

On Thu, 30 Apr 2020 16:57:24 -0300
Vitor Massaru Iha <[email protected]> wrote:

> Sorry about that. I searched but I didn't find the documentation tree.
> Could you point me to the git url?

The MAINTAINERS file is always the place to look for such things:

> T: git git://git.lwn.net/linux.git docs-next

jon

2020-04-30 20:12:06

by Vitor Massaru Iha

[permalink] [raw]
Subject: Re: [PATCH] docs: filesystems: fix `make htmldocs` warning

On Thu, 2020-04-30 at 14:04 -0600, Jonathan Corbet wrote:
> On Thu, 30 Apr 2020 16:57:24 -0300
> Vitor Massaru Iha <[email protected]> wrote:
>
> > Sorry about that. I searched but I didn't find the documentation
> > tree.
> > Could you point me to the git url?
>
> The MAINTAINERS file is always the place to look for such things:
>
> > T: git git://git.lwn.net/linux.git docs-next
>
> jon

Thanks Jon!