mpociot / laravel-apidoc-generator

            })

            ->mapWithKeys(function ($tag) {

                preg_match('/(.+?)\s+(.+?)\s+(required\s+)?(.*)/', $tag->getContent(), $content);

                if (empty($content)) {

                    // this means only name and type were supplied

                    list($name, $type) = preg_split('/\s+/', $tag->getContent());

                    $required = false;

                    $description = '';

                } else {

                    list($_, $name, $type, $required, $description) = $content;

                    $description = trim($description);

                    if ($description == 'required' && empty(trim($required))) {

                        $required = $description;

                        $description = '';

                    }

                    $required = trim($required) == 'required' ? true : false;

                }

                $type = $this->normalizeParameterType($type);

                list($description, $example) = $this->parseDescription($description, $type);

            })

            ->mapWithKeys(function ($tag) {

                preg_match('/(.+?)\s+(required\s+)?(.*)/', $tag->getContent(), $content);

                if (empty($content)) {

                    // this means only name was supplied

                    list($name) = preg_split('/\s+/', $tag->getContent());

                    $required = false;

                    $description = '';

                } else {

                    list($_, $name, $required, $description) = $content;

                    $description = trim($description);

                    if ($description == 'required' && empty(trim($required))) {

                        $required = $description;

                        $description = '';

                    }

                    $required = trim($required) == 'required' ? true : false;

                }

                list($description, $value) = $this->parseDescription($description, 'string');

                if (is_null($value)) {