<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">I have no idea personally, only a guess but ;<div><br></div><div>All this type information in the xml files is duplicate now... the specs contain not only the function signature but also the types of the inputs.</div><div><br></div><div>Specs are relatively recent addition, so the original creation of the xml documentation files probably predate the addition of specs to erlang. It might be that <a href="http://ErlDocs.com">ErlDocs.com</a> is incapable of parsing the specs out of the source and turning that into the documentation type information.</div><div><br></div><div>The official erlang site appears to have it correct <a href="http://www.erlang.org/doc/man/lists.html#keymerge-3">http://www.erlang.org/doc/man/lists.html#keymerge-3</a> </div><div><br></div><div>So probably there is an effort to remove duplicate data from documentation xml files, reducing double updates along with the fact that the xml docs are just data, i don't believe they are machine checked for accuracy..</div><div><br></div><div>One other thing tho, why is the separate xml file preferred instead of the edoc inline notation, just to keep the two things separate and keep the code more readable? </div><div><br></div><div>Anyhow thats my guess!</div><div><br></div><div>James</div><div><br></div><div><br><div><div>On 12 Jun 2011, at 01:25, Dale Harvey wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">Hey all<br><br>I was wondering about the changes in the format documentation sources, in the last release I noticed a few function definitions changed from<span class="nt"> </span><div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC284">
<font size="1"><br>      <span class="nt"><name></span>keymember(Key, N, TupleList) -> boolean()<span class="nt"></name></span></font></div><div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC285">
<font size="1">      <span class="nt"><fsummary></span>Test for membership of a list of tuples<span class="nt"></fsummary></span></font></div><div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC286">
<font size="1">      <span class="nt"><type></span></font></div><div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC287"><font size="1">        <span class="nt"><v></span>Key = term()<span class="nt"></v></span></font></div>
<div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC288"><font size="1">        <span class="nt"><v></span>N = 1..tuple_size(Tuple)<span class="nt"></v></span></font></div>
<div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC289"><font size="1">        <span class="nt"><v></span>TupleList = [Tuple]<span class="nt"></v></span></font></div>
<div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC290"><font size="1">        <span class="nt"><v></span><span class="ni">&nbsp;</span>Tuple = tuple()<span class="nt"></v></span></font></div>
<div style="background-color: transparent; font-family: courier new,monospace;" class="line" id="LC291"><font size="1">      <span class="nt"></type></span></font></div>to<br><pre style="font-family: courier new,monospace;"><div style="background-color: transparent;" class="line" id="LC299"><font size="1">      <span class="nt"><name</span> <span class="na">name=</span><span class="s">"keymerge"</span> <span class="na">arity=</span><span class="s">"3"</span><span class="nt">/></span></font></div>
<div style="background-color: transparent;" class="line" id="LC300"><font size="1">      <span class="nt"><fsummary></span>Merge two key-sorted lists of tuples<span class="nt"></fsummary></span></font></div><div style="background-color: transparent;" class="line" id="LC301">
<font size="1">      <span class="nt"><type_desc</span> <span class="na">variable=</span><span class="s">"N"</span><span class="nt">></span>1..tuple_size(Tuple)<span class="nt"></type_desc></span></font></div>
</pre><br><a href="https://github.com/erlang/otp/blob/dev/lib/stdlib/doc/src/lists.xml#L299">https://github.com/erlang/otp/blob/dev/lib/stdlib/doc/src/lists.xml#L299</a> is the source for these changes, somehow the recent erlang documention (<a href="http://www.erlang.org/doc/man/lists.html#keymerge-3">http://www.erlang.org/doc/man/lists.html#keymerge-3</a>) shows the full parameter list information and I am quite confused at how that can be derived from the source xml.<br>
<br>I was also just curious about the reason for the change and what was planned for going forward<br><br>since <a href="http://erldocs.com/R14B03/stdlib/lists.html?i=0&search=lists%20keymerge#keymerge/3">http://erldocs.com/R14B03/stdlib/lists.html?i=0&search=lists%20keymerge#keymerge/3</a><br>
is a lot less useful than <a href="http://erldocs.com/R14B02/stdlib/lists.html?i=0&search=lists%20keymerge#keymerge/3">http://erldocs.com/R14B02/stdlib/lists.html?i=0&search=lists%20keymerge#keymerge/3</a><br><br>
Cheers, good work on the new release<br>Dale<br>
_______________________________________________<br>erlang-questions mailing list<br><a href="mailto:erlang-questions@erlang.org">erlang-questions@erlang.org</a><br>http://erlang.org/mailman/listinfo/erlang-questions<br></blockquote></div><br></div></body></html>