[Bf-committers] Help with the source code of Blender

[Campbell Barton]

Some feedback on doxy's blender.chm

* "Detailed Description" --- I've gone through and added summery
comments at the header of parts of the python api, however this text
shows up pages below include and function info, see bpy_rna.c File
Reference. if possible would be nice to show this first.

* Python scripts are indexed - would prefer they not be indexed, or
they have their own doxy files, find mixing these in to C/C++ adds
noise.

* Doxy can generate call graphs, saw these used a while ago, there
disabled for blenders docs but could be useful?

For me opening blender.chm in kchmviewer and parsing takes longer
(2-3x) then opening QtCreator and parsing, so I don't see it as being
all that useful when a dev has a well setup IDE (or can grep the
source), but could be nice if this was updated weekly or so, on a
server for people who want to look over the source without configuring
an IDE.

On Wed, Jan 18, 2012 at 6:22 PM, Nathan Letwory
<nathan at letworyinteractive.com> wrote:
> The sync run has completed during the night. For those who like compiled
> html can get http://letworyinteractive.com/blendercode/blender.chm (100MB)
>
> /Nathan
>
> On Tue, Jan 17, 2012 at 3:54 PM, Nathan Letwory <
> nathan at letworyinteractive.com> wrote:
>
>> The new doxygen docs are being mirrored to
>> http://letworyinteractive.com/blendercode . Currently 15 minutes into the
>> job, no ETA available. When done the index should say it is blender 2.61
>> and revision 43446
>>
>> /Nathan
>>
>>
>> On Tue, Jan 17, 2012 at 2:20 PM, Nathan Letwory <
>> nathan at letworyinteractive.com> wrote:
>>
>>> On Tue, Jan 17, 2012 at 8:57 AM, Campbell Barton <ideasman42 at gmail.com>wrote:
>>>
>>>> We have doxygen setup but AFAIK nobody is generating and uploading
>>>> these docs online often enough for them to be a useful resource.
>>>>
>>>>
>>> An old run is here: http://letworyinteractive.com/blendercode/
>>>
>>> I'll do a rerun and push the changes there. Doxygen run starting now.
>>> Will take some hour or so to complete, and another for me to get everything
>>> moved around.
>>>
>>> /Nathan
>>>
>>>
>>> --
>>> Nathan Letwory
>>> Letwory Interactive
>>> http://www.letworyinteractive.com
>>>
>>
>>
>>
>> --
>> Nathan Letwory
>> Letwory Interactive
>> http://www.letworyinteractive.com
>>
>
>
>
> --
> Nathan Letwory
> Letwory Interactive
> http://www.letworyinteractive.com
> _______________________________________________
> Bf-committers mailing list
> Bf-committers at blender.org
> http://lists.blender.org/mailman/listinfo/bf-committers



-- 
- Campbell