On 07/26/11 17:42, Mike Blumenkrantz wrote: > 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. > +1
I went trying to find a function in that header this morning ... ugg, thought I was going to get lost without a roadmap. There has to be a better way.... dh ------------------------------------------------------------------------------ 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
