2011/7/26 Mike Blumenkrantz <m...@zentific.com>: > On Sun, 17 Jul 2011 21:39:50 +0900 > Carsten Haitzler (The Rasterman) <ras...@rasterman.com> 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. >> >> if u want a quick ref, this can be generated just removing all comments (a >> bit >> of sed work methinks could do the job). >> > in all seriousness, this is a problem. elm's header is approaching 20k lines > and that's really not acceptable for a header. >
wc -l /usr/include/* ... 83002 /usr/include/ppl.hh ... Granted, it's a C++ header, but maybe we can get to 40k > -- > 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
