Since this subject is annoying, I will also be annoying by top-posting. I like my docs in the .c files, and keep in the .h whatever is needed to be there only. If needed, doxygen even supports having docs in some other random file, but I like headers to be as small and packed as possible so the entire list of functions fits in one terminal window.
2011/7/28 Mike Blumenkrantz <m...@zentific.com>: > On Thu, 28 Jul 2011 20:22:51 +0300 > Tom Hacohen <t...@stosb.com> wrote: > >> On 28/07/11 19:42, Mike Blumenkrantz wrote: >> > This is a community project, so we can do stuff like having polls and >> > taking >> > votes right? Okay then, since there's been some disagreement with strong >> > opinions on either side we're voting on a super important issue - header >> > size. Specifically, the Elementary.h header. >> > >> > As with any serious vote, here is your ballot: >> > >> > 1) LEAVE AS-IS, CONTINUE ADDING DOCS TO Elementary.h >> > 2) SPLIT INTO WIDGET HEADERS SIMILAR TO EINA >> > 3) OTHER (Explain) >> > >> > This thread is for voting ONLY. Reply with your vote, no logical reasoning >> > required. Any discussion can continue in the recently-made thread. >> > >> > PS. I expect all active developers to vote on this, even if you do not have >> > a strong opinion. I WILL grep through the devs/ directory and email each of >> > you individually if I have to. >> >> I don't know why you guys care, it's not like you should ever open that >> header... I personally think eina's separation is a bit annoying, but I >> don't care either way. If you twist my arm and force me to choose one, I >> guess 2 makes more sense (As long as I don't have to do anything to >> support it). >> >> But can you summarize all points brought up by both camps? > no, you can read through the header threads for that. > THIS THREAD IS ONLY FOR VOTING. READ. >> >> -- >> Tom. > > > -- > Mike Blumenkrantz > Zentific: Coding in binary since '10. > > ------------------------------------------------------------------------------ > Got Input? Slashdot Needs You. > Take our quick survey online. Come on, we don't ask for help often. > Plus, you'll get a chance to win $100 to spend on ThinkGeek. > http://p.sf.net/sfu/slashdot-survey > _______________________________________________ > enlightenment-devel mailing list > enlightenment-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > ------------------------------------------------------------------------------ Got Input? Slashdot Needs You. Take our quick survey online. Come on, we don't ask for help often. Plus, you'll get a chance to win $100 to spend on ThinkGeek. http://p.sf.net/sfu/slashdot-survey _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
