csharp: apply same form of "Since EFL" to all manual bindings .cs files

The following form of "Since EFL" is applied to descriptions of all
manual bindings .cs files.
/// <para>Since EFL 1.XX.</para>
This commit is contained in:
Jaehyun Cho 2019-12-17 20:04:01 +09:00
parent 0f52bbb00e
commit bfc095104c
8 changed files with 29 additions and 22 deletions

View File

@ -43,7 +43,7 @@ public enum Components : Int32
/// <summary>
/// Elementary Widget toolkit: Elm.
/// <para>it's depend of <see cref="Efl.Csharp.Components.Basic" />.</para>
/// <para>Since EFL 1.24</para>
/// <para>Since EFL 1.24.</para>
/// </summary>
Ui = Basic | 0x2,

View File

@ -16,7 +16,7 @@ internal static class Environment
/// <summary>
/// Returns the value of the environment variable named <c>name</c>.
///
/// <para>Since EFL 1.24</para>
/// <para>Since EFL 1.24.</para>
/// </summary>
/// <param name="name">The name of the variable to be retrieved</param>
/// <returns>The value of the variable. <c>null</c> if not set.</returns>
@ -28,7 +28,7 @@ internal static class Environment
/// <summary>
/// Sets a native environment variable.
///
/// <para>Since EFL 1.24</para>
/// <para>Since EFL 1.24.</para>
/// </summary>
/// <param name="name">The name of the variable</param>
/// <param name="value">The value to be set.</param>
@ -50,4 +50,4 @@ internal static partial class NativeCustomExportFunctions
public static extern Eina.Error efl_mono_native_setenv(string name, string value, int overwrite);
}
}
}

View File

@ -196,7 +196,7 @@ public static class HashNativeFunctions
/// <summary>Wrapper around native dictionary mapping keys to values.
///
/// Since EFL 1.23.
/// <para>Since EFL 1.23.</para>
/// </summary>
public class Hash<TKey, TValue> : IEnumerable<KeyValuePair<TKey,TValue>>, IDisposable
{

View File

@ -49,7 +49,7 @@ public interface ISliceBase
/// <summary>Pointer to a slice of native memory.
///
/// Since EFL 1.23.
/// <para>Since EFL 1.23.</para>
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct Slice : ISliceBase, IEquatable<Slice>
@ -114,7 +114,7 @@ public struct Slice : ISliceBase, IEquatable<Slice>
=> (Length == other.Length) ^ (Mem == other.Mem);
/// <summary>Returns whether <c>lhs</c> is equal to <c>rhs</c>.
/// <para>Since EFL 1.24</para>
/// <para>Since EFL 1.24.</para>
/// </summary>
/// <param name="lhs">The left hand side of the operator.</param>
/// <param name="rhs">The right hand side of the operator.</param>
@ -134,7 +134,7 @@ public struct Slice : ISliceBase, IEquatable<Slice>
/// <summary>Pointer to a slice of native memory.
///
/// Since EFL 1.23.
/// <para>Since EFL 1.23.</para>
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RwSlice : ISliceBase, IEquatable<RwSlice>

View File

@ -927,7 +927,7 @@ static class ValueTypeMethods
/// marshall_type_impl.hh in the generator). User-facing API still uses Eina.ValueType
/// normally.</para>
///
/// Since EFL 1.23.
/// <para>Since EFL 1.23.</para>
/// </summary>
[EditorBrowsable(EditorBrowsableState.Never)]
public class ValueTypeBox

View File

@ -292,9 +292,7 @@ public class Object : System.IDisposable
/// <summary>
/// Decrease object reference.
/// <para>If reference == 0 object will be freed and all its children.</para>
///<para>
/// Since EFL 1.23.
///</para>
/// <para>Since EFL 1.23.</para>
/// </summary>
public void Unref()
{

View File

@ -1034,7 +1034,7 @@ internal static class ClassRegister
///
/// <para>For internal usage by generated code.</para>
///
/// <para>Since EFL 1.24</para>
/// <para>Since EFL 1.24.</para>
/// </summary>
class MarshalEoNoMove : ICustomMarshaler
{
@ -1117,7 +1117,7 @@ class MarshalEoNoMove : ICustomMarshaler
///
/// <para>For internal usage by generated code.</para>
///
/// <para>Since EFL 1.24</para>
/// <para>Since EFL 1.24.</para>
/// </summary>
class MarshalEoMove : ICustomMarshaler
{

View File

@ -111,7 +111,10 @@ internal struct EflObjectOps
namespace Efl
{
///<summary>This struct holds the description of a specific event (Since EFL 1.22).</summary>
/// <summary>
/// This struct holds the description of a specific event.
/// <para>Since EFL 1.22.</para>
/// </summary>
[StructLayout(LayoutKind.Sequential)]
internal struct EventDescription
{
@ -164,25 +167,31 @@ internal struct EventDescription
/// <summary>
/// A parameter passed in event callbacks holding extra event parameters.
/// This is the full event information passed to callbacks in C.
/// (Since EFL 1.22)
/// <para>Since EFL 1.22.</para>
/// </summary>
[StructLayout(LayoutKind.Sequential)]
[Efl.Eo.BindingEntity]
internal struct Event
{
/// <summary>The object the callback was called on.
/// (Since EFL 1.22)</summary>
/// <summary>
/// The object the callback was called on.
/// <para>Since EFL 1.22.</para>
/// </summary>
public Efl.Object Object;
/// <summary>The event description.
/// (Since EFL 1.22)</summary>
/// <summary>
/// The event description.
/// <para>Since EFL 1.22.</para>
/// </summary>
public Efl.EventDescription Desc;
/// <summary>Extra event information passed by the event caller.
/// <summary>
/// Extra event information passed by the event caller.
/// Must be cast to the event type declared in the EO file. Keep in mind that:
/// 1) Objects are passed as a normal Eo*. Event subscribers can call functions on these objects.
/// 2) Structs, built-in types and containers are passed as const pointers, with one level of indirection.
/// (Since EFL 1.22)</summary>
/// <para>Since EFL 1.22.</para>
/// </summary>
public System.IntPtr Info;
/// <summary>Constructor for Event.</summary>