Собственно вопрос: как использовать PhpDocumentor?

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

А что не понятно в официальной документации ?
http://www.phpdoc.org/docs/latest/getting-...umentation.html

ну если спросил, то наверное не понял. В документации слишком всё кратко и на инглиш 

ps
на выходе хочу получить html-код с навигацией по своему проекту.. если такое возможно конечно..


Это сообщение отредактировал(а) Gold Dragon - 19.12.2014, 08:32

Насколько я понял - это что вроде javadoc https://ru.wikipedia.org/wiki/Javadoc

Просто комментируете функции/классы/методы/файлы/и т.п. определенным образом и запускаете phpdoc
По моему все предельно ясно.

Сейчас попробую.. может это именно оно...

Всё прокомментировано, вот и хочу посмотреть что получается

Добавлено @ 13:19
:(

Это сообщение отредактировал(а) Gold Dragon - 19.12.2014, 13:20

Кое как что-то поставил, но это какой-то ужас... ошибка на ошибке. Под PHP5.3+ вообще не адаптирован
правлю пути и ошибки, но что-то их уж совсем много.. видимо легче самому написать 

Сам недавно перевел один проект на phpDoc комментарии и хотел составить документацию, перерыл множество библиотек, и... ничего, нет ни одного нормального ((

Все делают документацию только из классов, а если проект состоит из функций, а также кучки левых файлов не php, то все, тушите свет сливайте воду, адекватной навигации не составить (( а хочется то всего ничего
1) составить структуру всего проекта, просто тупо ссылки на файлы
2) входишь в файл, если он класс тогда понятно, свойства методы, а если обычный php то просто все что закомментировано показать (функции, переменные, константы)
3) список всех переменных, всех констант

вот пожалуй и все, этого уже достаточно чтобы можно было показать любому программисту и рассказать кратко откуда ноги растут, НО где же ты такой инструмент

конечно проще самому

ReflectionClass::getDocComment()
ReflectionProperty::getDocComment 
ReflectionFunctionAbstract::getDocComment 

Я ссылку к тому дал, что по моему мнению - вдохновение бралось из javadoc
А поймешь как работает первоисточник, поймешь и производные.

Aliance, спасибо за ссылки.. даже и не знал ну или не обращал внимание 

В общем нашёл Doxygen. Поставил клиента под Винду. Запустил настройки по умолчанию и.... всё офигенно получилось!!! Есть маленькие нюансы, но думаю это уже нужно делать тонкую настройку..

Добавлено через 1 минуту и 5 секунд
PS
код всегдак стараюсь комментировать полностью, по крайней мере описание функций/классов с примерами.. а вот захотел получить справку.. не тут то было   

А можно пример? Ато я только при работе с php5.6 столкнулся с нерабочестью документирования функций с переменным числом аргументов.

Я только потом нашёл что существет PhpDocumentor2, а я видимо использовал первую версию.. Но и вторую не получилось поставить :( да и  Doxygen начал выдавать какие-то ошибки. В общем ещё что-то пытался ставить. Вроде как написано, но 99% это одна и таже перепечатанная статья. Видимо автор что-то пропустил в описание думая что это само собой разумеещееся, но сказать другим про это забыл.. 
В итоге я так и не решил проблему что и как ставить и пока только документирую код... Может найдётся тот кто всё пошагово покажет в картинках да ещё и с видео 

ЗЫ
много ошибок было по типу

т.е. даже без кавычек

Хм. Я ключи в одинарных кавычках вписываю. Пока не сталкивался с этим.

Ставил просто: 

А запускаю: 

Сумасшедший, у тебя какой-нибудь WAMP или всё сам ручками ставил? У использую OpenServer

Говорит о том что у него гента