[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH RFC 0/3] qemu-img: remove command documentation dupl
From: |
John Snow |
Subject: |
[Qemu-devel] [PATCH RFC 0/3] qemu-img: remove command documentation duplication |
Date: |
Tue, 9 Apr 2019 21:24:10 -0400 |
This might hopefully cut down on the doc duplication/mismatching
until I can devise something more comprehensive.
Ideally, I'd like to redo all of the documentation for qemu-img
nearly from scratch; with a parser generator that helps generate
the documentation as well so they'll never get out of date.
That's probably quite a ways off, and maybe there are other
structural changes we want to make with respect to sphinx and
other build tools, so I am sending something very minimal instead.
This ought to be functionally identical down to the last char.
(I've re-included patch one which I have sent to the list separately,
purely as a dependency if you want to apply these patches.)
John Snow (3):
qemu-img: fix .hx and .texi disparity
pxtool: Add new qemu-img command info generation tool
qemu-img.texi: use macros for command summaries
qemu-img.texi | 28 ++++----
Makefile | 8 +--
qemu-img-cmds.json | 165 +++++++++++++++++++++++++++++++++++++++++++++
qemu-img-cmds.hx | 102 ----------------------------
scripts/pxtool.py | 53 +++++++++++++++
5 files changed, 236 insertions(+), 120 deletions(-)
create mode 100644 qemu-img-cmds.json
delete mode 100644 qemu-img-cmds.hx
create mode 100755 scripts/pxtool.py
--
2.17.2
- [Qemu-devel] [PATCH RFC 0/3] qemu-img: remove command documentation duplication,
John Snow <=
[Qemu-devel] [PATCH RFC 3/3] qemu-img.texi: use macros for command summaries, John Snow, 2019/04/09