On Fri, 22 Jul 2011 14:41:58 +0200 (CEST) Vincent Torri <vto...@univ-evry.fr> wrote:
> > > On Fri, 22 Jul 2011, Iván Briano (Sachiel) wrote: > > > 2011/7/22 Daniel Juyung Seo <seojuyu...@gmail.com>: > >> Right. Finish documentation first. > >> > >> Just curious, I checked Elementary.h.in. > >> It has 13298 lines now :) > >> But it'll be so much longer once genlist documentation is moved to header. > >> genlist has 82 APIs :) > >> > > > > Stop bitching about header sizes, we can always just bzip2 them and > > they'll be much smaller. > > better : lzma -9 > > Vincent better: lrzip -z > > > > >> Daniel Juyung Seo (SeoZ) > >> > >> On Wed, Jul 20, 2011 at 7:50 PM, Vincent Torri <vto...@univ-evry.fr> wrote: > >>> > >>> > >>> On Wed, 20 Jul 2011, Daniel Juyung Seo wrote: > >>> > >>>> Hi Mike, > >>>> This is why I raised elementary header separation topic. > >>>> > >>>> http://www.mail-archive.com/enlightenment-devel@lists.sourceforge.net/msg31764.html > >>>> > >>>> I found that reading a big elementary header was so painful. > >>>> But we concluded that we're gonna use one header for elementary. > >>>> So we're just following the result. > >>> > >>> maybe we should let profusion finish his doc work first > >>> > >>> Vincent > >>> > >>> > >>>> > >>>> Thanks. > >>>> Daniel Juyung Seo (SeoZ) > >>>> > >>>> On Sun, Jul 17, 2011 at 9:58 PM, Vincent Torri <vto...@univ-evry.fr> > >>>> wrote: > >>>>> > >>>>> > >>>>> On Sun, 17 Jul 2011, Carsten Haitzler (The Rasterman) wrote: > >>>>> > >>>>>> On Sat, 16 Jul 2011 09:23:45 -0400 Mike Blumenkrantz > >>>>>> <m...@zentific.com> said: > >>>>>> > >>>>>>> With the recent infusion (profusion?) of documentation, our header > >>>>>>> sizes have > >>>>>>> become, imo, WAAAAAAY too big. They are entirely impossible to > >>>>>>> navigate, and > >>>>>>> this is a problem that will only get worse. > >>>>>>> > >>>>>>> As an example, the elm .h file is over 10k lines already, and I have > >>>>>>> to scroll > >>>>>>> quite a bit to find something when I am looking for it (since all the > >>>>>>> doxygen > >>>>>>> tags break scintilla as it is...). > >>>>>>> > >>>>>>> Something must be done! Bring back the readable headers!!! > >>>>>> > >>>>>> you could just strip all comments from the headers and use them.... > >>>>>> but i thought you use geany and ctags files.. so why would you need to > >>>>>> read > >>>>>> them? > >>>>>> > >>>>>> this was hashed over. we are required to put some of the doxy docs in > >>>>>> the > >>>>>> headers anyway - enums structs, macros for example. so this means our > >>>>>> docs are > >>>>>> split between private and public files. if we put them all in public > >>>>>> headers we > >>>>>> c an generate docs from installed headers. also people have expressed a > >>>>>> desire > >>>>>> for the docs there so they can read the docs in the .h file. > >>>>> > >>>>> common users don't read .h files... They want either browsable doc, or a > >>>>> tool like devhelp (i begun such tool in 2005, in trunc/doc/api). Imho, > >>>>> it's the way to do it (you can even use such tool in your favorite code > >>>>> editor) > >>>>> > >>>>> Vincent > >>>>> > >>>>>> if u want a quick ref, this can be generated just removing all comments > >>>>>> (a bit > >>>>>> of sed work methinks could do the job). > >>>>>> > >>>>>> -- > >>>>>> ------------- Codito, ergo sum - "I code, therefore I am" > >>>>>> -------------- The Rasterman (Carsten Haitzler) ras...@rasterman.com > >>>>>> > >>>>>> > >>>>>> > >>>>>> ------------------------------------------------------------------------------ > >>>>>> AppSumo Presents a FREE Video for the SourceForge Community by Eric > >>>>>> Ries, the creator of the Lean Startup Methodology on "Lean Startup > >>>>>> Secrets Revealed." This video shows you how to validate your ideas, > >>>>>> optimize your ideas and identify your business strategy. > >>>>>> http://p.sf.net/sfu/appsumosfdev2dev > >>>>>> _______________________________________________ > >>>>>> enlightenment-devel mailing list > >>>>>> enlightenment-devel@lists.sourceforge.net > >>>>>> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > >>>>>> > >>>>>> > >>>>> > >>>>> > >>>>> ------------------------------------------------------------------------------ > >>>>> AppSumo Presents a FREE Video for the SourceForge Community by Eric > >>>>> Ries, the creator of the Lean Startup Methodology on "Lean Startup > >>>>> Secrets Revealed." This video shows you how to validate your ideas, > >>>>> optimize your ideas and identify your business strategy. > >>>>> http://p.sf.net/sfu/appsumosfdev2dev > >>>>> _______________________________________________ > >>>>> enlightenment-devel mailing list > >>>>> enlightenment-devel@lists.sourceforge.net > >>>>> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > >>>>> > >>>> > >>> > >> > >> ------------------------------------------------------------------------------ > >> 10 Tips for Better Web Security > >> Learn 10 ways to better secure your business today. Topics covered include: > >> Web security, SSL, hacker attacks & Denial of Service (DoS), private keys, > >> security Microsoft Exchange, secure Instant Messaging, and much more. > >> http://www.accelacomm.com/jaw/sfnl/114/51426210/ > >> _______________________________________________ > >> enlightenment-devel mailing list > >> enlightenment-devel@lists.sourceforge.net > >> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > >> > > > > -- Mike Blumenkrantz Zentific: Coding in binary since '10. ------------------------------------------------------------------------------ 10 Tips for Better Web Security Learn 10 ways to better secure your business today. Topics covered include: Web security, SSL, hacker attacks & Denial of Service (DoS), private keys, security Microsoft Exchange, secure Instant Messaging, and much more. http://www.accelacomm.com/jaw/sfnl/114/51426210/ _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
