lkml.org 
[lkml]   [2019]   [Aug]   [6]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH] Documentation: fs: Convert xfs-delayed-logging-design.txt to ReSt
On Tue, 6 Aug 2019 10:03:23 +0100
Sheriff Esseson <sheriffesseson@gmail.com> wrote:

> Convert xfs-delayed-logging-design.txt to ReST and fix broken references.
> The enumerations at "Lifecycle Changes" breaks because of lines begining with
> "<", treat as diagrams.

[...]

> @@ -27,14 +30,18 @@ written to disk after change D, we would see in the log the following series
> of transactions, their contents and the log sequence number (LSN) of the
> transaction:
>
> + ============ ========= ==============
> Transaction Contents LSN
> + ============ ========= ==============
> A A X
> B A+B X+n
> C A+B+C X+n+m
> D A+B+C+D X+n+m+o
> <object written to disk>
> - E E Y (> X+n+m+o)
> + ------------------------------------------------------
> + E E Y (> X+n+m+o)
> F E+F Y+p
> + ============ ========= ==============

So this is really more of a diagram than a table; I'd suggest just using a
literal block like you did elsewhere.

[...]

> Lifecycle Changes
> +=================
>
> -The existing log item life cycle is as follows:
> +The existing log item life cycle is as follows::
>
> 1. Transaction allocate
> 2. Transaction reserve

This, instead, is a proper outline. I guess the literal block is OK, but
it feels like we could do better.

Thanks,

jon

\
 
 \ /
  Last update: 2019-08-06 19:47    [W:0.083 / U:0.996 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site