roboforum.ru

Технический форум по робототехнике.

Энциклопедия по робототехнике - Поиск пути на карте (обсужд.)

Вопросы не попавшие в другие категории.

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение =DeaD= » 26 дек 2007, 10:38

Vooon писал(а):лучше писать комменты так, чтобы они были совместимы с doxygen'ом
да и комменты написанные для доксигена очень хороше читаются просто в коде

пример:
Код: Выделить всёРазвернуть
   /**
    * This function puts a character into the USART output queue for
    * transmission.
    *
    * \param ch character to be transmitted
    * \return ch on success, -1 on error (queue full)
    */
   int16_t putch(char ch);


Добавлено спустя 10 минут 35 секунд:
и вот пример сгенеренной документации http://roboforum.ru/doc/usart/index.html

Не скажу, что с ходу разобрался как в этой документации ориентироваться :) возможно не самый удачный пример :) и смесь русской обертки и англоязычного содержания.
Проект [[Open Robotics]] - Универсальные модули для построения роботов
Аватара пользователя
=DeaD=
 
Сообщения: 24218
Зарегистрирован: 06 окт 2004, 18:01
Откуда: Ебург
прог. языки: C++ / PHP / 1C
ФИО: Антон Ботов

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Vooon » 26 дек 2007, 11:15

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

Doxyfile:
Код: Выделить всёРазвернуть
...
OUTPUT_LANGUAGE   = Russian
...


вот более сложный пример: doc/glcd/classlcd.html
Linux user | Firefox user
Аватара пользователя
Vooon
Site Admin
 
Сообщения: 3339
Зарегистрирован: 09 фев 2006, 15:36
Откуда: Москва
Skype: vooon341
прог. языки: Python, C, Bash, JavaScript, C++, PHP
ФИО: Владимир Ермаков

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Digit » 26 дек 2007, 11:20

Чего-то я путаюсь в этой структуре документации :( Правда, я не сидел долго с целью разобраться - с налету не получилось...
злой полицейский
Аватара пользователя
Digit
 
Сообщения: 3339
Зарегистрирован: 27 ноя 2004, 00:42
Откуда: совсем Москва
ФИО: Григорий

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение =DeaD= » 26 дек 2007, 11:32

Vooon писал(а):причина в том, что это переделанная заграничная либа, я не стал переписывать их на русский.
кстати язык обертки легко меняется

Doxyfile:
Код: Выделить всёРазвернуть
...
OUTPUT_LANGUAGE   = Russian
...


вот более сложный пример: http://roboforum.ru/doc/glcd/classlcd.html

О! Вот это уже более понятно, хотя всё равно по моему перегруз левой информацией, а полезной инфы в такой документации 10-30%. Но наверное это настраивается шаблонами - что выводить, а что нет.
Проект [[Open Robotics]] - Универсальные модули для построения роботов
Аватара пользователя
=DeaD=
 
Сообщения: 24218
Зарегистрирован: 06 окт 2004, 18:01
Откуда: Ебург
прог. языки: C++ / PHP / 1C
ФИО: Антон Ботов

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Vooon » 26 дек 2007, 15:02

ну я обычно ставлю EXTRACT ALL т.е. парсер доксигена выдирает все и документированное и нет
все это естественно настраивается, поставь доксиген и посмотри doxywizard - GUI чтоб удобнее было настраивать Doxyfile
приведу скрины, кстати с этим визардом удобно смотреть какая настройка чего делает не заглядывая в документацию - всплывающие подсказки очень толковые.

вот несколько скринов:
doxywizard-main.png
doxywizard-project-tab.png
doxywizard-build-tab.png


предлагаю сами сорсы документирокать с пом. доксигена а в вике примеры применения, и в обьясняющей части делать сноски на кокументацию.
Linux user | Firefox user
Аватара пользователя
Vooon
Site Admin
 
Сообщения: 3339
Зарегистрирован: 09 фев 2006, 15:36
Откуда: Москва
Skype: vooon341
прог. языки: Python, C, Bash, JavaScript, C++, PHP
ФИО: Владимир Ермаков

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение =DeaD= » 26 дек 2007, 15:37

Vooon писал(а):поставь доксиген и посмотри doxywizard - GUI чтоб удобнее было настраивать Doxyfile

Вот в этом месте мой мозг разорвало :)

Но попробую :)
Проект [[Open Robotics]] - Универсальные модули для построения роботов
Аватара пользователя
=DeaD=
 
Сообщения: 24218
Зарегистрирован: 06 окт 2004, 18:01
Откуда: Ебург
прог. языки: C++ / PHP / 1C
ФИО: Антон Ботов

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Vooon » 26 дек 2007, 15:56

ммм, даже неверится, у меня мозг рвется когда читаю тему про зрение, а здесь вобщемто простая вещь
Doxyfile это файл настроек для консольной программы doxygen (название на подобие Makefile)

два нижних скрина это фотки режима "Эксперт", вобще достаточно воспользоваться режимом "Визард" а потом в режиме "Эксперт" переключить кодировку и язык оболочки
Linux user | Firefox user
Аватара пользователя
Vooon
Site Admin
 
Сообщения: 3339
Зарегистрирован: 09 фев 2006, 15:36
Откуда: Москва
Skype: vooon341
прог. языки: Python, C, Bash, JavaScript, C++, PHP
ФИО: Владимир Ермаков

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение =DeaD= » 26 дек 2007, 16:36

