diff --git a/src/bindings/mono/eina_mono/eina_promises.cs b/src/bindings/mono/eina_mono/eina_promises.cs
index 897d200cf1..a2cef0d15c 100644
--- a/src/bindings/mono/eina_mono/eina_promises.cs
+++ b/src/bindings/mono/eina_mono/eina_promises.cs
@@ -2,6 +2,7 @@ using System;
using System.Runtime.InteropServices;
using System.Collections.Generic;
using System.Linq;
+using System.ComponentModel;
using static Eina.EinaNative.PromiseNativeMethods;
@@ -12,6 +13,7 @@ namespace Eina
namespace EinaNative
{
+[EditorBrowsable(EditorBrowsableState.Never)]
static internal class PromiseNativeMethods
{
internal delegate void Promise_Cancel_Cb(IntPtr data, IntPtr dead);
@@ -71,14 +73,16 @@ static internal class PromiseNativeMethods
///
/// With a Promise you can attach futures to it, which will be used to notify of the value being available.
///
-/// Since Efl 1.23.
+/// Since Efl 1.23.
///
public class Promise : IDisposable
{
internal IntPtr Handle;
private GCHandle CleanupHandle;
- /// Delegate for functions that will be called upon a promise cancellation.
+ /// Delegate for functions that will be called upon a promise cancellation.
+ /// Since EFL 1.23.
+ ///
public delegate void CancelCb();
///
@@ -86,6 +90,7 @@ public class Promise : IDisposable
///
/// Currently, creating a promise directly uses the Main Loop scheduler the source of notifications (i.e. the
/// future callbacks will be called mainly from a loop iteration).
+ /// Since EFL 1.23.
///
public Promise(CancelCb cancelCb = null)
{
@@ -133,20 +138,26 @@ public class Promise : IDisposable
handle.Free();
}
- /// Dispose this promise, causing its cancellation if it isn't already fulfilled.
+ /// Dispose this promise, causing its cancellation if it isn't already fulfilled.
+ /// Since EFL 1.23.
+ ///
public void Dispose()
{
Dispose(true);
GC.SuppressFinalize(this);
}
- /// Finalizer to be called from the Garbage Collector.
+ /// Finalizer to be called from the Garbage Collector.
+ /// Since EFL 1.23.
+ ///
~Promise()
{
Dispose(false);
}
- /// Disposes of this wrapper, rejecting the native promise with
+ /// Disposes of this wrapper, rejecting the native promise with .
+ /// Since EFL 1.23.
+ ///
/// True if this was called from public method. False if
/// called from the C# finalizer.
protected virtual void Dispose(bool disposing)
@@ -176,7 +187,8 @@ public class Promise : IDisposable
///
/// Fulfills a promise with the given value.
///
- /// This will make all futures attached to it to be called with the given value as payload.
+ /// This will make all futures attached to it to be called with the given value as payload.
+ /// Since EFL 1.23.
///
public void Resolve(Eina.Value value)
{
@@ -193,8 +205,9 @@ public class Promise : IDisposable
///
/// Rejects a promise.
///
- /// The future chain attached to this promise will be called with an Eina.Value of type
- /// Eina.ValueType.Error and payload Eina.Error.ECANCELED.
+ /// The future chain attached to this promise will be called with an Eina.Value of type
+ /// and payload .
+ /// Since EFL 1.23.
///
public void Reject(Eina.Error reason)
{
@@ -207,17 +220,19 @@ public class Promise : IDisposable
///
/// Futures are the structures holding the callbacks to be notified of a promise fullfillment
/// or cancellation.
+/// Since EFL 1.23.
///
public class Future
{
///
/// Callback attached to a future and to be called when resolving/rejecting a promise.
///
- /// The Eina.Value as argument can come with an Eina.Error.ECANCELED as payload if the
- /// promise/future was rejected/cancelled.
+ /// The Eina.Value as argument can come with an as payload if the
+ /// promise/future was rejected/cancelled.
///
- /// The return value usually is same as the argument, forwarded, but can be changed in
- /// case were the chain act as a transforming pipeline.
+ /// The return value usually is same as the argument, forwarded, but can be changed in
+ /// case were the chain act as a transforming pipeline.
+ /// Since EFL 1.23.
///
public delegate Eina.Value ResolvedCb(Eina.Value value);
@@ -225,7 +240,9 @@ public class Future
///
/// Creates a Future from a native pointer.
+ /// Since EFL 1.23.
///
+ [EditorBrowsable(EditorBrowsableState.Never)]
public Future(IntPtr handle)
{
handle = ThenRaw(handle, (Eina.Value value) =>
@@ -239,9 +256,13 @@ public class Future
///
/// Creates a Future attached to the given Promise.
///
- /// Optionally a resolved callback may be provided. If so, it will be chained
- /// before the returned future.
+ /// Optionally a resolved callback may be provided. If so, it will be chained
+ /// before the returned future.
+ /// Since EFL 1.23.
///
+ /// The which rejection or resolution will cause
+ /// the future to trigger.
+ /// The callback to be called when the attached promise resolves.
public Future(Promise promise, ResolvedCb cb = null)
{
IntPtr intermediate = eina_future_new(promise.Handle);
@@ -268,8 +289,9 @@ public class Future
///
/// Cancels this future and the chain it belongs to, along with the promise linked against it.
///
- /// The callbacks will still be called with Eina.Error.ECANCELED as payload. The promise cancellation
- /// callback will also be called if present.
+ /// The callbacks will still be called with as payload. The promise cancellation
+ /// callback will also be called if present.
+ /// Since EFL 1.23.
///
public void Cancel()
{
@@ -280,12 +302,15 @@ public class Future
///
/// Creates a new future to be called after this one.
///
- /// Once the promise this future is attached to resolves, the callbacks on the chain
- /// are called in the order they were chained.
+ /// Once the promise this future is attached to resolves, the callbacks on the chain
+ /// are called in the order they were chained.
///
- /// CAUTION: Calling Then() on a future that had it called before will replace the previous chain
- /// from this point on.
+ /// CAUTION: Calling Then() on a future that had it called before will replace the previous chain
+ /// from this point on.
+ /// Since EFL 1.23.
///
+ /// The callback to be called when this future is resolved.
+ /// A new future in the chain after registering the callback.
public Future Then(ResolvedCb cb)
{
SanityChecks();
@@ -332,7 +357,10 @@ public class Future
///
/// It is just syntatic sugar for sequential Then() calls, without creating intermediate
/// futures explicitly.
+ /// Since EFL 1.23.
///
+ /// An enumerable with the callbacks to be chained together.
+ /// The future representing the chain.
public Future Chain(IEnumerable cbs)
{
SanityChecks();
@@ -375,6 +403,7 @@ public class Future
/// Custom marshaler to convert between managed and native .
/// Internal usage in generated code.
+[EditorBrowsable(EditorBrowsableState.Never)]
public class FutureMarshaler : ICustomMarshaler
{