On 04/03/2014 09:15 PM, Michael R. Hines wrote: >>> # >>> +# @mc: #options @MCStats containing details Micro-Checkpointing >>> statistics >> s/options/optional/ - I'm assuming it is optional because it only >> appears when MC is in use. >> >> 'mc' is a rather short name, maybe 'micro-checkpoint' is better? > > Funny. I thought 'micro-checkpoint' was too long, particularly > in the ./configure output and the QEMU Monitor 'help' command output =)
For ./configure output, short is fine. For QMP, it's a programmatic interface, and management programs like libvirt have no problem outputting longer names. Where the longer names are nice is when reading logs generated by a management program, as we tried hard to make the QMP wire format still seem more or less legible to a human, even though humans aren't the primary driver of the interface. At the end of the day, though, the name doesn't matter, so it's not worth arguing what color to paint the bikeshed - you as author have some sway on what name you want :) -- Eric Blake eblake redhat com +1-919-301-3266 Libvirt virtualization library http://libvirt.org
signature.asc
Description: OpenPGP digital signature