[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Qemu-commits] [qemu/qemu] 13c24e: qemu-img: fix .hx and .texi disparity

From: John Snow
Subject: [Qemu-commits] [qemu/qemu] 13c24e: qemu-img: fix .hx and .texi disparity
Date: Fri, 12 Apr 2019 14:12:37 +0000 (UTC)

  Branch: refs/heads/master
  Home:   https://github.com/qemu/qemu
  Commit: 13c24edaa742181af8d9c6b027ee366b04de1ea1
  Author: John Snow <address@hidden>
  Date:   2019-04-12 (Fri, 12 Apr 2019)

  Changed paths:
    M qemu-img-cmds.hx
    M qemu-img.texi

  Log Message:
  qemu-img: fix .hx and .texi disparity

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>
Reviewed-by: Markus Armbruster <address@hidden>
Message-id: address@hidden
Signed-off-by: Peter Maydell <address@hidden>

reply via email to

[Prev in Thread] Current Thread [Next in Thread]