lib: list_sort.c: add a blank line to avoid kernel-doc warnings [Linux 5.3]

This Linux kernel change "lib: list_sort.c: add a blank line to avoid kernel-doc warnings" is included in the Linux 5.3 release. This change is authored by Mauro Carvalho Chehab <mchehab+samsung [at]> on Tue Jun 18 15:51:19 2019 -0300. The commit for this change in Linux stable tree is 4ae5b8f (patch).

lib: list_sort.c: add a blank line to avoid kernel-doc warnings

In order for a list to be recognized as such, blank lines
are required.

Solve those Sphinx warnings:

./lib/list_sort.c:162: WARNING: Unexpected indentation.
./lib/list_sort.c:163: WARNING: Block quote ends without a blank line; unexpected unindent.

Signed-off-by: Mauro Carvalho Chehab <>
Signed-off-by: Jonathan Corbet <>

There are 2 lines of Linux source code added/deleted in this change. Code changes to Linux kernel are as follows.

 lib/list_sort.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/list_sort.c b/lib/list_sort.c
index 712ed1f..52f0c25 100644
--- a/lib/list_sort.c
+++ b/lib/list_sort.c
@@ -157,9 +157,11 @@ static void merge_final(void *priv, cmp_func cmp, struct list_head *head,
  * The number of pending lists of size 2^k is determined by the
  * state of bit k of "count" plus two extra pieces of information:
+ *
  * - The state of bit k-1 (when k == 0, consider bit -1 always set), and
  * - Whether the higher-order bits are zero or non-zero (i.e.
  *   is count >= 2^(k+1)).
+ *
  * There are six states we distinguish.  "x" represents some arbitrary
  * bits, and "y" represents some arbitrary non-zero bits:
  * 0:  00x: 0 pending of size 2^k;           x pending of sizes < 2^k

Leave a Reply

Your email address will not be published. Required fields are marked *