[Bf-blender-cvs] SVN commit: /data/svn/bf-blender [27854] trunk/blender/source/gameengine/ PyDoc/how_to_build_win.txt: BGE API DOC: a guide on how to build epydoc for windows

Dalai Felinto dfelinto at gmail.com
Tue Mar 30 08:37:44 CEST 2010


Revision: 27854
          http://projects.blender.org/plugins/scmsvn/viewcvs.php?view=rev&root=bf-blender&revision=27854
Author:   dfelinto
Date:     2010-03-30 08:37:44 +0200 (Tue, 30 Mar 2010)

Log Message:
-----------
BGE API DOC: a guide on how to build epydoc for windows
We have already a .sh file to build epydocs from Linux, so why not to have it in Windows as well ;) I think that this guide can help people interested in help with the API documentation to test their work.

I'm actually already in touch with at least one volunteer helping with PhysicsConstraints module. VideoTexture may not be a one man job though, for I hope this document can also help.

Added Paths:
-----------
    trunk/blender/source/gameengine/PyDoc/how_to_build_win.txt

Added: trunk/blender/source/gameengine/PyDoc/how_to_build_win.txt
===================================================================
--- trunk/blender/source/gameengine/PyDoc/how_to_build_win.txt	                        (rev 0)
+++ trunk/blender/source/gameengine/PyDoc/how_to_build_win.txt	2010-03-30 06:37:44 UTC (rev 27854)
@@ -0,0 +1,16 @@
+How To Build the BGE Documentation in Windows
+-------------------------------------------------------------------------
+1) download and install Python 2.6 - http://www.python.org
+2) download and install Epydocs - http://epydoc.sourceforge.net
+
+* for the following lines we will assume that your installation of Python is in C:\Python26 and epydocs is installed in the default folder Scripts\epydoc.
+
+3) creates a epy_docgen.bat file in this folder (source\gameengine\PyDoc\) and paste the following line into it:
+
+::::::
+C:\Python26\python.exe C:\Python26\Scripts\epydoc.py --debug -v  -o BPY_GE --url "http://www.blender.org" --top API_intro  --name "Blender GameEngine" --no-private --no-sourcecode --inheritance=included  *.py  ../../../source/blender/python/api2_2x/doc/BGL.py  ../../../source/blender/python/api2_2x/doc/Mathutils.py  ../../../source/blender/python/api2_2x/doc/Geometry.py
+::::::
+
+4) run your created batch file. If everything goes well it creates a folder named BPY_GE with all the generated documentation.
+
+Documentation valid in March of 2010 - Blender 2.5alpha2
\ No newline at end of file





More information about the Bf-blender-cvs mailing list