Source documentation/fr

The online source documentation is located at http://www.freecadweb.org/api/

The FreeCAD source code is commented to allow automatic html documentation generation with Doxygen. This is the case for both the C++ and Python parts of the FreeCAD source code.

For those wanting to follow closely the latest development versions of FreeCAD, and who try to have a look at the C++ or Python parts, the first insight in the sources can give the feeling you're looking at an hedgehog: you can't discriminate head from tail and don't really know how to catch it!

In complement to this Wiki, the Source Documentation can hopefully alleviate this feeling, providing an entry point, and allowing for easy browsing through the dozens of files and directories.

Build source documentation

Si vous avez installé Doxygen, il est très facile de compiler la doc. Accédez au répertoire de compilation de FreeCAD, et configurez vos sources avec CMake comme ceci :

make DevDoc 

et consultez les fichiers HTML résultants à partir de Doc/SourceDocu/html/index.html.

The DevDoc make target above will, if graphviz is installed on your system, generate a 2Gb+ volume of data. An alternative, smaller version (~500Mb), that is the version used on http://www.freecadweb.org/api/ can also be generated by issuing instead:

make WebDoc 

Par nature, le doc source est, et sera toujours, le travail en cours. N'hésitez pas à recompiler aussi souvent que nécessaire.

Si vous tombez sur des incohérences, n'hésitez pas à poster sur le forum (PS : Vérifiez bien le processus de compilation avec CMake).

As an alternative, the doc is generated from time to time and accessible on sourceforge here.

Here is another FreeCAD Doxygen documentation generate by qingfeng.xia.

Integrate Coin3D documentation

Sur les systèmes Unix, il est possible de lier les documents sources Coin3D avec FreeCAD.

Il permet une navigation plus facile dans l'arborescence des diagrammes, pour les classes Coin dérivées.

• Sur les systèmes Debian et dérivés :

- Installez le paquet libcoin60-doc.

- Décompressez le fichier /usr/share/doc/libcoin60-doc/html/coin.tag.gz.

- Régénérer le source de la documentation.

Vous êtes prêt pour la navigation hors ligne.

• Si vous ne voulez pas, ou ne pouvez pas installer Coin doc package, les liens seront générés pour accéder à Coin doc en ligne, sur doc.coin3D.org, si le fichier doxygen tag peut être téléchargé au moment de la configuration (wget).

How to integrate doxygen in to the FreeCAD source code

Example of a complete doxygen page: (from another project)

doxygen: http://www.vtk.org/doc/nightly/html/classvtkArrayCoordinates.html

source: https://github.com/Kitware/VTK/blob/master/Common/Core/vtkArrayCoordinates.h