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

[PATCH v3] doc: userguide: update code blocks #2154

Merged
merged 1 commit into from
Dec 12, 2024

Conversation

MatiasElo
Copy link
Collaborator

Remove code sections copied from the API headers as they will not stay up- to-date. Update some code examples to utilize current APIs and remove some obsolete ones.

@odpbuild odpbuild changed the title doc: userguide: update code blocks [PATCH v1] doc: userguide: update code blocks Nov 22, 2024
@MatiasElo MatiasElo added this to the v1.46.0.0 release milestone Nov 26, 2024
Copy link
Collaborator

@JannePeltonen JannePeltonen left a comment

Choose a reason for hiding this comment

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

I made two comments, one not really related to the changes donen here and the other so minor that feel free to ignore it.

Note that parsing is automatically done whenever classification is enabled
for an RX interface (see below).
receipt as controlled by the `odp_pktio_parser_config_t` struct. Note that
parsing is automatically done whenever classification is enabled for an RX
Copy link
Collaborator

Choose a reason for hiding this comment

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

parsing is automatically done whenever classification is enabled

This statement caught my eye even though it is not changed by this commit. I wonder if enabling of parsing is really guaranteed by the API in this case as I did not find it in the API text. Or perhaps this is just the way the linux-gen ODP implementation works?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Indeed the API doesn't mention this, so removed the sentence.

-----
Note that the *queue_param* field of this struct is ignored in DIRECT mode.
The purpose of `odp_pktin_queue_config()` is to specify the number of PktIn
`odp_pktin_queue_config()` API, which purpose is to specify the number of PktIn
Copy link
Collaborator

Choose a reason for hiding this comment

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

The 'which' does not sound quite right to me. I would probably use 'whose', or if that is not good, I would say "... API, the purpose of which is ...".

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Changed to whose in V2.

@odpbuild odpbuild changed the title [PATCH v1] doc: userguide: update code blocks [PATCH v2] doc: userguide: update code blocks Dec 5, 2024
@MatiasElo MatiasElo enabled auto-merge (rebase) December 12, 2024 07:06
Remove code sections copied from the API headers as they will not stay up-
to-date. Update some code examples to utilize current APIs and remove some
obsolete ones.

Signed-off-by: Matias Elo <[email protected]>
Reviewed-by: Janne Peltonen <[email protected]>
@odpbuild odpbuild changed the title [PATCH v2] doc: userguide: update code blocks [PATCH v3] doc: userguide: update code blocks Dec 12, 2024
@MatiasElo MatiasElo merged commit 7b08ff5 into OpenDataPlane:master Dec 12, 2024
162 checks passed
@MatiasElo MatiasElo deleted the dev/user-guide branch December 16, 2024 07:45
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.

2 participants