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

[Раед]

Введение

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

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

Проблема 1

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

Проблема 2

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

Проблема 3

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

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

[nerv_]

Он калечит русские символы

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

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

[melky]

2.2: эти либы нужны для кроссбраузерности, как исключить их из документирования?).

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

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

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

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

[Раед]

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

Кодировку чего? Если файла, то

Помогло перекодирование файла в UTF-8, но хотелось бы узнать, есть ли ещё варианты.

. .

. .

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

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

[melky]

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

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

[Раед]

Думаете, что неверным поступком будет повтор тега по всему коду?

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

[melky]

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

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

[Раед]

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

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