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
