On Sat, Nov 26, 2022 at 12:09:01PM +0900, Akira Yokosawa wrote: > Hi, > > On Thu, 24 Nov 2022 14:22:03 +0800, Zhen Lei wrote: > > Documentation/RCU/stallwarn.rst: > > 401: WARNING: Literal block expected; none found. > > 428: WARNING: Literal block expected; none found. > > 445: WARNING: Literal block expected; none found. > > 459: WARNING: Literal block expected; none found. > > 468: WARNING: Literal block expected; none found. > > > > The literal block need to be indented, so add two spaces to each line. > > > > In addition, ':', which is used as a boundary in the literal block, is > > replaced by '|'. > > > > Link: https://lore.kernel.org/linux-next/20221123163255.48653674@xxxxxxxxxxxxxxxx/ > > Fixes: 3d2788ba4573 ("doc: Document CONFIG_RCU_CPU_STALL_CPUTIME=y stall information") > > Reported-by: Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx> > > Signed-off-by: Zhen Lei <thunder.leizhen@xxxxxxxxxx> > > Tested "make htmldocs" on top of -rcu tree's dev. > Resulting stallwarn.html looks much better! > > Tested-by: Akira Yokosawa <akiyks@xxxxxxxxx> Queued for further testing and review, thank you all! Thanx, Paul > Thanks, Akira > > > --- > > Documentation/RCU/stallwarn.rst | 56 ++++++++++++++++++--------------- > > 1 file changed, 30 insertions(+), 26 deletions(-) > > > > v2 --> v3: > > 1. Add "Link:", "Fixes:", "Reported-by:". > > 2. Remove a orphaned pipe (|). > > 3. Change ". ::" to "::" > > > > v1 --> v2: > > For the case that both colons need to be deleted, change "::" to expanded > > form or partially minimized form.