PasDoc и fpDoc

[Иван Шихалев]

Как выяснилось, обе утилиты напрочь не приспособлены к работе с русским языком. То есть - совершенно. Оба проекта открытые (fpdoc — часть Free Pascal), соответственно, их можно взять и поправить.

Думаю, не совру, если пообещаю со стороны коллектива FreePascal.ru всяческую поддержку и помощь в меру наших скромных возможностей.

fpdoc распространяется вместе с FPC, и исходники тоже.
<a href='http://www.freepascal.org/' target='_blank'>Официальный сайт Free Pascal</a>
<a href='http://sourceforge.net/projects/freepascal/' target='_blank'>Free Pascal на SourceForge</a>
<a href='http://sourceforge.net/projects/pasdoc/' target='_blank'>PasDoc на SourceForge</a>

[Uniser]

Поддерживаю! Токо нужно дейсвия синхронизировать. С чего начать?

[Иван Шихалев]

Сначала кому-то надо разобраться в исходниках и определить - где что доделать.

[Arslan]

Итак, проблема PasDoc заключена в следующем.

В классах типа THTMLDocGenerator, TTexDocGenerator и т.п. есть метод ConvertString, заменяющий некоторые символы escape-последовательностями. Т.е. символы из массива Specials заменяются на строки из массива NumSpecials. В массиве Specials можно найти все кириллические символы. Остается только заменить последовательности в массиве NumSpecials на нужные кириллические символы.

Решение прямолинейное, но для генерации документации на одном языке вполне удовлетворительное.

[SStas]

Про PasDoc.
Если в PasDoc_GenHtml.pas в функции THTMLDocGenerator.ConvertString закомментарить всю обработку, то с русским языком все становится хорошо.

[Иван Шихалев]

Может быть, кто-нибудь сделает рабочую сборку? Желательно такую, чтоб не изменялась работа с нерусскими текстами. Выложим у себя и попытаемся «разбудить» авторов оригинала...

[Иван Шихалев]

Только что получил ответ от администратора проекта PasDoc — проект жив и готовится релиз Так что: если кто будет разбираться, следует качать исходники по CVS и связываться с разработчиками.

[Иван Шихалев]

В июле вышел PasDoc 0.9. С русскими кодировками проблем нет, локализация по названиям неполная.