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

Fix doxygen comments for hwtimer.h, queue.h and io.h #1041

Merged
merged 3 commits into from
May 15, 2014

Conversation

LudwigKnuepfer
Copy link
Member

Some things struck me as strange and I added "@todo" comments to them. I'd propose to add tickets in their regard unless someone says here and now that everything is in order with the respective bits.

Fixes #951

void hwtimer_init(void);
void hwtimer_init_comp(uint32_t fcpu);
Copy link
Contributor

Choose a reason for hiding this comment

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

This function exists and is not static.
Sorry, you only moved the prototype.

LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request Apr 22, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request Apr 22, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request Apr 22, 2014
@LudwigKnuepfer LudwigKnuepfer assigned OlegHahm and kaspar030 and unassigned OlegHahm Apr 22, 2014
uint32_t priority;
struct queue_node_t *next; /**< next queue node */
unsigned int data; /**< queue node data */
uint32_t priority; /**< queue node priority */
Copy link
Member

Choose a reason for hiding this comment

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

could you align above comments?

LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request Apr 28, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request Apr 28, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request Apr 28, 2014
*/
void hwtimer_spin(unsigned long ticks);

int hwtimer_active(void);

/** @} */
Copy link
Member

Choose a reason for hiding this comment

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

this file includes 2 closing @} but only one opening @{

void queue_add_head(queue_node_t *root, queue_node_t *new_obj);

/**
* @brief remove the queues head
Copy link
Member

Choose a reason for hiding this comment

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

queue's head

LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 13, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 13, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 13, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 13, 2014
@LudwigKnuepfer
Copy link
Member Author

Anything else or shall I squash?

@@ -17,7 +17,7 @@
* interrupt context and must use the shortest possible execution time (e.g.
* set a flag and trigger a worker thread).
*
* <b>The hardware timer must not be used within applications</b>, use \ref vtimer
* <b>The hardware timer must not be used within applications</b>, use \ref sys_vtimer
Copy link
Member

Choose a reason for hiding this comment

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

I think actually should not be used (until you know what you're doing) would be more accurate.

LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 14, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 14, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 14, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 14, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 14, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 14, 2014
LudwigKnuepfer added a commit to LudwigKnuepfer/RIOT that referenced this pull request May 14, 2014
@LudwigKnuepfer
Copy link
Member Author

Everything addressed again, squash now?

@@ -22,6 +22,12 @@
#ifndef IO_H
#define IO_H

/**
* @brief Feuerwhere putstring implementation
Copy link
Member

Choose a reason for hiding this comment

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

Feuerware (Feuerwhere was only the name of the project) - or call it firmware_puts. ;)

@OlegHahm
Copy link
Member

One last comment from my side, otherwise I'm fine with squashing and merging.

@LudwigKnuepfer
Copy link
Member Author

rebased, squashed

@LudwigKnuepfer
Copy link
Member Author

has got one explicit and one implicit ACKs -> go

LudwigKnuepfer added a commit that referenced this pull request May 15, 2014
Fix doxygen comments for hwtimer.h, queue.h and io.h
@LudwigKnuepfer LudwigKnuepfer merged commit 3fb3583 into RIOT-OS:master May 15, 2014
@LudwigKnuepfer LudwigKnuepfer deleted the issue_951 branch May 15, 2014 11:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Area: doc Area: Documentation Type: enhancement The issue suggests enhanceable parts / The PR enhances parts of the codebase / documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

core: documentation: hwtimer.h hwtimer_arch.h io.h queue.h
5 participants