redsnow 0.2.0 → 0.2.1

data/ext/snowcrash/src/BlueprintUtility.h

@@ -60,12 +60,14 @@ namespace snowcrash {
             
             // Resolve left content type
             Collection<Header>::const_iterator header;
+
             header = std::find_if(left.headers.begin(),
                                   left.headers.end(),
                                   std::bind2nd(MatchFirstWith<Header, std::string>(),
                                                HTTPHeaderName::ContentType));
 
             std::string leftContentType;
+
             if (header != left.headers.end())
                 leftContentType = header->second;
             
@@ -76,6 +78,7 @@ namespace snowcrash {
                                                HTTPHeaderName::ContentType));
 
             std::string rightContentType;
+
             if (header != right.headers.end())
                 rightContentType = header->second;
             
@@ -97,30 +100,6 @@ namespace snowcrash {
             return first.method == second.method;
         }
     };
-    
-    /**
-     *  \brief  Find a request within given action.
-     *  \param  transaction  A transaction to check.
-     *  \param  request A request to look for.
-     *  \return Iterator pointing to the matching request within given method requests.
-     */
-    inline Collection<Request>::const_iterator FindRequest(const TransactionExample& example, const Request& request) {
-        return std::find_if(example.requests.begin(),
-                            example.requests.end(),
-                            std::bind2nd(MatchPayload(), request));
-    }
-
-    /**
-     *  \brief  Find a response within responses of a given action.
-     *  \param  transaction  A transaction to check.
-     *  \param  response A response to look for.
-     *  \return Iterator pointing to the matching response within given method requests.
-     */
-    inline Collection<Response>::const_iterator FindResponse(const TransactionExample& example, const Response& response) {
-        return std::find_if(example.responses.begin(),
-                            example.responses.end(),
-                            std::bind2nd(MatchPayload(), response));
-    }
 }
 
 #endif

data/ext/snowcrash/src/CBlueprint.cc

@@ -10,7 +10,6 @@
 #include "CBlueprint.h"
 #include "snowcrash.h"
 
