[ 
https://issues.apache.org/jira/browse/MESOS-3581?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15026471#comment-15026471
 ] 

Till Toenshoff commented on MESOS-3581:
---------------------------------------

{noformat}
commit 3539b7a0e15b594148308319bf052d28b1429b98
Author: Benjamin Bannier <[email protected]>
Date:   Mon Nov 23 06:53:38 2015 -0800

    [libprocess]: Made license-headers doxygen-compatible.

    This commit adjusts license headers of C++ source and header files.

    Review: https://reviews.apache.org/r/39592
{noformat}

{noformat}
commit dc23756a5433d6f7fcd22d291babad14f6799233
Author: Benjamin Bannier <[email protected]>
Date:   Mon Nov 23 06:53:01 2015 -0800

    [stout]: Made license-headers doxygen-compatible.

    This commit adjusts license headers of C++ source and header files.

    Review: https://reviews.apache.org/r/39591
{noformat}

{noformat}
commit fa36917dd142f66924c5f7ed689b87d5ceabbf79
Author: Benjamin Bannier <[email protected]>
Date:   Mon Nov 23 06:49:31 2015 -0800

    Made license-headers doxygen-compatible.

    This commit adjusts license headers of C++ source and header files,
    and protobuf definitions.

    Also, reflect the changed style in the C++ style guide.

    Review: https://reviews.apache.org/r/39590
{noformat}

{noformat}
commit 384de473d9f388b84b77321c8a08e17efd558f10
Author: Benjamin Bannier <[email protected]>
Date:   Wed Nov 25 10:05:44 2015 +0100

    [stout] Fixed two headers that got cut off in dc23756a.

    Review: https://reviews.apache.org/r/40652/
{noformat}


> 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
>              Labels: mesosphere
>
> 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)

Reply via email to