-
Notifications
You must be signed in to change notification settings - Fork 283
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
c-api: README.md #974
c-api: README.md #974
Conversation
/azp run |
Azure Pipelines successfully started running 1 pipeline(s). |
common/c-api/README.md
Outdated
@@ -0,0 +1,72 @@ | |||
# C API | |||
|
|||
This directory contains the swss-common C API. The C API is an incomplete, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
maybe better to change incomplete to in progress :D
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok, although my understanding is the intention is never for it to be complete.
common/c-api/README.md
Outdated
This directory contains the swss-common C API. The C API is an incomplete, | ||
hand-written C wrapper around functions in swss-common. Functionality is | ||
added as needed. It is designed to be understandable without incurring major | ||
performance penalties. It was primarily written to support Rust code using |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It was initially (not primarily)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These mean the same thing in context but I will make this change
returned value in this case. | ||
|
||
Example: | ||
```c |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nit: line break before code block
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
usually markdown-lint vs extension can help identify all the small format issues.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I can change this but I'm not sure why. It's not required by markdown.
common/c-api/README.md
Outdated
@@ -0,0 +1,72 @@ | |||
# C API |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
swss-common C API
/azp run |
Azure Pipelines successfully started running 1 pipeline(s). |
Added a README for the C API at Riff's request, explaining its purpose, exception handling, and memory management practices.