Vooon писал(а):ммм, даже неверится, у меня мозг рвется когда читаю тему про зрение, а здесь вобщемто простая вещь
Doxyfile это файл настроек для консольной программы doxygen (название на подобие Makefile)

два нижних скрина это фотки режима "Эксперт", вобще достаточно воспользоваться режимом "Визард" а потом в режиме "Эксперт" переключить кодировку и язык оболочки

Да я же просто докси-прикололся надо докси-словами в докси-тексте :ROFL:
Проект [[Open Robotics]] - Универсальные модули для построения роботов
Аватара пользователя
=DeaD=
 
Сообщения: 24218
Зарегистрирован: 06 окт 2004, 18:01
Откуда: Ебург
прог. языки: C++ / PHP / 1C
ФИО: Антон Ботов

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Vooon » 26 дек 2007, 16:38

экий ты докси-приколист :D :beer:
Linux user | Firefox user
Аватара пользователя
Vooon
Site Admin
 
Сообщения: 3339
Зарегистрирован: 09 фев 2006, 15:36
Откуда: Москва
Skype: vooon341
прог. языки: Python, C, Bash, JavaScript, C++, PHP
ФИО: Владимир Ермаков

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение =DeaD= » 26 дек 2007, 23:50

Vooon писал(а):создал svn репо: svn://roboforum.ru/public/findapath
но он пока недоступен - нужно перезапустить svnserve

Как этим можно будет пользоваться из под винды?
Проект [[Open Robotics]] - Универсальные модули для построения роботов
Аватара пользователя
=DeaD=
 
Сообщения: 24218
Зарегистрирован: 06 окт 2004, 18:01
Откуда: Ебург
прог. языки: C++ / PHP / 1C
ФИО: Антон Ботов

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Vooon » 26 дек 2007, 23:57

поставить любой приглянувшийся клиент.

я пользуюсь RapidSVN (кросплатформенная) вполне удобно :)
Linux user | Firefox user
Аватара пользователя
Vooon
Site Admin
 
Сообщения: 3339
Зарегистрирован: 09 фев 2006, 15:36
Откуда: Москва
Skype: vooon341
прог. языки: Python, C, Bash, JavaScript, C++, PHP
ФИО: Владимир Ермаков

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение =DeaD= » 27 дек 2007, 00:08

Vooon писал(а):поставить любой приглянувшийся клиент.

я пользуюсь RapidSVN (кросплатформенная) вполне удобно :)

А на каком репозитарии его можно посмотреть на робофоруме? Или подождать пока перезапустится сервис и будет findpath работать?
Проект [[Open Robotics]] - Универсальные модули для построения роботов
Аватара пользователя
=DeaD=
 
Сообщения: 24218
Зарегистрирован: 06 окт 2004, 18:01
Откуда: Ебург
прог. языки: C++ / PHP / 1C
ФИО: Антон Ботов

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Vooon » 27 дек 2007, 00:37

необязательно иметь сервер, svn и с локальными работает

правда я не пробовал, но идея вся таже, кратко:

  • создаеш папку в коорой будет лежать репозиторий (лучше путь сдклать как можно короче)
  • в консоль пишеш svnsdmin create <путь до папки>
  • для локального репо все готово, запускаеш клиент, адресс репо будет выглядеть так: file:///<путь до папки>
    например: file:///C:/svn/alpha

под вин с локальными репо не работал, может ошибка где...
вобще советую сначало посмотреть руководство, так меньше вопросов возникнет.

http://svnbook.red-bean.com/nightly/ru/svn-book.html

нестоятельно рекомендую почитать хотябы первую и вторую главы
остальное потом в процессе пазберешся
Linux user | Firefox user
Аватара пользователя
Vooon
Site Admin
 
Сообщения: 3339
Зарегистрирован: 09 фев 2006, 15:36
Откуда: Москва
Skype: vooon341
прог. языки: Python, C, Bash, JavaScript, C++, PHP
ФИО: Владимир Ермаков

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение =DeaD= » 27 дек 2007, 12:59

Vooon писал(а):http://svnbook.red-bean.com/nightly/ru/svn-book.html
нестоятельно рекомендую почитать хотябы первую и вторую главы
остальное потом в процессе пазберешся

Ничего себе "хотя бы". Чуть мозг не сломал :) Вроде всё более менее понятно, но с разрешением конфликтов - это надо пробовать :)

PS: А когда здесь хранилище запустится, чтобы в рабочем режиме опробовать это?
Проект [[Open Robotics]] - Универсальные модули для построения роботов
Аватара пользователя
=DeaD=
 
Сообщения: 24218
Зарегистрирован: 06 окт 2004, 18:01
Откуда: Ебург
прог. языки: C++ / PHP / 1C
ФИО: Антон Ботов

Re: Энциклопедия по робототехнике - Поиск пути на карте (обсужд.

Сообщение Vooon » 27 дек 2007, 13:30

как сетара поймаю онлайн, так и запустица
Linux user | Firefox user
Аватара пользователя
Vooon
Site Admin
 
Сообщения: 3339
Зарегистрирован: 09 фев 2006, 15:36
Откуда: Москва
Skype: vooon341
прог. языки: Python, C, Bash, JavaScript, C++, PHP
ФИО: Владимир Ермаков

Пред.След.

Вернуться в Обо всём

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 0

cron