linux-kernel - Re: [PATCH] doc/rcu: Update LWN articles at the beginning

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: <d63cc303-0b73-4100-829d-01c6e3bb3548@gmail.com>
Date:   Sat, 20 Aug 2022 20:05:47 +0700
From:   Bagas Sanjaya <bagasdotme@...il.com>
To:     Shao-Tse Hung <ccs100203@...il.com>, corbet@....net,
        paulmck@...nel.org
Cc:     frederic@...nel.org, quic_neeraju@...cinc.com,
        josh@...htriplett.org, rostedt@...dmis.org,
        mathieu.desnoyers@...icios.com, jiangshanlai@...il.com,
        joel@...lfernandes.org, rcu@...r.kernel.org,
        linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] doc/rcu: Update LWN articles at the beginning

On 8/20/22 15:32, Shao-Tse Hung wrote:
> This patch adds LWN articles about RCU APIs which were released in 2019.
> Also, HTTP URLs are replaced by HTTPS.
> 

Please write patch description in imperative mood (say "Add 2019 edition
of RCU API documentation and use HTTPS links." instead).

> -| 1.	What is RCU, Fundamentally?  http://lwn.net/Articles/262464/
> -| 2.	What is RCU? Part 2: Usage   http://lwn.net/Articles/263130/
> -| 3.	RCU part 3: the RCU API      http://lwn.net/Articles/264090/
> -| 4.	The RCU API, 2010 Edition    http://lwn.net/Articles/418853/
> -| 	2010 Big API Table           http://lwn.net/Articles/419086/
> -| 5.	The RCU API, 2014 Edition    http://lwn.net/Articles/609904/
> -|	2014 Big API Table           http://lwn.net/Articles/609973/
> +| 1.	What is RCU, Fundamentally?  https://lwn.net/Articles/262464/
> +| 2.	What is RCU? Part 2: Usage   https://lwn.net/Articles/263130/
> +| 3.	RCU part 3: the RCU API      https://lwn.net/Articles/264090/
> +| 4.	The RCU API, 2010 Edition    https://lwn.net/Articles/418853/
> +| 	2010 Big API Table           https://lwn.net/Articles/419086/
> +| 5.	The RCU API, 2014 Edition    https://lwn.net/Articles/609904/
> +|	2014 Big API Table           https://lwn.net/Articles/609973/
> +| 6.	The RCU API, 2019 Edition    https://lwn.net/Articles/777036/
> +|	2019 Big API Table           https://lwn.net/Articles/777165/
>  

I don't think line blocks are necessary for lists. Instead, use nested
list. Why? Big API entry should be as sublist.

Thanks.

-- 
An old man doll... just what I always wanted! - Clara