On 24/12/2020 12:13, Andy Shevchenko wrote: > On Thu, Dec 24, 2020 at 3:12 AM Daniel Scally <djrscally@xxxxxxxxx> wrote: >> >> To maintain consistency with software_node_unregister_nodes(), reverse >> the order in which the software_node_unregister_node_group() function >> unregisters nodes. > > ... > >> - * Unregister multiple software nodes at once. >> + * Unregister multiple software nodes at once. The array will be unwound in >> + * reverse order (i.e. last entry first) and thus if any member of the array >> + * has its .parent member set then they should appear later in the array such >> + * that they are unregistered first. > > I'm, as being not a native speaker, a bit confused by this comment. > The idea is that children are unregistered first. Can you try to make > it more clear maybe? Sure, how about: The array will be unwound in reverse order (i.e. last entry first). If any member of the array is a child of another member then the child must appear later in the array than their parent, so that they are unregistered first. ?
