[
https://issues.apache.org/jira/browse/MESOS-3581?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14970921#comment-14970921
]
Benjamin Bannier commented on MESOS-3581:
-----------------------------------------
After soliciting feedback on the [mailing
list|http://www.mail-archive.com/dev@mesos.apache.org/msg33488.html] there was
some consensus that updating the source files was preferable over a workaround
using e.g. {{INPUT_FILTER}}.
Will propose a patch implementing changed license headers next.
> License headers show up all over doxygen documentation.
> -------------------------------------------------------
>
> Key: MESOS-3581
> URL: https://issues.apache.org/jira/browse/MESOS-3581
> Project: Mesos
> Issue Type: Documentation
> Components: documentation
> Affects Versions: 0.24.1
> Reporter: Benjamin Bannier
> Assignee: Benjamin Bannier
> Priority: Minor
>
> Currently license headers are commented in something resembling Javadoc style,
> {code}
> /**
> * Licensed ...
> {code}
> Since we use Javadoc-style comment blocks for doxygen documentation all
> license headers appear in the generated documentation, potentially and likely
> hiding the actual documentation.
> Using {{/*}} to start the comment blocks would be enough to hide them from
> doxygen, but would likely also result in a largish (though mostly
> uninteresting) patch.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
