On Fri, Feb 26, 2010 at 1:07 AM, Eduardo Felipe
<eduardofelip...@gmail.com> wrote:
> On Thu, Feb 25, 2010 at 9:08 PM, Gustavo Sverzut Barbieri
> <barbi...@profusion.mobi> wrote:
>> On Wed, Feb 24, 2010 at 2:28 AM, Eduardo Felipe
>> <eduardofelip...@gmail.com> wrote:
>>> Hi folks!
>>>
>>> Since the adding of map capabilities to Edje, it's EDC Reference
>>> documentation has been broken due to the inclusion of tags out of
>>> proper order. That can be easily verified by going to
>>> http://docs.enlightenment.org/auto/edje/edcref.html and looking at the
>>> bottom part.
>>>
>>> So, I created this patch that contains no code change and just changes
>>> the already existing documentation to be in order so Doxygen is nice
>>> and produce the desired output. I also fixed a couple of spelling
>>> errors, and some documentation error on an internal header (There's no
>>> need to confuse new devs)
>>
>> well this fails in "no code change":
>>
>>
>>  static void
>> -st_collections_group_parts_part_description_map_rotation_center(void)
>> +st_collections_group_parts_part_description_map_on(void)
>>  {
>>    Edje_Part_Collection *pc;
>>    Edje_Part *ep;
>> @@ -5805,37 +5801,24 @@
>>
>>    ed = ep->default_desc;
>>    if (ep->other_desc) ed = 
>> eina_list_data_get(eina_list_last(ep->other_desc));
>> -     {
>> -       char *name;
>> -
>> -       name = parse_str(0);
>> -       data_queue_part_lookup(pc, name, &(ed->map.rot.id_center));
>> -       free(name);
>> -     }
>> +   ed->map.on = parse_bool(0);
>>  }
>
> Unfortunately diffs do not track part moves. I changed a few functions
> around so that the documentation could be built in the correct order.
> The type of table based docs that EDC uses cares about order, so
> that's why I changed it. If you apply the patch and view under a diff
> tool you'll notice the move.
>
> Should I not change the order of the functions, then the documentation
> will be broken again as tags will appear under the wrong descriptor.
>
> What do you suggest?

2 patches, one adding/fixing the docs, another one moving.

-- 
Gustavo Sverzut Barbieri
http://profusion.mobi embedded systems
--------------------------------------
MSN: barbi...@gmail.com
Skype: gsbarbieri
Mobile: +55 (19) 9225-2202

------------------------------------------------------------------------------
Download Intel&#174; Parallel Studio Eval
Try the new software tools for yourself. Speed compiling, find bugs
proactively, and fine-tune applications for parallel performance.
See why Intel Parallel Studio got high marks during beta.
http://p.sf.net/sfu/intel-sw-dev
_______________________________________________
enlightenment-devel mailing list
enlightenment-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-devel

Reply via email to