doc格式支持更宽松的写法

[fishbar]

以下case需要跑通

/**
 * description
 * @api /tset
 *       description
 * @query
 *        description
 * @body
 *        description
 * @success
 * @error
 **/

[baqian]

建议支持schema描述 params、query和body

@api {POST|GET} /api/${version}/user/:id
@name 获取用户信息
@description 获取用户信息
@params
  id {String} 用户ID
  status {Boolean} 用户状态
@query
   limit {Object} se
     {
       search {String[]} must be urlencoded
       search1 {String} must be urlencoded
     }
   createTime:dataTime {String} must be urlencoded

@body:json
   name {Object} s

@success:json
   search {String[]} must be urlencoded
@success
   description
@failure
   description
@example
@private
@public
@internal

解析后

[
   {
      "token": "api",
      "methods": [
         "post",
         "get"
      ],
      "url": "/api/${version}/user/:id"
   },
   {
      "token": "name",
      "value": "获取用户信息"
   },
   {
      "token": "desc",
      "value": " 获取用户信息
"
   },
   {
      "token": "params",
      "type": null,
      "value": [
         {
            "name": "id",
            "type": "String",
            "format": null,
            "desc": "用户ID"
         },
         {
            "name": "status",
            "type": "Boolean",
            "format": null,
            "desc": "用户状态"
         }
      ]
   },
   {
      "token": "query",
      "type": null,
      "value": [
         {
            "name": "limit",
            "type": "Object",
            "format": null,
            "desc": "se",
            "properties": [
               {
                  "name": "search",
                  "type": "Array",
                  "format": null,
                  "desc": "must be urlencoded",
                  "items": {
                     "type": "String"
                  }
               },
               {
                  "name": "search1",
                  "type": "String",
                  "format": null,
                  "desc": "must be urlencoded"
               }
            ]
         },
         {
            "name": "createTime",
            "type": "String",
            "format": "dataTime",
            "desc": "must be urlencoded"
         }
      ]
   },
   {
      "token": "body",
      "type": "json",
      "value": [
         {
            "name": "name",
            "type": "Object",
            "format": null,
            "desc": "s",
            "properties": null
         }
      ]
   },
   {
      "token": "success",
      "type": "json",
      "value": [
         {
            "name": "search",
            "type": "Array",
            "format": null,
            "desc": "must be urlencoded",
            "items": {
               "type": "String"
            }
         }
      ]
   },
   {
      "token": "success",
      "type": "json",
      "value": "
   description
"
   },
   {
      "token": "failure",
      "type": "json",
      "value": "
   description
"
   },
   {
      "token": "example",
      "value": ""
   },
   {
      "token": "private",
      "value": true
   },
   {
      "token": "public",
      "value": true
   },
   {
      "token": "internal",
      "value": true
   }
]