дайте мне шашкой помахать!

Пример. Есть огромный проект. В одном файле держать всё не удобно(бегать искать замучишься, даже если есть поисковые системы умные...). Значит несколько файлов.
Есть глобальная переменная.
Попробуйте без заголовка передать её в из одного файла в другой.

Ещё пример. Есть некий готовый отлаженный файл, скажем некого диалога частого пользования (например юзерский мессаджбокс(хотя бред полный, никому не советую делать свои мессаджбоксы! - нужно переделывать на ходу системные! Тогда не потеряете связь с будущими операционками)). С ахрененным кодом. Нафиг нам его за собой из проекта в проект таскать? Собираем один раз obj файл, и берём заголовок. Заголовок ложим в сорсы, объектник в дебаг и релиз и забываем про пересборку.

Уже говорилось ранее. Для порядка. Захотел описание класс посмотреть, не надо бегать по всему срр (хедеры, как правило на порядок меньше)

Ещё. Захотели вы ранее описанный класс(мессаджбокс) продать разработчикам, чтобы они радостно его использовали в своих программах... Без хедеров вам придётся продавать весь срр файл, и обязательно найдётся умник, который на вашем выстаданном коде легко сгенерит что-то более умное и заработает на вашем труде.

Я слышал (и даже видел) самодокументированные, точнее самодокументирующие вещи на яве.
Вполне явно, что СиДиез перенял эту особенность и надстроил над ней XML

Тока я не понял, это камень в чей огород? :)

JibSkeart, а я изначально # узнал как "диез", музыкант, блин!

автора обязательно такую мутоту в язык встраивать ?
Да она там места много не занимает...
Вот, помнится, в яве так просто хитрые комментарии (вроде /** если не путаю), которые при проходе некой софтиной типа javadoc делают из этих комментариев документацию.

авторНе сначала или после, а в процессе написания идет документирование.
Это точно. Пожелалки, новые фичи, отвалившиеся фичи и баги... Всего в начале не предусмотришь. Сделал релиз - сделал доку.

.. и идём мы на парад с красными шарами! .· )