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?


[]s

Eduardo Felipe.
>
> Please do a new patch with just documentation. The current version is
> quite confusing with things like that :-(
>
>
>
> --
> 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