<div dir="ltr">An extremely common complaint about Haskell coming from other languages is the proliferation of un-Googleable operators and symbols. I would be unhappy to see these changes made, especially as the fancy brackets aren't valid code (and thus can't be Hoogled or copy/pasted). I suspect that every non-maintainer of the containers documentation would need to look these symbols up every time they consulted the documentation, as the documentation would likely be the only place they're used.<div><br></div><div>The `fromList` calls are perhaps a little noisy -- having literal syntax like Python's for maps and sets would be nice, but that's probably not going to fly given that `containers` isn't part of `base` or the Report.</div></div><div class="gmail_extra"><br clear="all"><div><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div>Matt Parsons</div></div></div></div>
<br><div class="gmail_quote">On Tue, Jan 9, 2018 at 9:08 PM, Michael Orlitzky <span dir="ltr"><<a href="mailto:michael@orlitzky.com" target="_blank">michael@orlitzky.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 01/09/2018 05:55 PM, David Feuer wrote:<br>
> The containers Haddock documentation currently represents sequences,<br>
> sets, and maps via the relevant `fromList` function. For example,<br>
> Data.Map gives the example<br>
><br>
>   findWithDefault 'x' 1 (fromList [(5,'a'), (3,'b')]) == 'x'<br>
><br>
> I find these `fromList` calls exceedingly distracting, and I think<br>
> they obscure the key ideas. Of course, I *could* just specify at the<br>
> top that the documentation assumes OverloadedLists, but I think that's<br>
> likely to be somewhat confusing, especially to beginners.<br>
<br>
</span>If you think that's confusing, just wait til you try to explain that<br>
unicode snowman means circumfix fromList.<br>
<br>
How about,<br>
<br>
  >>> let map_with_no_1 = fromList [(5,'a'), (3,'b')]<br>
  >>> let default_value = 'x'<br>
  >>> findWithDefault default_value 1 map_with_no_1 == default_value<br>
  True<br>
<div class="HOEnZb"><div class="h5">______________________________<wbr>_________________<br>
Haskell-Cafe mailing list<br>
To (un)subscribe, modify options or view archives go to:<br>
<a href="http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe" rel="noreferrer" target="_blank">http://mail.haskell.org/cgi-<wbr>bin/mailman/listinfo/haskell-<wbr>cafe</a><br>
Only members subscribed via the mailman list are allowed to post.</div></div></blockquote></div><br></div>