Re: [E-devel] Edje documentation patch

2010-02-26 Thread Gustavo Sverzut Barbieri
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


Re: [E-devel] Edje documentation patch

2010-02-26 Thread Eduardo Felipe
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


Re: [E-devel] Edje documentation patch

2010-02-26 Thread Eduardo Felipe
Ok. Edje has moved forward, and so did this patch.
Now it's in sync with SVN again.

Thanks!

Eduardo.

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)

 If anything is wrong, please feel free to change. It was created with r46394.

 Cheers,

 Eduardo Felipe.

--
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


Re: [E-devel] Edje documentation patch

2010-02-26 Thread Gustavo Sverzut Barbieri
On Fri, Feb 26, 2010 at 4:26 PM, Eduardo Felipe
eduardofelip...@gmail.com wrote:
 There you go. The doc_move_patch.txt must be applied over the doc_patch.txt.

all in svn! thanks!


-- 
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


Re: [E-devel] Edje documentation patch

2010-02-25 Thread Gustavo Sverzut Barbieri
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);
 }


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