Skip to content

gnrc_ipv6: add config macros to config doc group#10617

Merged
jia200x merged 1 commit intoRIOT-OS:masterfrom
miri64:gnrc_ipv6/enh/config-group
Dec 17, 2018
Merged

gnrc_ipv6: add config macros to config doc group#10617
jia200x merged 1 commit intoRIOT-OS:masterfrom
miri64:gnrc_ipv6/enh/config-group

Conversation

@miri64
Copy link
Copy Markdown
Member

@miri64 miri64 commented Dec 14, 2018

Contribution description

See #10566

Testing procedure

Compile documentation. A new group for the configuration macros of gnrc_ipv6 should show up both in the config group doc as well in the doc of the respective gnrc_ipv6 (sub-)modules changed here.

Issues/PRs references

Addresses #10566 in part

@miri64 miri64 added Type: enhancement The issue suggests enhanceable parts / The PR enhances parts of the codebase / documentation Area: doc Area: Documentation TF: Config Marks issues and PRs related to the work of the Configuration Task Force labels Dec 14, 2018
@miri64 miri64 requested a review from jia200x December 14, 2018 15:31
@miri64 miri64 force-pushed the gnrc_ipv6/enh/config-group branch from 948ceba to 3f17db1 Compare December 14, 2018 15:35
#endif

/**
* @defgroup net_gnrc_ipv6_blacklist_conf GNRC IPv6 address blacklisting compile configurations
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Can't really split the line, otherwise doxygen renders it as @brief. It is still within the absolute maximum though

#endif

/**
* @defgroup net_gnrc_ipv6_whitelist_conf GNRC IPv6 address whitelisting compile configurations
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Dito



/**
* @defgroup net_gnrc_ipv6_conf GNRC IPv6 compile configurations
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

so, we agree all configuration groups have the <dox_module>_conf name?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

As long as it is clear, that they have something to do with configuration and are in the config group, I don't really care either way.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'm OK with it

@jia200x jia200x added the CI: ready for build If set, CI server will compile all applications for all available boards for the labeled PR label Dec 17, 2018
@jia200x
Copy link
Copy Markdown
Member

jia200x commented Dec 17, 2018

Looks OK to me. We might need another grouping in the future if the list of configurations keeps growing (e.g config>ipv6>nib-like grouping). But it's a good starting point :)

@jia200x
Copy link
Copy Markdown
Member

jia200x commented Dec 17, 2018

Generated documentation looks ok and Doxygen doesn't report errors.

Copy link
Copy Markdown
Member

@jia200x jia200x left a comment

Choose a reason for hiding this comment

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

ACK

@jia200x jia200x merged commit 1c82f78 into RIOT-OS:master Dec 17, 2018
@jia200x
Copy link
Copy Markdown
Member

jia200x commented Dec 17, 2018

First PR of the #10566 series! Congratz 🎉

@miri64 miri64 deleted the gnrc_ipv6/enh/config-group branch December 17, 2018 12:56
@aabadie aabadie added this to the Release 2019.01 milestone Dec 19, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area: doc Area: Documentation CI: ready for build If set, CI server will compile all applications for all available boards for the labeled PR TF: Config Marks issues and PRs related to the work of the Configuration Task Force 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.

3 participants