linux-kernel - Re: [PATCH v2 38/53] mtdnand.rst: group the "::" with previous line

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: Windows password security audit tool. GUI, reports in PDF.

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

Message-ID: <20170516151208.0246f874@bbrezillon>
Date:   Tue, 16 May 2017 15:12:08 +0200
From:   Boris Brezillon <boris.brezillon@...e-electrons.com>
To:     Mauro Carvalho Chehab <mchehab@...pensource.com>
Cc:     Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        Jonathan Corbet <corbet@....net>,
        Richard Weinberger <richard@....at>,
        linux-kernel@...r.kernel.org,
        Mauro Carvalho Chehab <mchehab@...radead.org>,
        Marek Vasut <marek.vasut@...il.com>,
        linux-mtd@...ts.infradead.org,
        Cyrille Pitchen <cyrille.pitchen@...el.com>,
        Brian Norris <computersforpeace@...il.com>,
        David Woodhouse <dwmw2@...radead.org>
Subject: Re: [PATCH v2 38/53] mtdnand.rst: group the "::" with previous line

On Tue, 16 May 2017 09:16:30 -0300
Mauro Carvalho Chehab <mchehab@...pensource.com> wrote:

> Group the :: with the previous paragraph, in order to make it
> visually better when reading as a text file.
> 
> While here, replace:
> 	ored (with means "Covered or adorned with ore or metal")
> by:
> 	OR-ed
> 
> To reflect its true meaning.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab@...pensource.com>

Acked-by: Boris Brezillon <boris.brezillon@...e-electrons.com>

> ---
>  Documentation/driver-api/mtdnand.rst | 24 +++++++-----------------
>  1 file changed, 7 insertions(+), 17 deletions(-)
> 
> diff --git a/Documentation/driver-api/mtdnand.rst b/Documentation/driver-api/mtdnand.rst
> index 8723175f955e..7c19795ebb4a 100644
> --- a/Documentation/driver-api/mtdnand.rst
> +++ b/Documentation/driver-api/mtdnand.rst
> @@ -843,10 +843,8 @@ Chip option constants
>  Constants for chip id table
>  ~~~~~~~~~~~~~~~~~~~~~~~~~~~
>  
> -These constants are defined in nand.h. They are ored together to
> -describe the chip functionality.
> -
> -::
> +These constants are defined in nand.h. They are OR-ed together to
> +describe the chip functionality::
>  
>      /* Buswitdh is 16 bit */
>      #define NAND_BUSWIDTH_16    0x00000002
> @@ -867,10 +865,8 @@ describe the chip functionality.
>  Constants for runtime options
>  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>  
> -These constants are defined in nand.h. They are ored together to
> -describe the functionality.
> -
> -::
> +These constants are defined in nand.h. They are OR-ed together to
> +describe the functionality::
>  
>      /* The hw ecc generator provides a syndrome instead a ecc value on read
>       * This can only work if we have the ecc bytes directly behind the
> @@ -881,9 +877,7 @@ describe the functionality.
>  ECC selection constants
>  -----------------------
>  
> -Use these constants to select the ECC algorithm.
> -
> -::
> +Use these constants to select the ECC algorithm::
>  
>      /* No ECC. Usage is not recommended ! */
>      #define NAND_ECC_NONE       0
> @@ -903,9 +897,7 @@ Hardware control related constants
>  ----------------------------------
>  
>  These constants describe the requested hardware access function when the
> -boardspecific hardware control function is called
> -
> -::
> +boardspecific hardware control function is called::
>  
>      /* Select the chip by setting nCE to low */
>      #define NAND_CTL_SETNCE     1
> @@ -929,9 +921,7 @@ Bad block table related constants
>  ---------------------------------
>  
>  These constants describe the options used for bad block table
> -descriptors.
> -
> -::
> +descriptors::
>  
>      /* Options for the bad block table descriptors */
>