On Fri, Dec 10, 2021 at 06:16:06PM +0100, Ján Tomko wrote: > On a Friday in 2021, Andrea Bolognani wrote: > > -``virt-qemu-run [OPTIONS...] [GUEST-XML]`` > > +``virt-qemu-run`` [*OPTIONS...*] *GUEST-XML-FILE* > > +``virt-qemu-run`` *OPTION* > > This puts them both on the same line in the resulting man page. So it does! Great catch, I don't know how I failed to notice. > Prefixing both lines with '|' fixed that for me: > > -``virt-qemu-run`` [*OPTIONS...*] *GUEST-XML-FILE* > -``virt-qemu-run`` *OPTION* > +| ``virt-qemu-run`` [*OPTIONS...*] *GUEST-XML-FILE* > +| ``virt-qemu-run`` *OPTION* I ended up adopting a slightly different approach: since the only situations in which you would not pass some mandatory ARGUMENT to the commands is for '--version' and '--help', which are extremely widespread and well understood, I've just changed the usage to ``command`` [*OPTION*]... *ARGUMENT* in all manual pages. I think this is a good solution, but if you'd rather see the version with two separate lines just let me know and I will prepare a follow-up patch. Thank you for the review! :) -- Andrea Bolognani / Red Hat / Virtualization
