Document schedule() functions in Cpp

[edwardalee]

In the packages/documentation/copy/en/reference/Target Language Reference.md file, there is a FIXME that says:

FIXME: Give a list of schedule() functions with descriptions.

Can someone add that list or point me to where to find it? The examples show schedule() and schedule_int(). Others?

[cmnrd]

There is no schedule_int in C++. If it is listed in a C++ example, the example should be fixed.

reactor-cpp provides 4 overloaded variants of schedule() defined here. All of them expect a value and a duration. The duration may be omitted and has a default of 0. The 4 overloads all accept different types for the value. These can be an immutable value pointer, a mutable value pointer, an rvalue reference or an lvalue reference. To make it even more complicated, schedule is a function template and can accept different duration types.

While we should explain how values work in C++, I don't think this is the place. I think it is best to just say that there is a single schedule function expecting a value (whatever that is) and an optional duration. We should probably link here to the target API documentations (except that these methods are not documented yet for C++...).

I hope this helps. I can also take a look at the text tomorrow.

[edwardalee]

The doc has this example:

reactor CountSelf(delay:time(100 msec)) {
    output out:int;
    logical action a:int;
    reaction(startup) -> a, out {=
        out.set(0);
        a.schedule_int(1, delay);
    =}
    reaction(a) -> a, out {=
        out.set(a.get());
        a.schedule_int(*a.get() + 1, delay);
    =}
}

which looks wrong.