Здравствуйте, Pavel Dvorkin, Вы писали:

ЕМ>>Вы полагаете, что функции в документации должны группироваться прежде всего по заголовкам, в которых они определены?

PD>Ну как один из способов, да.

Для кого/чего может быть полезен такой способ группировки? Он не несет никакой дополнительной информации сверх содержимого самого заголовка, разве что подает его в чуть более удобной форме. Но и это избыточно, поскольку заголовок, который нужно включить для использования функции, всегда указан в ее описании. Тогда зачем? По сути, это как комментарии вроде "i++; // увеличиваем i на единицу".

PD>100% надежного разделения все равно не добиться — пересечения есть.

Для чего стоило бы добиваться "100% надежного разделения"? Правильнее было бы создать несколько списков, с разными способами группировки. А еще лучше — присвоить каждой функции/структуре тэги — window, DC, rectangle, line, shape, curve, pen, brush и т.п. Но документация, как известно, никогда не была сильной стороной MS.

PD>Тот же ScrollDC скорее я бы отнес с GDI, но он почему-то в USER. Почему — не знаю, может, потому что близок к ScrollWindow, а это точно USER

Про разделение KERNEL/USER/GDI нужно было забыть еще лет тридцать назад, и начать группировать по свойствам.