JSDoc - помогите разобраться
 

Введение

Пишу для себя фреймворк. Решил прокомментировать его JSDoc'ом, так как уже начал путаться во всех этих функциях.

Единственный генератор документации, который я нашёл - JSDoc Toolkit.

Проблема 1

Он калечит русские символы, превращая их в вопросики (ну так они выглядят в FF)
Помогло перекодирование файла в UTF-8, но хотелось бы узнать, есть ли ещё варианты. Если нет, то подскажите какой-нибудь ещё генератор документации, который нормально работает с русским текстом.

Проблема 2

Структура файла примерно такая: вверху дополнительные либы (не мои), они сжаты и прокомментированы одним тегом @author (подвопрос 2.1: на какой кусок кода будет распространяться этот тег; подвопрос 2.2: эти либы нужны для кроссбраузерности, как исключить их из документирования?).
Дальше идёт мой код.
Он обвёрнут в (function(){}()). Там объявляется локальная переменная $m, которая в конце вставляется в глобальную область (window.$m = $m).
Так вот JSDoc никак не хочет её документировать.
Вопрос: какие теги нужно указать при объявлении этой переменной?

Проблема 3

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

__________________________________________________ ________________
Пока всё, но возможно со временем тут ещё будут публиковаться вопросы.

кодировку поменять не пробовал?)

C JSDocs дело иметь не приходилось, поэтому за темой буду следить с интересом :)

http://code.google.com/p/jsdoc-toolkit/wiki/TagIgnore

http://code.google.com/p/jsdoc-toolkit/wiki/TagExports

на остальные вопросы - хз. но там есть папка документации. я так JSDoc изучал

Кодировку чего? Если файла, то
Если я правильно понял, он только на 1 переменную (объект, функцию) действует, а мне нужно исключить из документирования целый кусок кода.

Думаете, что неверным поступком будет повтор тега по всему коду? Но ведь @param ведь повторяется в каждой функции, и ничего.

То есть нет способа просто исключить кусок кода из документирования?

Я на это не намекал. Я не знаю :).

Понял. Он суёт часть локальных переменных в глобальную область. Есть идеи, как исправить?