calinrada/php-apidoc — pull request #10 by santosdiez (2014-06-11 10:03:05+00:00)
Title: Handle multiline annotations

I've slightly changed the regex so that it also matches multiline annotations. For complex return objects, it's usually helpful to be able to write it down that way, instead of in a single line...

```
/**
* @ApiDescription(section="Home Page", description="Get the homepage information")
* @ApiMethod(type="get")
* @ApiRoute(name="/page-data/home")
* @ApiReturn(type="object", sample="{
* 'upcomingSeminars' : [],
* 'featuredSeminar' : {
* 'id' : 7,
* 'state' : 'live',
* 'startTimestamp' : 1392318000,
* 'favourited' : false,
* 'registered' : false,
* 'calendarUrl' : 'http://example.com/cals/seminar7.ics',
* 'seminarTime' : '7:00pm - 7:30pm (UTC)',
* 'level' : 'BEGINNER',
* 'seminarDate' : 'February 13 2014'
* },
* 'onDemandSeminars' : [
* {
* 'thumbnail' : {
* 'retinaUrl' : 'http://example.com/thumbs/23/event3-large-thumbnail.gif',
* 'standardUrl' : 'http://example.com/thumbs/17/event3-thumbnail.gif'
* },
* 'id' : 3,
* 'title' : 'Presentations',
* 'level' : 'BEGINNER',
* 'duration' : 1800,
* 'seminarDate' : 'February 27 2013',
* 'favourited' : false
* },
* {
* 'thumbnail' : {
* 'retinaUrl' : 'http://example.com/thumbs/24/event4-large-thumbnail.gif',
* 'standardUrl' : 'http://example.com/thumbs/18/event4-thumbnail.gif'
* },
* 'id' : 4,
* 'level' : 'INTERMEDIATE',
* 'duration' : 1800,
* 'seminarDate' : 'September 10 2012',
* 'favourited' : false
* },
* {
* 'thumbnail' : {
* 'retinaUrl' : 'http://example.com/thumbs/26/event6-large-thumbnail.gif',
* 'standardUrl' : 'http://example.com/thumbs/20/event6-thumbnail.gif'
* },
* 'id' : 6,
* 'level' : 'BEGINNER',
* 'duration' : 1800,
* 'seminarDate' : 'July 26 2012',
* 'favourited' : false
* }
* ]
* }")
*/
public function home($storeAlias)
{
}
```