linux-kernel - [PATCH] docs: driver-api/dma.../provider.rst: fix indents

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-next>] [day] [month] [year] [list]

Message-Id: <20200312181318.1368421-1-steve@sk2.org>
Date:   Thu, 12 Mar 2020 19:13:18 +0100
From:   Stephen Kitt <steve@....org>
To:     Vinod Koul <vkoul@...nel.org>, Jonathan Corbet <corbet@....net>,
        Tero Kristo <t-kristo@...com>,
        Grygorii Strashko <grygorii.strashko@...com>,
        Peter Ujfalusi <peter.ujfalusi@...com>,
        dmaengine@...r.kernel.org, linux-doc@...r.kernel.org
Cc:     linux-kernel@...r.kernel.org, Stephen Kitt <steve@....org>
Subject: [PATCH] docs: driver-api/dma.../provider.rst: fix indents

This fixes some block indentations, formatting them as definitions
(which seems appropriate given the content), and addressing these
warnings:

	Documentation/driver-api/dmaengine/provider.rst:270: WARNING: Unexpected indentation.
	Documentation/driver-api/dmaengine/provider.rst:273: WARNING: Block quote ends without a blank line; unexpected unindent.
	Documentation/driver-api/dmaengine/provider.rst:288: WARNING: Unexpected indentation.
	Documentation/driver-api/dmaengine/provider.rst:290: WARNING: Block quote ends without a blank line; unexpected unindent.

Fixes: 7d083ae98357 ("dmaengine: doc: Add sections for per descriptor metadata support")
Signed-off-by: Stephen Kitt <steve@....org>
---
 Documentation/driver-api/dmaengine/provider.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/Documentation/driver-api/dmaengine/provider.rst b/Documentation/driver-api/dmaengine/provider.rst
index 790a15089f1f..6367a79de47d 100644
--- a/Documentation/driver-api/dmaengine/provider.rst
+++ b/Documentation/driver-api/dmaengine/provider.rst
@@ -260,34 +260,35 @@ descriptors. Depending on the architecture the DMA driver can implement either
 or both of the methods and it is up to the client driver to choose which one
 to use.
 
-- DESC_METADATA_CLIENT
-
+DESC_METADATA_CLIENT
   The metadata buffer is allocated/provided by the client driver and it is
   attached (via the dmaengine_desc_attach_metadata() helper to the descriptor.
 
   From the DMA driver the following is expected for this mode:
-  - DMA_MEM_TO_DEV / DEV_MEM_TO_MEM
+
+  DMA_MEM_TO_DEV / DEV_MEM_TO_MEM
     The data from the provided metadata buffer should be prepared for the DMA
     controller to be sent alongside of the payload data. Either by copying to a
     hardware descriptor, or highly coupled packet.
-  - DMA_DEV_TO_MEM
+  DMA_DEV_TO_MEM
     On transfer completion the DMA driver must copy the metadata to the client
     provided metadata buffer before notifying the client about the completion.
     After the transfer completion, DMA drivers must not touch the metadata
     buffer provided by the client.
 
-- DESC_METADATA_ENGINE
-
+DESC_METADATA_ENGINE
   The metadata buffer is allocated/managed by the DMA driver. The client driver
   can ask for the pointer, maximum size and the currently used size of the
   metadata and can directly update or read it. dmaengine_desc_get_metadata_ptr()
   and dmaengine_desc_set_metadata_len() is provided as helper functions.
 
   From the DMA driver the following is expected for this mode:
-  - get_metadata_ptr
+
+  get_metadata_ptr
     Should return a pointer for the metadata buffer, the maximum size of the
     metadata buffer and the currently used / valid (if any) bytes in the buffer.
-  - set_metadata_len
+
+  set_metadata_len
     It is called by the clients after it have placed the metadata to the buffer
     to let the DMA driver know the number of valid bytes provided.
 

base-commit: 7d3d3254adaa61cba896f71497f56901deb618e5
-- 
2.24.1