[doc][algorithms][num_points] update the return value for boxes (now
depends on the dimension of the box)
[doc][algorithms][num_segments] remove add_for_open argument from
doxygne documentation; update qbk documentataion to reflect that there
is only one argument to the free function
[doc][examples][num_segments] update num_segments example: the free
function takes only one argument