Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

capi: Clarify comments #635

Merged
merged 1 commit into from
Nov 6, 2020
Merged

capi: Clarify comments #635

merged 1 commit into from
Nov 6, 2020

Conversation

gumb0
Copy link
Collaborator

@gumb0 gumb0 commented Nov 4, 2020

No description provided.

@codecov
Copy link

codecov bot commented Nov 4, 2020

Codecov Report

Merging #635 (3f8dcbf) into master (7c0562b) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #635   +/-   ##
=======================================
  Coverage   98.36%   98.36%           
=======================================
  Files          69       69           
  Lines        9622     9622           
=======================================
  Hits         9465     9465           
  Misses        157      157           

@gumb0 gumb0 requested review from chfast and axic November 4, 2020 18:46
/// Takes ownership of module, i.e. @p module is invalidated after this call.
/// Takes ownership of module, i.e. fizzy_free_module must not be called after this call.
/// For simplicity module cannot be shared among several instances (calling fizzy_instatiate more
/// than once with the same module is not allowed), but after fizzy_instantiate functions querying
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"is not allowed" -> "results in undefined behaviour" ?

/// Takes ownership of module, i.e. @p module is invalidated after this call.
/// Takes ownership of module, i.e. fizzy_free_module must not be called after this call.
/// For simplicity module cannot be shared among several instances (calling fizzy_instatiate more
/// than once with the same module is not allowed), but after fizzy_instantiate functions querying
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here?

@@ -165,7 +165,10 @@ bool fizzy_find_exported_function(
const FizzyModule* module, const char* name, uint32_t* out_func_idx);

/// Instantiate a module.
/// Takes ownership of module, i.e. @p module is invalidated after this call.
/// Takes ownership of module, i.e. fizzy_free_module must not be called after this call.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// Takes ownership of module, i.e. fizzy_free_module must not be called after this call.
/// The instance takes ownership of the module, i.e. fizzy_free_module must not be called on the module after this call.

@@ -165,7 +165,10 @@ bool fizzy_find_exported_function(
const FizzyModule* module, const char* name, uint32_t* out_func_idx);

/// Instantiate a module.
/// Takes ownership of module, i.e. @p module is invalidated after this call.
/// Takes ownership of module, i.e. fizzy_free_module must not be called after this call.
/// For simplicity module cannot be shared among several instances (calling fizzy_instatiate more
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// For simplicity module cannot be shared among several instances (calling fizzy_instatiate more
/// For simplicity a module cannot be shared among several instances (calling fizzy_instatiate more

@axic
Copy link
Member

axic commented Nov 6, 2020

Squashed.

@axic axic merged commit b58d6e6 into master Nov 6, 2020
@axic axic deleted the capi-comments branch November 6, 2020 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants