I'm in the "I like C/C++ .h files," just like I like the concept of IDL files.<div><br></div><div>I can very quickly scan through the file (just like Erlang -export areas) and see what's available and the parameters.</div>
<div>Otherwise you're either bogged down going through the code or relying on a secondary toolpass to generate documentation which then has to be hosted somewhere.</div><div><br></div><div>"What was the exact parameter list?"</div>
<div>"Hold on, let me fire up a browser to get to the file/site."</div><div>"Nevermind, I just opened up the header and I got it."</div><div><br></div><div>Headers have downsides, to be sure, but they have a very nice usage pattern for figuring out WTF this object is, what it appears to do and maybe how it plays into the overall architecture of the system.</div>
<div><br></div><div>Also, I can grep a header dir and not get slammed with a wall of implementation crap.</div><div><br></div><div>-mox</div><div><br><div class="gmail_quote">On Thu, Sep 27, 2012 at 11:50 AM, Raoul Duke <span dir="ltr"><<a href="mailto:raould@gmail.com" target="_blank">raould@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">On Thu, Sep 27, 2012 at 11:24 AM,  <<a href="mailto:freza@circlewave.net">freza@circlewave.net</a>> wrote:<br>

>> ah, yes, bring back c/++ style .h files and all their glory! ;-)<br>
> And I thought ".sig" would be recognized as obvious reference to<br>
> Standard ML... :-)<br>
<br>
</div>i missed that, since i haven't had the good fortune of using SML for<br>
nigh 20 years now, and have only rarely done anything related like<br>
ocaml or f# or whatever else. more is the pity, sucks to be me.<br>
<br>
but look at it this way: some people, when faced with the problem of<br>
having a single source file that has embedded metadata (be it user<br>
docs or type annotations or whatever), say, "i know! i'll split it<br>
into 2 files!" of course, now they are faced with /two/ problems.<br>
that's why e.g. java tried to get away from that, and the go language<br>
was invented.<br>
<br>
i'm not saying 1 vs. 2 files has a clear best answer for everybody,<br>
just that both choices have problems. in the end, this feels to me<br>
like yet another concrete example of why 99.five9s% of our development<br>
ides are stupid crap that don't really help with the real problems. we<br>
should not have to worry what files they are in or if we do/not have<br>
to see them, the ide should magically take care of all that. but<br>
that's a pipe dream of course these days.<br>
<div class="HOEnZb"><div class="h5">_______________________________________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" target="_blank">http://erlang.org/mailman/listinfo/erlang-questions</a><br>
</div></div></blockquote></div><br></div>