Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-11-25 Thread Stefan Schmidt
Hello. On 24/11/16 23:33, Gustavo Sverzut Barbieri wrote: > Plus reference to events, as it will be hard to add afterwards. See all > io/net where I try to document their relation to methods Jpeg also raised this point before. Daniel is looking into this. AFAIK he was thinking about the best syn

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-11-24 Thread Gustavo Sverzut Barbieri
Plus reference to events, as it will be hard to add afterwards. See all io/net where I try to document their relation to methods Also, it would be nice to extend or replace docs for methods we implement. Clear user is "dial(address)" where I'd like to document address string encoding for each prot

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-11-24 Thread Stefan Schmidt
Hello. On 24/11/16 19:38, Felipe Magno de Almeida wrote: > On Thu, Nov 24, 2016 at 1:35 PM, Stefan Schmidt > wrote: >> Hello. > > [snip] > >> With the last batch I pushed today we have 100% doc coverage in our eo >> files! :) >> >> Now we need to keep it like this, please. :) > > Great job! > Wh

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-11-24 Thread Felipe Magno de Almeida
On Thu, Nov 24, 2016 at 1:35 PM, Stefan Schmidt wrote: > Hello. [snip] > With the last batch I pushed today we have 100% doc coverage in our eo > files! :) > > Now we need to keep it like this, please. :) Great job! Why not have Daniel add an error for functions that are not documented in Eo?

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-11-24 Thread Jérémy Zurcher
On Thursday 24 November 2016 16:35, Stefan Schmidt wrote : > Hello. > > On 25/10/16 10:15, Stefan Schmidt wrote: > > Hello. > > > > On 25/10/16 05:04, Carsten Haitzler (The Rasterman) wrote: > >> On Sat, 22 Oct 2016 00:43:30 +0200 Stefan Schmidt > >> said: > >> > >>> Hello. > >>> > >>> TL;DR: I

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-11-24 Thread Stefan Schmidt
Hello. On 25/10/16 10:15, Stefan Schmidt wrote: > Hello. > > On 25/10/16 05:04, Carsten Haitzler (The Rasterman) wrote: >> On Sat, 22 Oct 2016 00:43:30 +0200 Stefan Schmidt >> said: >> >>> Hello. >>> >>> TL;DR: If you are committing new eo files I expect them to have full >>> docs from now one.

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-25 Thread The Rasterman
On Tue, 25 Oct 2016 10:15:52 +0200 Stefan Schmidt said: > Hello. > > On 25/10/16 05:04, Carsten Haitzler (The Rasterman) wrote: > > On Sat, 22 Oct 2016 00:43:30 +0200 Stefan Schmidt > > said: > > > >> Hello. > >> > >> TL;DR: If you are committing new eo files I expect them to have full > >> doc

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-25 Thread Stefan Schmidt
Hello. On 25/10/16 05:04, Carsten Haitzler (The Rasterman) wrote: > On Sat, 22 Oct 2016 00:43:30 +0200 Stefan Schmidt > said: > >> Hello. >> >> TL;DR: If you are committing new eo files I expect them to have full >> docs from now one. Also help with the ones you are currently working on. > > thi

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-24 Thread The Rasterman
On Sat, 22 Oct 2016 00:43:30 +0200 Stefan Schmidt said: > Hello. > > TL;DR: If you are committing new eo files I expect them to have full > docs from now one. Also help with the ones you are currently working on. this is actually looking pretty decent below now in terms of progress. :) > Long

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-24 Thread Stefan Schmidt
Hello. On 24/10/16 10:27, Stefan Schmidt wrote: > Hello. > > On 24/10/16 05:15, Jean-Philippe André wrote: >> Hi Stefan, >> >> On 22 October 2016 at 07:43, Stefan Schmidt wrote: >> >> I assume gendoc.lua should be run against /share/eolian/include >> rather than the internal lib folder? > > Well,

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-24 Thread Stefan Schmidt
Hello. On 24/10/16 11:27, Jean-Philippe André wrote: > Hey Stefan, > > On 24 October 2016 at 17:27, Stefan Schmidt wrote: >> >> [...] >>> Also, I would argue that quite often an obvious parameter, getter return, >>> etc... doesn't need to be documented, so the goal shouldn't be 100% >>> coverage

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-24 Thread Jean-Philippe André
Hey Stefan, On 24 October 2016 at 17:27, Stefan Schmidt wrote: > > [...] > > Also, I would argue that quite often an obvious parameter, getter return, > > etc... doesn't need to be documented, so the goal shouldn't be 100% > > coverage :) > > I expected that someone will bring this up. :) > > Wha

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-24 Thread Stefan Schmidt
Hello. On 24/10/16 05:15, Jean-Philippe André wrote: > Hi Stefan, > > On 22 October 2016 at 07:43, Stefan Schmidt wrote: > >> Hello. >> >> TL;DR: If you are committing new eo files I expect them to have full >> docs from now one. Also help with the ones you are currently working on. >> >> Longer

Re: [E-devel] Making documentation for all elements of a eo file mandatory for new files

2016-10-23 Thread Jean-Philippe André
Hi Stefan, On 22 October 2016 at 07:43, Stefan Schmidt wrote: > Hello. > > TL;DR: If you are committing new eo files I expect them to have full > docs from now one. Also help with the ones you are currently working on. > > Longer version: > If you look at the commit log you can see that I starte