On 4/10/19 1:39 AM, Markus Armbruster wrote:
> John Snow <js...@redhat.com> writes:
>
>> 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 "@item.*@var" qemu-img.texi | tail -14
>>
>> Signed-off-by: John Snow <js...@redhat.com>
>
> Extra points for explaining how you found the issues in detail
> sufficient for reproducing.
>
> Nice to have in 4.0.
>
> Reviewed-by: Markus Armbruster <arm...@redhat.com>
>
If it can go in for 4.0, who stages it? Kevin?
--js
