Обычно документация к программе и устройствам идет в виде chm справки и pdf документа
chm удобна тем, что можно сделать контекстно зависимый хелп, но его неудобно распечатывать.
pdf удобен для печати...
как это совместить???
попробовал несколько прог для автоматической конвертации:
chm2pdf, abc amber chm converter, chm to pdf converter pro..
ни одна полностью не подходит

основная разница в том, что в версии для распечатки нужно оглавление, например, а в chm его не сделать...
поддерживать две версии хелпа утомительно

кроме того, есть еще один вопрос:
при переводе из doc в pdf с помощью acrobat 7, если в доке используются заголовки и меню на их основе, неправильно формируется иерархия в дереве слева, который отображает акробат. как поправить это не нашел.
как фирмы делают свою документацию? в ней все нормально!

кто-нибудь сталкивался с такими задачами?

В какомто форуме, уже не помню каком недавно пробегала ссылка на программу AuthorIT.
Trial лежит сдесь _tt_://www.author-it.com/ и он полнофункционален. Сам я с ней пока толком не разобрался, но в двух словах: она позволяет вести документацию, хранит все во внутренем формате, а в нужный момент позволяет сделать экспорт в CHM,PDF,DOC,XML ну и чего то там еще уже не помню. Внешне интерфейс очень похож на ms_Word. Как мне кажется это то что вам нужно.

а кто-нибудь с ней работал?
как она, например, понимает, что в chm не надо оглавление делать, а в pdf надо?
поддерживает она вызовы из приложений для контекстного хелпа?

Вам сюда http://authorit.ru/forum/index.php

С этим поможет 'Help & Manual':
_http://www.helpandmanual.com/

Перепробовав различные средства создания документации и help, могу порекомендовать ComponentOne Doc-to-Help. Документ пишется в MS Word, на выходе можно получить HTML (вполне достойный, не такой, как сам word пишет), CHM и прочие форматы. Удобная система создания линков, автоматической индексации, глоссария и т.п. PDF, к сожалению, сам не пишет - приходится плагином от Acrobat 7 пользоваться.
Правда, использую версию 7.2, хотелось бы проапгрейдится до 2005 или даже 2006 - там глюков поменьше и возможностей побольше будет.

Help&Manual не понравился - он использует свой формат, а все же привычней писать в Word'е, функционал побогаче, да и написано уже много, не перебивать заново.

Еще распространен Robohelp от Macromedia. Впечатления - виснет сам и вешает машину. Посмотрев в процессах, выяснилось, что работает конвертор в режиме эмуляции 16-битной MS DOS. Соответственно, имена файлов длиннее 8 символов не понимает. Видимо, как сто лет назад написали движок, так только обертку правят. Правда, может такая уникальная версия попалась на рассмотрение.

1. Если к программе, то пользуюсь Doxygen - автодокументирование по исходным текстам - на выходе .html, .chm, .pdf (внешний TeX нужен), .rtf, ...
2. Если писать ручками, то я подсел на формат DocBook - пишу при пом. плугина к Eclipse - есть конвертаторы в .chm, а вот в .pdf есть, но русские буквы не получаются - но, это было пол года назад, теперь может выправилось...
3. Если надо .doc сохранить в .pdf (со всеми оглавлениями), то есть OpenOffice - он открывает MSWord .doc и экспортирует в .pdf v.5
(все это свободные тулзы)

Для конвертации в PDF рекомендую программу pdfFactory Pro (http://www.pdffactory.com/) - отлично понимает русские буквы, умеет создавать и редактировать закладки, интегрирует шрифты в документ, при работе эмулирует принтер, поэтому создать PDF можно из любой программы (лишь бы программа печатать умела ). Программа не бесплатная, но всё что нужно к ней минут за 5 находится в сети.

к сожалению, программы, эмулирующие принтер, не подходят, так как они не могут с chm документу создать оглавление, титульную страницу...
попробовал Help & Manual.
понравилось, что она как раз умеет делать оглавление, титульный лист, закрывающий, но...
она почему-то не понимает ссылки внутри старницы из топиков, в результате чего одну и ту же страницу размножает по количеству топиков и почему-то часть ссылок напрочь не видит.
беда прям..