Re: [Qemu-block] [Qemu-devel] [PATCH] qemu-img: fix .hx and .texi disparity

[Peter Maydell]

On Tue, 9 Apr 2019 at 22:08, John Snow <address@hidden> wrote:
>
> It turns out that having options listed in three places continues to be
> a bad idea. I'm still toying with the idea of an improved infrastructure
> here, but in the meantime, another bandaid.
>
> There are three locations:
> (1) .hx file, formatted as texi
> (2) .hx file, formatted as human readable.
> (3) .texi file, as section headers, formatted as texi.
>
> You can compare the two summaries within the .hx file like so:
>
> Human-readable command summaries:
> `./qemu-img --help | grep 'Command syntax' -A14`
> Detokenized texi command summaries:
> `grep "@item" qemu-img-cmds.hx | sed -E 's|@var\{([^\}]*?)\}|\1|g'`
>
> You can compare the two separate texi summaries like so:
>
> Texi command summaries:
> `grep "@item" qemu-img-cmds.hx"`
> Texi command headers:
> grep -E "@address@hidden" qemu-img.texi | tail -14
>
> Signed-off-by: John Snow <address@hidden>
> ---
>  qemu-img.texi    | 4 ++--
>  qemu-img-cmds.hx | 2 +-
>  2 files changed, 3 insertions(+), 3 deletions(-)

Applied to master for rc4, since we needed an rc4 anyway and
this is a safe docs change.

thanks
-- PMM