Эдуард Тибет

Добрый день!

Ту задачу, которую вы описали, под силу docbook. Там есть специальный функционал, называемый Docbook profiling (как в один проход, так и в два прохода) (подробнее здесь: www.sagehill.net/docbookxsl/Profiling.html).

Однако, внедрение docbook - неординарная задача, которая требует некоторых усилий и для _маленьких_ проектов невыгодна. Если же у вас проект, который предполагает наличие НЕСКОЛЬКИХ срезов (например, разные аудитории/заказчики/OS) и одновременно нескольких форматов вывода, то docbook однозначно. И все это идет из одного источника, в т.ч. (в особо сложных случаях) с помощью Apache Cocoon в автоматическом режиме по http get).

Если интересуют подробности, спрашивайте - постараюсь ответить.

Добрый день!

Вообще для такой цели (именно документация по коду, если я правильно понял вопрос) существуют специальные утилиты, которые позволяют выцеплять документацию/комментарии (написанную разработчиками прямо в коде). Вы смотрели в сторону doxygen (www.doxygen.org)?

P.S. Непонятно только, зачем все это _хранить_ в pdf. PDF - это средство представления, а не формат хранения/обработки.