[riot-notifications] [RIOT-OS/RIOT] doc: Tracking doxygen 1.8.15 problems (#10815)

Gunar Schorcht notifications at github.com
Thu Feb 7 11:58:08 CET 2019


> (2)  it is OK to ignore the "undocumented entity" warnings?

Our static tests include `make doc` which probably will fail with doxygen 1.8.15 due to these warnings.

> (3) Is there a reason why we have an empty project name?

I guess it was by intention. The behavior of earlier version of doxygen was to handle `mainpage.md` as root in the navigation tree if `PROJECT_NAME` is empty. For example, if you set `PROJECT_NAME = RIOT-OS` you would get a navigation tree as follows

![snapshot2](https://user-images.githubusercontent.com/31932013/52407041-7c172800-2acf-11e9-958d-b13f3333763c.png)

instead of

![snapshot1](https://user-images.githubusercontent.com/31932013/52407020-728dc000-2acf-11e9-871d-e38598a393e0.png)


-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/RIOT-OS/RIOT/issues/10815#issuecomment-461374304
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.riot-os.org/pipermail/notifications/attachments/20190207/69cc307c/attachment.html>


More information about the notifications mailing list