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