Document backcalls

[gkz]

Document backcalls on the site

Thanks @francescoagati for the tip in #37

[michaelficarra]

Remember to document the return-suppressing ! feature, too. I didn't know about that.

[paulmillr]

why is there four types of backcalls instead of two though (the ones with !)? Is there any example how non-suppressed return can be useful?

[satyr]

four types of backcalls instead of two

Would be eight if curried variants were supported. =D

[gkz]

@paulmillr

x <- map ..., [1 to 5]
x * 2
#=> [2,4,6,8,10]

Also good call @satyr, I need to add support for curried variants.

[josher19]

For documentation, you might consider having an optional 'docs.ls' module which documents keywords and features.

livescript> docs = require 'docs'
livescript> docs('->')
{
definition: "Operator to define a function."
details: "Arguments (in parenthesis) on the left and returned function body on right. "
syntax: ' "("ParameterList")"? "->" Block '
example: "  squareplus = (x) -> x = x + 1; x * x \n  squareplus(2) == 9"
link: 'http://gkz.github.com/LiveScript/#functions'
}

[josher19]

livescript> docs = require 'docs'
livescript> docs('<-!')
{
definition: "Suppress returns on backcalls.",
details: "Temporary variable to be assigned in callback on the left and function to call on the right. Returns undefined (void). ",
example: """
val  <-! $.ajax 'examples/helloworld.roy'
val2 <-! $.ajax 'examples/alias.roy'
console.log val + val2
""",
compilesTo: """
$.ajax('examples/helloworld.roy', function(val){
  $.ajax('examples/alias.roy', function(val2){
    console.log(val + val2);
  });
});
""",
see: ["!", "<-", "backcall", "undefined", "void"],
link: null
}

[satyr]

Would be eight if curried variants were supported

I need to add support for curried variants

Forgot there are named variants as well. Make it sixteen!

[gkz]

@satyr 16 is not enough! We should add something to signify pure functions, let's make it 32!

[gkz]

@josher19 I like your idea. Perhaps you can start a new issue with details.