Re: [PATCH v2 4/8] Documentation: convert nfsd-admin-interfaces to ReST

From: Jonathan Corbet
Date: Mon Dec 30 2019 - 14:30:51 EST


On Mon, 30 Dec 2019 01:55:58 -0300
"Daniel W. S. Almeida" <dwlsalmeida@xxxxxxxxx> wrote:

> From: "Daniel W. S. Almeida" <dwlsalmeida@xxxxxxxxx>
>
> Convert nfsd-admin-interfaces to ReST and move it into admin-guide.
> Content remains mostly untouched.
>
> Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@xxxxxxxxx>
> ---
> Documentation/admin-guide/nfs/index.rst | 1 +
> .../nfs/nfsd-admin-interfaces.rst} | 19 +++++++++----------
> 2 files changed, 10 insertions(+), 10 deletions(-)
> rename Documentation/{filesystems/nfs/nfsd-admin-interfaces.txt => admin-guide/nfs/nfsd-admin-interfaces.rst} (70%)
>
> diff --git a/Documentation/admin-guide/nfs/index.rst b/Documentation/admin-guide/nfs/index.rst
> index 498652a8b955..c73ba9c16b77 100644
> --- a/Documentation/admin-guide/nfs/index.rst
> +++ b/Documentation/admin-guide/nfs/index.rst
> @@ -8,4 +8,5 @@ NFS
> nfs-client
> nfsroot
> nfs-rdma
> + nfsd-admin-interfaces
>
> diff --git a/Documentation/filesystems/nfs/nfsd-admin-interfaces.txt b/Documentation/admin-guide/nfs/nfsd-admin-interfaces.rst
> similarity index 70%
> rename from Documentation/filesystems/nfs/nfsd-admin-interfaces.txt
> rename to Documentation/admin-guide/nfs/nfsd-admin-interfaces.rst
> index 56a96fb08a73..7f8c64ad7632 100644
> --- a/Documentation/filesystems/nfs/nfsd-admin-interfaces.txt
> +++ b/Documentation/admin-guide/nfs/nfsd-admin-interfaces.rst
> @@ -1,5 +1,6 @@
> +==================================
> Administrative interfaces for nfsd
> -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> +==================================
>
> Note that normally these interfaces are used only by the utilities in
> nfs-utils.
> @@ -13,18 +14,16 @@ nfsd/threads.
> Before doing that, NFSD can be told which sockets to listen on by
> writing to nfsd/portlist; that write may be:
>
> - - an ascii-encoded file descriptor, which should refer to a
> - bound (and listening, for tcp) socket, or
> - - "transportname port", where transportname is currently either
> - "udp", "tcp", or "rdma".
> + #. an ascii-encoded file descriptor, which should refer to a
> + bound (and listening, for tcp) socket, or
> + #. "transportname port", where transportname is currently either
> + "udp", "tcp", or "rdma".

So here we actually had bullets, I think it would be best to leave them
that way.

Let's focus on getting the series up to this point ready, then we can look
at the later patches.

Thanks,

jon