Source documentation/ru: Difference between revisions

From FreeCAD Documentation
(Created page with "==== Объединение с документацией Coin3D ====")
(Created page with "В unix системах, возможно связать документацию исходников Coin3D с FreeCAD-овской. Это упростит навигац...")
Line 20: Line 20:
==== Объединение с документацией Coin3D ====
==== Объединение с документацией Coin3D ====


В unix системах, возможно связать документацию исходников Coin3D с FreeCAD-овской.
On unix systems, it is possible to link Coin3D source documentation with FreeCAD's.
Это упростит навигацию и закончить диаграмму наследования для производных от Coin классов.
It allows easier navigation and complete inheritance diagrams for Coin derived classes.


* On Debian and derived systems:
* On Debian and derived systems:

Revision as of 19:03, 22 September 2014

Исходный код FreeCAD прокомментирован для автоматической генерации html документации с помощью Doxygen.

Для тех кто хочет внимательно следить за последней svn версией FreeCAD, и кто пытается взглянуть на c++ часть кода, при первом взгляде на исходники, может создасться ощущение что ты смотришь на ежа: вы не можете отличить голову от хвоста и действительно не знаете как его поймать!

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

Сборка документации исходных кодов

Если у вас установлен Doxygen, то собрать документацию очень просто. Отправляйтесь в каталог сборки FreeCADbuild, с конфигурируйте ваши исходники CMake, введя

 make DevDoc

и обратитесь к получившимся html файлам, запустив Doc/SourceDocu/html/index.html (Примечание: цель DevDoc не распространяется на сборку с помощью autotools)

По своей природе, документация искодников есть и всегда будет в стадии разработки. Не стесняйтесь пересобирать её так часто как это необходимо. Если вы наткнетесь на вопиющие недостатки, вы можете написать об этом на форум (Примечание: Это реально полностью проверялось только в процессе сборке с помощью cMake).

Как альтернатива, документация генерируется время от времени и доступна на sourceforge здесь

Объединение с документацией Coin3D

В unix системах, возможно связать документацию исходников Coin3D с FreeCAD-овской. Это упростит навигацию и закончить диаграмму наследования для производных от Coin классов.

  • On Debian and derived systems:
- Install the package libcoin60-doc
- Uncompress the file /usr/share/doc/libcoin60-doc/html/coin.tag.gz
- Regenerate source documentation
You are up for offline browsing.
  • If you don't want to or can't install Coin doc package, the links will be generated to access coin doc online at doc.coin3D.org, if doxygen tag file can be downloaded at configure time (wget).
Extra python modules
List of Commands