[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-block] [Qemu-devel] [PATCH] qemu-img: fix .hx and .texi dispar
From: |
Peter Maydell |
Subject: |
Re: [Qemu-block] [Qemu-devel] [PATCH] qemu-img: fix .hx and .texi disparity |
Date: |
Fri, 12 Apr 2019 15:13:08 +0100 |
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