metrics: steal_count documentation doesn't match implementation

[jschwe]

The documentation says:

Returns the number of times the given worker thread stole tasks from another worker thread.

But the actual implementation increments the steal count by the amount of tasks stolen in each steal.
Is the fact that the stealing operation steals in batches an "implementation detail" or should the implementation perhaps be adpated to match the description?

In my opinion actually both metrics are interesting (at least when evaluating the effects of stealing with different batch sizes).

[andrewpollack]

In my opinion actually both metrics are interesting (at least when evaluating the effects of stealing with different batch sizes).

In this case, does it make sense to create a new function in addition to worker_steal_count to capture both metrics?

[jschwe]

In this case, does it make sense to create a new function in addition to worker_steal_count to capture both metrics?

I needed those numbers, so I already did something like this in my fork here and here.

I could add/adjust the missing documentation and open a PR if both metrics are interesting for the wider community.