{"action":"created","issue":{"url":"https://api.github.com/repos/RobotLocomotion/drake/issues/2359","repository_url":"https://api.github.com/repos/RobotLocomotion/drake","labels_url":"https://api.github.com/repos/RobotLocomotion/drake/issues/2359/labels{/name}","comments_url":"https://api.github.com/repos/RobotLocomotion/drake/issues/2359/comments","events_url":"https://api.github.com/repos/RobotLocomotion/drake/issues/2359/events","html_url":"https://github.com/RobotLocomotion/drake/pull/2359","id":154944514,"number":2359,"title":"Enable autobrief in doxygen","user":{"login":"sherm1","id":4088016,"avatar_url":"https://avatars.githubusercontent.com/u/4088016?v=3","gravatar_id":"","url":"https://api.github.com/users/sherm1","html_url":"https://github.com/sherm1","followers_url":"https://api.github.com/users/sherm1/followers","following_url":"https://api.github.com/users/sherm1/following{/other_user}","gists_url":"https://api.github.com/users/sherm1/gists{/gist_id}","starred_url":"https://api.github.com/users/sherm1/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sherm1/subscriptions","organizations_url":"https://api.github.com/users/sherm1/orgs","repos_url":"https://api.github.com/users/sherm1/repos","events_url":"https://api.github.com/users/sherm1/events{/privacy}","received_events_url":"https://api.github.com/users/sherm1/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":{"login":"liangfok","id":1388098,"avatar_url":"https://avatars.githubusercontent.com/u/1388098?v=3","gravatar_id":"","url":"https://api.github.com/users/liangfok","html_url":"https://github.com/liangfok","followers_url":"https://api.github.com/users/liangfok/followers","following_url":"https://api.github.com/users/liangfok/following{/other_user}","gists_url":"https://api.github.com/users/liangfok/gists{/gist_id}","starred_url":"https://api.github.com/users/liangfok/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/liangfok/subscriptions","organizations_url":"https://api.github.com/users/liangfok/orgs","repos_url":"https://api.github.com/users/liangfok/repos","events_url":"https://api.github.com/users/liangfok/events{/privacy}","received_events_url":"https://api.github.com/users/liangfok/received_events","type":"User","site_admin":false},"milestone":null,"comments":7,"created_at":"2016-05-16T01:23:16Z","updated_at":"2016-05-16T15:45:23Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/RobotLocomotion/drake/pulls/2359","html_url":"https://github.com/RobotLocomotion/drake/pull/2359","diff_url":"https://github.com/RobotLocomotion/drake/pull/2359.diff","patch_url":"https://github.com/RobotLocomotion/drake/pull/2359.patch"},"body":"Per discussion in issue #2051, this PR enables `JAVADOC_AUTOBRIEF` in the Drake Doxyfiles for C++ and Matlab.\r\n\r\nWhat this means is that the first sentence of every doxygen comment will automatically be used as though it were preceded by `@brief` and followed by a blank line. This provides a one-line brief for every class and method that has even a short doxygen comment.\r\n\r\nDoxygen considers a sentence to end at the first period -- use `\\.` if you want a period included in the brief or want to have a multi-sentence brief. An explicit `@brief` will be harmlessly ignored, but those can be removed as code is updated.\r\n\r\nPossible source of trouble: explicit `@brief`s that were previously multi-sentence will be reduced to just their first sentence if no `\\.` is used, although the rest of the brief will still appear in the `More...` section.\r\n\r\nReviews, please:\r\nFeature: @liangfok \r\nPlatform: @jwnimmer-tri\n\n<!-- Reviewable:start -->\n---\nThis change is [<img src=\"https://reviewable.io/review_button.svg\" height=\"35\" align=\"absmiddle\" alt=\"Reviewable\"/>](https://reviewable.io/reviews/robotlocomotion/drake/2359) &emsp; Multiple assignees:&emsp;<img alt=\"@jwnimmer-tri\" height=\"20\" width=\"20\" align=\"absmiddle\" src=\"https://avatars.githubusercontent.com/u/17596505?s=40&v=3\">&nbsp;<a href=\"/robotlocomotion/drake/pulls/assigned/jwnimmer-tri\">jwnimmer-tri</a>,&emsp;<img alt=\"@liangfok\" height=\"20\" width=\"20\" align=\"absmiddle\" src=\"https://avatars.githubusercontent.com/u/1388098?s=40&v=3\">&nbsp;<a href=\"/robotlocomotion/drake/pulls/assigned/liangfok\">liangfok</a>\n<!-- Reviewable:end -->\n"},"comment":{"url":"https://api.github.com/repos/RobotLocomotion/drake/issues/comments/219460580","html_url":"https://github.com/RobotLocomotion/drake/pull/2359#issuecomment-219460580","issue_url":"https://api.github.com/repos/RobotLocomotion/drake/issues/2359","id":219460580,"user":{"login":"sherm1","id":4088016,"avatar_url":"https://avatars.githubusercontent.com/u/4088016?v=3","gravatar_id":"","url":"https://api.github.com/users/sherm1","html_url":"https://github.com/sherm1","followers_url":"https://api.github.com/users/sherm1/followers","following_url":"https://api.github.com/users/sherm1/following{/other_user}","gists_url":"https://api.github.com/users/sherm1/gists{/gist_id}","starred_url":"https://api.github.com/users/sherm1/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sherm1/subscriptions","organizations_url":"https://api.github.com/users/sherm1/orgs","repos_url":"https://api.github.com/users/sherm1/repos","events_url":"https://api.github.com/users/sherm1/events{/privacy}","received_events_url":"https://api.github.com/users/sherm1/received_events","type":"User","site_admin":false},"created_at":"2016-05-16T15:45:23Z","updated_at":"2016-05-16T15:45:23Z","body":"Merging although build hasn't completed yet since this doesn't affect the build. "}}