[Haskell-cafe] Getting some funny brackets in Haddock docs
Michael Orlitzky
michael at orlitzky.com
Wed Jan 10 04:08:45 UTC 2018
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
More information about the Haskell-Cafe
mailing list