Simplified signatures in generated documentation

Jacob Carlborg via Digitalmars-d digitalmars-d at puremagic.com
Wed Aug 20 01:35:24 PDT 2014


On 20/08/14 09:35, bearophile wrote:

> Another possible improvement is to add popups that show the complete
> type when the mouse is over the name of a type or value.
>
> You can see that used in this F# code:
> http://tomasp.net/blog/2014/puzzling-fsharp/
>
> And in this near-Haskell code:
> http://goto.ucsd.edu/~rjhala/liquid/haskell/blog/blog/2014/08/15/a-finer-filter.lhs/

Yeah. Scala also uses simplified signatures for some of their methods 
[1]. They have a section last in the documentation for each symbol that 
can be expanded to show the full signature. This is actually where I got 
the idea. Although I haven't been able to find the source code for the 
documentation so I don't know if it's manually specified. I'm suspecting 
that because it's only available for very few methods.


[1] 
http://www.scala-lang.org/api/current/#scala.collection.immutable.HashMap filter 
on "toArray".

-- 
/Jacob Carlborg


More information about the Digitalmars-d mailing list