Здравствуйте, Аноним, Вы писали:

А>Привет, всем,
А>вопрос не новый, наверное.
А>кто какие справочные системы использует. в windows как я понял существует только довольно убогий htmlhelp, а если я хочу сделать справку как в MSDN, например, или у продуктов IBM? искал в гугле custom help systems, ничего толкового не нашел. по RSDN тоже нет такой информации. куда надо копать?

Смотря что вы хотите от help. Существует 2-а пути создания документации. Первый это когда вы пишите отдельные разделы документации устанавливаете связи между разделами. Потом берете прогу натравливаете на все файлы и получаете документацию. Для винды это htmlhelp. Кросплаформенное решение — пишите сразу html файлы и связывайте их сылками. Второй способ — на основании комментариев исходного кода. Для виндовых — sandcastle(http://ru.wikipedia.org/wiki/Sandcastle). Универсальное решение — doxygen(http://ru.wikipedia.org/wiki/Doxygen, ), после работы создаются html.
Если есть силы и желание можно посмотреть еще на DocBook.

Но у каждой из технологий есть свои достоинства и недостатки. У меня например была задача создовать документацию(help) используя комментарии из исходников и причем на двух языках(на англиском и немецком), да и причем чтобы и все красиво было. Ни одна из систем такого не поддерживает, только ручками. Благо народ подкинул сылку на один из своих проектов HELPER. Можно вести комментирование исходников на любом количестве яыков, набор тегов комментирования чем-то похожа на doxygen. Выходная информация складывается в xml фалы. И есть отдельная среда по визуализации этих данных (образец внешнего вида можно посмотреть на их сайте www.wfound.com/wfc/doc/html/)

P.S. Правда они сейчас убрали проект с сайта но можно написать им письмо. И я думаю что они дадут HELPER поюзать.