Слияние при запуске и слияние при компиляции

В WinhelpЗаметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. и Справке HTML, Вы можете создать подлинные модульные проекты с отдельными файлами справки, которые отображены в единственном Содержании. Альтернативно, Вы можете также объединить все ваши модули в один большой файл справки.

См. Выбор метода слияния для инструкций о том, как установить другие методы слияния для вывода Winhelp и Справки HTML.

Вы не можете смешать слияние при компиляции и при запуске!

Метод слияния всегда применяется ко всем проектам. Вы не можете смешать слияние при зауске и при компиляции в единственном проекте. Например, хотя Вы можете вложить проекты, Вы не можете установить один модуль быть слитым при запуске, а другой при компиляции. Вы должны использовать тот же метод слияния повсюду.

Слияние при компиляции – один интегрированный файл справки

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

Одно из наиболее практических преимуществ слияния при компиляции - то, что все модули, включая все дочерние модули, компилируются в одном быстром процессе, когда Вы компилируете главный проект. Вы не должны открывать и компилировать каждый модуль отдельно, как Вы делаете для проектов, конфигурированных для слияния при запуске.

Слияние при компиляции Help & Manual комбинирует все модули и создает один большой файл справки, когда Вы компилируете главный модуль. Если Вы хотите исключить модуль, Вы должны перекомпилировать без модуля.

Слияние при запуске - отдельные файлы справки

Когда Вы генерируете отдельные файлы справки для каждого модуля в вашем проекте, это называется слияние при запуске: Когда пользователь "запускает" справку, отдельные файлы справки "сливаются" и отображены в единственном средстве просмотра справки с единственным Содержанием, содержащим все разделы всех доступных модулей.

Слияние при запуске производит действительно модульные системы справки и в Winhelp, и в Справке HTML. Главный модуль, содержащий основное Содержание, должен всегда присутствовать, но Вы можете включить или исключить другие модули из справки просто включая и исключая файлы справки дочерних модулей из каталога, в котором сохранена справка. Если файл справки модуля не присутствует, его разделы просто не включены в Содержание.

Большое преимущество этого - огромная гибкость, которую это Вам дает. С небольшим планированием Вас можете уменьшить работу, нужную для выпуска разных версий вашей справки для других разных вашего продукта. Все, что Вы должны сделать, - включить или исключить файлы справки из вашего дистрибутивного пакета.

При слиянии при запуске Вы создаете отдельные файлы справки для главного и дочерних модулей (каждый модуль должен компилироваться отдельно). Файлы справки, которые не присутствуют на компьютере пользователя, автоматически исключены из Содержания.

Преимущества и недостатки двух методов слияния
Слияние при запуске		Слияние при компиляции
Преимущества	Недостатки	Преимущества	Недостатки
Действительно модульные, динамические системы справки. Разные версии могут быть созданы просто включением и исключением файлов справки в вашем дистрибутиве без перекомпилирования.	Все составляющие модули должны компилироваться отдельно.	Единственный файл справки, точно как произведенный из единственного проекта Help & Manual. Все составляющие модули компилируются автоматически в одном быстром процессе.	Вы должны перекомпилировать, чтобы произвести разные версии справки для разных версий продукта.
Двойные ID раздела и контекстные числа в модулях не проблема, потому что выходные файлы являются действительно отдельными.	Создавая ссылки к справке из вашего приложения, Вы должны всегда делать все возможное, чтобы связаться с правильным файлом справки.	Ссылки к справке из вашего приложения всегда к тому же файлу справки.	Вы должны делать все возможное, чтобы избежать двойных ID раздела и контекстных чисел в разных модулях, потому что модули слиты в единственном файле справки.
Невидимые разделы всех модулей включены автоматически, потому что дочерние модули компилируются отдельно.	Несколько файлов, которые должны быть в дистрибутиве, вместо единственного файла справки.	Вы должны принять дополнительные меры, чтобы включить невидимые разделы дочерних модулей в ваш вывод.

См. также:

Работа с модульными системами справки

Планирование модульных проектов