Skip to content

Minor Doxygen fixes for BufferedBlockDevice and iBeacon #9333

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

Merged
merged 3 commits into from
Jan 18, 2019

Conversation

offirko
Copy link
Contributor

@offirko offirko commented Jan 10, 2019

Description

Minor Doxygen fixes for BufferedBlockDevice and iBeacon

Pull request type

[ ] Fix
[ ] Refactor
[ ] Target update
[ ] Functionality change
[X] Docs update
[ ] Test update
[ ] Breaking change

Reviewers

@offirko
Copy link
Contributor Author

offirko commented Jan 10, 2019

@AnotherButler , @GuyWi - Please review

@ciarmcom ciarmcom requested review from a team January 10, 2019 13:07
@ciarmcom
Copy link
Member

@offirko, thank you for your changes.
@ARMmbed/mbed-os-pan @ARMmbed/mbed-os-storage @ARMmbed/mbed-os-maintainers please review.

@@ -35,35 +35,36 @@ namespace mbed {
*/
class BufferedBlockDevice : public BlockDevice {
public:
/** Lifetime of the memory block device
/** Create a memory-buffered block device wrapping an underlying block device
Copy link
Contributor

Choose a reason for hiding this comment

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

"Lifetime" is actually a standard phrase for the constructor.

pan-
pan- previously requested changes Jan 10, 2019
Copy link
Member

@pan- pan- left a comment

Choose a reason for hiding this comment

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

BLE iBeacon review.

* See the License for the specific language governing permissions and
* limitations under the License.
*/
* Copyright (c) 2006-2015 ARM Limited
Copy link
Member

Choose a reason for hiding this comment

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

Why the change of indentation ?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

hmm not sure why, guess its a result of : astyle --options=.astylerc

@@ -176,12 +176,11 @@ class iBeacon
len(0x15),
majorNumber(__REV16(majNum)),
minorNumber(__REV16(minNum)),
txPower(transmitPower)
{
txPower(transmitPower) {
Copy link
Member

Choose a reason for hiding this comment

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

According to mbed os guideline, { should be position on a new line when a function scope is opened.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

again a result of: astyle --options=.astylerc

Copy link
Contributor

Choose a reason for hiding this comment

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

BLE files are being ignored so shall not be changed - should be done as one update but requires more effort

@@ -192,14 +191,14 @@ class iBeacon
* to group their iBeacons into a single network, a single region and
* identify their organization among others.
*
* @param[in] majNum Beacon major group ID. iBeacon exploitants may use
* this field to divide the region into subregions, their network into
* @param[in] majNum Beacon major group ID. iBeacon users may use
Copy link
Member

Choose a reason for hiding this comment

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

iBeacon users may referred to end users that or the business operating an iBeacon fleet. I'd suggest iBeacon fleet operator

offirko and others added 2 commits January 10, 2019 15:42
Technical author review
@GuyWi
Copy link
Contributor

GuyWi commented Jan 10, 2019

@offirko - I committed some language edits.

@cmonr
Copy link
Contributor

cmonr commented Jan 10, 2019

@pan @davidsaada Changes look good now?

@0xc0170
Copy link
Contributor

0xc0170 commented Jan 17, 2019

CI started

@mbed-ci
Copy link

mbed-ci commented Jan 18, 2019

Test run: SUCCESS

Summary: 11 of 11 test jobs passed
Build number : 1
Build artifacts

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants