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.

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.

Matt Parsons

On Tue, Jan 9, 2018 at 9:08 PM, Michael Orlitzky <michael@orlitzky.com> wrote:
On 01/09/2018 05:55 PM, David Feuer wrote:
> The containers Haddock documentation currently represents sequences,
> sets, and maps via the relevant `fromList` function. For example,
> Data.Map gives the example
>
>   findWithDefault 'x' 1 (fromList [(5,'a'), (3,'b')]) == 'x'
>
> I find these `fromList` calls exceedingly distracting, and I think
> they obscure the key ideas. Of course, I *could* just specify at the
> top that the documentation assumes OverloadedLists, but I think that's
> likely to be somewhat confusing, especially to beginners.

If you think that's confusing, just wait til you try to explain that
unicode snowman means circumfix fromList.

How about,

  >>> let map_with_no_1 = fromList [(5,'a'), (3,'b')]
  >>> let default_value = 'x'
  >>> findWithDefault default_value 1 map_with_no_1 == default_value
  True
_______________________________________________
Haskell-Cafe mailing list
To (un)subscribe, modify options or view archives go to:
http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe
Only members subscribed via the mailman list are allowed to post.