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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20191230123047.72ebabff@lwn.net>
Date:   Mon, 30 Dec 2019 12:30:47 -0700
From:   Jonathan Corbet <corbet@....net>
To:     "Daniel W. S. Almeida" <dwlsalmeida@...il.com>
Cc:     mchehab+samsung@...nel.org, linux-doc@...r.kernel.org,
        linux-kernel@...r.kernel.org, skhan@...uxfoundation.org,
        linux-kernel-mentees@...ts.linuxfoundation.org
Subject: Re: [PATCH v2 4/8] Documentation: convert nfsd-admin-interfaces to
 ReST

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

> From: "Daniel W. S. Almeida" <dwlsalmeida@...il.com>
> 
> Convert nfsd-admin-interfaces to ReST and move it into admin-guide.
> Content remains mostly untouched.
> 
> Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@...il.com>
> ---
>  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