Skip to content

Update and improve API documentation#2952

Merged
dbatyai merged 1 commit intojerryscript-project:masterfrom
galpeter:doc_update_1
Jul 10, 2019
Merged

Update and improve API documentation#2952
dbatyai merged 1 commit intojerryscript-project:masterfrom
galpeter:doc_update_1

Conversation

@galpeter
Copy link
Copy Markdown
Contributor

@galpeter galpeter commented Jul 8, 2019

A few parts of the API documentation was not clear enough.
Added extra details and examples.

@galpeter galpeter added the documentation Related to documentation label Jul 8, 2019
Copy link
Copy Markdown
Member

@rerobika rerobika left a comment

Choose a reason for hiding this comment

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

Nice examples, only a minor style issue.

Comment thread docs/02.API-REFERENCE.md Outdated
returns the number of bytes used for the string.
- This is **not** the number of bytes required to store the string.


Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

IMO 1 new line is enough here.

@galpeter galpeter force-pushed the doc_update_1 branch 2 times, most recently from ec63efe to d2b5ab7 Compare July 9, 2019 08:43
Copy link
Copy Markdown
Member

@rerobika rerobika left a comment

Choose a reason for hiding this comment

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

LGTM

@galpeter
Copy link
Copy Markdown
Contributor Author

galpeter commented Jul 9, 2019

@rerobika I've did a bit of update (around the jerry_string_to_char_buffer method)

@rerobika
Copy link
Copy Markdown
Member

rerobika commented Jul 9, 2019

Still LGTM.

Comment thread docs/02.API-REFERENCE.md Outdated
void *user_data_p);
```

- `object` - is current the JavaScript in the iteration.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Please fix this sentence.

Comment thread docs/02.API-REFERENCE.md Outdated
jerry_release_value (func_val);
jerry_release_value (glob_obj);


Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Extra line here.

Comment thread docs/02.API-REFERENCE.md Outdated

... // create or acquire value to set
// create or acquire value to set
// Fo example:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

For example

Comment thread docs/02.API-REFERENCE.md Outdated
{
jerry_value_t test_property = jerry_create_string ((const jerry_char_t *) "DemoProp");
jerry_value_t test_value = jerry_create_number (3);
/* By default all properties added to an object is enumerable. */
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

is -> are

A few parts of the API documentation was not clear enough.
Added extra details and examples.

JerryScript-DCO-1.0-Signed-off-by: Peter Gal pgal.u-szeged@partner.samsung.com
Copy link
Copy Markdown
Contributor

@LaszloLango LaszloLango left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Copy Markdown
Member

@dbatyai dbatyai left a comment

Choose a reason for hiding this comment

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

LGTM

@dbatyai dbatyai merged commit 1374d5f into jerryscript-project:master Jul 10, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Related to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants