Re: [Libguestfs] [PATCH] docs: Prefer 'cookie' over 'handle'

2023-03-06 Thread Eric Blake
On Sun, Mar 05, 2023 at 10:53:38AM +0200, Wouter Verhelst wrote: > On Sat, Mar 04, 2023 at 10:03:46PM +0200, Nir Soffer wrote: > > On Sat, Mar 4, 2023 at 12:15 AM Eric Blake wrote: > > > Makes no difference to implementations (other than older code > > > still using 'handle' may be slightly

Re: [Libguestfs] [PATCH] docs: Prefer 'cookie' over 'handle'

2023-03-05 Thread Wouter Verhelst
On Sat, Mar 04, 2023 at 10:03:46PM +0200, Nir Soffer wrote: > On Sat, Mar 4, 2023 at 12:15 AM Eric Blake wrote: > > Makes no difference to implementations (other than older code > > still using 'handle' may be slightly harder to tie back to the spec). > > To avoid confusion with older code that

Re: [Libguestfs] [PATCH] docs: Prefer 'cookie' over 'handle'

2023-03-04 Thread Richard W.M. Jones
On Fri, Mar 03, 2023 at 04:15:03PM -0600, Eric Blake wrote: > In libnbd, we quickly learned that distinguishing between 'handle' > (verb for acting on an object) and 'handle' (noun describing which > object to act on) could get confusing; we solved it by renaming the > latter to 'cookie'. Copy

Re: [Libguestfs] [PATCH] docs: Prefer 'cookie' over 'handle'

2023-03-04 Thread Nir Soffer
On Sat, Mar 4, 2023 at 12:15 AM Eric Blake wrote: > > In libnbd, we quickly learned that distinguishing between 'handle' > (verb for acting on an object) and 'handle' (noun describing which > object to act on) could get confusing; we solved it by renaming the > latter to 'cookie'. Copy that

Re: [Libguestfs] [PATCH] docs: Prefer 'cookie' over 'handle'

2023-03-03 Thread Laszlo Ersek
On 3/3/23 23:15, Eric Blake wrote: > In libnbd, we quickly learned that distinguishing between 'handle' > (verb for acting on an object) and 'handle' (noun describing which > object to act on) could get confusing; we solved it by renaming the > latter to 'cookie'. Copy that approach into the NBD

[Libguestfs] [PATCH] docs: Prefer 'cookie' over 'handle'

2023-03-03 Thread Eric Blake
In libnbd, we quickly learned that distinguishing between 'handle' (verb for acting on an object) and 'handle' (noun describing which object to act on) could get confusing; we solved it by renaming the latter to 'cookie'. Copy that approach into the NBD spec, and make it obvious that a cookie is