docparser

type DocComment struct {
	Summary     string
	Description string
	Params      []ParamDoc
	Returns     *ReturnDoc
	Deprecated  string
	Since       string
	See         []string
	Examples    []string
	Throws      []ThrowDoc
}

type ParamDoc struct {
	Name        string
	Type        string
	Description string
	Optional    bool
	Default     string
}

type Parser interface {
	Parse(raw string) *DocComment
}

type ReturnDoc struct {
	Type        string
	Description string
}

type ThrowDoc struct {
	Type        string
	Description string
}