On Fri, 22 Jul 2011, Iván Briano (Sachiel) wrote:
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.
better : lzma -9
Vincent
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
