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 :)
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
