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

Documentation fixes #2116

Merged
merged 8 commits into from
Oct 19, 2020
Merged

Documentation fixes #2116

merged 8 commits into from
Oct 19, 2020

Conversation

mikee47
Copy link
Contributor

@mikee47 mikee47 commented Oct 17, 2020

@kmihaylov Re #2106 I've included a basic README for the CS5460 library, if you'd like to add anything you could do it here!

@mikee47 mikee47 changed the title Add missing library README files and fix headings so index is generated correctly Documentation fixes [WIP] Oct 18, 2020
@slaff slaff added this to the 4.2.0 milestone Oct 18, 2020
@slaff slaff changed the title Documentation fixes [WIP] [WIP] Documentation fixes Oct 18, 2020
@mikee47
Copy link
Contributor Author

mikee47 commented Oct 18, 2020

You can browse the resulting documentation for this PR at https://smingdev.readthedocs.io/en/fix-documentation/

@mikee47 mikee47 changed the title [WIP] Documentation fixes Documentation fixes Oct 18, 2020
Otherwise cannot then omit members, which for stream documentation makes it unusable.
Don't repeat comments from inherited classes unless there is something to add.
This means we must explicitly add `:members:` declarations if required.
@slaff
Copy link
Contributor

slaff commented Oct 19, 2020

@mikee47 Ping me when this PR is ready.

@mikee47
Copy link
Contributor Author

mikee47 commented Oct 19, 2020

@slaff All done, thanks.

:cpp:class:`IDataSourceStream` is used where read-only access is required.
It introduces the :cpp:func:`IDataSourceStream::readMemoryBlock` method which
performs a regular read without updating the stream position.
This allows optimistic reading and re-sending, but cannot be handle by some stream
Copy link
Contributor

@slaff slaff Oct 19, 2020

Choose a reason for hiding this comment

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

but cannot be handle by some stream

Did you mean "but cannot be handled by some stream" ?

@slaff
Copy link
Contributor

slaff commented Oct 19, 2020

Ready?

@mikee47
Copy link
Contributor Author

mikee47 commented Oct 19, 2020

Yep. Hit it!

@slaff slaff removed the 3 - Review label Oct 19, 2020
@slaff slaff merged commit b3893e0 into SmingHub:develop Oct 19, 2020
@mikee47 mikee47 deleted the fix/documentation branch October 19, 2020 17:11
mikee47 added a commit to mikee47/Sming that referenced this pull request Oct 20, 2020
Premature as PR hasn't been submitted yet! This will end up in 4.1 -> 4.2.
slaff pushed a commit that referenced this pull request Oct 20, 2020
Premature as PR hasn't been submitted yet! This will end up in 4.1 -> 4.2.
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