-
 SC_API sc_blueprint_t* sc_blueprint_new()
 {
     return AS_TYPE(sc_blueprint_t, ::new snowcrash::Blueprint);
@@ -52,7 +51,7 @@ SC_API const sc_metadata_collection_t* sc_metadata_collection_handle(const sc_bl
 
 SC_API size_t sc_metadata_collection_size(const sc_metadata_collection_t* metadata)
 {
-    const snowcrash::Collection<snowcrash::Metadata>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Metadata>::type, metadata);
+    const snowcrash::MetadataCollection* p = AS_CTYPE(snowcrash::MetadataCollection, metadata);
     if (!p)
         return 0;
 
@@ -63,7 +62,7 @@ SC_API size_t sc_metadata_collection_size(const sc_metadata_collection_t* metada
 
 SC_API const sc_metadata_t* sc_metadata_handle(const sc_metadata_collection_t* metadata_col, size_t index)
 {
-    const snowcrash::Collection<snowcrash::Metadata>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Metadata>::type, metadata_col);
+    const snowcrash::MetadataCollection* p = AS_CTYPE(snowcrash::MetadataCollection, metadata_col);
     if (!p)
         return NULL;
 
@@ -90,18 +89,18 @@ SC_API const char* sc_metadata_value(const sc_metadata_t* metadata)
 
 /*----------------------------------------------------------------------*/
 
-SC_API const sc_resource_groups_collection_t* sc_resource_groups_collection_handle(const sc_blueprint_t* blueprint)
+SC_API const sc_resource_group_collection_t* sc_resource_group_collection_handle(const sc_blueprint_t* blueprint)
 {
     const snowcrash::Blueprint* p = AS_CTYPE(snowcrash::Blueprint, blueprint);
     if (!p)
         return NULL;
 
-    return AS_CTYPE(sc_resource_groups_collection_t, &p->resourceGroups);
+    return AS_CTYPE(sc_resource_group_collection_t, &p->resourceGroups);
 }
 
-SC_API size_t sc_resource_groups_collection_size(const sc_resource_groups_collection_t* resource)
+SC_API size_t sc_resource_group_collection_size(const sc_resource_group_collection_t* resource)
 {
-    const snowcrash::Collection<snowcrash::ResourceGroup>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::ResourceGroup>::type, resource);
+    const snowcrash::ResourceGroups* p = AS_CTYPE(snowcrash::ResourceGroups, resource);
     if (!p)
         return 0;
 
@@ -110,16 +109,16 @@ SC_API size_t sc_resource_groups_collection_size(const sc_resource_groups_collec
 
 /*----------------------------------------------------------------------*/
 
-SC_API const sc_resource_groups_t* sc_resource_groups_handle(const sc_resource_groups_collection_t* resource, size_t index)
+SC_API const sc_resource_group_t* sc_resource_group_handle(const sc_resource_group_collection_t* resource, size_t index)
 {
-    const snowcrash::Collection<snowcrash::ResourceGroup>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::ResourceGroup>::type, resource);
+    const snowcrash::ResourceGroups* p = AS_CTYPE(snowcrash::ResourceGroups, resource);
     if (!p)
         return NULL;
 
-    return AS_CTYPE(sc_resource_groups_t, &p->at(index));
+    return AS_CTYPE(sc_resource_group_t, &p->at(index));
 }
 
-SC_API const char* sc_resource_groups_name(const sc_resource_groups_t* handle)
+SC_API const char* sc_resource_group_name(const sc_resource_group_t* handle)
 {
     const snowcrash::ResourceGroup* p = AS_CTYPE(snowcrash::ResourceGroup, handle);
     if(!p)
@@ -128,7 +127,7 @@ SC_API const char* sc_resource_groups_name(const sc_resource_groups_t* handle)
     return p->name.c_str();
 }
 
-SC_API const char* sc_resource_groups_description(const sc_resource_groups_t* handle)
+SC_API const char* sc_resource_group_description(const sc_resource_group_t* handle)
 {
     const snowcrash::ResourceGroup* p = AS_CTYPE(snowcrash::ResourceGroup, handle);
     if(!p)
@@ -139,7 +138,7 @@ SC_API const char* sc_resource_groups_description(const sc_resource_groups_t* ha
 
 /*----------------------------------------------------------------------*/
 
-SC_API const sc_resource_collection_t* sc_resource_collection_handle(const sc_resource_groups_t* handle)
+SC_API const sc_resource_collection_t* sc_resource_collection_handle(const sc_resource_group_t* handle)
 {
     const snowcrash::ResourceGroup* p = AS_CTYPE(snowcrash::ResourceGroup, handle);
     if (!p)
@@ -150,7 +149,7 @@ SC_API const sc_resource_collection_t* sc_resource_collection_handle(const sc_re
 
 SC_API size_t sc_resource_collection_size(const sc_resource_collection_t* resource)
 {
-    const snowcrash::Collection<snowcrash::Resource>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Resource>::type, resource);
+    const snowcrash::Resources* p = AS_CTYPE(snowcrash::Resources, resource);
     if (!p)
         return 0;
 
@@ -161,7 +160,7 @@ SC_API size_t sc_resource_collection_size(const sc_resource_collection_t* resour
 
 SC_API const sc_resource_t* sc_resource_handle(const sc_resource_collection_t* resource, size_t index)
 {
-    const snowcrash::Collection<snowcrash::Resource>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Resource>::type, resource);
+    const snowcrash::Resources* p = AS_CTYPE(snowcrash::Resources, resource);
     if (!p)
         return NULL;
 
@@ -230,7 +229,7 @@ SC_API const sc_payload_t* sc_payload_handle(const sc_payload_collection_t* hand
 {
     const snowcrash::Collection<snowcrash::Payload>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Payload>::type, handle);
     if(!p)
-        return 0;
+        return NULL;
 
     return AS_CTYPE(sc_payload_t, &p->at(index));
 }
@@ -253,6 +252,16 @@ SC_API const char* sc_payload_name(const sc_payload_t* handle)
     return p->name.c_str();
 }
 
+/** TODO: Need to change this to use the "Reference" data structure */
+SC_API const char* sc_payload_symbol(const sc_payload_t* handle)
+{
+    const snowcrash::Payload* p = AS_CTYPE(snowcrash::Payload, handle);
+    if (!p)
+        return "";
+
+    return p->symbol.c_str();
+}
+
 SC_API const char* sc_payload_description(const sc_payload_t* handle)
 {
     const snowcrash::Payload* p = AS_CTYPE(snowcrash::Payload, handle);
@@ -311,7 +320,7 @@ SC_API const sc_parameter_collection_t* sc_parameter_collection_handle_action(co
 
 SC_API size_t sc_parameter_collection_size(const sc_parameter_collection_t* handle)
 {
-    const snowcrash::Collection<snowcrash::Parameter>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Parameter>::type, handle);
+    const snowcrash::Parameters* p = AS_CTYPE(snowcrash::Parameters, handle);
     if(!p)
         return 0;
 
@@ -322,9 +331,9 @@ SC_API size_t sc_parameter_collection_size(const sc_parameter_collection_t* hand
 
 SC_API const sc_parameter_t* sc_parameter_handle(const sc_parameter_collection_t* handle, size_t index)
 {
-    const snowcrash::Collection<snowcrash::Parameter>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Parameter>::type, handle);
+    const snowcrash::Parameters* p = AS_CTYPE(snowcrash::Parameters, handle);
     if(!p)
-        return 0;
+        return NULL;
 
     return AS_CTYPE(sc_parameter_t, &p->at(index));
 }
@@ -396,7 +405,7 @@ SC_API const sc_value_collection_t* sc_value_collection_handle(const sc_paramete
 
 SC_API size_t sc_value_collection_size(const sc_value_collection_t* handle)
 {
-    const snowcrash::Collection<snowcrash::Value>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Value>::type, handle);
+    const snowcrash::Values* p = AS_CTYPE(snowcrash::Values, handle);
     if (!p)
         return 0;
 
@@ -407,14 +416,14 @@ SC_API size_t sc_value_collection_size(const sc_value_collection_t* handle)
 
 SC_API const sc_value_t* sc_value_handle(const sc_value_collection_t* handle, size_t index)
 {
-    const snowcrash::Collection<snowcrash::Value>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Value>::type, handle);
+    const snowcrash::Values* p = AS_CTYPE(snowcrash::Values, handle);
     if (!p)
         return NULL;
 
-    return AS_CTYPE( sc_value_t, &p->at(index));
+    return AS_CTYPE(sc_value_t, &p->at(index));
 }
 
-SC_API const char* sc_value_string(const sc_value_t* handle)
+SC_API const char* sc_value(const sc_value_t* handle)
 {
     const snowcrash::Value* p = AS_CTYPE(snowcrash::Value, handle);
     if(!p)
@@ -454,7 +463,7 @@ SC_API const sc_header_collection_t* sc_header_collection_handle_action(const sc
 
 SC_API size_t sc_header_collection_size(const sc_header_collection_t* handle)
 {
-    const snowcrash::Collection<snowcrash::Header>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Header>::type, handle);
+    const snowcrash::Headers* p = AS_CTYPE(snowcrash::Headers, handle);
     if (!p)
         return 0;
 
@@ -465,7 +474,7 @@ SC_API size_t sc_header_collection_size(const sc_header_collection_t* handle)
 
 SC_API const sc_header_t* sc_header_handle(const sc_header_collection_t* handle, size_t index)
 {
-    const snowcrash::Collection<snowcrash::Header>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Header>::type, handle);
+    const snowcrash::Headers* p = AS_CTYPE(snowcrash::Headers, handle);
     if (!p)
         return NULL;
 
@@ -503,7 +512,7 @@ SC_API const sc_action_collection_t* sc_action_collection_handle(const sc_resour
 
 SC_API size_t sc_action_collection_size(const sc_action_collection_t* handle)
 {
-    const snowcrash::Collection<snowcrash::Action>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Action>::type, handle);
+    const snowcrash::Actions* p = AS_CTYPE(snowcrash::Actions, handle);
     if (!p)
         return 0;
 
@@ -514,9 +523,9 @@ SC_API size_t sc_action_collection_size(const sc_action_collection_t* handle)
 
 SC_API const sc_action_t* sc_action_handle(const sc_action_collection_t* handle, size_t index)
 {
-    const snowcrash::Collection<snowcrash::Action>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::Action>::type, handle);
+    const snowcrash::Actions* p = AS_CTYPE(snowcrash::Actions, handle);
     if(!p)
-        return 0;
+        return NULL;
 
     return AS_CTYPE(sc_action_t, &p->at(index));
 }
@@ -561,7 +570,7 @@ SC_API const sc_transaction_example_collection_t* sc_transaction_example_collect
 
 SC_API size_t sc_transaction_example_collection_size(const sc_transaction_example_collection_t* handle)
 {
-    const snowcrash::Collection<snowcrash::TransactionExample>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::TransactionExample>::type, handle);
+    const snowcrash::TransactionExamples* p = AS_CTYPE(snowcrash::TransactionExamples, handle);
     if (!p)
         return 0;
 
@@ -572,9 +581,9 @@ SC_API size_t sc_transaction_example_collection_size(const sc_transaction_exampl
 
 SC_API const sc_transaction_example_t* sc_transaction_example_handle(const sc_transaction_example_collection_t* handle, size_t index)
 {
-    const snowcrash::Collection<snowcrash::TransactionExample>::type* p = AS_CTYPE(snowcrash::Collection<snowcrash::TransactionExample>::type, handle);
+    const snowcrash::TransactionExamples* p = AS_CTYPE(snowcrash::TransactionExamples, handle);
     if(!p)
-        return 0;
+        return NULL;
 
     return AS_CTYPE(sc_transaction_example_t, &p->at(index));
 }

data/ext/snowcrash/src/CBlueprint.h

@@ -23,7 +23,8 @@ extern "C" {
     /** brief Blueprint Parser Options Enums */
     enum sc_blueprint_parser_option {
         SC_RENDER_DESCRIPTIONS_OPTION = (1 << 0),       /// < Render Markdown in description.
-        SC_REQUIRE_BLUEPRINT_NAME_OPTION = (1 << 1)     /// < Treat missing blueprint name as error
+        SC_REQUIRE_BLUEPRINT_NAME_OPTION = (1 << 1),    /// < Treat missing blueprint name as error
+        SC_EXPORT_SORUCEMAP_OPTION = (1 << 2)           /// < Export source maps AST
     };
 
     /** Parameter Use flag */
@@ -45,19 +46,19 @@ extern "C" {
     struct sc_metadata_s;
     typedef struct sc_metadata_s sc_metadata_t;
 
-    /** Array Resource Groups wrapper */
-    struct sc_resource_groups_collection_s;
-    typedef struct sc_resource_groups_collection_s sc_resource_groups_collection_t;
+    /** Array Resource Group Collection wrapper */
+    struct sc_resource_group_collection_s;
+    typedef struct sc_resource_group_collection_s sc_resource_group_collection_t;
 
     /** Class Resource Group wrapper */
-    struct sc_resource_groups_s;
-    typedef struct sc_resource_groups_s sc_resource_groups_t;
+    struct sc_resource_group_s;
+    typedef struct sc_resource_group_s sc_resource_group_t;
 
-    /** Array Resources Collection wrapper */
+    /** Array Resource Collection wrapper */
     struct sc_resource_collection_s;
     typedef struct sc_resource_collection_s sc_resource_collection_t;
 
-    /** Class Resources wrapper */
+    /** Class Resource wrapper */
     struct sc_resource_s;
     typedef struct sc_resource_s sc_resource_t;
 
@@ -97,14 +98,6 @@ extern "C" {
     struct sc_value_s;
     typedef struct sc_value_s sc_value_t;
 
-    /** Array Header wrapper */
-    struct sc_header_collection_s;
-    typedef struct sc_header_collection_s sc_header_collection_t;
-
-    /** class Header wrapper */
-    struct sc_header_s;
-    typedef struct sc_header_s sc_header_t;
-
     /** Array Action wrapper */
     struct sc_action_collection_s;
     typedef struct sc_action_collection_s sc_action_collection_t;
@@ -123,10 +116,10 @@ extern "C" {
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns pointer to allocated Blueprint*/
+    /** \returns pointer to allocated Blueprint */
     SC_API sc_blueprint_t* sc_blueprint_new();
 
-    /** \deallocate Blueprint from pointer*/
+    /** \deallocate Blueprint from pointer */
     SC_API void sc_blueprint_free(sc_blueprint_t* blueprint);
 
     /** \returns Blueprint name */
@@ -137,7 +130,7 @@ extern "C" {
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Metadata Handle */
+    /** \returns Metadata array handle */
     SC_API const sc_metadata_collection_t* sc_metadata_collection_handle(const sc_blueprint_t* blueprint);
 
     /** \returns size of Metadata array */
@@ -156,34 +149,34 @@ extern "C" {
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Resource Groups Array Handle */
-    SC_API const sc_resource_groups_collection_t* sc_resource_groups_collection_handle(const sc_blueprint_t* blueprint);
+    /** \returns Resource Group Collection array handle */
+    SC_API const sc_resource_group_collection_t* sc_resource_group_collection_handle(const sc_blueprint_t* blueprint);
 
-    /** \returns size of Resource Groups array */
-    SC_API size_t sc_resource_groups_collection_size(const sc_resource_groups_collection_t* resource);
+    /** \returns size of Resource Group Collection array */
+    SC_API size_t sc_resource_group_collection_size(const sc_resource_group_collection_t* resource);
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Resource Groups Handle */
-    SC_API const sc_resource_groups_t* sc_resource_groups_handle(const sc_resource_groups_collection_t* resource, size_t index);
+    /** \returns Resource Group handle */
+    SC_API const sc_resource_group_t* sc_resource_group_handle(const sc_resource_group_collection_t* resource, size_t index);
 
-    /** \returns Resource Groups name */
-    SC_API const char* sc_resource_groups_name(const sc_resource_groups_t* handle);
+    /** \returns Resource Group name */
+    SC_API const char* sc_resource_group_name(const sc_resource_group_t* handle);
 
-    /** \returns Resource Groups Description */
-    SC_API const char* sc_resource_groups_description(const sc_resource_groups_t* handle);
+    /** \returns Resource Group description */
+    SC_API const char* sc_resource_group_description(const sc_resource_group_t* handle);
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Resource Array Handle */
-    SC_API const sc_resource_collection_t* sc_resource_collection_handle(const sc_resource_groups_t* handle);
+    /** \returns Resource array handle */
+    SC_API const sc_resource_collection_t* sc_resource_collection_handle(const sc_resource_group_t* handle);
 
-    /** \returns Resource array size*/
+    /** \returns Resource array size */
     SC_API size_t sc_resource_collection_size(const sc_resource_collection_t* resource);
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Resource Handle */
+    /** \returns Resource handle */
     SC_API const sc_resource_t* sc_resource_handle(const sc_resource_collection_t* resource, size_t index);
 
     /** \returns Resource URITemplate */
@@ -197,26 +190,29 @@ extern "C" {
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Payload Collection handle from TransactionExample for requests*/
+    /** \returns Payload Collection array handle from TransactionExample for requests*/
     SC_API const sc_payload_collection_t* sc_payload_collection_handle_requests(const sc_transaction_example_t* handle);
 
-    /** \returns Payload Collection handle from TransactionExample for responses*/
+    /** \returns Payload Collection array handle from TransactionExample for responses*/
     SC_API const sc_payload_collection_t* sc_payload_collection_handle_responses(const sc_transaction_example_t* handle);
 
-    /** \returns Payload Collection size */
+    /** \returns Payload Collection array size */
     SC_API size_t sc_payload_collection_size(const sc_payload_collection_t* handle);
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Payload at `index` Handle*/
+    /** \returns Payload at `index` handle */
     SC_API const sc_payload_t* sc_payload_handle(const sc_payload_collection_t* handle, size_t index);
 
-    /** \returns Payload Handle from resource*/
+    /** \returns Payload handle from resource */
     SC_API const sc_payload_t* sc_payload_handle_resource(const sc_resource_t* handle);
 
     /** \returns Payload name */
     SC_API const char* sc_payload_name(const sc_payload_t* handle);
 
+    /** \returns Payload symbol name */
+    SC_API const char* sc_payload_symbol(const sc_payload_t* handle);
+
     /** \returns Payload description */
     SC_API const char* sc_payload_description(const sc_payload_t* handle);
 
@@ -228,13 +224,13 @@ extern "C" {
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Parameter Collection handle from Payload*/
+    /** \returns Parameter Collection handle from Payload */
     SC_API const sc_parameter_collection_t* sc_parameter_collection_handle_payload(const sc_payload_t* handle);
 
-    /** \returns Parameter Collection handle from Resource*/
+    /** \returns Parameter Collection handle from Resource */
     SC_API const sc_parameter_collection_t* sc_parameter_collection_handle_resource(const sc_resource_t* handle);
 
-    /** \returns Parameter Collection handle from Action*/
+    /** \returns Parameter Collection handle from Action */
     SC_API const sc_parameter_collection_t* sc_parameter_collection_handle_action(const sc_action_t* handle);
 
     /** \returns Parameter Collection size */
@@ -251,24 +247,24 @@ extern "C" {
     /** \returns Parameter description */
     SC_API const char* sc_parameter_description(const sc_parameter_t* handle);
 
-    /** \returns Parameter Type */
+    /** \returns Parameter type */
     SC_API const char* sc_parameter_type(const sc_parameter_t* handle);
 
-    /** \returns Parameter Parameter Use */
+    /** \returns Parameter use */
     SC_API sc_parameter_use sc_parameter_parameter_use(const sc_parameter_t* handle);
 
-    /** \returns Parameter Default Value */
+    /** \returns Parameter default value */
     SC_API const char* sc_parameter_default_value(const sc_parameter_t* handle);
 
-    /** \returns Parameter Example Value */
+    /** \returns Parameter example value */
     SC_API const char* sc_parameter_example_value(const sc_parameter_t* handle);
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Value Collection handle */
+    /** \returns Value Collection array handle */
     SC_API const sc_value_collection_t* sc_value_collection_handle(const sc_parameter_t* handle);
 
-    /** \returns Value Collection size */
+    /** \returns Value Collection array size */
     SC_API size_t sc_value_collection_size(const sc_value_collection_t* handle);
 
     /*----------------------------------------------------------------------*/
@@ -277,20 +273,20 @@ extern "C" {
     SC_API const sc_value_t* sc_value_handle(const sc_value_collection_t* handle, size_t index);
 
     /** \returns Value string */
-    SC_API const char* sc_value_string(const sc_value_t* handle);
+    SC_API const char* sc_value(const sc_value_t* handle);
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Header Collection handle from Payload*/
+    /** \returns Header Collection array handle from Payload */
     SC_API const sc_header_collection_t* sc_header_collection_handle_payload(const sc_payload_t* handle);
 
-    /** \returns Header Collection handle from Resource*/
+    /** \returns Header Collection array handle from Resource */
     SC_API const sc_header_collection_t* sc_header_collection_handle_resource(const sc_resource_t* handle);
 
-    /** \returns Header Collection handle from Action*/
+    /** \returns Header Collection array handle from Action */
     SC_API const sc_header_collection_t* sc_header_collection_handle_action(const sc_action_t* handle);
 
-    /** \returns Header Collection size */
+    /** \returns Header Collection array size */
     SC_API size_t sc_header_collection_size(const sc_header_collection_t* handle);
 
     /*----------------------------------------------------------------------*/
@@ -306,10 +302,10 @@ extern "C" {
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Action Collection handle */
+    /** \returns Action Collection array handle */
     SC_API const sc_action_collection_t* sc_action_collection_handle(const sc_resource_t* handle);
 
-    /** \returns Action Collection size */
+    /** \returns Action Collection array size */
     SC_API size_t sc_action_collection_size(const sc_action_collection_t* handle);
 
     /*----------------------------------------------------------------------*/
@@ -323,15 +319,15 @@ extern "C" {
     /** \returns Action name */
     SC_API const char* sc_action_name(const sc_action_t* handle);
 
-    /** \returns Action Description */
+    /** \returns Action description */
     SC_API const char* sc_action_description(const sc_action_t* handle);
 
     /*----------------------------------------------------------------------*/
 
-    /** \returns Transaction Example Collection handle */
+    /** \returns Transaction Example Collection array handle */
     SC_API const sc_transaction_example_collection_t* sc_transaction_example_collection_handle(const sc_action_t* handle);
 
-    /** \returns Transaction Example Collection size */
+    /** \returns Transaction Example Collection array size */
     SC_API size_t sc_transaction_example_collection_size(const sc_transaction_example_collection_t* handle);
 
     /*----------------------------------------------------------------------*/
@@ -342,7 +338,7 @@ extern "C" {
     /** \returns Transaction Example name */
     SC_API const char* sc_transaction_example_name(const sc_transaction_example_t* handle);
 
-    /** \returns Transaction Example Description */
+    /** \returns Transaction Example description */
     SC_API const char* sc_transaction_example_description(const sc_transaction_example_t* handle);
 
     /*----------------------------------------------------------------------*/