[libvirt] [PATCHv2 01/15] docs: use correct terminology for 1024 bytes

Christophe Fergeau cfergeau at redhat.com
Tue Mar 6 14:34:00 UTC 2012


On Mon, Mar 05, 2012 at 05:34:16PM -0700, Eric Blake wrote:
> @@ -3619,7 +3619,7 @@ error:
>  /**
>   * virDomainSetMaxMemory:
>   * @domain: a domain object or NULL
> - * @memory: the memory size in kilobytes
> + * @memory: the memory size in kibibytes (blocks of 1024)

"of 1024 bytes"? I don't know how this looks to a native speaker, but this
looks truncated to my French eyes if "bytes" is not there, same for the 2
other occurrences below.

Christophe

>   *
>   * Dynamically change the maximum amount of physical memory allocated to a
>   * domain. If domain is NULL, then this change the amount of memory reserved
> @@ -3674,7 +3674,7 @@ error:
>  /**
>   * virDomainSetMemory:
>   * @domain: a domain object or NULL
> - * @memory: the memory size in kilobytes
> + * @memory: the memory size in kibibytes (blocks of 1024)
>   *
>   * Dynamically change the target amount of physical memory allocated to a
>   * domain. If domain is NULL, then this change the amount of memory reserved
> @@ -3729,7 +3729,7 @@ error:
>  /**
>   * virDomainSetMemoryFlags:
>   * @domain: a domain object or NULL
> - * @memory: the memory size in kilobytes
> + * @memory: the memory size in kibibytes (blocks of 1024)
>   * @flags: bitwise-OR of virDomainMemoryModFlags
>   *
>   * Dynamically change the target amount of physical memory allocated to a
> @@ -6684,7 +6684,7 @@ error:
>   * @conn: pointer to the hypervisor connection
>   *
>   * provides the free memory available on the Node
> - * Note: most libvirt APIs provide memory sizes in kilobytes, but in this
> + * Note: most libvirt APIs provide memory sizes in kibibytes, but in this
>   * function the returned value is in bytes. Divide by 1024 as necessary.
>   *
>   * Returns the available free memory in bytes or 0 in case of error
> -- 
> 1.7.7.6
> 
> --
> libvir-list mailing list
> libvir-list at redhat.com
> https://www.redhat.com/mailman/listinfo/libvir-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20120306/087038c8/attachment-0001.sig>


More information about the libvir-list mailing list