Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread The Rasterman
On Mon, 25 Oct 2010 09:31:01 -0200 Gustavo Sverzut Barbieri said: > On Mon, Oct 25, 2010 at 7:31 AM, Carsten Haitzler > wrote: > > On Mon, 25 Oct 2010 11:15:42 +0200 Cedric BAIL said: > > > >> On Mon, Oct 25, 2010 at 10:26 AM, Carsten Haitzler > >> wrote: > >> > On Mon, 25 Oct 2010 09:42:43 +0

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread Vincent Torri
On Mon, 25 Oct 2010, Gustavo Sverzut Barbieri wrote: > On Mon, Oct 25, 2010 at 7:31 AM, Carsten Haitzler > wrote: >> On Mon, 25 Oct 2010 11:15:42 +0200 Cedric BAIL said: >> >>> On Mon, Oct 25, 2010 at 10:26 AM, Carsten Haitzler >>> wrote: On Mon, 25 Oct 2010 09:42:43 +0200 Cedric BAIL

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread Gustavo Sverzut Barbieri
On Mon, Oct 25, 2010 at 7:31 AM, Carsten Haitzler wrote: > On Mon, 25 Oct 2010 11:15:42 +0200 Cedric BAIL said: > >> On Mon, Oct 25, 2010 at 10:26 AM, Carsten Haitzler >> wrote: >> > On Mon, 25 Oct 2010 09:42:43 +0200 Cedric BAIL said: >> >> > the html docs should work offline too... just bring

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread The Rasterman
On Mon, 25 Oct 2010 11:15:42 +0200 Cedric BAIL said: > On Mon, Oct 25, 2010 at 10:26 AM, Carsten Haitzler > wrote: > > On Mon, 25 Oct 2010 09:42:43 +0200 Cedric BAIL said: > >> > the html docs should work offline too... just bring up index.html in a > >> > browser. > >> > >> I actually think th

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread Cedric BAIL
On Mon, Oct 25, 2010 at 10:26 AM, Carsten Haitzler wrote: > On Mon, 25 Oct 2010 09:42:43 +0200 Cedric BAIL said: >> > the html docs should work offline too... just bring up index.html in a >> > browser. >> >> I actually think that putting in each "root" header a link to the auto >> generated doc

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread The Rasterman
On Mon, 25 Oct 2010 09:42:43 +0200 Cedric BAIL said: > > the html docs should work offline too... just bring up index.html in a > > browser. > > I actually think that putting in each "root" header a link to the auto > generated doc will help people that are looking at our API. We could > also ta

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread Cedric BAIL
On Mon, Oct 25, 2010 at 9:15 AM, Carsten Haitzler wrote: > On Mon, 25 Oct 2010 15:10:30 +0800 Brian Wang > said: > >> On Mon, Oct 25, 2010 at 2:19 PM, Carsten Haitzler >> wrote: >> > On Fri, 22 Oct 2010 07:05:09 -0200 Gustavo Sverzut Barbieri >> > said: >> > >> >> On Friday, October 22, 2010,

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread Brian Wang
On Mon, Oct 25, 2010 at 3:15 PM, Carsten Haitzler wrote: > On Mon, 25 Oct 2010 15:10:30 +0800 Brian Wang > said: > >> On Mon, Oct 25, 2010 at 2:19 PM, Carsten Haitzler >> wrote: >> > On Fri, 22 Oct 2010 07:05:09 -0200 Gustavo Sverzut Barbieri >> > said: >> > >> >> On Friday, October 22, 2010,

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread The Rasterman
On Mon, 25 Oct 2010 15:10:30 +0800 Brian Wang said: > On Mon, Oct 25, 2010 at 2:19 PM, Carsten Haitzler > wrote: > > On Fri, 22 Oct 2010 07:05:09 -0200 Gustavo Sverzut Barbieri > > said: > > > >> On Friday, October 22, 2010, Cedric BAIL wrote: > >> > On Fri, Oct 22, 2010 at 7:22 AM, Carsten Ha

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-25 Thread Brian Wang
On Mon, Oct 25, 2010 at 2:19 PM, Carsten Haitzler wrote: > On Fri, 22 Oct 2010 07:05:09 -0200 Gustavo Sverzut Barbieri > said: > >> On Friday, October 22, 2010, Cedric BAIL wrote: >> > On Fri, Oct 22, 2010 at 7:22 AM, Carsten Haitzler >> > wrote: >> >> ok as a general thing. this isn't any api

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-24 Thread The Rasterman
On Mon, 25 Oct 2010 08:28:58 +0200 (CEST) Vincent Torri said: > > > On Mon, 25 Oct 2010, Carsten Haitzler (The Rasterman) wrote: > > > On Fri, 22 Oct 2010 07:05:09 -0200 Gustavo Sverzut Barbieri > > said: > > > >> On Friday, October 22, 2010, Cedric BAIL wrote: > >>> On Fri, Oct 22, 2010 at

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-24 Thread Vincent Torri
On Mon, 25 Oct 2010, Carsten Haitzler (The Rasterman) wrote: > On Fri, 22 Oct 2010 07:05:09 -0200 Gustavo Sverzut Barbieri > said: > >> On Friday, October 22, 2010, Cedric BAIL wrote: >>> On Fri, Oct 22, 2010 at 7:22 AM, Carsten Haitzler >>> wrote: ok as a general thing. this isn't any a

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-24 Thread The Rasterman
On Fri, 22 Oct 2010 07:05:09 -0200 Gustavo Sverzut Barbieri said: > On Friday, October 22, 2010, Cedric BAIL wrote: > > On Fri, Oct 22, 2010 at 7:22 AM, Carsten Haitzler > > wrote: > >> ok as a general thing. this isn't any api break. > >> > >> doxyegen doc comments. should they go in .c files

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-24 Thread The Rasterman
On Fri, 22 Oct 2010 08:43:17 -0400 Mike Blumenkrantz said: > On Fri, 22 Oct 2010 10:28:40 -0200 > Lucas De Marchi wrote: > > > On Fri, Oct 22, 2010 at 7:05 AM, Gustavo Sverzut Barbieri > > wrote: > > > On Friday, October 22, 2010, Cedric BAIL wrote: > > >> On Fri, Oct 22, 2010 at 7:22 AM, Car

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-22 Thread Mike Blumenkrantz
On Fri, 22 Oct 2010 10:28:40 -0200 Lucas De Marchi wrote: > On Fri, Oct 22, 2010 at 7:05 AM, Gustavo Sverzut Barbieri > wrote: > > On Friday, October 22, 2010, Cedric BAIL wrote: > >> On Fri, Oct 22, 2010 at 7:22 AM, Carsten Haitzler > >> wrote: > >>> ok as a general thing. this isn't any api

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-22 Thread Lucas De Marchi
On Fri, Oct 22, 2010 at 7:05 AM, Gustavo Sverzut Barbieri wrote: > On Friday, October 22, 2010, Cedric BAIL wrote: >> On Fri, Oct 22, 2010 at 7:22 AM, Carsten Haitzler >> wrote: >>> ok as a general thing. this isn't any api break. >>> >>> doxyegen doc comments. should they go in .c files or in

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-22 Thread Gustavo Sverzut Barbieri
On Friday, October 22, 2010, Cedric BAIL wrote: > On Fri, Oct 22, 2010 at 7:22 AM, Carsten Haitzler > wrote: >> ok as a general thing. this isn't any api break. >> >> doxyegen doc comments. should they go in .c files or in .h files? good >> question. eet has it all in Eet.h. the rest of efl has

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-22 Thread Cedric BAIL
On Fri, Oct 22, 2010 at 7:22 AM, Carsten Haitzler wrote: > ok as a general thing. this isn't any api break. > > doxyegen doc comments. should they go in .c files or in .h files? good > question. eet has it all in Eet.h. the rest of efl has it in .c files. a good > case has been made for it being i

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-21 Thread The Rasterman
On Fri, 22 Oct 2010 07:31:48 +0200 (CEST) Vincent Torri said: > > > On Fri, 22 Oct 2010, Carsten Haitzler (The Rasterman) wrote: > > > ok as a general thing. this isn't any api break. > > > > doxyegen doc comments. should they go in .c files or in .h files? good > > question. eet has it all in

Re: [E-devel] efl documentation (for 1.0.0)

2010-10-21 Thread Vincent Torri
On Fri, 22 Oct 2010, Carsten Haitzler (The Rasterman) wrote: > ok as a general thing. this isn't any api break. > > doxyegen doc comments. should they go in .c files or in .h files? good > question. eet has it all in Eet.h. the rest of efl has it in .c files. a good > case has been made for it b

[E-devel] efl documentation (for 1.0.0)

2010-10-21 Thread The Rasterman
ok as a general thing. this isn't any api break. doxyegen doc comments. should they go in .c files or in .h files? good question. eet has it all in Eet.h. the rest of efl has it in .c files. a good case has been made for it being in .h files instead of .c - that developers actually do read the .h