[doc][algorithms][num_segments] add back documentation for num_segments algorithm

To be included in boost 1.58